

新闻资讯
技术百科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,却不知道哪行代码崩了。
这是最稳定、推荐的配置方式,适用于生产前调试或本地开发环境。修改后需重启 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 覆盖。
如果不能改 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;
常见原因不是配置没写对,而是被更高优先级的设置覆盖或环境限制:
php_admin_flag[display_errors] 在 pool 配置中被设为 off,会无视 php.ini 和 ini_set()
.htaccess 里写了 php_flag di
splay_errors off,也会屏蔽error_reporting(0) 或 @ 抑制符(如 @file_get_contents()),错误被静默吞掉display_errors 在 CLI 模式下默认为 stderr,但 Web SAPI 下仍需显式开启日志路径看似配了,但文件为空或报错“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 能立刻暴露问题。