如何在Linux上配置PHP的日志级别

作者：WarmHope 时间：2026-07-06 来源：正软商城浏览：0

在Linux上配置PHP日志级别需编辑php.ini，设置error_reporting、display_errors、log_errors及error_log。生产环境应关闭display_errors，开启log_errors并指定日志路径。修改后重启Web服务器或PHP-FPM使配置生效。

在Linux上配置PHP的日志级别，本质上还是得跟php.ini这个配置文件打交道。别看操作步骤不多，但每个环节都有讲究，漏掉一个细节都可能让调试变得事倍功半。下面直接进入正题。

如何在Linux上配置PHP的日志级别

先找到php.ini文件。实际路径取决于你的服务器环境：Apache下通常位于/etc/php/{php_version}/apache2/，CLI命令行模式则在/etc/php/{php_version}/cli/。这里的{php_version}请替换为你实际安装的版本号，比如7.4或8.1。

如果一时半会儿找不到确切位置，可以用这条命令快速定位：
```
php --ini
```
找到文件后，用你顺手的文本编辑器打开。以nano为例：
```
sudo nano /etc/php/{php_version}/apache2/php.ini
```
记得把{php_version}换成真实的PHP版本号。
在php.ini里找到下面这几行（它们通常集中在一处，方便统一管理）：
```
;error_reporting = E_ALL
;display_errors = Off
;log_errors = On
;error_log = /var/log/php_errors.log
```
注意行首的分号表示注释，实际生效时需要去掉分号。这几行分别控制了：错误报告级别、是否在浏览器输出错误、是否记录错误日志、以及日志文件的存放路径。
根据需求修改这些参数。这里有几个关键点需要说明：
- error_reporting：这是日志级别的核心。如果只想看到致命错误，设成E_ERROR；如果要在开发阶段捕获所有错误（包括警告和通知），保留E_ALL即可。生产环境建议使用E_ALL & ~E_DEPRECATED & ~E_STRICT，既能记录大部分问题，又不会被废弃提示刷屏。
- display_errors：生产环境必须设为Off，避免把敏感信息暴露给用户。开发环境可以临时设为On方便调试，但上线前一定要改回来。
- log_errors：通常设为On，否则配置了日志路径也没意义。
- error_log：指定日志文件的绝对路径。注意PHP进程（如www-data用户）需要对目标目录有写权限，否则日志不会生成。
举个例子，一个典型的生产环境配置长这样：
```
error_reporting = E_ALL
display_errors = Off
log_errors = On
error_log = /var/log/php_errors.log
```
保存并关闭文件。这一步没什么悬念，但别忘了检查语法——如果改错了参数名或漏了分号，PHP可能直接罢工。
重启Web服务器让配置生效。Apache用户执行：
```
sudo systemctl restart apache2
```
如果用的是Nginx + PHP-FPM组合，则需要重启PHP-FPM再重启Nginx：
```
sudo systemctl restart php{php_version}-fpm
sudo systemctl restart nginx
```
同样，{php_version}要换成实际版本号。