ubuntu php-fpm怎样开启错误日志

ubuntu

小樊

2026-06-30 23:34:32

栏目: 编程语言

在 Ubuntu 下 PHP-FPM 的错误日志一般分两类：

PHP-FPM 自身的错误日志（php-fpm 进程启动、退出、警告等）
PHP 脚本错误日志（PHP 代码里的 error / warning / notice）

下面分别说明如何开启和配置。

一、PHP-FPM 自身错误日志（推荐先确认这个）

1️⃣ 找到 php-fpm 配置文件

Ubuntu 通常位于：

/etc/php/8.x/fpm/php-fpm.conf

（8.x 换成你的 PHP 版本，如 7.4 / 8.1 / 8.2 / 8.3）

2️⃣ 确认或添加错误日志路径

error_log = /var/log/php8.2-fpm.log

如果这行被注释了，取消注释即可。

3️⃣ 确认日志级别（可选）

log_level = notice

可选值：

alert
error
warning
notice（默认）
debug（调试用）

二、PHP 脚本错误日志（代码报错）

1️⃣ 编辑 php.ini（fpm 用的那个）

/etc/php/8.x/fpm/php.ini

2️⃣ 开启错误日志

log_errors = On
error_log = /var/log/php_errors.log

3️⃣ 是否显示错误（生产环境建议关闭）

display_errors = Off

4️⃣ 错误报告级别（可选）

error_reporting = E_ALL

三、创建日志文件并授权

sudo touch /var/log/php_errors.log
sudo chown www-data:www-data /var/log/php_errors.log
sudo chmod 644 /var/log/php_errors.log

www-data 是 Ubuntu 下 PHP-FPM 默认运行用户

四、重启 PHP-FPM

sudo systemctl restart php8.2-fpm

（版本号按实际情况）

五、查看日志

tail -f /var/log/php8.2-fpm.log
tail -f /var/log/php_errors.log

六、常见问题排查

✅ 1. 改了没生效？

改的是 fpm 的 php.ini，不是 cli 的
一定要 重启 php-fpm

✅ 2. 日志没写入？

ls -l /var/log/php_errors.log

确认权限和属主

✅ 3. 使用 Nginx？

Nginx 不会直接记录 PHP 错误，只看 PHP-FPM 日志

七、快速自检命令

php-fpm8.2 -t

如果配置正确，会显示：

configuration file /etc/php/8.2/fpm/php-fpm.conf test is successful

如果你愿意，可以告诉我：

PHP 版本
Ubuntu 版本
用的是 Nginx 还是 Apache

我可以帮你给出完全对应你环境的配置示例。