хук-фильтр
since 2.9.0
pre_http_request
Проверено на WordPress 6.9, обновлено Источник: WordPress Developer Resources.
Сигнатура
apply_filters( 'pre_http_request', false|array|WP_Error $response, array $parsed_args, string $url )Описание
Возврат из фильтра значения, отличного от false, прервёт HTTP-запрос и досрочно вернёт это значение. Фильтр должен возвращать одно из:
Массив, содержащий элементы 'headers', 'body', 'response', 'cookies' и 'filename'
Экземпляр WP_Error
Логическое false, чтобы не прерывать ответ
Возврат любого другого значения может привести к непредсказуемому поведению.
Оригинал (английский)
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.
Фильтруемое значение
Упреждающее возвращаемое значение HTTP-запроса. Значение по умолчанию — false.
Параметры
$response
false|array|WP_Error
обязательный
Упреждающее возвращаемое значение HTTP-запроса. Значение по умолчанию — false.
$parsed_args
array
обязательный
Аргументы HTTP-запроса.
$url
string
обязательный
URL запроса.
Исходный код
wp-includes/class-wp-http.php:277
$pre = apply_filters( 'pre_http_request', false, $parsed_args, $url );История изменений
| Версия | Описание |
|---|---|
| 2.9.0 | Introduced. |
