apply_filters( 'pre_http_request', false|array|WP_Error $response, array $parsed_args, string $url )
- Since
- 2.9.0
Filters the preemptive return value of an HTTP request.
Description
Returning a non-false value from the filter will short-circuit the HTTP request and return early with that value. A filter should return one of:
- An array containing 'headers', 'body', 'response', 'cookies', and 'filename' elements
- A WP_Error instance
- boolean false to avoid short-circuiting the response
Returning any other value may result in unexpected behavior.
Parameters
$responsefalse|array|WP_Error- A preemptive return value of an HTTP request. Default false.
$parsed_argsarray- HTTP request arguments.
$urlstring- The request URL.
Fired at · 1
wp-includes/class-wp-http.php:272WP_Http::request()
Source
* @since 2.9.0 * * @param false|array|WP_Error $response A preemptive return value of an HTTP request. Default false. * @param array $parsed_args HTTP request arguments. * @param string $url The request URL. */ $pre = apply_filters( 'pre_http_request', false, $parsed_args, $url ); if ( false !== $pre ) { return $pre; } if ( function_exists( 'wp_kses_bad_protocol' ) ) {History
Introduced in 2.9.0. Unchanged from 6.7.7 through 7.1.0.
Signature, return type and hooks compared across 5 parsed releases.
About this page
- Parsed data
- Generated from the wordpress-develop 6.7.7 tag, and regenerated for each WordPress release so it tracks the code rather than a snapshot of it.
- Corrections
- Something wrong on this page? Report it and it gets fixed in the next regeneration.