当前未启用支持轮转的日志处理器，需集成Monolog并配置RotatingFileHandler或TimedRotatingFileHandler实现按大小或时间归档，同时禁用ThinkPHP原生日志驱动以避免双写冲突。
如果您在ThinkPHP项目中发现日志文件持续增长、单个日志体积过大，且原生File驱动未自动归档，则说明当前未启用支持轮转的日志处理器。RotatingFileHandler并非ThinkPHP内置驱动，而是Monolog提供的标准轮转处理器，需通过集成Monolog并显式配置实现。以下是具体配置步骤：
一、安装Monolog依赖并引入自动加载
RotatingFileHandler属于Monolog组件，必须先通过Composer安装其核心库，并确保自动加载机制在ThinkPHP运行环境中生效。该步骤是后续所有配置的基础，缺失将导致类无法实例化。
1、在项目根目录执行命令安装Monolog：composer require monolog/monolog
2、确认vendor/autoload.php已正确加载：在ThinkPHP启动入口（如public/index.php或命令行start.php）顶部添加：require __DIR__ . '/../vendor/autoload.php';
立即学习“PHP免费学习笔记（深入）”；
3、验证安装成功：在任意控制器中临时执行class_exists('Monolog\Handler\RotatingFileHandler')，返回true即表示类可识别。
二、创建自定义日志初始化器并注册RotatingFileHandler
ThinkPHP默认日志系统不直接支持Monolog处理器，需绕过log.php驱动配置，改用代码方式构建Logger实例并注入框架日志门面。此方法可完全控制轮转策略，且不干扰原有配置结构。
1、在app/common.php或app/bootstrap.php中定义初始化函数：function init_monolog_rotating_logger() { ... }
2、在函数内创建Logger实例：$logger = new MonologLogger('thinkphp');
3、实例化RotatingFileHandler，指定路径、最大文件数与日志级别：$handler = new MonologHandlerRotatingFileHandler(runtime_path() . 'log/monolog_app.log', 30, MonologLogger::DEBUG);
4、设置LineFormatter以统一时间格式与字段顺序：$formatter = new MonologFormatterLineFormatter("[%datetime%] [%channel%.%level_name%] %message% %context% %extra% ", "Y-m-d H:i:s"); $handler->setFormatter($formatter);
5、将处理器推入Logger并设为ThinkPHP全局日志器： hinkLog::setLogger($logger);
三、配置按大小触发轮转的RotatingFileHandler参数
RotatingFileHandler默认按文件大小轮转，当当前日志文件达到阈值时自动重命名旧文件并新建空白文件。该机制适用于高频率写入场景，避免单次写入阻塞，但需精确设定maxBytes与backupCount以防止磁盘耗尽。
1、修改上一步中的RotatingFileHandler构造参数，显式传入maxBytes：$handler = new MonologHandlerRotatingFileHandler(runtime_path() . 'log/app.log', 7, MonologLogger::WARNING, true, 0644, 5242880);
2、其中末位参数5242880代表5MB（即5 × 1024 × 1024），超出此大小即触发轮转；7表示最多保留7个历史备份文件（app.log.1～app.log.7）。
3、确保runtime/log/目录具有PHP进程的写权限，否则轮转时会抛出Failed to write file异常。
四、配置按时间触发轮转的TimedRotatingFileHandler替代方案
若需严格按日期归档（如每日一个文件），应使用Monolog的TimedRotatingFileHandler而非RotatingFileHandler。该处理器基于系统时间判断是否轮转，支持D（天）、H（小时）、midnight（零点）等周期，更适合审计与排查。
1、替换处理器类名为MonologHandlerTimedRotatingFileHandler：$handler = new MonologHandlerTimedRotatingFileHandler(runtime_path() . 'log/app.log', 'D', 1, 30, null, true);
2、参数说明：'D'表示按天轮转，1表示间隔1天，30表示最多保留30个历史文件，最后一个true启用压缩归档（需zlib扩展）。
3、注意时区一致性：确保PHP运行环境的date.timezone与服务器系统时区一致，否则可能在23:59与00:01之间出现重复或遗漏轮转。
五、禁用ThinkPHP原生日志驱动并接管全部日志输出
为避免File驱动与Monolog双写冲突，必须彻底关闭ThinkPHP内置日志记录行为。否则将导致同一请求生成两份日志，且RotatingFileHandler无法控制File驱动产生的文件增长。
1、在config/log.php中将'type'设为'test'或任意无效类型：'type' => 'test',
2、将'level'设为空数组：'level' => [],
3、确认 hinkLog::record()调用被跳过：在任意位置插入dump( hinkLog::getLevel());，输出应为空数组。
4、此后所有日志必须通过Monolog实例发出，例如：$logger->info('User login success', ['uid' => 1001]);
