Apache 404 页面获取真实请求路径方法

本文深入讲解了在 Apache 环境下如何通过简单的 `.htaccess` 配置（`ErrorDocument 404 /404.php`）与安全的 PHP 实践，精准捕获用户访问的原始请求路径（如 `/example?ref=home`），并强调避开 `$_SERVER['REDIRECT_URL']` 等不可靠变量、强制 HTML 转义防 XSS、严格维持 404 状态码等关键细节——这一轻量却稳健的方案，无需重写模块即可支撑 SEO 友好跳转、智能错误路由、前端 SSR 兜底等真实业务场景，是开发者构建高可用 Web 应用不可或缺的基础技巧。

本文详解如何通过 .htaccess 配置自定义 404 页面，并在 PHP 脚本中安全、准确地获取用户访问的原始 URL 路径（如 /example），适用于 SEO 友好跳转、动态错误处理或路由兜底等场景。

本文详解如何通过 `.htaccess` 配置自定义 404 页面，并在 PHP 脚本中安全、准确地获取用户访问的原始 URL 路径（如 `/example`），适用于 SEO 友好跳转、动态错误处理或路由兜底等场景。

当用户访问一个不存在的路径（例如 https://test.de/example），Apache 默认返回标准 404 响应。若希望将其优雅降级至自定义 PHP 页面（如 404.php），并保留原始请求路径用于后续逻辑处理（如日志记录、智能重定向或前端渲染），需正确配置服务器与脚本协同机制。

✅ 正确配置 .htaccess

在网站根目录下创建或编辑 .htaccess 文件，添加以下指令：

ErrorDocument 404 /404.php

⚠️ 注意：路径 /404.php 必须以斜杠开头，表示相对于站点根目录（DocumentRoot）；不能写成 ./404.php 或 404.php，否则 Apache 将无法正确定位。

✅ 在 404.php 中获取原始请求路径

Apache 在触发 ErrorDocument 时，会保留原始请求的环境变量。此时，$_SERVER['REQUEST_URI'] 的值即为用户最初输入的完整路径（含查询参数），例如：

• 用户访问 https://test.de/example?ref=home → $_SERVER['REQUEST_URI'] 返回 /example?ref=home
• 用户访问 https://test.de/abc/def/ → 返回 /abc/def/

因此，在 404.php 中可直接使用：

<?php
$originalPath = $_SERVER['REQUEST_URI'] ?? '/';
// 安全截取路径部分（不含查询参数）
$pathOnly = parse_url($originalPath, PHP_URL_PATH);

echo "<h2>未找到页面：</h2>";
echo "<p>您尝试访问：<code>" . htmlspecialchars($pathOnly) . "</code></p>";

// 示例：根据路径前缀做智能跳转
if (str_starts_with($pathOnly, '/api/')) {
    http_response_code(404);
    echo "<p>API 接口不存在，请检查文档。</p>";
} elseif ($pathOnly === '/admin') {
    header('Location: /login?redirect=' . urlencode($pathOnly));
    exit;
}
?>

⚠️ 关键注意事项

• 不要依赖 $_SERVER['REDIRECT_URL'] 或 $_SERVER['REDIRECT_QUERY_STRING']：这些变量在 ErrorDocument 场景下行为不稳定，尤其在多层重写或 FastCGI 环境中可能为空或被覆盖。
• 始终对输出内容进行 HTML 转义：$_SERVER['REQUEST_URI'] 可被恶意构造（如含 XSS 载荷），直接输出存在安全风险，务必使用 htmlspecialchars() 处理。
• 确保响应状态码为 404：虽然 Apache 已发送 404 状态，但若 404.php 内部执行了 header('Location: ...') 或 http_response_code(200)，将覆盖原始状态码，影响搜索引擎和爬虫判断。如需重定向，请显式设置：

  http_response_code(302); // 或 301
  header('Location: /fallback');
  exit;

• 避免循环重定向：确保 404.php 自身路径不会触发新的 404（例如文件权限错误、路径拼写错误），建议部署前用 curl -I https://test.de/404.php 验证其可访问性。

✅ 总结

通过 ErrorDocument 404 /404.php 配置 + $_SERVER['REQUEST_URI'] 读取，即可轻量、可靠地捕获原始请求路径。该方案兼容所有标准 Apache 部署（包括共享主机），无需启用 mod_rewrite 或复杂规则，是构建健壮前端路由或错误处理系统的基石实践。

本篇关于《Apache 404 页面获取真实请求路径方法》的介绍就到此结束啦，但是学无止境，想要了解学习更多关于文章的相关知识，请关注golang学习网公众号！