wp/wp-includes/class-wp-http-requests-hooks.php
changeset 7 cf61fcea0001
child 9 177826044cd9
--- /dev/null	Thu Jan 01 00:00:00 1970 +0000
+++ b/wp/wp-includes/class-wp-http-requests-hooks.php	Mon Oct 14 17:39:30 2019 +0200
@@ -0,0 +1,76 @@
+<?php
+/**
+ * HTTP API: Requests hook bridge class
+ *
+ * @package WordPress
+ * @subpackage HTTP
+ * @since 4.7.0
+ */
+
+/**
+ * Bridge to connect Requests internal hooks to WordPress actions.
+ *
+ * @since 4.7.0
+ *
+ * @see Requests_Hooks
+ */
+class WP_HTTP_Requests_Hooks extends Requests_Hooks {
+	/**
+	 * Requested URL.
+	 *
+	 * @var string Requested URL.
+	 */
+	protected $url;
+
+	/**
+	 * WordPress WP_HTTP request data.
+	 *
+	 * @var array Request data in WP_Http format.
+	 */
+	protected $request = array();
+
+	/**
+	 * Constructor.
+	 *
+	 * @param string $url URL to request.
+	 * @param array $request Request data in WP_Http format.
+	 */
+	public function __construct( $url, $request ) {
+		$this->url = $url;
+		$this->request = $request;
+	}
+
+	/**
+	 * Dispatch a Requests hook to a native WordPress action.
+	 *
+	 * @param string $hook Hook name.
+	 * @param array $parameters Parameters to pass to callbacks.
+	 * @return boolean True if hooks were run, false if nothing was hooked.
+	 */
+	public function dispatch( $hook, $parameters = array() ) {
+		$result = parent::dispatch( $hook, $parameters );
+
+		// Handle back-compat actions
+		switch ( $hook ) {
+			case 'curl.before_send':
+				/** This action is documented in wp-includes/class-wp-http-curl.php */
+				do_action_ref_array( 'http_api_curl', array( &$parameters[0], $this->request, $this->url ) );
+				break;
+		}
+
+		/**
+		 * Transforms a native Request hook to a WordPress actions.
+		 *
+		 * This action maps Requests internal hook to a native WordPress action.
+		 *
+		 * @see https://github.com/rmccue/Requests/blob/master/docs/hooks.md
+		 *
+		 * @param array $parameters Parameters from Requests internal hook.
+		 * @param array $request Request data in WP_Http format.
+		 * @param string $url URL to request.
+		 */
+		do_action_ref_array( "requests-{$hook}", $parameters, $this->request, $this->url );
+
+		return $result;
+	}
+}