Symfony日志系统基于Monolog组件，通过配置handlers可将不同级别的日志输出到文件、控制台等目标。在config/packages/monolog.yaml中定义处理器，如生产环境记录错误日志到emergency.log，开发环境输出到console。使用LoggerInterface注入可在代码中记录info、warning、error等PSR-3标准级别日志。可通过channels隔离支付、API等特定日志，提升排查效率。合理设置日志级别与处理器（如fingers_crossed、syslog）可优化性能并对接集中式日志系统。
Symfony日志系统基于Monolog组件构建，提供了强大且灵活的日志记录功能。通过合理配置，可以将不同级别的日志输出到文件、控制台、数据库甚至远程服务。下面介绍如何在Symfony项目中配置和使用日志组件。
配置日志处理器（Handlers）
Symfony的日志行为主要由monolog配置决定，通常在config/packages/monolog.yaml中设置。你可以为不同环境定义不同的日志输出方式。
例如，在生产环境中将错误日志单独记录：
# config/packages/monolog.yaml
monolog:
handlers:
main:
type: stream
path: "%kernel.logs_dir%/%kernel.environment%.log"
level: debug
channels: ["!event"]
# 专门记录严重错误
emergency:
type: stream
path: "%kernel.logs_dir%/emergency.log"
level: error
# 开发环境下输出到console
console:
type: console
process_psr_3_messages: false
channels: ["!event", "!doctrine"]说明：
- type: stream 表示写入文件
-
path 指定日志文件路径，
%kernel.logs_dir%默认指向var/log - level 控制最低记录级别（从debug到critical）
- channels 可过滤特定频道的消息，如排除event或doctrine日志
使用日志服务记录消息
在控制器或服务中，可以通过依赖注入获取LoggerInterface来记录日志。
use Psr\Log\LoggerInterface;class MyController extends AbstractController { public function index(LoggerInterface $logger) { $logger->info('用户访问了首页', ['user_id' => 123]); $logger->warning('这是一个警告'); $logger->error('发生了一个错误');
return $this-youjiankuohaophpcnjson(['status' =youjiankuohaophpcn 'ok']); }}
支持的日志级别包括：debug, info, notice, warning, error, critical, alert, emergency，符合PSR-3标准。
自定义日志频道（Channels）
当需要隔离某类日志时（如支付、API调用），可创建独立频道。
# config/packages/monolog.yaml
monolog:
channels:
- payment
- api
然后在代码中使用特定频道：
use Symfony\Bridge\Monolog\Logger;public function pay(LoggerInterface $logger) { $paymentLogger = $this->get('monolog.logger.payment'); $paymentLogger->info('支付请求发起', ['amount' => 99.9]);
// 或通过channel名称注入}
常见配置技巧
-
开发环境启用
console处理器，便于调试 - 生产环境建议关闭debug级别日志以提升性能
- 敏感信息不要直接写入日志，避免泄露
- 可结合
fingers_crossed处理器实现“仅错误时才保存全部上下文” - 使用
syslog或gelf处理器对接集中式日志系统（如ELK）
基本上就这些。Symfony的Monolog集成非常成熟，只要掌握基本配置结构，就能满足大多数场景需求。不复杂但容易忽略的是频道划分和级别控制，合理设计能极大提升后期排查效率。
