PHP错误日志排查

PHP错误日志排查

引言

线上页面白屏、500错误，前台看不到具体原因，靠猜很难定位。正确做法是开启并查看PHP错误日志，从日志里拿到文件、行号、错误类型，再针对性修复。

先确认日志位置

在phpinfo页面搜索error_log，或查看php.ini配置：

#查看php.ini错误日志配置
php -i | grep error_log
#常见位置
tail -f /var/log/php-fpm/www-error.log
tail -f /var/log/httpd/php_errors.log

宝塔、面板环境一般在日志菜单里可直接打开PHP错误日志。

开发环境临时显示错误

<?php
ini_set('display_errors',1);
ini_set('error_reporting',E_ALL);
error_reporting(E_ALL);

生产环境不要直接display_errors到页面，统一写日志。

日志格式解读

一条错误日志通常包含：错误级别、报错文件、行号、错误信息。

[12-Oct-2026 07:00:00] PHP Fatal error:
Call to undefined function xxx() in /www/app/index.php on line 18

含义：第18行调用了不存在的函数，检查函数是否引入、命名是否拼错。

常见错误类型

• Fatal error：致命错误，程序中断，如调用不存在的类、函数；
• Warning：警告不中断，如参数类型不对；
• Notice：提示，未定义变量；
• Deprecated：废弃语法，未来版本不兼容。

排查流程

1. 复现问题，记录访问时间；
2. 按时间过滤日志，定位对应报错；
3. 打开报错文件对应行号；
4. 修复后清空日志再验证。

总结

PHP排错第一步永远是看错误日志，而不是反复刷新页面。开发环境显示错误，生产环境写日志，按时间和行号快速定位，养成记录日志的习惯。