如何使用Composer安装ThinkPHP日志包？

本文共计859个文字，预计阅读时间需要4分钟。

若您想在ThinkPHP项目中增强日志功能，例如支持结构化输出、多通道写入或PSR-3标准兼容，需要单独安装并集成日志扩展包。以下是对不同需求场景的安装与配置方法：

一、使用Composer安装Monolog日志库

Monolog是PHP生态中最主流的PSR-3兼容日志库，支持文件、Syslog、邮件、Slack等多种处理器，适用于需要高定制化日志行为的ThinkPHP项目。

1、确保项目根目录下已存在composer.json且Composer可执行，运行composer --version验证。

2、确认PHP版本满足要求：Monolog 2.x 需 PHP >=7.3，ThinkPHP 6.x 推荐搭配使用。

立即学习“PHP免费学习笔记（深入）”；

3、在ThinkPHP项目根目录（含think可执行文件及vendor目录）执行安装命令：

4、运行：composer require monolog/monolog:^2.10

5、安装完成后，检查vendor/monolog/monolog目录是否生成，且vendor/autoload.php可被正常引入。

二、启用ThinkPHP内置日志增强包（think-log）

think-log是专为ThinkPHP设计的日志增强扩展，提供自动上下文注入、请求ID追踪、JSON格式化等特性，无需修改核心日志逻辑即可插拔式启用。

1、进入项目根目录，执行：composer require topthink/think-log

2、安装后，该包会自动注册服务提供者，无需手动绑定容器。

3、在config/log.php中新增通道配置，例如启用带TraceID的JSON日志：

4、添加如下配置项至'channels'数组内：

5、'json_trace'=> ['type'=>'file','path'=>runtime_path('log'),'json'=>true,'trace_id'=>true],

6、在控制器中调用： hinkLog::channel('json_trace')->info('订单创建', ['order_id'=>12345]);

三、手动集成自定义日志处理器（无Composer环境）

当目标服务器无法联网或禁用Composer时，可采用手动方式引入轻量级日志类，绕过依赖管理直接部署。

1、下载PsrLogLoggerInterface最小实现（如slimphp/log精简版），解压至extend/log/目录。

2、在app/common.php中添加自动加载映射：

3、Loader::addNamespace('Psr\Log', APP_PATH . '../extend/log/Psr/Log');

4、创建app/library/CustomLogger.php，实现PsrLogLoggerInterface接口并封装文件写入逻辑。

5、在应用初始化阶段（如app/provider.php）将其实例绑定至容器：

6、 hinkContainer::getInstance()->bind('logger', CustomLogger::class);

四、切换默认日志驱动为Swoole协程日志（适用于Swoole Server模式）

在基于Swoole常驻内存运行ThinkPHP时，原生文件日志可能因并发写入冲突导致丢日志，需改用线程安全的协程日志驱动。

1、安装Swoole扩展并确认php --ri swoole输出中显示已启用。

2、执行：composer require topthink/think-swoole

3、发布配置：php think swoole:publish

4、编辑config/swoole.php，将'log_channel'设为'swoole_file'。

5、确保runtime/log目录对swoole进程用户（如www-data）具有rw权限。

6、启动服务：php think swoole，日志将通过Swoole异步IO写入，避免阻塞主协程。