钩子文档

http_api_transports

💡 云策文档标注

概述

本文档介绍了 WordPress 中用于过滤可用 HTTP 传输方式及其顺序的 Hook。该 Hook 已从 6.4.0 版本起被弃用,建议使用替代方法。

关键要点

  • Hook 名称:http_api_transports,用于控制 HTTP 请求的传输方式(如 curl 和 streams)及其优先级。
  • 参数:包括传输方式数组、HTTP 请求参数和请求 URL,允许开发者自定义传输逻辑。
  • 弃用状态:从 WordPress 6.4.0 起被弃用,推荐使用 WpOrgRequestsRequests::get_transport_class() 作为替代。
  • 相关函数:WP_Http::_get_first_available_transport() 用于测试支持请求的传输方式。

注意事项

由于该 Hook 已被弃用,开发者应避免在新代码中使用,并考虑迁移到推荐的替代方案以确保兼容性。


📄 原文内容

Filters which HTTP transports are available and in what order.

Parameters

$transportsstring[]
Array of HTTP transports to check. Default array contains 'curl' and 'streams', in that order.
$argsarray
HTTP request arguments.
$urlstring
The URL to request.

Source

$request_order = apply_filters_deprecated( 'http_api_transports', array( $transports, $args, $url ), '6.4.0' );

Changelog

Version Description
6.4.0 Deprecated. Use WpOrgRequestsRequests::get_transport_class()
3.7.0 Introduced.