正确安装Monolog需先根据PHP版本选择命令：PHP 7.4–8.0执行composer require monolog/monolog:^2.9，PHP 8.1+执行composer require monolog/monolog:^3.0；安装后必须引入vendor/autoload.php，初始化Logger实例并为每个Handler显式调用pushHandler()、设置setLevel()级别阈值，且确保路径权限与命名空间正确。
Monolog 不需要手动下载或复制文件，直接用 Composer 安装并按需配置 Handler 和 Processor 就能支持 debug/info/warning/error 等多级日志输出。
如何用 Composer 正确安装 Monolog
别用 composer require monolog/monolog 无脑安装——默认会拉取最新版（v3+），而 v3 移除了 StreamHandler 的部分构造参数，且要求 PHP ≥ 8.1。如果你项目还在用 PHP 7.4 或 8.0，得显式指定兼容版本：
- PHP 7.4–8.0：运行
composer require monolog/monolog:^2.9 - PHP 8.1+：可用
composer require monolog/monolog:^3.0，但注意 v3 中StreamHandler构造函数第 3 个参数（file permission）已被移除 - 安装后检查
vendor/autoload.php是否存在，这是后续加载类的基础
怎么初始化一个支持多级别的 Logger 实例
Monolog 的级别控制不在 Logger 构造时设定，而是靠 Handler 的 setLevel() 或构造时传入最小接受级别。常见错误是只绑一个 Handler 却期望它过滤所有级别——实际上每个 Handler 可独立设置阈值：
- 用
Logger实例统一接收所有日志调用，比如$logger->info('user logged in')、$logger->error('DB connection failed') - 给不同 Handler 设置不同级别：例如
new StreamHandler('php://stdout', Logger::INFO)只输出 INFO 及以上；new StreamHandler('var/log/error.log', Logger::ERROR)只写 ERROR 及以上 - 别漏掉
use Monolog\Logger;和use Monolog\Handler\StreamHandler;，否则会报Class 'Logger' not found
为什么日志没按预期级别分开写入文件
最常踩的坑是 Handler 没加到 Logger 实例里，或者级别阈值设反了。Monolog 默认所有 Handler 都接收全部日志，除非你明确限制：
- 确认是否调用了
$logger->pushHandler($handler)，仅 new 出 Handler 是无效的 - 级别常量用
Logger::DEBUG、Logger::WARNING等，别手写字符串如'warning'—— 这会导致 Handler 直接忽略该条日志 - 如果用了
FingersCrossedHandler包裹其他 Handler，注意它默认只在触发 error 级别后才刷新缓冲日志，调试时容易误判“没输出” - 检查日志文件路径是否有写权限，尤其
var/log/目录在 CLI 和 Web 环境下用户可能不同（如 www-data vs cli user）
真正麻烦的是 Handler 之间的优先级和异步写入冲突，比如同时用 RotatingFileHandler 和 SyslogHandler 时，前者可能因文件锁阻塞后者。这类问题不会报错，但会导致日志丢失或延迟——得结合实际部署环境做压测验证。
