PHP无法处理404是因为Web服务器(如Nginx/Apache)在文件不存在时直接返回404,PHP未执行;需通过重写规则(Apache用RewriteCond+RewriteRule,Nginx用try_files)将请求统一转发至index.php,再由PHP解析REQUEST_URI提取路径并路由,最后显式调用http_response_code(404)发送正确状态码。

PHP 文件不存在时返回 404,不是 PHP 自己报的,而是 Web 服务器(如 Nginx 或 Apache)在找不到对应文件时直接拦截并返回的——PHP 根本没机会运行。所以想“用 PHP 处理 404”,得先让请求落到 PHP 脚本上。
Apache 下让所有请求都走 index.php(前端控制器模式)
关键在 .htaccess 或虚拟主机配置里启用重写,并把非静态资源全部转发给 index.php。否则 example.com/missing.php 这种路径一不存在,Apache 就立刻 404,不进 PHP。
常见错误:只写了 RewriteRule ^(.*)$ index.php [QSA,L],但没开 RewriteEngine On,或没配 AllowOverride All,导致规则压根不生效。
正确最小配置示例:
立即学习“PHP免费学习笔记(深入)”;
RewriteEngine On
RewriteCond %{REQUEST_FILENAME} !-f
RewriteCond %{REQUEST_FILENAME} !-d
RewriteRule ^(.*)$ index.php [QSA,L]
说明:
-
%{REQUEST_FILENAME} !-f:当前请求路径不是真实文件 -
%{REQUEST_FILENAME} !-d:也不是真实目录 - 两个条件同时满足才重写,避免把
/css/style.css这类静态资源也转给 PHP
Nginx 下等效的 try_files 配置
Nginx 没有 .htaccess,必须改 server 块配置。核心是用 try_files 把请求“试”一遍:先找文件,再找目录,最后 fallback 到 index.php。
典型错误:漏掉 $args,导致 URL 参数(如 ?id=123)丢失;或写成 try_files $uri $uri/ /index.php,没加 =404 或 index.php 后的 ?$query_string,结果 $_GET 为空。
推荐写法:
location / {
try_files $uri $uri/ /index.php?$query_string;
}
注意:$query_string 是 Nginx 内置变量,等价于 $args,确保查询参数透传到 PHP。
PHP 层怎么知道原始请求路径?
重写后所有请求都打到 index.php,但你需要知道用户原本访问的是 /user/profile 还是 /api/v2/posts,才能做路由分发。不能靠 $_SERVER['REQUEST_URI'] 直接用——它可能带查询参数、编码字符,也可能被代理污染。
更稳妥的方式:
- 用
$_SERVER['REQUEST_URI']获取原始路径(Nginx/Apache 默认保留) - 用
parse_url($_SERVER['REQUEST_URI'], PHP_URL_PATH)提取干净路径部分 - 过滤掉空段、
..、开头多余的/,再按/分割成路由数组
示例(简化版):
$path = parse_url($_SERVER['REQUEST_URI'], PHP_URL_PATH);
$path = trim($path, '/');
$segments = $path ? explode('/', $path) : [];
别忘了 404 响应头和状态码
即使你用 PHP 渲染了“页面未找到”的 HTML,如果没显式发送 HTTP/1.1 404 Not Found,搜索引擎和爬虫仍会当作 200 成功页收录。这是最容易被忽略的一环。
正确做法:
- 在输出任何内容前调用
http_response_code(404) - 或者更底层一点:
header('HTTP/1.1 404 Not Found') - 如果用了框架(如 Laravel、Slim),通常有
abort(404)或notFound()方法,本质也是设响应码
注意:http_response_code() 必须在 echo、print 或任何输出之前调用,否则会触发 “headers already sent” 错误。











