PHP 中如何实现重定向

技术背景

在 PHP 开发中，页面重定向是一种常见的需求，比如在用户登录成功或失败时、表单提交后等场景下，需要将用户导向其他页面。实现重定向的方法有多种，每种方法都有其适用场景和特点。

实现步骤

基本方法：使用header()函数

header()函数可以发送新的 HTTP 头信息，但必须在任何 HTML 或文本输出之前调用。以下是基本示例：

header('Location: '.$newURL);

注意事项及细节

1. 使用die()或exit()
   调用header()函数后，建议使用die()或exit()停止脚本的后续执行，确保浏览器能正确处理重定向。示例如下：

header("Location: https://example.com/myOtherPage.php");
die();

2. 绝对或相对 URL
   自 2014 年 6 月以来，相对和绝对 URL 都可以在Location头中使用。例如：
   • 绝对 URL：header('Location: https://example.com');
   • 相对 URL：header('Location: ./somepage.php');
3. 状态码
   PHP 的Location头默认使用 HTTP 302（临时重定向）状态码，可根据需要换成 301（永久重定向）或 303。示例如下：

header('Location: https://example.com', true, 301); // 永久重定向

替代方法

可以使用http_redirect($url);，但需要安装 PECL 包pecl_http。

辅助函数

以下是两个实用辅助函数：

function Redirect($url, $permanent = false)
{
    header('Location: ' . $url, true, $permanent ? 301 : 302);
    exit();
}

Redirect('https://example.com/', false);

function redirect($url, $statusCode = 303)
{
    header('Location: ' . $url, true, $statusCode);
    die();
}

解决方案

当header()重定向在 HTML 输出之后调用失败时，可以使用 HTML 元刷新标签或 JavaScript 实现重定向：

<meta http-equiv="refresh" content="0;url=finalpage.html">

window.location.replace("https://example.com/");

其他注意事项

在 CLI 环境中，重定向无法实现；若 Web 服务器以 (F)CGI 模式运行 PHP，则需要预先设置Status头才能正确重定向。

核心代码

以下是几种常见重定向方式的核心代码：

使用header()函数进行重定向

header('Location: target-page.php');
exit();

使用 JavaScript 重定向

echo '<script type="text/javascript">
           window.location = "http://www.google.com/";
      </script>';

带条件的重定向

session_start();
if (!isset( $_SESSION["valid_user"]))
{
    header("location:../");
    exit();
}

最佳实践

1. 确保header()函数在任何输出之前调用，避免出现“headers already sent”警告。
2. 根据重定向的性质选择合适的状态码：临时重定向使用 302，永久重定向使用 301。
3. 调用header()函数后使用die()或exit()停止脚本执行。
4. 在用户认证、表单提交等场景中合理应用重定向。

常见问题

1. “headers already sent”警告：在调用header()函数前，有任何输出（包括空格、换行符、标签等）导致无法发送 HTTP 头。解决方法是确保在调用header()之前没有任何输出，或使用输出缓冲（ob_start()和ob_end_flush()）来捕获输出。
2. 用户代理忽略重定向：部分用户代理可能忽略Location头，导致重定向失败。为避免此问题，可在header()之后使用die()或exit()停止脚本执行。
3. 搜索引擎索引问题：使用不当的重定向状态码可能影响搜索引擎索引，比如临时重定向（302）可能被搜索引擎认为页面是临时变动。需根据实际情况选择合适的状态码。