PHP设置自定义404错误页教程

一分耕耘，一分收获！既然打开了这篇文章《PHP自定义404错误页设置方法》，就坚持看下去吧！文中内容包含等等知识点...希望你能在阅读本文后，能真真实实学到知识或者帮你解决心中的疑惑，也欢迎大佬或者新人朋友们多留言评论，多给建议！谢谢！

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。

• 不要写成 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 面板是否全绿。

以上就是本文的全部内容了，是否有顺利帮助你解决问题？若是能给你带来学习上的帮助，请大家多多支持golang学习网！更多关于文章的相关知识，也可关注golang学习网公众号。