新闻中心 分类>>

php错误怎么开启_display_errors与log_errors的设置【汇总】

2026-01-01 00:00:00
浏览次数:
返回列表
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_errorslog_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_NOTICEE_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() 修改。

  • 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-datanginx)有写权限: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 能立刻暴露问题。

搜索