钩子文档

http_request_timeout

💡 云策文档标注

概述

http_request_timeout 是一个 WordPress 过滤器,用于修改 HTTP 请求的超时时间。它允许开发者根据 URL 动态调整请求超时值,默认值为 5 秒。

关键要点

  • 过滤器名称:http_request_timeout
  • 参数:$timeout_value(浮点数,超时秒数,默认 5)和 $url(字符串,请求 URL)
  • 用途:在 WP_Http::request() 中应用,控制 HTTP 请求的超时行为
  • 版本历史:从 2.7.0 版本引入,5.1.0 版本添加了 $url 参数

代码示例

'timeout' => apply_filters( 'http_request_timeout', 5, $url ),

注意事项

使用此过滤器时,需确保超时值设置合理,以避免请求阻塞或过早超时影响性能。


📄 原文内容

Filters the timeout value for an HTTP request.

Parameters

$timeout_valuefloat
Time in seconds until a request times out. Default 5.
$urlstring
The request URL.

Source

'timeout'             => apply_filters( 'http_request_timeout', 5, $url ),

Changelog

Version Description
5.1.0 The $url parameter was added.
2.7.0 Introduced.