requests-{$hook}
云策文档标注
概述
此文档描述了如何将 Requests 库的内部钩子转换为 WordPress 动作,用于在 HTTP 请求处理中映射钩子到 WordPress 动作系统。
关键要点
- 将 Requests 内部钩子映射为 WordPress 动作,通过 do_action_ref_array 调用。
- 参数包括 $parameters(Requests 钩子参数数组)、$request(WP_Http 格式的请求数据)和 $url(请求的 URL)。
- 相关函数 WP_HTTP_Requests_Hooks::dispatch() 用于调度钩子到 WordPress 动作。
- 此功能自 WordPress 4.7.0 版本引入。
注意事项
- 钩子名称使用 "requests-{$hook}" 格式,需注意 WordPress 命名规范(代码中已忽略下划线规则)。
- 参考 Requests 库的 hooks.md 文档以了解更多钩子细节。
原文内容
Transforms a native Request hook to a WordPress action.
Description
This action maps Requests internal hook to a native WordPress action.
See also
Parameters
$parametersarray-
Parameters from Requests internal hook.
$requestarray-
Request data in WP_Http format.
$urlstring-
URL to request.
Source
do_action_ref_array( "requests-{$hook}", $parameters, $this->request, $this->url ); // phpcs:ignore WordPress.NamingConventions.ValidHookName.UseUnderscores
Changelog
| Version | Description |
|---|---|
| 4.7.0 | Introduced. |