如何为WordPress单个插件生成的页面单独添加.php后缀

架构老林

2026-10-4

解决方案

你可以通过组合使用WordPress重写规则、永久链接过滤钩子实现单个页面自定义.php后缀，不会影响其他页面的链接结构，具体实现步骤如下：

步骤1：添加自定义重写规则

将以下代码添加到你当前主题的functions.php文件，或者你的自定义插件的代码文件中：

// 添加单个页面的.php重写规则
function custom_single_page_php_rewrite_rule() {
    // 替换成你目标页面的slug，示例为myfile
    $target_slug = 'myfile';
    add_rewrite_rule(
        '^' . $target_slug . '\.php$',
        'index.php?pagename=' . $target_slug,
        'top'
    );
}
add_action('init', 'custom_single_page_php_rewrite_rule');

// 允许WordPress识别.php后缀的查询
function custom_allow_php_suffix_in_query($vars) {
    if (isset($_SERVER['REQUEST_URI']) && preg_match('/\/myfile\.php$/', $_SERVER['REQUEST_URI'])) {
        $vars['pagename'] = 'myfile';
    }
    return $vars;
}
add_filter('request', 'custom_allow_php_suffix_in_query');

步骤2：过滤目标页面的永久链接输出

添加以下代码，让WordPress生成该页面的链接时自动带上.php后缀，不需要手动修改页面固定链接，也不会出现点号被转成-php的问题：

function custom_append_php_to_single_page_link($permalink, $post) {
    // 替换成你目标页面的slug，也可以用$post->ID == 你的页面ID来判断
    if ($post->post_type == 'page' && $post->post_name == 'myfile') {
        $permalink = rtrim($permalink, '/') . '.php';
    }
    return $permalink;
}
add_filter('post_type_link', 'custom_append_php_to_single_page_link', 10, 2);
add_filter('page_link', 'custom_append_php_to_single_page_link', 10, 2);