monolog v2 要求 php ≥7.2，v3 要求 php ≥8.1；php 7.4 项目只能用 v2.10，8.2+ 才可安全升级 v3；需显式指定 exact 版本、补全 streamhandler 日志级别等构造参数，并检查间接依赖是否废弃。
monolog/monolog 版本迁移前必须检查 PHP 兼容性
Monolog v2 和 v3 对 PHP 版本要求不同：v2.x 支持 PHP ≥7.2，v3.x 要求 PHP ≥8.1。如果你项目 composer.json 中声明 "php": "^7.4"，却执行 composer require monolog/monolog:^3.0，Composer 会直接拒绝安装，报错类似 Your requirements could not be resolved。
正确做法是先确认当前环境：
- 运行
php -v看实际 PHP 版本 - 查
composer.json的require.php字段（不是系统 PHP，是项目声明的约束） - PHP 7.4 项目只能选
monolog/monolog:^2.10；PHP 8.2+ 才能安全上 v3
用 require 指定版本比 update 更可控
想从 v2.9 升到 v2.10？别直接 composer update monolog/monolog——它会按 composer.json 里写的 ^2.9 规则拉取最新匹配版，可能跳到 v2.11 或 v2.12，而你只想锁死 v2.10。
更稳妥的方式是显式指定：
-
composer require monolog/monolog:2.10.0—— 安装 exact 版本，composer.json里写死"monolog/monolog": "2.10.0"，无^无~ - 如果包已存在，加
--no-update先改配置，再手动composer update monolog/monolog，避免意外升级其他依赖 - 执行后立刻检查
composer.lock中monolog/monolog的version和source.reference，确认没被解析成dev-main
Handler 和 Formatter 必须重配，不能复用旧逻辑
Monolog v3 移除了部分 Handler 构造参数默认值，也调整了 LineFormatter 的行为。比如 v2 中这样写能跑：
围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论（Discussion）”部分——包括结果解读、与既往文献关联、阐释意外发现、界定研究局限性，以及撰写结论。当用户输入以下任一指令时也会自动触发该功能： - “write my discussion” - “help me discuss my findings” - “how do I compare to prior studies” - “write the limitations par
$handler = new \Monolog\Handler\StreamHandler('app.log');
$formatter = new \Monolog\Formatter\LineFormatter();
v3 会报错：StreamHandler 构造函数第二个参数（日志级别）不再可选；LineFormatter 第三个参数（是否启用颜色）默认为 false，CLI 下不加 true 就看不到高亮。
迁移时务必检查并补全：
-
StreamHandler必须传入第二参数，如\Monolog\Logger::INFO -
LineFormatter显式传参：new \Monolog\Formatter\LineFormatter(null, null, true, true)（最后两个true分别表示启用颜色和毫秒时间戳） - 若用了
RotatingFileHandler，v3 默认关闭日志压缩，要启用得手动调setFilenameFormat()并确保 zlib 扩展已加载
废弃警告不等于立即崩溃，但得查 Packagist 替代项
执行 composer update 时看到 Package monolog/monolog is abandoned？先别慌——Monolog 官方并未废弃自己，这个提示大概率来自某个**间接依赖**（比如你装了某个过时的封装包，它在 composer.json 里写了 "replace": {"monolog/monolog": "*"} 或标记了 abandoned）。
真正要做的不是删 Monolog，而是定位源头：
- 运行
composer depends monolog/monolog查谁在依赖它 - 对每个上游包，打开
https://packagist.org/packages/{vendor}/{package}，看右上角「Replaced by」字段 - 如果某个包写着 replaced by
psr/log，说明它只是提供接口，不用换；如果写着php-logging/logger，那才是真要迁移的目标
Monolog 本身仍是 PHP 日志事实标准，只要版本与 PHP 匹配、Handler 配置更新到位，v2 到 v3 的迁移就是一次参数补全和构造器校验，不是重构。最容易漏的是 StreamHandler 缺少日志级别参数，一跑就抛 ArgumentCountError。
