monolog扩展不能直接用monolog/monolog打包所有处理器，因其仅含核心抽象与基础handler（如streamhandler），redis/elasticsearch等高级handler已拆分为独立包以降低体积和autoload开销；需按需安装兼容版本扩展包。
Monolog扩展为什么不能直接用monolog/monolog包装一堆处理器？
因为官方monolog/monolog只提供核心抽象和基础处理器（如StreamHandler、NullHandler），像RedisHandler、ElasticsearchHandler、SyslogUdpHandler这些都拆到了独立包里。硬塞进主包会拉高依赖体积和加载开销，尤其对无用功能做autoload扫描是浪费。
实操建议：
- 按需安装扩展包，例如需要写入Redis：运行
composer require monolog/monolog:^2.0 monolog/monolog-redis-handler - 注意版本兼容性——
monolog/monolog-redis-handler2.x 只支持 Monolog 2.x；Monolog 3.x 的扩展包命名和接口有变化，目前（2024）多数第三方扩展尚未适配 - 别在
require-dev里装生产用的处理器，否则部署时可能漏掉
多个处理器共存时，如何避免Logger实例被重复初始化？
常见错误是每个模块自己new Logger()再pushHandler()，结果日志混发、层级错乱、甚至内存泄漏（Handler带闭包或资源句柄时）。
正确做法是集中初始化一次Logger，然后复用：
- 用工厂类或DI容器统一创建，例如
LoggerFactory::create('app')返回已预设StreamHandler+RotatingFileHandler+SlackWebhookHandler的实例 - 确保所有Handler的
$level参数不重叠冲突，比如StreamHandler设Logger::WARNING，SlackWebhookHandler设Logger::ERROR，避免警告消息刷屏 - 若用
HandlerWrapper（如FingersCrossedHandler）套多层，注意嵌套深度——PHP栈有限，3层以上易触发Allowed memory size exhausted
monolog/monolog-redis-handler连不上Redis？检查这三处
这个包默认依赖predis/predis，但很多项目实际用phpredis扩展。Composer装完不配置，RedisHandler会静默失败，日志消失且无报错。
排查步骤：
- 确认已启用
phpredis扩展：php -m | grep redis；若没输出，要么改用predis（composer require predis/predis），要么编译加载phpredis - 构造
RedisHandler时传入的$redis实例必须是Predis\Client或Redis原生类，不能是字符串连接串 - Redis服务器需开启
notify-keyspace-events（仅限某些监听场景），但普通写入不需要；如果用哨兵或集群，Predis\Client配置项要显式指定'replication' => 'sentinel'等，不能只填host
升级到Monolog 3后，Logger::pushHandler()还能用吗？
能用，但行为变了：Monolog 3废弃了HandlerInterface::handle()的返回值语义，改为强制返回bool（是否已处理），且pushHandler()不再自动调用reset()。这意味着旧代码里靠返回false来“跳过后续Handler”的逻辑会失效。
迁移要点：
- 把
return false改成抛出MissingExtensionException或改用FilterHandler包装 - 原来靠
pushHandler()顺序控制优先级的，现在得显式用HandlerStack管理，例如$stack->push(new StreamHandler(...), 'file') - 第三方扩展包如
monolog/monolog-syslog-handler尚未发布v3兼容版，强行升级会导致Class not found，务必先查packagist上对应扩展的requires字段
Monolog的Handler生态是松散耦合的，集成复杂度不在代码量，而在各扩展包的生命周期管理和错误静默机制——一个Handler初始化失败，很可能让整条日志链路静默丢弃，而不是报错中断。这点比性能更值得花时间盯住。
