启用PHP错误日志需先开启log_errors并设置error_log路径，调整error_reporting级别，配置Web服务器记录错误，测试日志功能后定期维护。
如果您在开发或维护PHP应用时遇到运行错误，但无法直观看到具体问题，则可能是由于错误日志未开启或配置不当。启用并正确配置PHP错误日志可以帮助您快速定位代码中的异常。
本文运行环境：Dell XPS 13，Ubuntu 22.04
一、启用PHP错误日志功能
PHP默认可能不会将错误信息写入日志文件，需要手动开启相关配置项以确保所有运行时错误被记录。
1、打开php.ini配置文件，该文件通常位于/etc/php/8.1/apache2/php.ini或/etc/php/8.1/cli/php.ini路径下，请根据您的实际安装环境查找。
立即学习“PHP免费学习笔记（深入）”；
2、找到display_errors = Off并确认其值为Off，以防止错误信息直接输出到浏览器页面，避免信息泄露。
3、确保log_errors = On已启用，此设置允许PHP将错误信息写入日志文件而非仅显示在输出中。
4、设置错误日志的存储路径，修改error_log = /var/log/php/error.log，请确保该目录存在且Web服务器用户（如www-data）具有写入权限。
二、调整错误报告级别
通过配置error_reporting参数，可以控制哪些类型的错误会被记录，便于在不同环境中精细化管理日志内容。
1、在php.ini文件中找到error_reporting指令。
2、根据需求设置适当的错误级别，例如使用error_reporting = E_ALL & ~E_NOTICE & ~E_DEPRECATED来记录除通知和弃用警告外的所有错误。
3、若需记录所有错误和警告，可设为error_reporting = E_ALL，适用于调试阶段。
三、配置Web服务器记录PHP错误
当PHP作为模块运行于Apache或Nginx时，还需确保Web服务器本身也正确转发并记录PHP产生的错误日志。
1、对于Apache，在虚拟主机配置中添加php_admin_value log_errors On和php_admin_value error_log /var/log/apache2/php_error.log。
2、重启Apache服务使配置生效：sudo systemctl restart apache2。
3、对于Nginx配合PHP-FPM使用的情况，编辑/www.conf（通常位于/etc/php/8.1/fpm/pool.d/），确保catch_workers_output = yes并设置php_admin_value[error_log] = /var/log/php-fpm/www-error.log。
四、测试错误日志是否正常工作
通过人为触发一个PHP错误，验证日志系统是否能正确捕获并记录该事件。
1、创建一个测试文件test_error.php，内容为。
2、通过浏览器或命令行访问该文件：curl http://localhost/test_error.php。
3、检查之前设定的日志路径，如/var/log/php/error.log，确认其中包含类似“Undefined variable: undefined_variable”的记录。
五、定期维护与查看错误日志
持续积累的错误日志可能占用大量磁盘空间，同时需定期审查以发现潜在问题。
1、使用tail命令实时查看最新日志：tail -f /var/log/php/error.log。
2、结合grep过滤关键错误类型，例如：grep "Fatal error" /var/log/php/error.log。
3、配置logrotate工具对PHP错误日志进行轮转，防止单个文件过大，示例配置片段如下：
/var/log/php/*.log {
daily
missingok
rotate 7
compress
delaycompress
notifempty
create 640 www-data adm
}
