Ubuntu PHP日志记录级别怎么设置

在Ubuntu中精准调控PHP日志记录级别：方法与实战

在Ubuntu服务器上管理PHP应用，日志是你的“眼睛”。但你是否觉得，默认的日志信息要么过于嘈杂，要么遗漏了关键线索？其实，PHP日志的记录级别是可以根据你的需求精细调控的。具体怎么做，取决于你使用的是原生PHP、特定的Web服务器，还是现代化的应用框架。下面，我们就来梳理一下这几种主流场景下的设置方法。

1. 从源头把控：使用PHP配置文件（php.ini）

对于直接使用PHP内置日志功能的情况，修改php.ini文件是最根本的方法。这相当于给PHP引擎本身设定一个全局的“信息过滤器”。

1. 首先，打开终端，用你熟悉的编辑器（比如nano）打开对应的php.ini文件：

   sudo nano /etc/php/7.4/cli/php.ini

   请注意，这里的路径/etc/php/7.4/cli/是针对PHP 7.4的命令行版本。实际操作时，务必根据你系统上安装的PHP版本（如8.1、8.2）和运行模式（如fpm）调整路径。

2. 接下来，在文件中找到并调整这几个核心指令：

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

   这里的error_reporting就是控制日志级别的关键。你可以将它设置为不同的常量，来过滤不同严重程度的信息：

   • E_ALL：记录所有错误、警告和通知，信息最全，适合开发调试。
   • E_ERROR：只记录致命的运行时错误，适合追求简洁的生产环境。
   • E_WARNING：记录非致命的运行时警告。
   • E_NOTICE：记录运行时通知，提示一些不一定是错误但值得注意的情况。

3. 修改完成后，保存并退出编辑器。要让新配置生效，别忘了重启你的PHP服务。如果你用的是PHP-FPM，重启它：

   sudo systemctl restart php7.4-fpm

   如果使用的是Apache作为模块运行PHP，则需要重启Apache：

   sudo systemctl restart apache2

2. 借助Web服务器的力量：Apache与Nginx配置

当PHP通过Web服务器（如Apache或Nginx）运行时，日志记录也可以在这些服务器的层面进行配置，这提供了另一层灵活性。

Apache配置

Apache本身有强大的日志模块，可以精细控制其自身及模块（如mod_php）的日志级别。

1. 编辑Apache的主配置文件或你的虚拟主机配置文件：

   sudo nano /etc/apache2/apache2.conf

   或者

   sudo nano /etc/apache2/sites-a vailable/your-site.conf

2. 你可以调整LogLevel指令来设定日志详细程度。例如，以下设置将重写模块的日志级别调至跟踪级别，并将错误和访问日志分别输出：

   LogLevel alert rewrite:trace3
   ErrorLog ${APACHE_LOG_DIR}/error.log
   CustomLog ${APACHE_LOG_DIR}/access.log combined

3. 保存配置后，重启Apache服务使更改生效：

   sudo systemctl restart apache2

Nginx配置

Nginx本身不直接解析PHP，它通过FastCGI与PHP-FPM进程通信。因此，PHP的错误日志记录主要在PHP-FPM侧配置。

1. 编辑你的PHP-FPM进程池配置文件，通常路径如下：

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

2. 在文件中找到或添加以下几行关键配置：

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

   catch_workers_output允许捕获FPM工作进程的输出（包括错误信息），后两行则指定了错误日志的路径并开启了错误日志功能。

3. 配置完成后，重启PHP-FPM服务：

   sudo systemctl restart php7.4-fpm

3. 现代开发之道：使用应用程序或框架配置

如果你在使用Lara vel、Symfony这类现代PHP框架，它们通常拥有自己强大且统一的日志系统。在这些框架里配置日志级别，往往更符合应用开发的逻辑。

Lara vel框架

Lara vel的日志配置非常清晰。首先，打开config/logging.php配置文件，你会看到类似下面的设置：

'level' => env('LOG_LEVEL', 'debug'),

这意味着日志级别优先从环境变量LOG_LEVEL读取。因此，更常见的做法是在项目根目录的.env环境变量文件中进行设置：

LOG_LEVEL=debug

你可以将debug替换为info、warning、error等不同级别，以适应开发、测试、生产等不同环境。

Symfony框架

Symfony框架通常使用Monolog组件来处理日志。配置位于config/packages/monolog.yaml文件中。你可以这样定义主处理器的日志级别：

monolog:
    handlers:
        main:
            level: debug

同样，这里的level值可以根据环境需求调整为info、error等。

通过以上这些方法，从底层的PHP引擎到顶层的应用框架，你完全可以掌控PHP日志记录的信息粒度，让日志真正成为你排查问题、洞察系统运行状态的得力助手。