钩子文档

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.