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

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

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

   如果一时半会儿找不到确切位置，可以用这条命令快速定位：

   php --ini

2. 找到文件后，用你顺手的文本编辑器打开。以nano为例：

   sudo nano /etc/php/{php_version}/apache2/php.ini

   记得把{php_version}换成真实的PHP版本号。

3. 在php.ini里找到下面这几行（它们通常集中在一处，方便统一管理）：

   ;error_reporting = E_ALL
   ;display_errors = Off
   ;log_errors = On
   ;error_log = /var/log/php_errors.log

   注意行首的分号表示注释，实际生效时需要去掉分号。这几行分别控制了：错误报告级别、是否在浏览器输出错误、是否记录错误日志、以及日志文件的存放路径。

4. 根据需求修改这些参数。这里有几个关键点需要说明：

   • 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

5. 保存并关闭文件。这一步没什么悬念，但别忘了检查语法——如果改错了参数名或漏了分号，PHP可能直接罢工。

6. 重启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}要换成实际版本号。

到这里，PHP的日志级别就已经按照你的意图调整完毕了。不过要提醒一句：日志文件不会自己清理，日积月累可能会撑爆磁盘。建议配合日志轮转（logrotate）或定期检查日志大小，避免生产环境出现意外。之后记得勤看/var/log/php_errors.log，很多隐蔽的问题都藏在里面。