讲师中心 微信公众号
AI工具推荐 视频效率加速

php如何设置自定义错误页面_php设置自定义错误页面方法【技巧】

秋婷吖_9467

秋婷吖_9467

发布时间:2026-02-26 17:48:11

|

237人浏览过

|

来源于php中文网

原创

php如何设置自定义错误页面_php设置自定义错误页面方法【技巧】

PHP 里 http_response_code() 和 header() 哪个该先调用

必须先调用 http_response_code()(或 header('HTTP/1.1 404 Not Found')),再调用 header('Location: /404.php')。否则重定向后状态码会变成 302,搜索引擎和 API 客户端收不到你想要的 404、500 等语义。

常见错误现象:页面跳转了,但浏览器开发者工具 Network 面板里响应状态码是 302,不是 404;curl -I 看到的是 HTTP/1.1 302 Found。

  • 如果只是想显示错误页而不跳转,直接 http_response_code(404) + include '404.php' 就够了
  • 如果用了 header('Location: ...'),记得它默认发 302,要显式覆盖:http_response_code(404); header('Location: /404.php'); —— 但注意:这其实不标准,客户端收到 404 状态却跳转,语义矛盾
  • 更合理的方式是:用 302 跳转时,保持状态码为 302;真要返回 404,就别跳转,直接输出内容

Apache 下用 .htaccess 设置 ErrorDocument 的坑

PHP 层面的错误处理控制不了服务器级错误(比如 404 文件不存在、500 PHP 解析失败),这类必须靠 Web 服务器配置。Apache 的 ErrorDocument 是最常用方式,但路径容易写错。

使用场景:用户访问 /nonexistent.php,Apache 直接 404,根本没进 PHP;或者 PHP 崩溃导致 500,set_error_handler 也捕获不到。

立即学习“PHP免费学习笔记(深入)”;

btpanel phpsite 宝塔面板PHP网站
btpanel phpsite 宝塔面板PHP网站

宝塔面板 PHP 网站管理:站点创建、删除、启停、PHP 版本切换、域名管理、SSL证书管理、伪静态管理、数据库管理

下载
  • ErrorDocument 404 /errors/404.php:路径是相对于网站根目录(DocumentRoot),不是当前脚本位置
  • 如果站点跑在子目录(如 http://site.com/app/),/errors/404.php 仍要从根开始写,不能写成 /app/errors/404.php
  • 确保 404.php 本身能被公开访问(没被 Deny from all 挡住),且里面手动调用 http_response_code(404),否则默认返回 200
  • Nginx 没有 ErrorDocument,对应的是 error_page 404 /404.html;,语法和路径逻辑不同,别套用

PHP 内部错误(Parse Error、Fatal Error)为什么 set_error_handler 捕获不到

set_error_handler 只捕获 E_WARNING、E_NOTICE 这类“可恢复”错误,对解析失败、致命错误、未捕获异常完全无效。它们发生得太早,PHP 连运行时环境都没完全起来。

真正能兜底的只有两个机制:register_shutdown_function 和 set_exception_handler,但各自有局限。

  • set_exception_handler 只管未被捕获的 Exception 和 Error(PHP 7+),不管 ParseError(文件语法错)
  • register_shutdown_function 总会执行,可用 error_get_last() 判断是否发生了致命错误,但无法阻止白屏或默认错误信息输出
  • 关键操作:在 shutdown 函数里检查 error_get_last() 类型是否为 E_PARSE 或 E_ERROR,然后 http_response_code(500) + readfile('500.php') 输出自定义页
  • 注意:此时 PHP 输出缓冲可能已关闭,echo 失效,必须用 readfile 或打开缓冲(ob_start() 得在出错前就开好)

为什么本地开发能显示自定义页,上线后又变默认 Apache 错误页

大概率是生产环境开了 display_errors = On 或 log_errors = Off,同时没关掉 Apache 的 AllowOverride None,导致 .htaccess 里的 ErrorDocument 不生效。

性能与兼容性影响:Apache 每次请求都要检查目录下有没有 .htaccess,线上关掉它能提速;但关掉后你就只能去主配置改 ErrorDocument,没法按虚拟主机或目录单独设。

  • 先确认 phpinfo() 里 display_errors 是 Off,log_errors 是 On —— 否则错误会直接打到页面上,盖掉你的自定义页
  • 检查 Apache 配置中对应目录的 AllowOverride 是否包含 FileInfo(ErrorDocument 所需)
  • 用 curl -I https://yoursite.com/nonexistent 看响应头,确认是否返回了你设的 Location 或状态码,而不是 Apache 默认文本
  • CDN 或反向代理(如 Nginx 做前端)可能吞掉原始状态码,把 404 转成 200 返回给用户,这时得查中间层配置

最常被忽略的一点:自定义错误页本身出错(比如 404.php 里写了 $undefined_var->method()),会导致二次 500,最终 fallback 到服务器默认页 —— 所以错误页代码越简单越好,别引入复杂逻辑或外部依赖。

相关文章

PHP速学教程(入门到精通)
PHP速学教程(入门到精通)

PHP怎么学习?PHP怎么入门?PHP在哪学?PHP怎么学才快?不用担心,这里为大家提供了PHP速学教程(入门到精通),有需要的小伙伴保存下载就能学习啦!

下载

相关标签:

php

本站声明:本文内容由网友自发贡献,版权归原作者所有,本站不承担相应法律责任。如您发现有涉嫌抄袭侵权的内容,请联系admin@php.cn

热门AI工具

更多
豆包大模型

豆包大模型是一款由字节跳动推出的企业级大语言模型服务平台。

二狗PPT
二狗PPT Hot

一款AI演示文稿工具,主要用于专为中式职场打造的AI PPT生成工具,适合需要提升相关任务效率的用户。

DeepSeek

DeepSeek是一款面向对话、写作、编程和推理场景的AI大模型工具。

切问学术

切问学术是一款AI论文写作工具,复旦大学NLP团队推出的AI学术智能体。

花生AI
花生AI Hot

一款AI视频创作工具,主要用于B站推出的AI视频创作工具,适合需要提升相关任务效率的用户。

小橡皮AI

一款AI工具,主要用于小橡皮一键去AI味,将机器味重的内容改得更有活人感,防止因为 AI 内容被平台打上 AI 标签,以及限流,适合需要提升相关任务效率的用户。

讯飞绘文

讯飞绘文是一款由科大讯飞推出的一站式 AIGC 内容运营平台。

UP简历
UP简历 Hot

一款AI办公效率工具,主要用于基于AI技术的免费在线简历制作工具,适合需要提升相关任务效率的用户。

WorkBuddy

一款AI办公效率工具,主要用于腾讯云推出的AI原生桌面智能体工作台,适合需要提升相关任务效率的用户。

相关专题

更多
nginx 重启
nginx 重启

nginx重启对于网站的运维来说是非常重要的,根据不同的需求,可以选择简单重启、平滑重启或定时重启等方式。本专题为大家提供nginx重启的相关的文章、下载、课程内容,供大家免费下载体验。

423

2023.07.27

nginx 配置详解
nginx 配置详解

Nginx的配置是指设置和调整Nginx服务器的行为和功能的过程。通过配置文件,可以定义虚拟主机、HTTP请求处理、反向代理、缓存和负载均衡等功能。Nginx的配置语法简洁而强大,允许管理员根据自己的需要进行灵活的调整。php中文网给大家带来了相关的教程以及文章,欢迎大家前来学习阅读。

3927

2023.08.04

nginx配置详解
nginx配置详解

NGINX与其他服务类似,因为它具有以特定格式编写的基于文本的配置文件。本专题为大家提供nginx配置相关的文章,大家可以免费学习。

6725

2023.08.04

tomcat和nginx有哪些区别
tomcat和nginx有哪些区别

tomcat和nginx的区别:1、应用领域;2、性能;3、功能;4、配置;5、安全性;6、扩展性;7、部署复杂性;8、社区支持;9、成本;10、日志管理。本专题为大家提供相关的文章、下载、课程内容,供大家免费下载体验。

601

2024.02.23

nginx报404怎么解决
nginx报404怎么解决

当访问 nginx 网页服务器时遇到 404 错误,表明服务器无法找到请求资源,可以通过以下步骤解决:1. 检查文件是否存在且路径正确;2. 检查文件权限并更改为 644 或 755;3. 检查 nginx 配置,确保根目录设置正确、没有冲突配置等等。本专题为大家提供相关的文章、下载、课程内容,供大家免费下载体验。

1496

2024.07.09

Nginx报404错误解决方法
Nginx报404错误解决方法

解决方法:只需要加上这段配置:try_files $uri $uri/ /index.html;即可。想了解更多Nginx的相关内容,可以阅读本专题下面的文章。

3978

2024.08.07

nginx部署php项目教程汇总
nginx部署php项目教程汇总

本专题整合了nginx部署php项目教程汇总,阅读专题下面的文章了解更多详细内容。

122

2026.01.13

nginx配置文件详细教程
nginx配置文件详细教程

本专题整合了nginx配置文件相关教程详细汇总,阅读专题下面的文章了解更多详细内容。

537

2026.01.13

Vite 项目如何打包和部署
Vite 项目如何打包和部署

Vite项目打包部署专题汇集生产构建、产物预览、输出目录、资源路径、Nginx与GitHub Pages部署及常见白屏和路由404问题的已审核文章,帮助读者完成上线流程。

60

2026.10.28

热门下载

更多
网站特效
/
网站源码
/
网站素材
/
前端模板

精品课程

更多
相关推荐
/
热门推荐
/
最新课程
墨刀帮助中心
墨刀帮助中心

共0课时 | 0人学习

MyEclipse学习中心
MyEclipse学习中心

共0课时 | 0人学习

Apache Subversion 官方手册
Apache Subversion 官方手册

共0课时 | 0人学习

关于我们 免责申明 举报中心 意见反馈 讲师合作 广告合作 最新更新
php中文网:公益在线php培训,帮助PHP学习者快速成长!
关注服务号
PHP中文网订阅号
每天精选资源文章推送

Copyright 2014-2026 https://www.php.cn/ All Rights Reserved | php.cn