0

0

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

蓮花仙者

蓮花仙者

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

|

197人浏览过

|

来源于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免费学习笔记(深入)”;

eMart 网店系统
eMart 网店系统

功能列表:底层程序与前台页面分离的效果,对页面的修改无需改动任何程序代码。完善的标签系统,支持自定义标签,公用标签,快捷标签,动态标签,静态标签等等,支持标签内的vbs语法,原则上运用这些标签可以制作出任何想要的页面效果。兼容原来的栏目系统,可以很方便的插入一个栏目或者一个栏目组到页面的任何位置。底层模版解析程序具有非常高的效率,稳定性和容错性,即使模版中有错误的标签也不会影响页面的显示。所有的标

下载
  • 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_functionset_exception_handler,但各自有局限。

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

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

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

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

  • 先确认 phpinfo()display_errorsOfflog_errorsOn —— 否则错误会直接打到页面上,盖掉你的自定义页
  • 检查 Apache 配置中对应目录的 AllowOverride 是否包含 FileInfoErrorDocument 所需)
  • 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速学教程(入门到精通),有需要的小伙伴保存下载就能学习啦!

下载

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

热门AI工具

更多
DeepSeek
DeepSeek

幻方量化公司旗下的开源大模型平台

豆包大模型
豆包大模型

字节跳动自主研发的一系列大型语言模型

通义千问
通义千问

阿里巴巴推出的全能AI助手

腾讯元宝
腾讯元宝

腾讯混元平台推出的AI助手

文心一言
文心一言

文心一言是百度开发的AI聊天机器人,通过对话可以生成各种形式的内容。

讯飞写作
讯飞写作

基于讯飞星火大模型的AI写作工具,可以快速生成新闻稿件、品宣文案、工作总结、心得体会等各种文文稿

即梦AI
即梦AI

一站式AI创作平台,免费AI图片和视频生成。

ChatGPT
ChatGPT

最最强大的AI聊天机器人程序,ChatGPT不单是聊天机器人,还能进行撰写邮件、视频脚本、文案、翻译、代码等任务。

相关专题

更多
nginx 重启
nginx 重启

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

240

2023.07.27

nginx 配置详解
nginx 配置详解

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

519

2023.08.04

nginx配置详解
nginx配置详解

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

587

2023.08.04

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

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

243

2024.02.23

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

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

585

2024.07.09

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

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

3606

2024.08.07

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

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

53

2026.01.13

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

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

67

2026.01.13

Golang 实际项目案例:从需求到上线
Golang 实际项目案例:从需求到上线

《Golang 实际项目案例:从需求到上线》以真实业务场景为主线,完整覆盖需求分析、架构设计、模块拆分、编码实现、性能优化与部署上线全过程,强调工程规范与实践决策,帮助开发者打通从技术实现到系统交付的关键路径,提升独立完成 Go 项目的综合能力。

1

2026.02.26

热门下载

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

相关下载

更多

精品课程

更多
相关推荐
/
热门推荐
/
最新课程
PHP课程
PHP课程

共137课时 | 12.5万人学习

JavaScript ES5基础线上课程教学
JavaScript ES5基础线上课程教学

共6课时 | 11.3万人学习

PHP新手语法线上课程教学
PHP新手语法线上课程教学

共13课时 | 0.9万人学习

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

Copyright 2014-2026 https://www.php.cn/ All Rights Reserved | php.cn | 湘ICP备2023035733号