剖析 WordPress `wp_redirect()` 函数的源码：它如何通过 `HTTP` 头信息进行重定向。 - 智猿学院-前后端，数据库，人工智能，云计算等领域前沿技术讲座

各位观众老爷，大家好！今天咱们来聊聊WordPress里一个很实用，但又容易被忽略的函数：wp_redirect()。别看它名字简单，背后可藏着不少学问呢。咱们今天就把它扒个精光，看看它到底是怎么通过HTTP头信息实现页面跳转的。

开场白：重定向的重要性

想象一下，你兴高采烈地访问一个网站，结果发现页面没了，或者网址变了。这时候，如果网站直接给你来个“404 Not Found”，估计你心里会骂娘。但如果网站能聪明地把你自动带到新的页面，是不是感觉好多了？这就是重定向的魅力所在。它可以提升用户体验，维护链接的有效性，甚至优化SEO。

wp_redirect()：WordPress的重定向利器

在WordPress中，wp_redirect() 就是实现重定向的工具。它的作用很简单：告诉浏览器，乖，别看这里了，赶紧去另一个地方。它本质上就是设置一个特定的HTTP响应头，让浏览器自动跳转。

源码剖析：wp_redirect() 的真面目

让我们深入 wp-includes/functions.php 文件，找到 wp_redirect() 的源码，看看它到底长啥样。

function wp_redirect( $location, $status = 302 ) {
    global $is_IIS;

    $location = wp_sanitize_redirect( $location );

    /**
     * Filters the redirect location.
     *
     * @since 2.1.0
     *
     * @param string $location The path to redirect to.
     * @param int    $status   The HTTP response status code.
     */
    $location = apply_filters( 'wp_redirect', $location, $status );

    /**
     * Filters the HTTP response status code for the redirect.
     *
     * @since 3.0.0
     *
     * @param int    $status   The HTTP response status code.
     * @param string $location The path to redirect to.
     */
    $status = apply_filters( 'wp_redirect_status', $status, $location );

    if ( ! $location ) {
        return false;
    }

    $status = absint( $status );
    if ( $status < 300 || $status > 399 ) {
        $status = 302;
    }

    if ( isset( $_SERVER['SERVER_PROTOCOL'] ) ) {
        $protocol = $_SERVER['SERVER_PROTOCOL'];
    } else {
        $protocol = 'HTTP/1.0';
    }

    $location = wp_get_location_header( $location );

    /**
     * Fires before the HTTP redirect is sent.
     *
     * @since 2.1.0
     *
     * @param string $location The path to redirect to.
     * @param int    $status   The HTTP response status code.
     */
    do_action( 'wp_redirect_header', $location, $status );

    if ( wp_doing_ajax() ) {
        /**
         * Fires before the HTTP redirect is sent, but only for AJAX requests.
         *
         * @since 4.4.0
         *
         * @param string $location The path to redirect to.
         * @param int    $status   The HTTP response status code.
         */
        do_action( 'wp_redirect_header_ajax', $location, $status );
    }

    if ( headers_sent() ) {
        return false;
    }

    header( "Location: $location", true, $status );

    if ( $is_IIS && function_exists( 'iis_redirect' ) ) {
        iis_redirect( $location, $status, false );
        exit;
    }

    exit;
}

是不是有点眼花缭乱？别怕，咱们一步步拆解。

参数解析

wp_redirect() 接收两个参数：

$location：这是必须的，指定你要跳转到的URL。可以是绝对路径 (例如: https://example.com/new-page)，也可以是相对路径 (例如: /new-page)。
$status：可选参数，指定HTTP状态码。默认是 302 (临时重定向)。常用的还有 301 (永久重定向)。

代码流程

清理URL (wp_sanitize_redirect): 首先，wp_sanitize_redirect() 会清理 $location，确保URL安全，防止重定向漏洞。
过滤器 (apply_filters): apply_filters( 'wp_redirect', $location, $status ) 和 apply_filters( 'wp_redirect_status', $status, $location ) 允许开发者通过钩子修改重定向的URL和状态码。这提供了极大的灵活性。
验证状态码: 代码会检查 $status 的值，确保它是一个有效的HTTP重定向状态码 (300-399)。如果不是，就默认设置为 302。

获取 Location Header (wp_get_location_header):

function wp_get_location_header( $location ) {
/**
 * Filters the location URI of the redirect header.
 *
 * @since 5.1.0
 *
 * @param string $location The path to redirect to.
 */
return apply_filters( 'wp_location_url', $location );
}

动作 (do_action): do_action( 'wp_redirect_header', $location, $status ) 和 do_action( 'wp_redirect_header_ajax', $location, $status ) 触发一些动作，允许其他插件或主题在重定向发生前执行一些操作。 AJAX请求会触发 wp_redirect_header_ajax 这个action。
检查Headers是否已经发送 (headers_sent): 这是非常重要的一步。 headers_sent() 函数检查HTTP头是否已经发送到浏览器。如果已经发送，就不能再发送新的头信息了。否则，会引发一个 "Headers already sent" 的PHP错误。如果头已经发送，wp_redirect() 将返回 false，重定向失败。
发送HTTP头 (header): 核心来了！ header( "Location: $location", true, $status ) 这行代码就是发送HTTP头信息，告诉浏览器进行重定向。 "Location: $location" 设置 Location 头，指定目标URL。 true 参数表示替换之前的 Location 头（如果存在）。 $status 参数设置HTTP状态码。
IIS兼容性: 如果运行在IIS服务器上，并且定义了 iis_redirect 函数，则调用它进行重定向。
终止脚本执行 (exit): exit 语句确保在发送重定向头后，停止执行后续的代码。这是必须的，否则服务器可能会继续处理请求，导致不可预料的结果。

HTTP头信息：重定向的幕后功臣

wp_redirect() 的关键在于 header() 函数，它负责发送HTTP头信息。 HTTP头信息是服务器和浏览器之间沟通的桥梁。 Location 头就是告诉浏览器要跳转到哪个URL。

一个典型的重定向HTTP响应头看起来像这样：

HTTP/1.1 302 Found
Date: Tue, 23 Apr 2024 08:00:00 GMT
Server: Apache/2.4.41 (Ubuntu)
Location: https://example.com/new-page
Content-Type: text/html; charset=UTF-8

其中，Location: https://example.com/new-page 就是告诉浏览器，赶紧去这个URL。

HTTP状态码：重定向的类型

$status 参数决定了重定向的类型。常用的状态码有：

状态码	含义	浏览器行为	SEO影响
301	永久重定向。表示资源已经永久移动到新的URL。	浏览器会缓存这个重定向，下次访问旧URL时，直接跳转到新URL，不再向服务器请求。	传递权重：搜索引擎会将旧URL的权重转移到新URL。对SEO友好，适用于网站永久迁移。
302	临时重定向。表示资源只是临时移动到新的URL。	浏览器不会缓存这个重定向，每次访问旧URL时，都会向服务器请求，服务器再返回重定向信息。	不传递权重：搜索引擎认为旧URL和新URL是两个独立的页面，不会转移权重。适用于临时维护、A/B测试等场景。
307	临时重定向，要求使用与原始请求相同的方法。 (例如: 如果原始请求是POST，则重定向后的请求也必须是POST)。	类似于302，但更严格，要求保持请求方法不变。	类似于302，不传递权重。
308	永久重定向，要求使用与原始请求相同的方法。 (例如: 如果原始请求是POST，则重定向后的请求也必须是POST)。	类似于301，但更严格，要求保持请求方法不变。	传递权重：类似于301，搜索引擎会将旧URL的权重转移到新URL。对SEO友好，适用于网站永久迁移，并且需要保持请求方法不变的场景。

使用示例

// 重定向到首页
wp_redirect( home_url() );
exit;

// 重定向到指定页面，使用301永久重定向
wp_redirect( 'https://example.com/new-page', 301 );
exit;

// 重定向到当前页面的HTTPS版本
if ( ! is_ssl() ) {
    wp_redirect( 'https://' . $_SERVER['HTTP_HOST'] . $_SERVER['REQUEST_URI'], 301 );
    exit;
}

注意事项

exit 的重要性: 在调用 wp_redirect() 之后，一定要调用 exit 语句，否则服务器可能会继续执行后续的代码，导致不可预料的结果。
Headers before content: 必须在任何内容输出之前调用 wp_redirect()。如果内容已经输出，HTTP头信息就无法再发送了，会导致 "Headers already sent" 的错误。
插件冲突: 有些插件可能会干扰 wp_redirect() 的工作，导致重定向失败。如果遇到问题，可以尝试禁用插件，逐个排查。
AJAX请求的重定向：wp_redirect() 在AJAX请求中也能工作，但行为略有不同。它不会直接让浏览器跳转，而是将 Location 头信息返回给前端。前端JS代码需要监听这个头信息，并手动进行页面跳转。

高级用法：利用过滤器自定义重定向

wp_redirect() 提供了 wp_redirect 和 wp_redirect_status 两个过滤器，允许开发者自定义重定向的行为。

// 示例：根据用户角色重定向到不同的页面
add_filter( 'wp_redirect', 'my_custom_redirect', 10, 2 );

function my_custom_redirect( $location, $status ) {
    if ( is_user_logged_in() ) {
        $user = wp_get_current_user();
        if ( in_array( 'administrator', (array) $user->roles ) ) {
            return admin_url(); // 管理员跳转到后台
        } else {
            return home_url( '/member-area' ); // 其他用户跳转到会员区
        }
    }
    return $location; // 未登录用户保持原URL
}

总结

wp_redirect() 是WordPress中一个简单而强大的重定向函数。它通过设置HTTP头信息，告诉浏览器进行页面跳转。理解它的工作原理，可以帮助你更好地控制网站的跳转行为，提升用户体验，优化SEO。记住，关键在于理解HTTP头信息，特别是 Location 头和HTTP状态码的含义。同时，要注意 exit 语句的使用，以及在内容输出之前调用 wp_redirect()。

希望今天的讲座对大家有所帮助！以后在使用 wp_redirect() 的时候，心里更有底了吧？祝大家编程愉快！

发表回复 取消回复

发表回复取消回复