[Summary view] [Print] [Text view]

   1  <?php
   2  /**
   3   * HTTP API: Requests hook bridge class
   4   *
   5   * @package WordPress
   6   * @subpackage HTTP
   7   * @since 4.7.0
   8   */
   9  
  10  /**
  11   * Bridge to connect Requests internal hooks to WordPress actions.
  12   *
  13   * @since 4.7.0
  14   *
  15   * @see WpOrg\Requests\Hooks
  16   */
  17  #[AllowDynamicProperties]
  18  class WP_HTTP_Requests_Hooks extends WpOrg\Requests\Hooks {
  19      /**
  20       * Requested URL.
  21       *
  22       * @var string Requested URL.
  23       */
  24      protected $url;
  25  
  26      /**
  27       * WordPress WP_HTTP request data.
  28       *
  29       * @var array Request data in WP_Http format.
  30       */
  31      protected $request = array();
  32  
  33      /**
  34       * Constructor.
  35       *
  36       * @param string $url     URL to request.
  37       * @param array  $request Request data in WP_Http format.
  38       */
  39  	public function __construct( $url, $request ) {
  40          $this->url     = $url;
  41          $this->request = $request;
  42      }
  43  
  44      /**
  45       * Dispatch a Requests hook to a native WordPress action.
  46       *
  47       * @param string $hook       Hook name.
  48       * @param array  $parameters Parameters to pass to callbacks.
  49       * @return bool True if hooks were run, false if nothing was hooked.
  50       */
  51  	public function dispatch( $hook, $parameters = array() ) {
  52          $result = parent::dispatch( $hook, $parameters );
  53  
  54          // Handle back-compat actions.
  55          switch ( $hook ) {
  56              case 'curl.before_send':
  57                  /** This action is documented in wp-includes/class-wp-http-curl.php */
  58                  do_action_ref_array( 'http_api_curl', array( &$parameters[0], $this->request, $this->url ) );
  59                  break;
  60          }
  61  
  62          /**
  63           * Transforms a native Request hook to a WordPress action.
  64           *
  65           * This action maps Requests internal hook to a native WordPress action.
  66           *
  67           * @see https://github.com/WordPress/Requests/blob/master/docs/hooks.md
  68           *
  69           * @since 4.7.0
  70           *
  71           * @param array $parameters Parameters from Requests internal hook.
  72           * @param array $request Request data in WP_Http format.
  73           * @param string $url URL to request.
  74           */
  75          do_action_ref_array( "requests-{$hook}", $parameters, $this->request, $this->url ); // phpcs:ignore WordPress.NamingConventions.ValidHookName.UseUnderscores
  76  
  77          return $result;
  78      }
  79  }