Ubuntu系统配置PHP-FPM错误日志记录方法

在Ubuntu上配置PHP-FPM错误日志记录

想让PHP-FPM在Ubuntu系统上乖乖记录错误日志吗？这事儿其实不复杂，关键在于找准配置文件并改对几个参数。下面这个分步指南，能帮你快速搞定。

第一步：打开终端

首先，你需要一个终端窗口。这没什么好说的，Ubuntu用户应该都很熟悉了。

第二步：定位并编辑PHP-FPM配置文件

核心操作从这里开始。PHP-FPM的主配置文件通常藏在这个路径下：/etc/php/{版本号}/fpm/pool.d/www.conf。记得把其中的{版本号}换成你实际使用的PHP版本，比如7.4或8.1。

接下来，用你顺手的文本编辑器打开它。这里以nano和vim为例：

sudo nano /etc/php/7.4/fpm/pool.d/www.conf

或者

sudo vim /etc/php/7.4/fpm/pool.d/www.conf

第三步：修改关键配置项

在打开的文件里，你需要找到下面这两行：

;error_log = /var/log/php-fpm/error.log
;catch_workers_output = yes

注意，它们很可能像上面一样，开头带着分号（;）。这个分号表示该行是注释，不起作用。你的任务就是删除这两个分号，让配置生效。

第四步：设置日志文件路径

取消error_log的注释后，你可以保留默认的/var/log/php-fpm/error.log路径，也可以把它改成任何你有写入权限的目录。例如：

error_log = /var/log/php-fpm/error.log

第五步：确保输出捕获已开启

下面这一行同样重要，它必须被设置为yes，PHP-FPM才能捕获到工作进程的输出信息并写入日志：

catch_workers_output = yes

第六步：保存并退出

完成上述修改后，保存文件并关闭编辑器。在nano里是按Ctrl+X，然后输入Y确认；在vim里则是:wq。

第七步：重启服务使配置生效

配置改完了，不重启服务可不行。运行以下命令来重启PHP-FPM（再次记得替换{版本号}）：

sudo systemctl restart php7.4-fpm

大功告成！

至此，所有设置就完成了。PHP-FPM会开始将错误信息记录到你指定的日志文件中。想实时查看日志动态？用这个命令就行：

sudo tail -f /var/log/php-fpm/error.log

以后排查PHP-FPM相关的问题，就有了清晰的线索。