执行 composer require monolog/monolog 前需确认：当前目录为项目根目录、已安装 Composer、PHP 版本匹配（v2≥7.2/v3≥8.0）、避免中文路径；安装后须引入 vendor/autoload.php 并正确配置 Handler 与日志级别。
直接用 composer require monolog/monolog 就能装上，但实际项目里光装上远远不够——路径自动加载、日志级别控制、Handler 配置错误都会导致写不进日志或报错。
执行 composer require monolog/monolog 前要确认什么
确保当前目录是 PHP 项目的根目录（即包含 composer.json 或准备生成它的位置），且已安装 Composer 并可执行 composer --version。Windows 用户注意不要在 Git Bash 里用中文路径，否则可能触发 file_put_contents(): Invalid path 类错误。
- 如果项目还没初始化 Composer，先运行
composer init或composer install（已有composer.lock时） - PHP 版本需 ≥ 7.2（Monolog v2）或 ≥ 8.0（v3），检查用
php -v - 避免在系统全局 PHP 环境下混用多个 Composer 版本，优先用
php composer.phar显式调用
安装后如何在 PHP 脚本中正确引入并创建 Logger 实例
Composer 安装后会自动生成 vendor/autoload.php，必须在使用 Monolog 前 require 它；否则会报 Class 'Monolog\Logger' not found。别手动 include 单个类文件，那是反模式。
require __DIR__ . '/vendor/autoload.php';
use Monolog\Logger;
use Monolog\Handler\StreamHandler;
$log = new Logger('my_app');
$log->pushHandler(new StreamHandler(__DIR__ . '/var/log/app.log', Logger::WARNING));
$log->warning('用户登录失败', ['user_id' => 123, 'ip' => $_SERVER['REMOTE_ADDR']]);
-
StreamHandler的第二个参数是日志级别阈值，WARNING表示只记录 WARNING 及更严重（ERROR、CRITICAL）的日志 - 确保
var/log/目录存在且 Web 服务器有写权限，否则抛出UnexpectedValueException - 不要在循环里反复 new Logger，应复用实例或用工厂封装
常见 Handler 选型与配置陷阱
Monolog 默认不带 RotatingFileHandler 或 SyslogHandler，得按需额外 require 扩展包；而误配 Handler 参数会导致静默失败（没报错也没日志）。
立即学习“PHP免费学习笔记（深入）”；
- 按天轮转日志：需先
composer require monolog/monolog:^2.0（v2 支持），再用RotatingFileHandler，v3 已移除该 Handler，改用WhatEverHandler+ 外部脚本 - Syslog 写入失败时通常无提示，检查
openlog()是否被禁用（disable_functions配置项） - 用
TestHandler（仅测试用）时，记得调用$handler->getRecords()拿数据，它不会落盘 - 多个 Handler 共存时，每个 Handler 自己的 level 设置独立生效，不是取交集
为什么 composer update monolog/monolog 后日志突然不写了
v2 升 v3 是重大变更：默认不再提供 Monolog\Handler\StreamHandler 的构造函数自动创建流上下文，且 Logger::addRecord() 签名变动。升级前必须读 UPGRADE.md。
- v3 中
StreamHandler构造函数第三个参数从布尔值改为StreamHandler::WRITE_USE_FLOCK等常量 - 若代码里用了已被移除的
Monolog\Formatter\LineFormatter的某些旧参数，会触发TypeError - CI 环境中未锁定版本（
"monolog/monolog": "^3"）极易因自动升版导致线上日志中断
Monolog 的核心复杂点不在安装，而在 Handler 生命周期管理与多环境日志路由设计——比如开发环境输出到 console，生产环境写文件+推 Sentry，这些逻辑一旦耦合在业务代码里，后续就很难解耦。别省那几行封装，早建一个 LoggerFactory 类。
