PHP本地开发需三处同步开启错误显示:修改php.ini中display_errors=On和error_reporting=E_ALL(或PHP 8.0+用-1),重启服务;确认CLI与Web使用同一配置;禁用Nginx fastcgi_intercept_errors并启用PHP-FPM catch_workers_output。

PHP本地开发时,默认不显示错误,必须手动开启并设为最高级别,否则语法错误、未定义变量等会静默失败,调试极其困难。
如何让PHP立即显示所有错误(含Notice和Warning)
关键不是改error_reporting值,而是确保三处同时生效:php.ini配置、运行时设置、以及Web服务器(如Apache/Nginx)不拦截错误输出。
- 编辑本地
php.ini文件(用php --ini确认路径),找到并修改两行:
display_errors = On error_reporting = E_ALL
- 重启Web服务器或PHP-FPM服务(仅改php.ini后必须重启)
- 如果用CLI运行脚本,还需确认CLI用的也是同一份php.ini(
php -i | grep "Loaded Configuration File") - 若仍不显示,检查是否被
ini_set("display_errors", "0")或error_reporting(0)在代码中覆盖
为什么error_reporting(E_ALL)在某些PHP版本里不报Undefined array key
因为E_ALL在PHP 7.2+才包含E_NOTICE子集中的E_WARNING相关提示,而Undefined array key属于E_NOTICE(PHP 7.4+)或E_WARNING(PHP 8.0+),具体取决于访问方式和错误上下文。
- 安全起见,本地开发应显式设为
error_reporting(E_ALL | E_STRICT | E_DEPRECATED) - PHP 8.0+推荐用
error_reporting(-1)——它等价于“所有已知错误级别”,比硬写常量更可靠 - 注意:
E_STRICT在PHP 8.0+已被移除,但-1仍兼容
使用ini_set()临时开启错误显示的限制
ini_set("display_errors", "1")只能在脚本运行期生效,且受php.ini中display_errors的“全局开关”约束——如果php.ini里是Off,部分SAPI(如CGI/FastCGI)会直接忽略ini_set调用。
立即学习“PHP免费学习笔记(深入)”;
- 仅适合调试单个文件,例如在入口
index.php顶部加:
- 不能替代php.ini配置,尤其在框架(如Laravel、ThinkPHP)中,错误可能在自动加载前就发生,此时
ini_set还来不及执行 - 上线前务必删掉,否则暴露敏感路径和变量名
常见踩坑:Nginx + PHP-FPM下错误仍不显示
不是PHP没设对,而是Nginx默认把PHP错误转成500响应,不输出到页面。需检查两处:
- Nginx配置中
fastcgi_intercept_errors off;——必须关闭拦截,否则错误被吃掉 - PHP-FPM pool配置(如
www.conf)中catch_workers_output = yes,并确保php_admin_value[log_errors] = on - 若用Docker,确认
php.ini挂载进了容器,且php-fpm进程读取的是该文件(而非镜像内置的默认配置)
最稳妥的做法:每次换环境都跑一遍php -r "echo error_reporting() . \"\\n\"; print_r(error_get_last());",看当前实际生效的级别和最近错误——别信配置文件写了什么,要信PHP此刻真正在用什么。











