PHP文件不存在报404怎么整_PHP文件缺失404处理招【对策】

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文件缺失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,没加 =404index.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() 必须在 echoprint 或任何输出之前调用,否则会触发 “headers already sent” 错误。

https://www.php.cn/faq/1997092.html

发表回复

Your email address will not be published. Required fields are marked *