web服务器（apache/nginx）处理404，php仅输出内容；apache用errordocument配置路径须以/开头，nginx需error_page+internal防止直接访问；404.php中应调用http_response_code(404)确保状态头正确，且避免资源404。
PHP 本身不直接处理 404 错误页，真正生效的是 Web 服务器（如 Apache 或 Nginx）。你写的 404.php 文件只是被服务器在发生 404 时“转发”过去，而不是由 PHP 解释器主动触发。
Apache 下用 .htaccess 设置 404 页面
这是最常见也最易出错的方式。确保你的服务器启用 mod_rewrite，且站点允许覆盖配置（AllowOverride All）。
在网站根目录下创建或编辑 .htaccess，写入：
ErrorDocument 404 /404.php
注意：/404.php 是相对于网站根目录（DocumentRoot）的路径，不是文件系统绝对路径；如果放在子目录，比如 /blog/404.php，就得写成 /blog/404.php。
立即学习“PHP免费学习笔记（深入）”；
- 不要写成
ErrorDocument 404 404.php（缺开头斜杠 → 会当成相对当前请求路径拼接，导致 404 嵌套） - 不要在
404.php里用header("HTTP/1.1 404 Not Found")来“补救”——服务器已发过状态码，PHP 只能输出内容 - 若页面内含 CSS/JS 资源，请用绝对路径（如
/css/style.css），否则因请求路径非根目录，资源会 404
Nginx 下配置 error_page 指令
Nginx 不读 .htaccess，必须改站点配置（通常在 /etc/nginx/sites-enabled/xxx 或 nginx.conf 的 server 块中）：
error_page 404 /404.php;
location = /404.php {
internal;
fastcgi_pass php-fpm;
include fastcgi_params;
fastcgi_param SCRIPT_FILENAME $document_root$fastcgi_script_name;
}
internal 很关键：它禁止用户直接访问 /404.php，只允许内部跳转；否则可能暴露错误页逻辑，或被搜索引擎收录为真实页面。
- 若没加
internal，别人访问https://yoursite.com/404.php就能看到错误页，且返回 200 状态码 → SEO 风险 -
fastcgi_param SCRIPT_FILENAME必须显式设置，Nginx 不像 Apache 自动推导，漏掉会导致空白页或 502 - 修改后要运行
sudo nginx -t && sudo systemctl reload nginx才生效
PHP 文件里别漏设 HTTP 状态码
虽然服务器已发了 404，但某些前端框架、爬虫或调试工具会检查响应头里的 Status 字段。为保险起见，在 404.php 开头加上：
<?php http_response_code(404); ?>
这不会重复发状态行（PHP 会忽略重复调用），但能确保 Status 头正确显示为 404 Not Found（尤其在 CLI 或某些 FastCGI 环境下）。
- 别用
header("HTTP/1.1 404 Not Found")—— 它在 HTTP/2 下可能失效，且不如http_response_code()兼容 - 这个函数必须在任何输出（包括空格、BOM）之前调用，否则报
Warning: Cannot modify header information - 如果你用 Composer 加载类库或用了输出缓冲（
ob_start()），也要确认没提前输出
最容易被忽略的一点：404 页面本身不能触发新的 404（比如引用了一个不存在的图片、字体或 API 接口），否则浏览器控制台会出现级联错误，影响加载和用户体验。上线前务必用无痕模式+禁用缓存访问一个明确不存在的路径，看 Network 面板是否全绿。
