如何使用 WordPress 的 wp_remote_get() 实现 API 数据抓取与展示

在现代网站开发中，很多功能都需要从外部源获取数据并展示在网站上。WordPress 提供了一个非常方便的工具 wp_remote_get() 来处理外部 API 的请求。今天，我们将探讨如何利用 wp_remote_get() 获取 API 数据，并在 WordPress 页面中动态展示这些数据。

为什么要使用 `wp_remote_get()`？

WordPress 自带了很多功能来与外部 API 进行交互，而 wp_remote_get() 是其中最常用的一种。它提供了简单的方式来发送 HTTP 请求，并且能够处理响应数据。

在常见的应用场景中，你可能需要从外部 API 获取：

新闻、天气等实时数据
第三方服务的内容，如社交媒体更新
从其他网站获取产品信息并展示

通过 wp_remote_get()，你可以轻松获取并解析这些数据，将其呈现到 WordPress 页面中。

使用 `wp_remote_get()` 获取 API 数据

基本语法

$response = wp_remote_get( $url, $args );

$url：目标 API 的 URL 地址。
$args：请求的参数（可选），例如设置超时、指定请求头等。

wp_remote_get() 返回一个响应对象，其中包含 HTTP 响应的主体、状态码和头部信息。如果请求成功，数据将包含在 body 属性中。

示例 1：获取 JSON 数据

假设我们从一个开放的 API 获取最新的新闻数据，并将其展示在网站上。

function fetch_news() {
    $response = wp_remote_get( 'https://api.example.com/latest-news' );

    if ( is_wp_error( $response ) ) {
        return '无法获取数据';
    }

    // 获取响应内容
    $data = wp_remote_retrieve_body( $response );

    // 将 JSON 转换为 PHP 数组
    $news = json_decode( $data, true );

    // 检查数据是否有效
    if ( empty( $news ) ) {
        return '没有新闻内容';
    }

    // 输出新闻内容
    $output = '<ul>';
    foreach ( $news as $item ) {
        $output .= '<li><a href="' . esc_url( $item['url'] ) . '">' . esc_html( $item['title'] ) . '</a></li>';
    }
    $output .= '</ul>';

    return $output;
}

解释

使用 wp_remote_get() 发送 GET 请求。
通过 wp_remote_retrieve_body() 获取响应内容。
使用 json_decode() 将 JSON 数据转换为 PHP 数组。
处理数据后，生成 HTML 输出并返回。

展示 API 数据

在 WordPress 页面中调用

我们可以创建一个自定义的短代码来展示这些新闻数据。通过短代码，你可以将其插入到任何页面或文章中。

function display_latest_news() {
    return fetch_news();
}
add_shortcode( 'latest_news', 'display_latest_news' );

然后，在页面编辑器中插入 [latest_news]，它会自动展示从 API 获取的新闻内容。

处理 API 响应错误

虽然 wp_remote_get() 非常强大，但它也可能会返回错误或超时，导致请求失败。为了更好地处理这些情况，可以使用 is_wp_error() 函数检查是否存在错误。

$response = wp_remote_get( 'https://api.example.com/data' );

if ( is_wp_error( $response ) ) {
    $error_message = $response->get_error_message();
    return '请求失败：' . $error_message;
}

这样可以帮助你提供更友好的错误信息，避免用户看到空白页面。

设置请求参数

你还可以向 wp_remote_get() 传递额外的参数，例如设置请求头、超时等。比如，发送一个带有自定义请求头的 GET 请求：

$response = wp_remote_get( 'https://api.example.com/data', array(
    'headers' => array(
        'Authorization' => 'Bearer your_api_token',
    ),
    'timeout' => 15, // 设置请求超时为15秒
) );

这对于需要认证的 API 或需要特定请求配置的场景非常有用。