自定义WordPress插件调用默认REST API的合理性及更佳方案咨询

嗨，我来帮你理清这个问题～首先直接通过HTTP调用WordPress默认REST API的方式可行但并不最优，核心问题在于：哪怕是本地请求，也会产生额外的HTTP请求开销（比如请求解析、响应处理、重复的权限验证），而且默认REST API端点本身还是会去查询数据库，所以这种方式根本没法避免重复查库的问题。

那要复用REST API的全部数据与功能，同时避免重复查库，最优的方案是直接调用WordPress REST API的底层核心类和函数，而不是绕HTTP请求的弯路。下面给你具体的实现思路和示例：

1. 直接使用REST控制器类 #

WordPress的REST API是基于各种控制器类实现的（比如文章的WP_REST_Posts_Controller、用户的WP_REST_Users_Controller），这些类已经封装了所有的数据查询、权限验证、格式化逻辑。你可以直接实例化这些控制器，调用对应的方法来获取和REST API返回完全一致的数据，而且只执行一次数据库查询。

举个获取公开文章的例子：

// 实例化文章REST控制器（参数为文章类型，比如page、自定义文章类型slug）
$posts_controller = new WP_REST_Posts_Controller('post');

// 模拟REST API的请求参数（比如分页、状态、分类等）
$request = new WP_REST_Request('GET', '/wp/v2/posts');
$request->set_query_params([
    'per_page' => 10,
    'status' => 'publish',
    'category' => 5
]);

// 调用控制器的get_items方法获取数据
$response = $posts_controller->get_items($request);

// 处理响应结果
if (!is_wp_error($response)) {
    $formatted_posts = $response->get_data();
    // 这里就可以用格式化好的数据去对接第三方API了
}

2. 复用数据格式化函数 #

如果你已经通过WordPress原生函数（比如get_posts()、get_userdata()）获取了原始数据，也可以直接用REST API的格式化函数把数据转换成和API返回一致的结构：

// 获取原始文章数据
$raw_posts = get_posts([
    'posts_per_page' => 10,
    'post_status' => 'publish'
]);

// 逐个格式化为REST API风格的数据
$formatted_posts = [];
foreach ($raw_posts as $post) {
    $formatted_posts[] = wp_prepare_post_for_rest($post, $request);
}

3. 扩展自定义REST端点（推荐） #

如果你的需求是定制API端点+对接第三方API，直接在自定义插件里注册新的REST路由，在回调里复用底层逻辑是最规范的做法。这样你既拥有自定义端点的灵活性，又能复用官方REST API的所有能力：

add_action('rest_api_init', function () {
    // 注册自定义路由
    register_rest_route(
        'my-plugin/v1', // 命名空间
        '/sync-posts', // 路由路径
        [
            'methods' => WP_REST_Server::CREATABLE, // 这里用POST方法触发同步
            'callback' => 'my_plugin_sync_posts_to_third_party',
            'permission_callback' => function () {
                // 在这里设置权限验证，比如只有管理员能调用
                return current_user_can('manage_options');
            }
        ]
    );
});

function my_plugin_sync_posts_to_third_party($request) {
    // 复用REST控制器获取格式化后的数据
    $posts_controller = new WP_REST_Posts_Controller('post');
    $api_response = $posts_controller->get_items($request);
    
    if (is_wp_error($api_response)) {
        return $api_response; // 直接返回错误信息
    }
    
    $posts_data = $api_response->get_data();
    
    // 对接第三方API的逻辑
    $third_party_response = wp_remote_post('https://third-party-api.com/receive-posts', [
        'body' => json_encode($posts_data),
        'headers' => ['Content-Type' => 'application/json'],
        'timeout' => 15
    ]);
    
    // 返回自定义响应
    return new WP_REST_Response([
        'synced_posts_count' => count($posts_data),
        'third_party_status' => wp_remote_retrieve_response_code($third_party_response)
    ], 200);
}

总结 #

• 直接HTTP调用默认REST API：可行但不推荐，会有额外性能开销，无法避免重复查库。
• 调用REST底层控制器/函数：最优解，完全复用官方逻辑，只查一次库，无HTTP开销。
• 注册自定义REST端点：最符合WordPress开发规范的方式，完美结合自定义需求与官方API能力。

内容的提问来源于stack exchange，提问作者ssakash