apply_filters( 'pre_http_request', false|array|WP_Error $preempt, array $parsed_args, string $url )

Filters the preemptive return value of an HTTP request.

Description 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 behaviour.

Top ↑

Parameters Parameters


(false|array|WP_Error) A preemptive return value of an HTTP request. Default false.


(array) HTTP request arguments.


(string) The request URL.

Top ↑

Source Source

File: wp-includes/class-http.php

View on Trac

Top ↑

Changelog Changelog

Version Description
2.9.0 Introduced.

Top ↑

User Contributed Notes User Contributed Notes

You must log in before being able to contribute a note or feedback.