WordPress页面PHP片段如何接管所有子目录路径请求

不需要修改任何Web服务器（Nginx/Apache）配置，通过WordPress自带的钩子即可实现，两种实现方式选其一即可：

方法1：parse_request 钩子拦截（推荐，稳定性最高） #

该钩子触发于WordPress路由解析的早期节点，直接修改查询参数即可绕开默认的404判定，让所有匹配/abc/**规则的请求直接加载目标页面，不会改变浏览器地址栏显示的路径。
将以下代码放入当前主题的functions.php文件，或自定义功能插件中即可生效：

// 兼容WordPress 5.9以下版本缺失str_starts_with函数的问题
if (!function_exists('str_starts_with')) {
    function str_starts_with($haystack, $needle) {
        return strncmp($haystack, $needle, strlen($needle)) === 0;
    }
}

add_action('parse_request', function($wp) {
    // 替换为你实际挂载代码的页面slug，此处对应路径/abc
    $base_slug = 'abc';
    $current_path = trim($wp->request, '/');

    // 匹配所有以$base_slug开头的路径，包括根路径/abc和所有子层级路径
    if (str_starts_with($current_path, $base_slug)) {
        // 直接指定加载目标页面
        $wp->query_vars = [
            'pagename' => $base_slug,
            // 把子路径段存入查询变量，业务代码中可直接调用
            'sub_path' => trim(substr($current_path, strlen($base_slug)), '/')
        ];
        return;
    }
});

代码生效后，你挂载在/abc页面的PHP代码可以通过get_query_var('sub_path')获取当前访问的子路径内容，例如访问wp-example.com/abc/def/ghi时，该函数返回值为def/ghi，可直接用于业务逻辑的路由分发。

方法2：template_redirect 钩子兜底处理 #

如果不想修改主查询解析逻辑，可在404触发节点判断路径匹配规则，手动重置查询状态加载目标页面：

// 兼容低版本WordPress
if (!function_exists('str_starts_with')) {
    function str_starts_with($haystack, $needle) {
        return strncmp($haystack, $needle, strlen($needle)) === 0;
    }
}

add_action('template_redirect', function() {
    $base_slug = 'abc';
    $current_path = trim(parse_url($_SERVER['REQUEST_URI'], PHP_URL_PATH), '/');

    // 仅处理/abc下的子路径404请求，根路径/abc本身走默认逻辑
    if (str_starts_with($current_path, $base_slug . '/') && is_404()) {
        global $wp_query;
        // 重置404状态
        $wp_query->is_404 = false;
        $wp_query->is_page = true;

        $target_page = get_page_by_path($base_slug);
        if ($target_page) {
            $wp_query->queried_object = $target_page;
            $wp_query->queried_object_id = $target_page->ID;
            $wp_query->set('sub_path', trim(substr($current_path, strlen($base_slug)), '/'));
            // 加载目标页面的模板文件，兼容自定义页面模板
            include(get_page_template());
            exit;
        }
    }
});

注意事项 #

• 两套代码不要同时启用，避免逻辑冲突。
• 如果代码添加后仍出现404，进入WordPress后台「设置-固定链接」页面，直接点击「保存更改」按钮刷新路由重写缓存即可，无需修改任何配置。
• 所有匹配请求的响应状态码默认为200，不会影响SEO表现。

内容的提问来源于stack exchange，提问作者João Pimentel Ferreira