PHP日志管理：Monolog多通道与轮转技巧

本文深入讲解了如何利用Monolog在PHP项目中实现专业级日志管理——通过构建错误、调试、访问三大独立日志通道，分别采用按文件大小轮转（保障错误日志可追溯性）、按日期轮转（便于按天归档调试信息）以及独立Logger+请求上下文注入（精准记录访问行为）等策略，真正实现日志的分类隔离、格式统一与自动化运维，让PHP应用的日志既清晰可控又高效可靠。

如果您在PHP项目中需要将不同类型的日志（如错误、调试、访问）分别写入独立文件，并自动按大小或时间进行轮转，则Monolog库提供了标准化的多通道与轮转能力。以下是实现该功能的具体方法：

一、安装Monolog并初始化基础Logger

Monolog通过Composer管理依赖，安装后可创建多个Handler实例绑定到同一Logger或多个独立Logger，从而实现通道分离。每个通道对应独立的输出目标与轮转策略。

1、在项目根目录执行命令安装Monolog：composer require monolog/monolog。

2、创建主日志器实例：$logger = new \Monolog\Logger('app');。

3、为后续各通道准备独立的Formatter，例如使用LineFormatter适配文件输出：$formatter = new \Monolog\Formatter\LineFormatter(null, null, true, true);。

二、配置错误通道：按大小轮转的Error Handler

该通道专用于记录ERROR及以上级别日志，使用RotatingFileHandler按文件大小切分，保留最近5个归档文件。

1、实例化RotatingFileHandler，设置路径、最大文件数和单文件上限：$errorHandler = new \Monolog\Handler\RotatingFileHandler('/var/log/app/error.log', 5, \Monolog\Logger::ERROR);。

2、为该Handler设置格式器：$errorHandler->setFormatter($formatter);。

3、将Handler添加至Logger：$logger->pushHandler($errorHandler);。

三、配置调试通道：按日期轮转的Debug Handler

该通道专用于DEBUG与INFO级别日志，使用StreamHandler配合DailyRotatingFileHandler（需自定义或使用第三方扩展），但Monolog原生支持DailyRotatingFileHandler需v2.0+，此处采用内置DailyRotatingFileHandler替代。

1、确认Monolog版本不低于2.0：composer show monolog/monolog。

2、创建DailyRotatingFileHandler实例，指定日志路径、保留天数及最低日志等级：$debugHandler = new \Monolog\Handler\RotatingFileHandler('/var/log/app/debug.log', 7, \Monolog\Logger::DEBUG, true, null, false);。

3、覆盖默认轮转逻辑以启用按日切分：$debugHandler->setFilenameFormat('{filename}-{date}', 'Y-m-d');。

4、设置格式器并推入Logger：$debugHandler->setFormatter($formatter); $logger->pushHandler($debugHandler);。

四、配置访问通道：独立Logger与自定义通道名

为避免访问日志污染主Logger，单独创建一个Logger实例，仅绑定访问专用Handler，并使用Processor注入请求上下文信息。

1、新建独立Logger：$accessLogger = new \Monolog\Logger('access');。

2、创建StreamHandler指向访问日志文件：$accessHandler = new \Monolog\Handler\StreamHandler('/var/log/app/access.log', \Monolog\Logger::INFO);。

3、添加WebProcessor以自动注入URL、IP等字段：$accessLogger->pushProcessor(new \Monolog\Processor\WebProcessor());。

4、设置格式器并添加Handler：$accessHandler->setFormatter($formatter); $accessLogger->pushHandler($accessHandler);。

五、使用通道写入日志并验证轮转行为

各通道通过Logger名称或Handler绑定关系隔离，调用时需明确指定通道目标。轮转行为在写入时由Handler自动触发，无需手动干预。

1、向错误通道写入日志：$logger->error('Database connection failed', ['host' => 'db.example.com']);。

2、向调试通道写入日志：$logger->info('User logged in', ['user_id' => 123]);。

3、向访问通道写入日志：$accessLogger->info('Request completed', ['method' => 'GET', 'uri' => '/api/v1/users']);。

4、手动触发一次轮转测试（仅限RotatingFileHandler）：$errorHandler->close();，随后再次写入日志观察新文件生成。

好了，本文到此结束，带大家了解了《PHP日志管理：Monolog多通道与轮转技巧》，希望本文对你有所帮助！关注golang学习网公众号，给大家分享更多文章知识！