啊哈！各位观众老爷们，今天咱们就来扒一扒 WordPress 里的“红娘”—— wp_redirect() 函数。 这家伙看似简单，实则暗藏玄机，它能神不知鬼不觉地把你从一个页面“嗖”的一下转移到另一个页面，而这背后的功臣，就是那些看似枯燥的 HTTP 状态码。
准备好了吗？咱们这就开始一场刺激的源码探险之旅！
第一幕：初识 wp_redirect()
首先，我们先来认识一下这位“红娘”长什么样：
function wp_redirect( $location, $status = 302, $x_redirect_by = 'WordPress' ) {
$location = wp_sanitize_redirect( $location ); // 安全第一！
$status = apply_filters( 'wp_redirect_status', $status, $location );
if ( wp_redirecting() ) { // 已经重定向过了？别瞎折腾！
return false;
}
$location = apply_filters( 'wp_redirect', $location, $status );
if ( ! $location ) {
return false;
}
wp_set_location( $location ); // 记录一下，省得以后再用
status_header( $status ); // 关键一步！设置 HTTP 状态码
if ( $x_redirect_by ) {
header( 'X-Redirect-By: ' . $x_redirect_by ); // 偷偷告诉别人，我是被 WordPress 重定向的
}
header( 'Location: ' . $location, true ); // 设置 Location Header，告诉浏览器往哪儿去
return true;
}怎么样，是不是感觉似曾相识？ 别慌，咱们一点点拆解。
$location: 这是你要重定向去的目的地，也就是“红娘”要牵线的对象。$status: 这就是重点了！ 它决定了重定向的方式，比如“永久搬家”还是“临时串门”。默认值是302，表示“临时重定向”。$x_redirect_by: 这个参数嘛，就是偷偷告诉浏览器，是谁把你重定向过来的，默认为'WordPress'。你可以改成'我爱WordPress'，或者'神秘力量'，随你喜欢！
第二幕：安全检查与过滤
wp_redirect() 函数可不是随随便便就给人牵线的，它首先要确保安全。
$location = wp_sanitize_redirect( $location );wp_sanitize_redirect() 函数会检查 $location 是否安全，防止有人利用重定向漏洞搞破坏。 它会过滤掉一些危险的字符，比如换行符、回车符等等。总之，就是确保 $location 是一个合法的 URL。
接下来，还有一道过滤：
$status = apply_filters( 'wp_redirect_status', $status, $location );
$location = apply_filters( 'wp_redirect', $location, $status );apply_filters() 函数允许插件或主题修改重定向的状态码和 URL。 你可以用它来实现一些高级功能，比如根据用户的角色来决定重定向到不同的页面。
第三幕：HTTP 状态码大揭秘
重头戏来了！HTTP 状态码才是重定向的灵魂。 wp_redirect() 函数通过 status_header() 函数来设置状态码。
status_header( $status );status_header() 函数会根据 $status 的值，设置相应的 HTTP 响应头。 不同的状态码，浏览器会有不同的反应。
那么，常用的重定向状态码都有哪些呢？ 咱们来列个表格：
| 状态码 | 名称 | 含义 | 浏览器行为 | 搜索引擎行为 | 使用场景 |
|---|---|---|---|---|---|
301 |
永久重定向 | 告诉浏览器和搜索引擎，这个页面已经永久搬家了，以后请去新地址。 | 浏览器会自动跳转到新地址，并且会记住这个重定向，下次再访问旧地址时，会直接跳转到新地址，不会再请求服务器。 | 搜索引擎会将旧地址的权重转移到新地址，并且会用新地址替换旧地址。 | 网站域名变更、页面 URL 结构调整。 |
302 |
临时重定向 | 告诉浏览器和搜索引擎，这个页面只是临时搬家了，以后还可能会回来。 | 浏览器会自动跳转到新地址，但是不会记住这个重定向，下次再访问旧地址时，还会请求服务器。 | 搜索引擎会将旧地址和新地址都保留，并且不会将旧地址的权重转移到新地址。 | 网站维护、活动推广、A/B 测试。 |
307 |
临时重定向 (HTTP 1.1) | 与 302 类似，但是要求浏览器在重定向时使用相同的 HTTP 方法 (比如 GET 或 POST)。 |
浏览器会自动跳转到新地址，并且会使用相同的 HTTP 方法。 | 搜索引擎会将旧地址和新地址都保留，并且不会将旧地址的权重转移到新地址。 | 需要确保 HTTP 方法不变的临时重定向。 |
308 |
永久重定向 (HTTP 1.1) | 与 301 类似，但是要求浏览器在重定向时使用相同的 HTTP 方法。 |
浏览器会自动跳转到新地址，并且会使用相同的 HTTP 方法，并且会记住这个重定向。 | 搜索引擎会将旧地址的权重转移到新地址，并且会用新地址替换旧地址。 | 需要确保 HTTP 方法不变的永久重定向。 |
303 |
See Other | 告诉浏览器，重定向后的页面应该使用 GET 方法请求。 |
浏览器会自动跳转到新地址，并且会使用 GET 方法请求。 |
搜索引擎会将旧地址和新地址都保留，并且不会将旧地址的权重转移到新地址。 | 在 POST 请求后，防止用户刷新页面导致重复提交。 |
敲黑板！划重点！
301是永久重定向，适用于网站域名变更、URL 结构调整等情况。302是临时重定向，适用于网站维护、活动推广等情况。307和308都是 HTTP 1.1 引入的，它们要求浏览器在重定向时使用相同的 HTTP 方法。303用于在POST请求后，防止用户刷新页面导致重复提交。
第四幕：设置 Location Header
设置完状态码，接下来就是告诉浏览器往哪儿去了：
header( 'Location: ' . $location, true );header() 函数用于设置 HTTP 响应头。 在这里，我们设置了 Location 头，它的值就是 $location，也就是我们要重定向去的地址。
true 参数表示强制替换之前的 Location 头。
第五幕：wp_redirecting() 函数
if ( wp_redirecting() ) {
return false;
}wp_redirecting() 函数用于检查是否已经发送了重定向头。 如果已经发送了，就直接返回 false，防止重复重定向。
它的源码大概是这样的：
function wp_redirecting() {
static $is_redirecting = false;
if ( headers_sent() ) {
$is_redirecting = true;
}
return $is_redirecting;
}第六幕：一个完整的例子
现在，咱们来用一个例子，把上面讲的串起来：
<?php
// 假设用户未登录
if ( ! is_user_logged_in() ) {
// 重定向到登录页面
wp_redirect( wp_login_url(), 302 );
exit;
}
// 用户已登录，显示欢迎信息
echo '<h1>欢迎回来！</h1>';
?>这段代码会检查用户是否登录。 如果用户未登录，就重定向到登录页面。 状态码是 302，表示临时重定向。
第七幕：深入 status_header() 函数
咱们再来看看 status_header() 函数的内部：
function status_header( $header, $description = '' ) {
if ( is_numeric( $header ) ) {
$status = absint( $header );
} else {
return;
}
$status_header_str = "$_SERVER[SERVER_PROTOCOL] $status $description";
if ( empty( $description ) ) {
$description = get_status_header_desc( $status );
$status_header_str = "$_SERVER[SERVER_PROTOCOL] $status $description";
}
header( $status_header_str, true );
}这个函数接收一个状态码 $header 和一个描述 $description。 如果 $description 为空，它会调用 get_status_header_desc() 函数来获取状态码的描述。
get_status_header_desc() 函数返回状态码的描述信息，比如 302 对应的描述是 Found。
第八幕：wp_safe_redirect() 函数
WordPress 还有一个 wp_safe_redirect() 函数，它比 wp_redirect() 函数更安全。
function wp_safe_redirect( $location, $status = 302 ) {
$location = wp_sanitize_redirect( $location ); // 安全第一！
if ( ! wp_is_internal_url( $location ) ) { // 检查是否是内部 URL
$location = home_url(); // 如果不是，就重定向到首页
}
return wp_redirect( $location, $status );
}wp_safe_redirect() 函数会先检查 $location 是否是内部 URL。 如果不是，就重定向到首页，防止用户被重定向到恶意网站。
第九幕：总结与思考
好了，今天的源码探险之旅就到这里了。 我们一起深入了解了 wp_redirect() 函数的内部机制，以及 HTTP 状态码在重定向中的作用。
希望通过今天的学习，你能够更加灵活地使用 wp_redirect() 函数，并且能够理解不同状态码的含义，从而更好地控制网站的重定向行为。
最后，留几个思考题给大家：
- 为什么
301重定向对 SEO 更有利？ - 在什么情况下应该使用
307或308重定向？ - 如何使用
apply_filters()函数来修改wp_redirect()函数的行为？
希望大家能够积极思考，共同进步！ 下次有机会，我们再一起探索 WordPress 的其他奥秘！
咱们下回再见！