前言

PHP报错了，页面白屏或者500，啥也不显示，不知道哪错了？开了错误显示就能看到具体错误了。本文讲怎么改php.ini开启错误显示。

一、为什么不显示错误

生产环境为了安全，默认不显示错误，防止暴露敏感信息（路径、数据库密码等）。

但开发的时候就不方便了，啥也看不到。

二、找到php.ini

找php.ini位置

php --ini

输出：

Loaded Configuration File: /etc/php.ini

或者：

/etc/php/7.4/cli/php.ini

注意：CLI和FPM的php.ini可能不一样。

看当前加载的是哪个

写个phpinfo：

<?php
phpinfo();
?>

浏览器访问，看Loaded Configuration File。

三、修改php.ini

1. 显示错误

display_errors = On

2. 报错级别

error_reporting = E_ALL & ~E_DEPRECATED & ~E_STRICT

或者全开：

error_reporting = E_ALL

3. 错误日志

log_errors = On
error_log = /var/log/php_errors.log

4. 显示启动错误

display_startup_errors = On

四、改完重启

PHP-FPM

systemctl restart php-fpm

或者：

systemctl reload php-fpm

Apache

systemctl restart httpd

五、代码里临时开启

不想改php.ini，在代码开头加：

ini_set('display_errors', 1);
ini_set('display_startup_errors', 1);
error_reporting(E_ALL);

或者：

ini_set('error_reporting', E_ALL);
ini_set('display_errors', 1);

六、常见错误类型

E_ALL

所有错误和警告。

E_ERROR

致命运行错误，脚本停止。

E_WARNING

运行时警告，脚本继续。

E_NOTICE

运行时注意，比如未定义变量。

七、常见坑

坑1：改了php.ini不生效

改的不是实际加载的那个php.ini。

解决： 用 php --ini 看实际加载的是哪个。

坑2：FPM和CLI的php.ini不一样

命令行改了，网页上不生效。

原因： CLI和FPM用不同的php.ini。

解决： 改FPM的那个，比如 /etc/php/7.4/fpm/php.ini。

坑3：页面白屏

可能是语法错误，php.ini都没加载起来。

检查： 看PHP错误日志。

坑4：开了错误显示有安全风险

生产环境不能开！

注意： 排查完一定要改回去。

坑5：.htaccess里覆盖了

有些主机在.htaccess里设了php_flag。

检查： 看看.htaccess里有没有。

八、生产环境配置

生产环境不要开display_errors，但要开日志：

display_errors = Off
log_errors = On
error_log = /var/log/php_errors.log
error_reporting = E_ALL & ~E_NOTICE & ~E_DEPRECATED

九、查看错误日志

PHP错误日志

tail -f /var/log/php_errors.log

Nginx错误日志

tail -f /var/log/nginx/error.log

Apache错误日志

tail -f /var/log/httpd/error_log

十、快速排查

第一步：代码里临时开

ini_set('display_errors', 1);
error_reporting(E_ALL);

第二步：看具体报错

刷新页面，看报什么错。

第三步：解决完删掉

改完了把代码里的ini_set删掉，或者改回生产配置。

总结

记住：

1. display_errors = On 显示错误
2. error_reporting = E_ALL 显示所有错误
3. 改完重启php-fpm
4. 生产环境关掉display_errors，开log_errors
5. 代码里可以用ini_set临时开

开发环境推荐：

display_errors = On
error_reporting = E_ALL
log_errors = On

生产环境推荐：

display_errors = Off
log_errors = On
error_reporting = E_ALL & ~E_NOTICE

遇到问题加QQ23979811 协助处理