需通过Composer安装Monolog并配置：一、确认PHP≥7.3且Composer可用；二、执行composer require monolog/monolog:^2.10；三、可选手动绑定容器、封装单例工具类或使用think-monolog扩展。
如果您希望在ThinkPHP项目中集成Monolog日志库以增强日志记录能力，则需通过Composer安装并正确配置。以下是实现该目标的具体步骤：
一、确认环境与Composer可用性
Monolog 2.x 要求 PHP 版本不低于 7.3，且必须确保 Composer 已全局安装并可执行命令行调用。环境不满足将导致依赖无法加载或运行时类找不到。
1、在终端中执行 php -v，确认输出版本号 ≥ 7.3。
2、执行 composer --version，验证 Composer 是否已安装并返回有效版本信息。
立即学习“PHP免费学习笔记（深入）”；
3、若提示“command not found”，需访问 https://getcomposer.org/download/ 下载并完成安装，Windows 用户需额外检查 CLI 模式下的 php.ini 是否启用 mbstring、openssl、pdo 扩展。
二、使用Composer安装Monolog核心包
Monolog 是独立 PSR-3 兼容库，无需 ThinkPHP 专用扩展即可直接引入。安装后所有类将由 Composer 自动加载，无需手动 require。
1、进入 ThinkPHP 项目根目录（即包含 think 目录与 composer.json 的路径）。
2、运行命令：composer require monolog/monolog:^2.10，指定稳定版约束以避免兼容风险。
3、安装完成后，确认 vendor/monolog/monolog 目录存在，且 vendor/autoload.php 可被正常引入。
三、方式一：手动初始化并绑定至容器
绕过 ThinkPHP 默认日志驱动，通过代码显式创建 Monolog 实例，并注册进容器供全局获取，适用于对日志行为有精细控制的场景。
1、在 app/common.php 或应用初始化文件顶部添加：require_once __DIR__ . '/../vendor/autoload.php';
2、实例化 Logger：$logger = new \Monolog\Logger('thinkphp');
3、添加 RotatingFileHandler（推荐生产环境）：$logger->pushHandler(new \Monolog\Handler\RotatingFileHandler('../runtime/log/app.log', 30, \Monolog\Logger::INFO));
4、绑定至容器：\think\Container::getInstance()->bind('monolog', function() use ($logger) { return $logger; });
四、方式二：封装为单例工具类
将 Monolog 实例管理逻辑集中封装，支持多通道、多处理器、自动目录创建与格式化，避免重复初始化开销，提升复用性与可维护性。
1、在 app/common/monolog/MonologUtil.php 创建工具类，命名空间设为 app\common\monolog。
2、类内定义静态方法 getLogger($channel = 'app', $logPath = '', $isStream = false)，内部实现单例缓存与目录自动创建逻辑。
3、使用 RotatingFileHandler 替代 StreamHandler，并设置 LineFormatter 启用 trace 与上下文输出：
4、在控制器中调用：$log = \app\common\monolog\MonologUtil::getLogger('api', 'api');，随后使用 $log->info('request received', ['ip' => $request->ip()]);
五、方式三：使用第三方扩展包 think-monolog
该扩展为 ThinkPHP 3.2/5.x/6.x 提供开箱即用的 Monolog 集成，已预置 StreamHandler 并封装静态调用接口，适合快速上线且无需深度定制的项目。
1、执行命令：composer require normal/think-monolog:dev-master（注意适配当前 TP 版本分支）。
2、安装后无需额外初始化，可直接在任意位置调用：\normalcoder\Think\Logger::error('DB connection timeout');
3、如需自定义 Handler，创建 Behavior 类（如 app/common/behavior/MonologBehavior.php），在 run 方法中调用 Logger::getLogger() 获取实例并动态替换 Handler。
4、注意：SHOW_PAGE_TRACE 设为 true 时，框架将禁用 trace 日志写入，启用该扩展后默认关闭 trace 记录以保障兼容性。
