如何在 Apache 404 错误页面中获取原始请求路径-php教程-PHP中文网

如何在 Apache 404 错误页面中获取原始请求路径

本文详解如何通过 .htaccess 配置自定义 404 页面，并在 PHP 脚本中准确捕获用户访问的原始 URL 路径（如 /example），避免重定向丢失上下文，适用于前端路由、单页应用或动态内容托管场景。

本文详解如何通过 `.htaccess` 配置自定义 404 页面，并在 php 脚本中准确捕获用户访问的原始 url 路径（如 `/example`），避免重定向丢失上下文，适用于前端路由、单页应用或动态内容托管场景。

在基于 Apache 的 Web 服务中，当用户访问一个不存在的路径（例如 https://test.de/example）时，服务器默认返回标准 404 响应。若需将此类请求统一交由 PHP 动态处理（如实现前端路由 fallback、个性化错误页或路径代理），必须正确配置错误文档并确保原始请求信息不丢失。

✅ 正确配置 .htaccess

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

ErrorDocument 404 /404.php

⚠️ 注意：路径 /404.php 必须以斜杠开头，表示相对于站点根目录的绝对路径；不能写成 ./404.php 或 404.php，否则 Apache 可能无法定位文件，导致配置失效或循环重定向。

✅ 在 PHP 中获取原始请求路径

Apache 在触发 ErrorDocument 时，会保留原始请求的环境变量。你可在 404.php 中直接使用：

Apache Tika Content Extraction Hub

通过Apache Tika Server REST API从1400多种文件格式中提取文本和元数据。处理PDF、DOCX、PPTX、电子邮件归档以及带有MIME类型检测的嵌入式文档提取。

下载

<?php // 获取用户最初请求的完整 URI（含查询参数）
$originalPath = $_SERVER['REQUEST_URI'] ?? '/';

// 示例输出：/example
echo "您访问的路径是：". htmlspecialchars($originalPath);

// 进阶用法：解析路径段、匹配路由、记录日志等
$pathInfo = parse_url($originalPath, PHP_URL_PATH);
// $pathInfo 将返回 '/example'（不含 query string）
?>

✅ $_SERVER['REQUEST_URI'] 是最可靠的方式——它原样保留了用户浏览器发起的请求路径（如 /example?ref=home），包括路径和查询字符串，且不受重定向影响。

⚠️ 常见误区与注意事项

❌ 不要使用 $_SERVER['REDIRECT_URL'] 或 $_SERVER['PHP_SELF']：前者在某些 Apache 版本中不可靠，后者仅返回当前脚本路径（即 /404.php），无法反映原始请求。
❌ 避免在 .htaccess 中使用 RewriteRule 模拟 404（如 RewriteRule ^(.*)$ /404.php [L]）：这会覆盖真实 404 状态码为 200，不利于 SEO 和调试；而 ErrorDocument 保持 HTTP 状态码为 404 Not Found，语义正确。
✅ 推荐在 404.php 开头显式设置状态码（尽管 Apache 已设置，但增强兼容性）：
```
http_response_code(404);
header('Content-Type: text/html; charset=utf-8');
```

? 总结

通过 ErrorDocument 404 /404.php 配置 + $_SERVER['REQUEST_URI'] 读取，即可轻量、可靠地实现“404 路由接管”。该方案无需额外模块、兼容主流 Apache 版本（2.2+），是构建 SPA（如 Vue/React History 模式）、静态站点动态路由或智能错误处理的基础实践。务必确保 PHP 文件存在、权限可读，且 .htaccess 启用（AllowOverride All）。