PHP自定义404页面设置教程

本文详解了如何在Apache和Nginx服务器上正确配置PHP自定义404错误页，强调PHP本身不处理404，真正起作用的是Web服务器的转发机制；文章指出常见陷阱——如Apache中路径漏写开头斜杠导致嵌套404、Nginx缺少internal指令引发SEO风险和安全暴露、PHP中未调用http_response_code(404)影响状态头准确性，以及404页面自身资源（CSS/JS/图片）路径错误引发的级联错误，并提供了可直接落地的配置代码与调试建议，帮你打造专业、合规、用户体验友好的错误响应。

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 面板是否全绿。

本篇关于《PHP自定义404页面设置教程》的介绍就到此结束啦，但是学无止境，想要了解学习更多关于文章的相关知识，请关注golang学习网公众号！