add rewrite rule 描述

add_rewrite_rule() 允许我们为 WordPress 添加自定义重写规则，该函数通常和 add_rewrite_tag() （允许我们添加 WordPress 可以识别的自定义查询参数）配合使用。

add rewrite rule 使用

add_rewrite_rule($regex, $redirect, $after);

add rewrite rule 参数

$regex

(string) (必需) 一个匹配请求 URL 的正则表达式，可是使用一个或多个正则表达式组。
默认：None

$redirect

(string) (必需)：真正需要获取的 URL， ($regex 匹配时).。我们可以使用 $matches[] 数组在这里插入捕获获的匹配组。
默认: None

$after

(string) (可选)：这可以是 ‘top’ 或 ‘bottom’.。’top’ 将在 WordPress 现有的规则之前优先处理， ‘bottom’ 将在其他规则之后处理。
默认: “bottom”

add rewrite rule 使用示例

基本使用方法

首先，我们可以很方便的获取某个页面的 ID，使用正则表达式匹配页面 ID，我们就可以自定义这个页面的访问 URL 了。

add_action('init', function ()
{
    add_rewrite_rule('^leaf/([0-9]+)/?', 'index.php?page_id=$matches[1]', 'top');
});

现在，我们可以通过下面的自定义 URL 访问同一个页面了。

http://example.com/leaf/95

在自定义模板中使用查询字符串

让我们假设你正在创建一个用来展示营养信息的页面 “Nutrition”。此页面使用了一个自定义模板，并且有两个参数，食物和品种。在主题目录中创建一个名为 my-custom-template.php 的文件，文件内容如下：

<?php
/**
* Template Name: Nutritional Information
*/
get_header();

global $wp_query;
echo 'Food : ' . $wp_query->query_vars['food'];
echo '<br />';
echo 'Variety : ' . $wp_query->query_vars['variety'];
// ... more ...
get_footer();
?>

使用上面的模版创建一个页面， 记下这个新页面的 ID，然后使用 add_rewrite_tag() 让 WordPress 可以识别自定义查询变量 「food」 和 「variety」,示例代码如下:

add_action('init', function ()
{
    add_rewrite_tag('%food%', '([^&]+)');
    add_rewrite_tag('%variety%', '([^&]+)');
}, 10, 0);

我们访问以下页面的时候, 这个页面将通过查询字符串传递过来两个自定义参数。

http://example.com/index.php?page_id=12&food=milkshake&variety=strawberry

现在我们可以创建自定义规则来重写上面的查询字符串为静态化的 URL 了，添加下面的代码到主题或插件中，替换其中的 12 为我们上面创建的自定义页面的 ID。创建完成后，不要忘了重新保存以下固定链接设置，以便让新的自定义重写规则生效。

add_action('init', function ()
{
    add_rewrite_rule('^nutrition/([^/]*)/([^/]*)/?', 'index.php?page_id=12&food=$matches[1]&variety=$matches[2]', 'top');
}, 10, 0);

重新保存了固定链接设置后，我们就可以通过 URL http://example.com/nutrition/milkshakes/strawberry/ 来访问我们重写后的自定义页面了。

从上面的代码中可以看出来，添加自定义 URL 规则还是很麻烦的，如果我们需要添加比较多的自定义 URL，可以使用 WordPress Dispatcher 自定义路由库来简化这个工作。