PHP错误默认不显示也不记录,需在php.ini中设置display_errors=On、log_errors=On、error_log指定路径、error_reporting=E_ALL,并重启服务器;Nginx+PHP-FPM下需检查php_admin_flag[display_errors]覆盖;ini_set('display_errors', '1')常失效,推荐用error_reporting(E_ALL)配合日志。

PHP 错误默认不显示也不记录,必须手动开启 display_errors 和 log_errors 才能看到错误详情——否则你只会看到空白页或 500,却不知道哪行代码崩了。
怎么在 php.ini 里永久开启错误显示和日志
这是最稳定、推荐的配置方式,适用于生产前调试或本地开发环境。修改后需重启 Web 服务器(如 Apache 或 PHP-FPM)才生效。
-
display_errors = On:让错误直接输出到浏览器(切勿在生产环境开启) -
log_errors = On:启用错误写入日志文件 -
error_log = /var/log/php_errors.log:指定日志路径(确保 PHP 进程有写权限) -
error_reporting = E_ALL:报告所有错误类型(包括E_NOTICE和E_DEPRECATED)
注意:display_errors 在 CGI/FastCGI 模式下(如 Nginx + PHP-FPM)默认被强制设为 Off,即使 php.ini 写了 On 也可能无效——这时得看 php-fpm.conf 或 pool 配置里是否用 php_admin_flag[display_errors] = on 覆盖。
运行时用 ini_set() 临时开启(适合调试单个脚本)
如果不能改 php.ini(比如共享主机),可在 PHP 文件开头用 ini_set() 动态设置,但部分指令受 PHP_INI_SYSTEM 级别限制,display_errors 就是其中之一——它在某些 SAPI 下无法被 ini_set() 修改。
立即学习“PHP免费学习笔记(深入)”;
-
ini_set('log_errors', '1');✅ 大多数情况有效 -
ini_set('error_log', '/tmp/php_debug.log');✅ 可覆盖日志路径 -
ini_set('display_errors', '1');❌ 常见失效,尤其在 PHP-FPM 下 - 更可靠的做法是搭配
error_reporting(E_ALL);+ini_set('log_errors', '1');,然后查日志
error_reporting(E_ALL);
ini_set('log_errors', '1');
ini_set('error_log', '/tmp/my_debug.log');
// 触发一个 Notice 测试
echo $undefined_var;
为什么开了 display_errors 还是看不到错误?
常见原因不是配置没写对,而是被更高优先级的设置覆盖或环境限制:
- Nginx + PHP-FPM 场景下,
php_admin_flag[display_errors]在 pool 配置中被设为off,会无视 php.ini 和ini_set() - Apache 的
.htaccess里写了php_flag display_errors off,也会屏蔽 - 脚本里调用了
error_reporting(0)或@抑制符(如@file_get_contents()),错误被静默吞掉 - PHP 版本 ≥ 8.0 后,
display_errors在 CLI 模式下默认为stderr,但 Web SAPI 下仍需显式开启
log_errors 日志写不进去?检查这三点
日志路径看似配了,但文件为空或报错“failed to open stream”,大概率是权限或路径问题:
- 确认
error_log指向的目录存在,且 PHP worker 用户(如www-data或nginx)有写权限:ls -ld /var/log/和ls -l /var/log/php_errors.log - 避免写到
/root/或用户家目录——Web 进程通常无权访问 - 如果用相对路径(如
error_log = php_error.log),日志会写入 Web 服务器的工作目录(通常是/var/www或/usr/share/nginx/html),不易追踪,建议用绝对路径
日志权限不够时,tail -f /var/log/php_errors.log 会一直空,但 ls -l 能立刻暴露问题。











