WordPress 插件开发教程：HTTP API 详解

在 WordPress 插件开发中，HTTP API 是一个非常重要的工具，它允许开发者与其他服务进行数据交换。在本教程中，我们将分 10 个知识点来详细讲解 HTTP API 的使用方法，并通过具体的代码示例来加深理解。

1. HTTP API 的基础概念

HTTP（超文本传输协议）是互联网的基础通信协议。WordPress 的 HTTP API 是为了简化与外部 API 通信而设计的，它支持多种 HTTP 方法，并在不同情况下选择最合适的方式来发送请求。通过 HTTP API，我们可以轻松地与 Twitter API、Google API 等平台进行数据交互。

速记句：HTTP API 是 WordPress 与外部服务对话的桥梁。

2. GET 请求：获取数据

GET 方法是 HTTP 中最常用的请求方式，用于从服务器获取数据。在 WordPress 中，使用 wp_remote_get()​函数可以轻松实现 GET 请求。比如，我们可以通过以下代码获取 GitHub 用户的信息：

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

速记句：GET 用于获取，wp_remote_get()​来实现。

3. POST 请求：发送数据

POST 方法通常用于发送数据到服务器，如提交表单。使用 wp_remote_post()​函数可以将数据发送至 API。例如，发送一个联系表单的数据：

$body = array(
   'name' => 'Jane Smith',
   'email' => 'some@email.com',
   'subject' => 'Checkout this API stuff',
   'comment' => 'I just read a great tutorial...'
);

$args = array(
   'body' => $body,
);

$response = wp_remote_post( 'http://your-contact-form.com', $args );

速记句：POST 用于发送，wp_remote_post()​来实现。

4. HEAD 请求：检查资源状态

HEAD 请求类似于 GET，但只获取响应头信息而不获取数据本身。它常用于检查资源是否更新。使用 wp_remote_head()​函数可以实现 HEAD 请求。比如：

$response = wp_remote_head( 'https://api.github.com/users/blobaugh' );

速记句：HEAD 只要头信息，wp_remote_head()​来实现。

5. HTTP 响应码

HTTP 响应码用于表示请求的结果状态。常见的响应码包括 200（成功）、404（未找到）等。在 WordPress 中，使用 wp_remote_retrieve_response_code()​可以获取响应码：

$response = wp_remote_get( 'https://api.github.com/users/blobaugh' );
$http_code = wp_remote_retrieve_response_code( $response );

速记句：响应状态看代码，wp_remote_retrieve_response_code()​来获取。

6. 获取响应体

通常我们只对响应体中的数据感兴趣。使用 wp_remote_retrieve_body()​可以提取响应体的内容。例如：

$body = wp_remote_retrieve_body( $response );

速记句：数据内容在响应体，wp_remote_retrieve_body()​来提取。

7. 获取特定的 Header 信息

有时我们需要获取特定的 Header 信息，如数据的最后修改时间。使用 wp_remote_retrieve_header()​可以实现：

$last_modified = wp_remote_retrieve_header( $response, 'last-modified' );

速记句：特定 Header 用 wp_remote_retrieve_header()​来获取。

8. 使用基本身份验证

对于需要身份验证的 API，可以通过在请求头中传递认证信息来实现。使用 wp_remote_get()​或 wp_remote_post()​都可以实现基本身份验证：

$args = array(
   'headers' => array(
      'Authorization' => 'Basic ' . base64_encode( 'username:password' )
   )
);
$response = wp_remote_get( $url, $args );

速记句：身份验证加头信息，Authorization​来传递。

9. 缓存 API 响应

为了减轻服务器负担，提高性能，我们可以缓存 API 的响应。使用 set_transient()​和 get_transient()​可以实现缓存操作：

$github_userinfo = get_transient( 'blobaugh_github_userinfo' );

if( false === $github_userinfo ) {
   $response = wp_remote_get( 'https://api.github.com/users/blobaugh' );
   set_transient( 'blobaugh_github_userinfo', $response, 60*60 );
}

速记句：数据缓存用 transient​，提高性能很关键。

10. 发送自定义 HTTP 请求

当需要使用自定义 HTTP 方法时，可以使用 wp_remote_request()​函数。比如，发送一个 DELETE 请求：

$args = array(
   'method' => 'DELETE'
);
$response = wp_remote_request( 'http://some-api.com/object/to/delete', $args );

速记句：自定义方法用 wp_remote_request()​来实现。

总结

通过 WordPress 的 HTTP API，我们可以方便地与外部服务进行数据交换。无论是发送 GET、POST 请求，还是处理响应、缓存数据，HTTP API 都提供了丰富的工具来支持开发者的需求。在实际开发中，合理使用这些工具可以大大提高插件的功能性和性能。

参考文献

1. WordPress 插件开发教程手册 — HTTP API - WordPress 智库
2. WordPress Codex: HTTP API