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.
Compatibility
- WordPress
- since 2.9.0
- 6.7.7
- 6.8.8
- 6.9.7
- 7.0.4
- 7.1.0
Present in every tracked release (6.7.7 to 7.1.0).
Parameters
$responsefalse|array|WP_Error- A preemptive return value of an HTTP request. Default false.
$parsed_argsarray- HTTP request arguments.
$urlstring- The request URL.
Where this hook fires · 1
wp-includes/class-wp-http.php:277WP_Http::request()
Changelog
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 7.1.0 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.