还记得那些年，在 PHP 项目中配置 Monolog 日志的经历吗？为了实现一个简单的文件日志，你可能需要实例化 Logger，然后添加一个 StreamHandler，再给它配一个 LineFormatter。如果项目需求稍微复杂一点，比如需要将错误日志发送到 Slack，同时将调试日志写入本地文件，并且还需要一个单独的审计日志记录到数据库，那整个配置过程就会变得异常繁琐。
复制粘贴的 Handler 实例化代码，硬编码的日志路径，以及每次需求变更时那令人头大的代码修改，都让日志配置成为了一项枯燥且容易出错的工作。特别是在大型应用或者微服务架构中，管理多个日志通道和不同的日志策略，简直是开发者的噩梦。
遇见救星：mimmi20/monolog-factory
就在我快要被这些重复劳动逼疯的时候，Composer 生态中的一位英雄——mimmi20/monolog-factory 出现了。它提供了一个强大的工厂模式，让你能够完全通过配置来构建 Monolog Logger 实例，彻底告别手写大量实例化代码的时代。
mimmi20/monolog-factory 的核心思想是：将 Monolog 的所有组件（Handler、Formatter、Processor）的创建和组装过程，从代码逻辑中抽离出来，转化为结构化的配置文件。这对于使用 Laminas 或 Mezzio 等依赖注入容器的框架来说，简直是天作之合，它能完美地与这些框架的配置系统融合。
安装与快速上手
通过 Composer 安装 mimmi20/monolog-factory 非常简单：
composer require mimmi20/monolog-factory
安装完成后，你需要在框架的配置目录（例如 config/autoload/logger.config.php）中添加相应的配置。
这是一个最简化的配置示例，它创建了一个名为 default 的日志器，并将所有日志写入到 /var/log/some-log-file.txt：
<?php
return [
'log' => [
'default' => [
'name' => 'my-app-logger', // 日志器的名称
'handlers' => [
'default' => [
'type' => 'stream', // 使用 StreamHandler
'options' => [
'stream' => '/var/log/some-log-file.txt', // 日志文件路径
'level' => \Psr\Log\LogLevel::DEBUG, // 最低记录级别
],
],
],
],
],
];通过这个配置，你就可以在应用中通过容器获取到这个配置好的 my-app-logger 实例，并开始记录日志了：
// 假设你通过依赖注入获取了 LoggerInterface 实例
$logger = $container->get('my-app-logger');
$logger->info('用户登录成功', ['user_id' => 123]);
$logger->error('数据库连接失败', ['exception' => $e->getMessage()]);灵活多变的日志策略
mimmi20/monolog-factory 的强大之处在于其无与伦比的灵活性。它几乎支持 Monolog 提供的所有 Handler、Formatter 和 Processor，并且都可以通过配置来组合使用。
1. 多种日志 Handler：
无论是将日志写入文件 (StreamHandler, RotatingFileHandler)，发送到 syslog (SyslogHandler, SyslogUdpHandler)，通过邮件发送警报 (NativeMailerHandler, SymfonyMailerHandler, SendGridHandler)，还是集成到 Slack (SlackWebhookHandler, SlackHandler)、Pushover (PushoverHandler) 等通知服务，甚至记录到 Redis (RedisHandler), MongoDB (MongoDBHandler), Elasticsearch (ElasticaHandler, ElasticsearchHandler) 等数据库，你都只需修改配置文件即可。
例如，添加一个 Slack 警报 Handler：
<?php
return [
'log' => [
'default' => [
'name' => 'my-app-logger',
'handlers' => [
'file_handler' => [
'type' => 'stream',
'options' => [
'stream' => '/var/log/my-app.log',
'level' => \Psr\Log\LogLevel::DEBUG,
],
],
'slack_alert_handler' => [
'type' => 'slackWebhook', // Slack Webhook Handler
'options' => [
'webhookUrl' => 'https://hooks.slack.com/services/T00000000/B00000000/XXXXXXXXXXXXXXXXXXXXXXXX',
'channel' => '#errors',
'userName' => 'Application Alerts',
'level' => \Psr\Log\LogLevel::ERROR, // 只有 ERROR 及以上级别才发送到 Slack
'bubble' => false, // 不再向上冒泡，避免重复处理
],
],
],
],
],
];2. 丰富的 Formatter 和 Processor：
你还可以为每个 Handler 指定不同的 Formatter，如 LineFormatter、HtmlFormatter、JsonFormatter 或 GelfMessageFormatter，以适应不同的日志存储和分析工具。同时，通过配置 Processor，可以自动为每条日志记录添加额外上下文信息，例如：
-
PsrLogMessageProcessor：处理 PSR-3 风格的日志消息，替换占位符。 -
IntrospectionProcessor：添加日志调用发生的文件、行号、类和方法。 -
WebProcessor：记录当前请求的 URI、方法和客户端 IP。 -
MemoryUsageProcessor：记录内存使用情况。 -
UidProcessor：为每条日志添加一个唯一的 ID。
这些都可以通过简单的配置来实现，而无需在代码中手动调用。
<?php
return [
'log' => [
'default' => [
'name' => 'my-app-logger',
'handlers' => [
'default' => [
'type' => 'stream',
'options' => [
'stream' => '/var/log/my-app.log',
'level' => \Psr\Log\LogLevel::DEBUG,
'formatter' => [ // 为此 Handler 配置 Formatter
'type' => 'json',
'options' => [
'prettyPrint' => true,
],
],
'processors' => [ // 为此 Handler 配置 Processor
['type' => 'psrLogMessage'],
['type' => 'web'],
],
],
],
],
'processors' => [ // 为所有 Handlers 配置全局 Processor
'uid_processor' => ['type' => 'uid'],
'memory_usage_processor' => ['type' => 'memoryUsage'],
],
],
],
];优势与实际应用效果
使用 mimmi20/monolog-factory 带来的好处是显而易见的：
- 告别硬编码，拥抱配置化管理： 所有的日志策略都集中在配置文件中，清晰明了，无需修改代码即可调整日志行为。
- 降低维护成本： 当日志需求变化时（例如从文件日志切换到 ELK 堆栈），只需修改配置，大大减少了代码改动和潜在的错误。
- 提升开发效率： 开发者可以专注于业务逻辑，将繁琐的日志配置交给工厂处理。
- 易于扩展： 可以轻松添加自定义的 Handler、Formatter 或 Processor，并将其集成到配置系统中。
- 统一日志策略： 在大型项目中，可以强制执行统一的日志标准和策略。
- 与框架无缝集成： 特别适合 Laminas 和 Mezzio 等框架，可以利用其强大的依赖注入容器能力。
总结
mimmi20/monolog-factory 极大地简化了 Monolog 在 PHP 应用中的配置和管理。它将强大的 Monolog 库与现代 PHP 框架的配置理念完美结合，让日志系统变得更加灵活、可维护和可扩展。如果你也曾被 Monolog 繁琐的配置所困扰，那么 mimmi20/monolog-factory 绝对值得一试，它将彻底改变你对日志配置的看法。从今天起，让你的日志管理变得轻松而优雅吧！
