WP API自定义路由：如何将查询参数式URL改为RESTful风格路径？

不用折腾服务器的URL重写规则，WordPress REST API本身就支持路径参数的路由定义，这才是符合REST设计风格的标准实现方式。我来一步步给你讲怎么改：

1. 修改路由注册代码 #

原来你注册的路由应该是类似这样的（只处理查询参数）：

register_rest_route( 'service/v1', '/shopping', array(
    'methods' => WP_REST_Server::READABLE,
    'callback' => 'your_shopping_callback',
) );

现在要把product参数嵌入到URL路径里，只需要调整路由的路径部分，用正则捕获组来定义参数：

register_rest_route( 'service/v1', '/shopping/(?P<product>[a-zA-Z0-9-]+)', array(
    'methods' => WP_REST_Server::READABLE,
    'callback' => 'your_shopping_callback',
    // 可选：添加参数验证规则，让接口更健壮
    'args' => array(
        'product' => array(
            'required' => true,
            'validate_callback' => function( $value, $request, $key ) {
                // 这里可以自定义验证逻辑，比如检查产品是否存在
                return is_string( $value ) && strlen( $value ) > 0;
            },
        ),
    ),
) );

这里的(?P<product>[a-zA-Z0-9-]+)是关键：

• (?P<product> 表示给捕获的参数命名为product
• [a-zA-Z0-9-]+ 是正则规则，限制产品名称只能包含字母、数字和连字符，你可以根据实际需求调整（比如允许下划线就改成[a-zA-Z0-9-_]+）

2. 调整回调函数的参数获取方式 #

原来你可能是通过$request->get_query_param('product')或者$_GET['product']获取参数，现在只需要用$request->get_param('product')就能拿到路径里的参数——WordPress会自动帮你解析路径参数，不用额外处理：

function your_shopping_callback( WP_REST_Request $request ) {
    $product_slug = $request->get_param( 'product' );
    
    // 这里写你的业务逻辑，比如根据产品slug查询数据
    $product_data = get_your_product_data( $product_slug );
    
    if ( $product_data ) {
        return rest_ensure_response( $product_data );
    }
    
    // 返回404错误，如果产品不存在
    return new WP_Error( 'product_not_found', 'Requested product does not exist', array( 'status' => 404 ) );
}

3. 别忘了刷新固定链接 #

最后一步很容易忽略：登录WordPress后台，进入设置 → 固定链接，随便选择一个固定链接结构（比如“文章名”）然后点击保存。这会刷新WordPress的重写规则，确保新的REST路由能被正确识别。

为什么不推荐.htaccess重写？ #

用WordPress原生的路由注册方式有几个明显优势：

• 逻辑集中在代码里，更容易维护和调试
• 自带参数验证、权限控制等功能，比硬写重写规则更安全
• 符合REST API的设计规范，和WordPress的生态兼容更好

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