Composer怎么安装Monolog日志_Composer Monolog日志教程【必备】-composer-PHP中文网

直接运行 composer require monolog/monolog 即可安装，但必须配置 handler、传入非空 name 参数、确保 php 版本兼容（v2≥7.2，v3≥8.1），并设置 formatter，否则日志无法输出。

composer怎么安装monolog日志_composer monolog日志教程【必备】

直接运行 composer require monolog/monolog 就能装上，但不配 Handler、不传 name、不检查 PHP 版本，90% 的人会卡在“写了日志却看不到”这一步。

为什么 `composer require monolog` 会失败

命令里漏掉 /monolog 是最常见错误——monolog 本身不是包名，monolog/monolog 才是官方唯一有效包名。其他如 monolog-core、php-log 都不存在或已废弃。

执行前先确认当前目录是项目根目录（含 composer.json 或准备生成它）
运行 php -v 查 PHP 版本：Monolog v2.x 要求 ≥7.2，v3.x 要求 ≥8.1；若版本不符，composer require monolog/monolog:^3.0 会直接报 Your requirements could not be resolved
国内用户常因源慢超时，可临时加 -vvv 看卡点，或换镜像：composer config -g repo.packagist composer https://packagist.phpcomposer.com
装完立刻检查 vendor/monolog/monolog/src/Monolog/Logger.php 是否存在，比看终端输出更可靠

`new \Monolog\Logger()` 必须传 `name` 参数

Logger 构造函数的 name 不是可选参数，PHP 8+ 下传空字符串或 null 会直接抛 ArgumentCountError。这个 name 是 channel 名，影响日志路由、分类和调试上下文识别。

Discussion Composer

围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论（Discussion）”部分——包括结果解读、与既往文献关联、阐释意外发现、界定研究局限性，以及撰写结论。当用户输入以下任一指令时也会自动触发该功能： - “write my discussion” - “help me discuss my findings” - “how do I compare to prior studies” - “write the limitations par

下载

必须写成 new \Monolog\Logger('app')，不能是 new \Monolog\Logger('') 或 new \Monolog\Logger(null)
多个 Logger 实例建议用不同 name，比如 'db'、'api'，方便后期分流处理
避免空格或特殊符号（如 'user login'），某些 Handler（如 SyslogHandler）会因此出错

没加 `Handler` 就等于没写日志

Logger 只负责格式化和分发，不负责写入。不调 pushHandler()，哪怕调了 $logger->info('hello')，也什么都不会出现在文件、控制台或系统日志里。

开发阶段首选 StreamHandler：$logger->pushHandler(new \Monolog\Handler\StreamHandler(__DIR__.'/logs/app.log', \Monolog\Logger::INFO))
务必确保 logs/ 目录存在，且 Web 服务器用户（如 www-data）有写权限，否则静默失败（无报错，日志就是不出现）
Handler 的第二个参数是最低记录级别：Logger::INFO 表示只记录 info 及以上（notice、warning、error…），别设成 ERROR 却只调 info()，结果日志全被过滤
别漏 setFormatter()，否则默认输出 JSON，人眼难读；加个 LineFormatter 更实用：$handler->setFormatter(new \Monolog\Formatter\LineFormatter(null, null, true, true))

线上环境必须用 `RotatingFileHandler` 防磁盘撑爆

StreamHandler 会把所有日志追加进同一个文件，跑几天就几 GB，线上绝对不能用。Monolog v2 支持 RotatingFileHandler，v3 已移除，改用外部轮转方案，所以生产环境请锁定 v2。

安装时显式指定：composer require monolog/monolog:^2.10
按天轮转示例：new \Monolog\Handler\RotatingFileHandler(__DIR__.'/logs/app.log', 7, \Monolog\Logger::INFO)，第三个参数 7 表示最多保留 7 天日志
注意：v3 中 RotatingFileHandler 已废弃，强行用会报类不存在；如必须用 v3，请搭配 WhatEverHandler + 定时脚本做归档
轮转 Handler 同样要检查目录权限和 setFormatter，否则日志内容不可读或写入失败

真正容易被忽略的是 Handler 和 Formatter 的组合逻辑——Logger 是调度中心，Handler 是执行者，Formatter 是翻译官。三者缺一不可，且顺序不能乱：先 new Handler，再 setFormatter，最后 pushHandler。漏掉任一环，日志就停在半路。