PHP框架如何配置日志级别与存储方式 PHP框架日志配置的操作教程-php教程-PHP中文网

PHP框架如何配置日志级别与存储方式 PHP框架日志配置的操作教程

爱谁谁

发布： 2025-08-12 20:49:01

原创

469人浏览过

laravel日志配置在config/logging.php中，通过修改channels数组中的level选项设置日志级别（如debug、info、error等），并选择single、daily、stack等driver指定存储方式，例如daily可设置days保留天数；2. symfony日志配置位于config/packages/monolog.yaml，通过handlers定义处理方式，设置level控制日志级别，并使用stream、console等handler指定输出路径或方式，支持参数如%kernel.logs_dir%动态生成路径；3. codeigniter 4日志配置在app/config/logger.php中，通过threshold数值控制记录级别（0为全部，1为error及以上），handlers数组配置处理类如filehandler并指定path存储路径；4. 自定义日志格式方面，laravel和symfony可在配置中设置formatter选项，codeigniter 4需继承lineformatter创建自定义格式化器；5. 代码中使用日志时，laravel用log::info()，symfony通过loggerinterface注入使用$info()，codeigniter 4调用log_message()函数；6. 配置不同日志级别可区分事件严重性，便于生产环境过滤无关信息；7. 不同环境日志配置可通过laravel的.env文件、symfony的环境化配置文件、codeigniter 4的环境专属logger.php实现；8. 日志轮转方面，laravel的daily驱动自动按天轮转并保留指定天数，symfony可使用rotatingfilehandler配置策略，codeigniter 4默认不支持需手动或借助第三方库实现。正确配置日志能显著提升应用调试与维护效率，确保问题可追溯。

PHP框架如何配置日志级别与存储方式 PHP框架日志配置的操作教程

PHP框架日志配置，简单来说，就是告诉框架，哪些错误或信息需要记录，以及记录到哪里。这直接影响到你调试和维护应用的效率。

配置日志级别和存储方式，实际上就是告诉你的PHP框架，什么等级的信息需要记录，以及把这些信息放到哪里。不同的框架，实现方式略有差异，但核心思路是相通的。

配置不同框架的日志，让问题无处遁形

立即学习“PHP免费学习笔记（深入）”；

Laravel框架的日志配置

Laravel的日志配置藏在

config/logging.php

登录后复制

里。打开这个文件，你会看到一个

channels

登录后复制

数组，每个channel代表一种日志输出方式。

配置日志级别: 在
```
channels
```
登录后复制
数组里，找到你想修改的channel（比如
```
stack
```
登录后复制
、
```
single
```
登录后复制
、
```
daily
```
登录后复制
等等），然后修改
```
level
```
登录后复制
选项。
```
level
```
登录后复制
可以是
```
debug
```
登录后复制
、
```
info
```
登录后复制
、
```
notice
```
登录后复制
、
```
warning
```
登录后复制
、
```
error
```
登录后复制
、
```
critical
```
登录后复制
、
```
alert
```
登录后复制
、
```
emergency
```
登录后复制
，级别从低到高。例如，如果你想记录所有
```
warning
```
登录后复制
级别及以上的日志，就设置
```
level
```
登录后复制
为
```
warning
```
登录后复制
。
配置存储方式: 同样在
```
channels
```
登录后复制
数组里，不同的channel对应不同的存储方式。
- ```
single
```
  登录后复制
  : 所有日志都写到一个文件里，适合小型项目。
- ```
daily
```
  登录后复制
  : 每天生成一个日志文件，方便管理。可以设置
```
days
```
  登录后复制
  选项，控制保留多少天的日志。
- ```
stack
```
  登录后复制
  : 允许你同时使用多个channel，比如同时输出到文件和Slack。
- ```
syslog
```
  登录后复制
  : 将日志发送到系统日志。
- ```
errorlog
```
  登录后复制
  : 使用PHP的
```
error_log
```
  登录后复制
  函数记录日志。
举个例子，如果你想使用
```
daily
```
登录后复制
模式，并且只保留7天的日志，可以这样配置：
```
'channels' => [
    'daily' => [
        'driver' => 'daily',
        'path' => storage_path('logs/laravel.log'),
        'level' => env('LOG_LEVEL', 'debug'),
        'days' => 7,
    ],
],
```
登录后复制
别忘了在
```
.env
```
登录后复制
文件中设置
```
LOG_LEVEL
```
登录后复制
，比如
```
LOG_LEVEL=debug
```
登录后复制
。

Symfony框架的日志配置

Symfony的日志配置在

config/packages/monolog.yaml

登录后复制

文件中。Monolog是Symfony默认使用的日志库。

配置handlers: 在
```
monolog.yaml
```
登录后复制
中，你会看到一个
```
handlers
```
登录后复制
配置项，类似于Laravel的
```
channels
```
登录后复制
。每个handler定义了一种日志处理方式。
配置日志级别: 在每个handler中，可以设置
```
level
```
登录后复制
选项。和Laravel一样，Symfony也支持
```
debug
```
登录后复制
、
```
info
```
登录后复制
、
```
notice
```
登录后复制
、
```
warning
```
登录后复制
、
```
error
```
登录后复制
、
```
critical
```
登录后复制
、
```
alert
```
登录后复制
、
```
emergency
```
登录后复制
这些级别。
配置存储方式: Symfony的handler种类非常多，可以灵活地配置存储方式。
- ```
stream
```
  登录后复制
  : 将日志写入文件。可以设置
```
path
```
  登录后复制
  选项指定文件路径。
- ```
console
```
  登录后复制
  : 将日志输出到控制台。
- ```
syslog
```
  登录后复制
  : 将日志发送到系统日志。
- ```
firephp
```
  登录后复制
  : 将日志发送到FirePHP插件，方便在浏览器中查看。
例如，你想把
```
error
```
登录后复制
级别及以上的日志写入
```
var/log/prod.log
```
登录后复制
文件，可以这样配置：

AI-Text-Classifier
OpenAI官方出品，可以区分人工智能书写的文本和人类书写的文本

59

查看详情
```
monolog:
    handlers:
        main:
            type: stream
            path: "%kernel.logs_dir%/%kernel.environment%.log"
            level: error
            channels: ["!event"]
```
登录后复制
这里的
```
%kernel.logs_dir%
```
登录后复制
和
```
%kernel.environment%
```
登录后复制
是Symfony的参数，分别代表日志目录和环境名称。

CodeIgniter 4框架的日志配置

CodeIgniter 4的日志配置在

app/Config/Logger.php

登录后复制

文件中。

配置threshold:
```
threshold
```
登录后复制
选项控制哪些级别的日志会被记录。它是一个数字，对应不同的日志级别。0表示不记录任何日志，1表示只记录
```
error
```
登录后复制
级别，2表示记录
```
error
```
登录后复制
和
```
debug
```
登录后复制
级别，以此类推。
配置handlers:
```
handlers
```
登录后复制
数组定义了日志处理方式。

配置存储方式: 默认情况下，CodeIgniter 4会将日志写入

writable/logs

登录后复制

目录下的文件中。你可以在

handlers

登录后复制

中配置自定义的存储方式。

例如，你想记录所有级别的日志，并将它们写入文件，可以这样配置：

public $threshold = 0; // 0表示记录所有日志

public $handlers = [
    'CodeIgniter\Logs\Handlers\FileHandler' => [
        'handles' => ['critical', 'alert', 'error', 'warning', 'notice', 'info', 'debug', 'emergency'],
        'path'  => WRITEPATH . 'logs/',
    ],
];

登录后复制

如何自定义日志格式？

除了配置日志级别和存储方式，自定义日志格式也很重要。不同的框架提供了不同的方式来实现。

Laravel: 可以在
```
config/logging.php
```
登录后复制
中，为每个channel配置
```
formatter
```
登录后复制
选项，指定一个自定义的日志格式化器。
Symfony: 可以在
```
monolog.yaml
```
登录后复制
中，为每个handler配置
```
formatter
```
登录后复制
选项，指定一个Monolog自带的或自定义的格式化器。
CodeIgniter 4: 可以通过继承
```
CodeIgniter\Logs\Formatters\LineFormatter
```
登录后复制
类，创建自定义的格式化器，并在
```
Logger.php
```
登录后复制
中配置使用。

如何在代码中使用日志？

配置好日志之后，就可以在代码中使用了。

Laravel: 使用
```
Log
```
登录后复制
facade。例如：
```
Log::info('User logged in', ['user_id' => $user->id]);
```
登录后复制
Symfony: 使用
```
Psr\Log\LoggerInterface
```
登录后复制
。可以通过依赖注入获取logger实例。例如：
```
$this->logger->info('User logged in', ['user_id' => $user->id]);
```
登录后复制

CodeIgniter 4: 使用

log_message()

登录后复制

函数。例如：

log_message('info', 'User logged in', ['user_id' => $user->id]);

登录后复制

注意，日志信息应该包含足够的信息，方便定位问题。可以包含用户ID、请求参数、时间戳等等。

为什么需要配置不同的日志级别？

不同的日志级别对应着不同严重程度的事件。

```
debug
```
登录后复制
: 调试信息，只在开发环境中使用。
```
info
```
登录后复制
: 一般信息，比如用户登录、订单创建等。
```
notice
```
登录后复制
: 重要事件，但不是错误。
```
warning
```
登录后复制
: 警告信息，可能预示着潜在的问题。
```
error
```
登录后复制
: 错误信息，表示发生了错误，但程序还可以继续运行。
```
critical
```
登录后复制
: 严重错误，可能导致程序崩溃。
```
alert
```
登录后复制
: 需要立即处理的错误。
```
emergency
```
登录后复制
: 系统不可用。

通过配置不同的日志级别，可以让你在生产环境中只关注重要的错误信息，避免被大量的调试信息淹没。

如何在不同环境中使用不同的日志配置？

通常，开发环境和生产环境需要不同的日志配置。

Laravel: 可以使用
```
.env
```
登录后复制
文件，为不同的环境设置不同的
```
LOG_LEVEL
```
登录后复制
。
Symfony: 可以使用不同的
```
monolog.yaml
```
登录后复制
配置文件，根据
```
kernel.environment
```
登录后复制
参数加载不同的配置。
CodeIgniter 4: 可以在
```
app/Config/
```
登录后复制
目录下创建不同的环境配置文件，比如
```
app/Config/Development/Logger.php
```
登录后复制
和
```
app/Config/Production/Logger.php
```
登录后复制
。

如何轮转日志文件？

长时间运行的程序会产生大量的日志，如果不进行轮转，日志文件会变得非常大，影响性能。

Laravel:
```
daily
```
登录后复制
channel会自动进行日志轮转。可以设置
```
days
```
登录后复制
选项控制保留多少天的日志。
Symfony: 可以使用Monolog的
```
RotatingFileHandler
```
登录后复制
，配置日志轮转策略。
CodeIgniter 4: 默认情况下，
```
FileHandler
```
登录后复制
不会自动轮转日志文件。需要手动配置或使用第三方库来实现日志轮转。