PHP开发时空白页多因错误被静默屏蔽,需同时配置error_reporting = E_ALL和display_errors = On,并注意log_errors与日志路径权限;运行时可用error_reporting()和ini_set()动态开启,但解析错误需用php -l检测。

PHP 默认在生产环境中关闭错误显示,所以开发时遇到空白页或逻辑异常,大概率是错误被静默吞掉了。要让错误立刻浮现出来,得手动打开两个开关:一个是报告哪些错误,一个是把它们输出到页面或日志。
修改 php.ini 中的错误报告级别
关键配置项是 error_reporting,它决定 PHP 报告哪些级别的错误。开发阶段建议设为 E_ALL,覆盖所有错误、警告和通知:
error_reporting = E_ALL
注意:E_ALL 在 PHP 8.0+ 还包含 E_DEPRECATED 和 E_WARNING 等,比旧版本更严格;如果用的是老项目,可能需要临时加 | E_STRICT 兼容(但不推荐长期保留)。
常见误配:
立即学习“PHP免费学习笔记(深入)”;
-
error_reporting = 0—— 什么也不报,调试时务必避开 -
error_reporting = E_ERROR—— 只报致命错误,漏掉Notice类问题(比如未定义变量)
开启 display_errors 并确认运行模式
即使设置了 error_reporting,错误也不会显示在页面上,除非 display_errors = On。这个开关必须显式启用:
display_errors = On
但要注意:该设置在 CGI/FPM 模式下(如 Nginx + PHP-FPM)可能被 SAPI 层忽略,此时需额外检查 php_admin_flag display_errors on 是否写在 FPM pool 配置里。Apache 的 .htaccess 中也可覆盖:
漂亮的企业网站。NET2.0出来了, 本次升级修改如下: 1、优化了3层结构。 2、优化了后台管理代码,增强了安全性能。 3、增加了系统名称及关键字管理。 4、增加了系统错误日志记录,自动生成Systemlog.log日志文件。 备注:本系统采用ASP.NET 2.O+ACCESS开发,请调试的朋友安装.NET2.0运行环境! 网站内容 网站栏目包括 首页|企业简介|新闻中心|产品展示|公司展示|
php_flag display_errors on
不过,display_errors = On 在线上环境极其危险,会暴露路径、变量名甚至数据库结构,所以切记——只在开发机或本地 Docker 环境中开启。
确认 log_errors 和日志路径是否可用
有些环境(比如容器化部署)禁用了 display_errors,但允许记录错误。这时要确保:
log_errors = On-
error_log = /var/log/php_errors.log(路径需 PHP 进程有写权限) - 对应目录存在且可写:
chown www-data:www-data /var/log/php_errors.log
如果日志文件为空,先用 tail -f /var/log/php_errors.log 实时观察,再触发一个明显错误(比如访问 undefined_function();),看是否落盘。
运行时动态开启(仅限脚本头部)
如果无法修改 php.ini(如共享主机),可在入口脚本(如 index.php)最开头加:
但要注意:ini_set('display_errors', '1') 对于解析错误(如语法错误、require 找不到文件)无效,因为这些发生在脚本执行前。这类问题只能靠 php -l index.php 命令行检查,或看 Web 服务器错误日志。
真正容易被忽略的是:错误显示开关只是“让错误可见”,不代表错误本身被修复。看到 Undefined variable: $user 后,得去查变量声明位置、作用域和初始化逻辑——开关只是把黑盒打开,里面是什么,还得自己看清楚。










