composer如何安装并在PHP项目中使用Monolog日志库_composer实战【详解】

执行 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 'MonologLogger' not found。别手动 include 单个类文件，那是反模式。

require __DIR__ . '/vendor/autoload.php';  use MonologLogger; use MonologHandlerStreamHandler;  $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 是重大变更：默认不再提供 MonologHandlerStreamHandler 的构造函数自动创建流上下文，且 Logger::addRecord() 签名变动。升级前必须读 UPGRADE.md。

• v3 中 StreamHandler 构造函数第三个参数从布尔值改为 StreamHandler::WRITE_USE_FLOCK 等常量
• 若代码里用了已被移除的 MonologFormatterLineFormatter 的某些旧参数，会触发 TypeError
• CI 环境中未锁定版本（"monolog/monolog": "^3"）极易因自动升版导致线上日志中断

Monolog 的核心复杂点不在安装，而在 Handler 生命周期管理与多环境日志路由设计——比如开发环境输出到 console，生产环境写文件+推 sentry，这些逻辑一旦耦合在业务代码里，后续就很难解耦。别省那几行封装，早建一个 LoggerFactory 类。