WordPress.org
Get WordPress
WordPress.org

WordPress Developer Resources

pre_http_request

apply_filters( ‘pre_http_request’, false|array|WP_Error $response, array $parsed_args, string $url )

In this article

Back to top

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.

Source

$pre = apply_filters( 'pre_http_request', false, $parsed_args, $url );

View all references View on Trac View on GitHub

Used byDescription
WP_Http::request()wp-includes/class-wp-http.php

Send an HTTP request to a URI.

Changelog

VersionDescription
2.9.0Introduced.

User Contributed Notes

  1. Skip to note 2 content
    expresstechsoftware
    You must log in to vote on the helpfulness of this noteVote results for this note: 0You must log in to vote on the helpfulness of this note
    add_filter( 'pre_http_request', 'pass_or_reject_request', 10, 3 );

function pass_or_reject_request( $preempt, $parsed_args, $url ){
	// filter...
	if( strpos($url, 'http(s)://any_domain.com') !==false ){
		return new WP_Error( 'http_request_block', __( "This request is not allowed", "textdomain" ) );
	}
	return $preempt;
}

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