如何配置Ubuntu PHP-FPM的错误日志

如何配置Ubuntu PHP-FPM的错误日志

想让PHP-FPM乖乖地把错误信息记录下来吗？其实配置过程并不复杂，跟着下面这几个步骤走，很快就能搞定。

第一步：找到并打开配置文件

首先，你得找到PHP-FPM的核心配置文件。它通常藏在这个路径下：/etc/php/{版本号}/fpm/pool.d/www.conf。举个例子，如果你用的是PHP 7.4，那么完整的路径就是 /etc/php/7.4/fpm/pool.d/www.conf。

接下来，用你熟悉的文本编辑器（比如nano或者vim）打开它：

sudo nano /etc/php/{版本号}/fpm/pool.d/www.conf

注意，记得把命令里的 {版本号} 替换成你实际使用的PHP版本号。

第二步：定位并理解关键配置项

在打开的 www.conf 文件里，你需要关注下面这两行配置：

catch_workers_output = yes
php_admin_value[error_log] = /var/log/php-fpm/www-error.log

这里简单解释一下：

• catch_workers_output = yes：这个设置非常关键。把它设为 yes，就意味着允许PHP-FPM捕获其工作进程的输出，并将其导向错误日志。这是日志能正常记录的前提。
• php_admin_value[error_log]：这行定义了错误日志文件的具体存放路径。例子中给出的是 /var/log/php-fpm/www-error.log，你可以根据需要修改成任何路径。不过要切记，务必确保运行PHP-FPM的进程有权限向这个位置写入文件。

第三步：按需调整错误日志级别

默认配置可能不会记录所有级别的错误。如果你想更精细地控制记录什么，可以接着在文件里找到这两个相关设置：

php_admin_flag[log_errors] = on
php_admin_value[error_reporting] = E_ALL

第一行 php_admin_flag[log_errors] = on 是总开关，确保错误日志功能是开启的。

第二行 php_admin_value[error_reporting] = E_ALL 则决定了记录的详细程度。E_ALL 表示记录所有类型的错误和警告，这对于开发调试阶段非常有用。当然，在生产环境中，你可能会根据实际情况调整这个值，比如只记录严重错误。

第四步：保存更改并重启服务

完成所有配置项的修改后，保存并关闭 www.conf 文件。

最后一步，让配置生效。重新启动PHP-FPM服务：

sudo systemctl restart php{版本号}-fpm

同样，别忘了替换 {版本号}。例如，重启PHP 7.4的FPM服务，命令就是：

sudo systemctl restart php7.4-fpm

好了，大功告成！现在，PHP-FPM就会按照你的设定，将运行时的错误信息清晰地记录到指定的日志文件里了。下次排查问题，直接去那里看看就行。