如何让WordPress中redirect_canonical函数修改不受更新影响

嘿，我明白你现在的困扰——改了WordPress核心的wp_includes/canonical.php文件解决了IIS URL重写后的首页重定向循环问题，但又怕下次WordPress版本更新把你的修改冲掉，毕竟核心文件每次更新都会被替换。别担心，下面这几个方法能让你的修改持久生效，完全不用碰核心文件：

1. 用pre_redirect_canonical过滤器接管逻辑 #

WordPress自带了pre_redirect_canonical这个过滤器钩子，它允许我们在核心的redirect_canonical函数执行前，先运行自己的逻辑，甚至直接跳过核心函数的处理。这是最推荐的方式，步骤如下：

• 如果你用了子主题（强烈建议用子主题，避免主题更新覆盖代码），打开子主题的functions.php文件；或者用「Code Snippets」这类代码片段插件（不用改主题文件更方便），添加下面的代码：

add_filter( 'pre_redirect_canonical', 'custom_fix_redirect_canonical', 10, 2 );
function custom_fix_redirect_canonical( $redirect_url, $requested_url ) {
    // 这里放入你修改后的核心函数逻辑
    if ( ! $requested_url && isset( $_SERVER['HTTP_HOST'] ) ) {
        // 构建地址栏中的URL
        $requested_url = is_ssl() ? 'https://' : 'http://';
        // 你原代码里的$sURL应该是笔误，这里改成获取当前完整请求URL
        $current_full_url = ( is_ssl() ? 'https://' : 'http://' ) . $_SERVER['HTTP_HOST'] . $_SERVER['REQUEST_URI'];
        $url_parts = parse_url( $current_full_url );
        $requested_url .= $url_parts['host'];
        $requested_url .= $_SERVER['REQUEST_URI'];
    }

    // 针对首页请求，直接返回false避免重定向循环
    if ( is_front_page() ) {
        return false;
    }

    // 其他请求可以根据需要返回处理后的URL，或者让原函数继续执行（去掉return即可）
    return $requested_url;
}

这样一来，你的自定义逻辑会优先于核心函数执行，完全不用担心更新覆盖的问题。

2. 写个极简自定义插件 #

如果你不想依赖主题文件，或者经常切换主题，可以自己写一个超简单的插件，把逻辑封装进去：

1. 打开WordPress的wp-content/plugins/目录，新建一个文件夹，比如custom-canonical-redirect-fix
2. 在这个文件夹里新建一个PHP文件，比如custom-canonical-fix.php
3. 把下面的代码粘贴进去：

<?php
/**
 * Plugin Name: Custom Canonical Redirect Fix
 * Description: Fixes homepage redirect loop caused by IIS URL Rewrite
 * Version: 1.0
 * Author: Your Name
 */

add_filter( 'pre_redirect_canonical', 'custom_fix_redirect_canonical', 10, 2 );
function custom_fix_redirect_canonical( $redirect_url, $requested_url ) {
    if ( ! $requested_url && isset( $_SERVER['HTTP_HOST'] ) ) {
        $requested_url = is_ssl() ? 'https://' : 'http://';
        $current_full_url = ( is_ssl() ? 'https://' : 'http://' ) . $_SERVER['HTTP_HOST'] . $_SERVER['REQUEST_URI'];
        $url_parts = parse_url( $current_full_url );
        $requested_url .= $url_parts['host'];
        $requested_url .= $_SERVER['REQUEST_URI'];
    }

    if ( is_front_page() ) {
        return false;
    }

    return $requested_url;
}

4. 保存文件后，登录WordPress后台，在「插件」列表里找到这个插件并激活就行。

这个插件完全独立，不管你更新WordPress核心还是切换主题，逻辑都不会受影响。

3. 重要提醒 #

• 永远不要直接修改WordPress核心文件：每次版本更新都会替换wp_includes里的文件，你的修改肯定会被覆盖，还可能引发兼容性问题。
• 用子主题而非父主题的functions.php：父主题更新时会覆盖自己的functions.php，子主题则不会。
• 测试验证：修改后一定要测试首页、文章页、分类页的访问情况，确保没有重定向循环，同时其他页面的 canonical 功能正常工作。

内容的提问来源于stack exchange，提问作者Vlado Pandžić