如何配置Ubuntu 18.04上的PHP错误日志管理的详细步骤？

首先确认PHP版本及配置文件路径，再设置error_reporting = E_ALL、log_errors = On、display_errors = Off，并指定error_log = /var/log/php/error.log；创建日志文件并授权www-data写入权限，重启Apache或PHP-FPM服务后，通过触发测试错误并使用tail命令验证日志记录是否生效。

如果您在开发或维护基于PHP的应用程序时遇到错误排查困难，可能是因为PHP错误日志未正确配置。合理的日志管理有助于快速定位脚本错误、警告和异常。以下是针对Ubuntu 18.04系统中PHP错误日志管理的详细配置步骤：

一、确认当前PHP版本及配置文件路径

在进行任何配置更改前，需明确当前系统使用的PHP版本及其对应的php.ini配置文件位置，因为不同SAPI（如Apache或FPM）可能使用不同的配置文件。

1、打开终端并执行以下命令查看PHP CLI版本及其加载的配置文件：
php --ini

2、查找输出中的“Loaded Configuration File”项，记录其路径，通常为 /etc/php/7.2/apache2/php.ini 或 /etc/php/7.2/cli/php.ini，具体路径取决于安装的PHP版本和运行模式。

二、启用错误报告级别

通过设置 error_reporting 指令，可以控制哪些类型的错误被记录。建议在开发环境中报告所有错误，在生产环境中仅记录严重错误。

立即学习“PHP免费学习笔记（深入）”；

1、使用文本编辑器打开目标 php.ini 文件，例如：
sudo nano /etc/php/7.2/apache2/php.ini

2、搜索并修改以下指令：
error_reporting = E_ALL

3、确保关闭显示错误给用户，防止敏感信息泄露：
display_errors = Off

4、启用将错误记录到日志文件的功能：
log_errors = On

三、指定错误日志文件路径

默认情况下，PHP可能不会写入自定义日志文件，需手动设定 log_errors_max_len 和 error_log 指令以确保错误被持久化存储。

挖错网

一款支持文本、图片、视频纠错和AIGC检测的内容审核校对平台。

28

查看详情

1、在同一 php.ini 文件中，找到或添加如下配置：
error_log = /var/log/php/error.log

2、创建指定的日志目录并设置权限：
sudo mkdir -p /var/log/php
sudo touch /var/log/php/error.log
sudo chown www-data:www-data /var/log/php/error.log

3、确保Web服务器进程（如Apache或PHP-FPM）对该文件具有写权限。

四、配置Web服务器处理PHP日志

当使用Apache或Nginx与PHP-FPM协同工作时，还需确认服务器端是否允许PHP写入日志，并避免权限冲突。

1、若使用Apache，确保 libapache2-mod-php 模块已启用：
sudo a2enmod php7.2

2、重启Apache服务使配置生效：
sudo systemctl restart apache2

3、若使用PHP-FPM，需检查对应池配置文件（如 www.conf），确保 error_log 参数指向合适的路径，并确认用户组为 www-data。

五、测试错误日志功能

完成配置后，应验证错误是否能正确写入指定日志文件。

1、创建一个测试PHP文件，例如 /var/www/html/test.php，内容如下：
<?php
trigger_error("This is a test error", E_USER_WARNING);
?>

2、通过浏览器访问该文件：
http://your-server-ip/test.php

3、检查日志文件是否生成错误记录：
sudo tail -f /var/log/php/error.log

以上就是如何配置Ubuntu 18.04上的PHP错误日志管理的详细步骤？的详细内容，更多请关注php中文网其它相关文章！