发起 HTTP 请求

我们经常需要从主题或插件中发起 HTTP 请求，例如当我们需要从外部 API 获取数据时。幸运的是，WordPress 提供了许多辅助函数来帮助您完成此操作。

在本节中，您将学习如何正确地发起 HTTP 请求并处理其响应。

以下是您将要看到的内容示例：

$response = wp_remote_get( 'https://api.github.com/users/wordpress' );
$body     = wp_remote_retrieve_body( $response );

在接下来的文章中，您将看到关于如何发起请求的详细解释：

• 从外部服务获取 GET 数据
• 向外部服务发送 POST 数据
• 性能
• 高级用法
• 身份验证

如果您只是查找可用的辅助函数，它们如下所示：

以下函数是您用于检索 URL 的函数。

• wp_remote_get()：使用 GET HTTP 方法检索 URL。
• wp_remote_post()：使用 POST HTTP 方法检索 URL。
• wp_remote_head()：使用 HEAD HTTP 方法检索 URL。
• wp_remote_request()：使用默认的 GET 或您指定的自定义 HTTP 方法检索 URL。

其他辅助函数用于检索响应的不同部分。这些函数使 API 的使用变得非常简单，是处理响应对象的首选方法。

• wp_remote_retrieve_body() – 仅检索响应中的正文。
• wp_remote_retrieve_header() – 根据名称从原始响应中检索单个头部。
• wp_remote_retrieve_headers() – 仅从原始响应中检索头部。
• wp_remote_retrieve_response_code() – 检索 HTTP 响应的响应代码。这应该是 200，但在失败时可能是 4xx 甚至 3xx。
• wp_remote_retrieve_response_message() – 仅从原始响应中检索响应消息。