php - WordPress 将自定义 url 映射到一个函数

Question

我正在尝试向基于 WordPress 的网站添加自定义 URL 结构。

例如:

example.com/machines             //list all machines in a table

example.com/machines?some=params //list filtered machines in a table

example.com/machines/1           //show single machine

数据将来 self 已经通过 curl 开发的外部 api。

我无法将数据导入自定义帖子类型，因为它已在许多表上进行了规范化，业务逻辑很复杂，而且 api 无论如何都被其他设备使用。

我查看了 add_rewrite_rule 的文档，但是第二个参数让我难住了:

$redirect
(string) (required) The URL you would like to actually fetch

好吧，我没有要获取的 url，我想运行一个函数，它将充当一个简单的路由器 - 获取 url 部分，调用外部 api 并返回一个包含正确数据的模板。

调用 API 很简单，但我如何将 url 实际路由到函数，以及我如何加载模板(利用现有的 WordPress header.php 和 footer.php)让我感到困惑。

Answer 1

经过大量谷歌搜索和阅读一些内容后 good resources ，我找到了解决方案。

第 1 步:使用 add_rewrite_endpoint 创建将映射到查询变量的基本 url:

add_action( 'init', function(){
    add_rewrite_endpoint( 'machines', EP_ROOT );
} );

第 2 步:访问永久链接设置页面并单击“保存更改”以刷新重写规则。

第 3 步: 挂接到操作 'template_redirect' 以在点击 url 时实际执行某些操作:

add_action( 'template_redirect', function() {
    if ( $machinesUrl = get_query_var( 'machines' ) ) {
        // var_dump($machinesUrl, $_GET);
        // $machinesURl contains the url part after example.com/machines
        // e.g. if url is example.com/machines/some/thing/else
        // then $machinesUrl == 'some/thing/else'
        // and params can be retrieved via $_GET

        // after parsing url and calling api, it's just a matter of loading a template:
        locate_template( 'singe-machine.php', TRUE, TRUE );

        // then stop processing
        die();
    }
});

第 4 步:唯一要做的另一件事是处理对没有其他部分的 url 的点击，例如example.com/machines。事实证明，在 WordPress 内部的某个时刻，空字符串被评估为 false 并因此被跳过，因此最后一步是挂接到过滤器 'request' 并设置默认值:

add_filter( 'request', function( $vars = [] ) {
    if ( isset( $vars['machines'] ) && empty( $vars['machines'] ) ) {
        $vars['machines'] = 'default';
    }
    return $vars;
});

这可以很容易地通过将其全部包装在一个类中来改进。url 解析和模板加载逻辑可以传递给基本路由器，甚至是基本的 MVC 设置、从文件加载路由等，但以上是起点。