让代码更简单

register_rest_route函数为WP REST API注册自定义接口

重要:本文最后更新于2019-08-01 08:26:56,某些文章具有时效性,若有错误或已失效,请在下方留言或联系代码狗

WordPress为给其它程序提供数据,核心带了一套WP REST API接口,但是我们在应用中难免会出现官方接口满足不了我们需求的情况。为此WordPress也提供了register_rest_route函数用于注册WP REST API接口,方便我们在WP REST API基础上自定义接口。那么register_rest_route函数如何使用呢?我们注册的接口实例怎么实现呢?一起来学习下吧!

复制
register_rest_route( string $namespace, string $route, array $args = array(),bool $override = false )

参数:

$namespace

(string) (Required) /wp-json后的第一个段

$route

(string) (Required) 添加的路由规则

$args

(array) (Optional) 多个端点的处理方法,默认空数组

$override

(bool) (Optional) 如果路径已经存在,是否覆盖它?True重写,false合并(如果存在重复键,则使用更新的重写键)。默认false

注意:这个函数不能在rest_api_init钩子作用前使用!

注册自定义接口

首先打开一个能被WordPress加载的文件,如functions.php或者插件文件,这样其中的代码才会被WordPress执行。

复制
function dmd_rest_register_route()
{
register_rest_route('dmd/v1', 'postlist/(?P<paged>[\d]+)', [
'methods' => 'GET',
'callback' => 'dmd_rest_postlist_callback',
]);
}
add_action('rest_api_init', 'dmd_rest_register_route');
function dmd_rest_postlist_callback($request)
{
    $paged = $request->get_param('paged');
    return get_postlist($paged);
}
function get_postlist($paged)
{
    $args = array(
        'posts_per_page' => get_option('posts_per_page'),
        'ignore_sticky_posts' => false,
        'paged' => $paged,
    );
    $querynr = new WP_Query($args);
    $response = array();
    while ($querynr->have_posts()): $querynr->the_post();
        $post = array(
            "PostId" => get_the_ID(),
            "title" => get_the_title(),
            "category" => get_the_category()[0]->name,
            "desc" => get_exc(get_the_ID()),
            "date" => get_the_time('Y-m-d'),
        );
        array_push($response, $post);
    endwhile;
    wp_reset_postdata();
    return $response;
}

上面的代码中,我们通过register_rest_route函数注册了一个get请求接口,请求地址域名/wp-json/dmd/v1/postlist/1,其中postlist是路由方法,由它觉得是什么方法处理,后面的1是参数paged,这里写的正则匹配数字,也就是说只能接收数字型的参数。然后请求将交给dmd_rest_postlist_callback函数处理并返回数据给客户端。

在接收请求时,我们可以使用$request这个变量来得到请求参数,具体,自行打印查看,请求示例:

register_rest_route函数为WP REST API注册自定义接口

register_rest_route函数为WP REST API注册自定义接口

感觉很棒!可以赞赏支持我哟~

7 打赏

评论 (0)

登录后评论
QQ咨询 邮件咨询 狗哥推荐