在ThinkPHP 5.1中引入Monolog替代默认日志系统是合理选择，需安装monolog/monolog:^2.10、手动封装Logger类、迁移配置项并保持格式兼容。

ThinkPHP 5.1 默认日志系统轻量但扩展性有限，若你希望增强日志能力（如按天轮转、JSON 格式、上下文追踪、远程投递），用 Monolog 替换是合理选择。这不是“升级 TP 版本”，而是**在 TP5.1 框架内引入 Monolog 作为底层日志驱动**，保留原有调用习惯或逐步迁移。 以下分四部分说明关键操作和注意事项：

确认兼容性与安装方式

TP5.1 基于 PHP 7.1+，Monolog 2.x 完全支持（推荐 monolog/monolog:^2.10）。执行：

• composer require monolog/monolog:^2.10
• 确保 runtime/log/ 目录可写（Web 服务器用户有读写权限）
• TP5.1 不依赖容器自动绑定，所以无需修改 app.php providers，只需手动初始化

封装 Monolog 实例并替换 Log::write()

TP5.1 的 Log::write() 是静态方法，不能直接替换为 Monolog 对象。建议新建一个日志服务类（如 app/common/Logger.php），统一管理：

ThinkPHP5.1企业站点快速开发-源码课件

ThinkPHP5.1企业站点快速开发

下载

• 构造时创建 Monolog\Logger 实例，并添加 RotatingFileHandler（按天轮转，避免单文件膨胀）
• 用 LineFormatter 或 JsonFormatter 输出结构化日志
• 提供静态方法 info()、error() 等，签名与 TP5.1 一致（$message, $context = []）
• 旧代码中把 Log::write('xxx', 'error') 改为 Logger::error('xxx')，平滑过渡

配置项迁移要点

TP5.1 的 config/log.php 中原参数（如 max_files、file_size）对 Monolog 无效。需改由处理器控制：

• RotatingFileHandler 的第 2 个参数是保留天数（如 7），不是字符串
• 日志级别用 \Monolog\Logger::ERROR 常量，不是字符串 'error'
• 路径统一用 Env::get('root_path') . 'runtime/log/'，避免硬编码
• 不建议用 StreamHandler 写单文件——线上环境必须轮转

保留原有行为的技巧

为减少改动成本，可让 Monolog 日志格式尽量贴近 TP5.1 默认输出：

• 使用 LineFormatter，格式设为 [{datetime}] {level_name}: {message} {context}
• 开启 include_stacktrace 仅用于开发环境（性能敏感）
• 若需 trace_id，可在请求入口生成唯一 ID（如 uniqid('req_')），通过 Processor 注入到每条日志的 $context
• 错误日志仍可触发 think\exception\Handle 的异常捕获逻辑，只需在异常处理器里调用你的 Logger::error()