Logrotate可解决ThinkPHP日志未自动归档问题,需配置绝对路径、daily或size切割策略、copytruncate与postrotate脚本,并通过-d和-f命令验证调试。

如果您使用 ThinkPHP 应用部署在 Linux 服务器上,但 runtime/log/ 目录下的日志文件持续增长、未自动归档,导致磁盘空间告急,则很可能是日志未接入系统级轮转机制。Logrotate 是独立于 PHP 框架的稳定切割方案,无需修改应用代码即可实现按时间或大小自动分割、压缩与清理。以下是具体配置步骤:
一、确认 ThinkPHP 日志真实路径并创建 logrotate 配置文件
Logrotate 必须精确匹配日志文件的绝对路径,否则轮转将被跳过。ThinkPHP 默认日志位于 runtime/log/ 目录下,需先确认其完整路径(如 /www/wwwroot/myapp/runtime/log/ 或 /var/www/html/runtime/log/),再在 /etc/logrotate.d/ 下新建专属配置文件。
1、执行命令确认运行目录:pwd 或 php -r "echo realpath('./runtime/log/');"
2、进入配置目录:sudo cd /etc/logrotate.d/
立即学习“PHP免费学习笔记(深入)”;
3、新建配置文件(如 myapp-thinkphp):sudo nano myapp-thinkphp
4、写入以下基础配置(请将 /path/to/runtime/log/*.log 替换为实际路径):
二、配置每日切割策略(推荐用于低至中流量站点)
该策略每天触发一次轮转,适合日志量相对平稳、便于按日期追溯的场景。Logrotate 将在 cron.daily 执行时检查是否满足 daily 条件,并自动重命名当前日志文件。
1、在配置文件中填入以下内容:
/path/to/runtime/log/*.log {
daily
missingok
rotate 30
compress
delaycompress
notifempty
create 644 www www
copytruncate
}
2、关键参数说明:create 644 www www 表示新日志文件权限为 644,属主属组为 www(宝塔常用)或 www-data(Ubuntu 常用);copytruncate 确保不重启 PHP 进程即可清空原文件,避免写入中断。
三、配置按大小切割策略(推荐用于高写入频率站点)
当日志写入频繁、单日可能生成多个大文件时,仅靠 daily 可能导致单个文件超百 MB。启用 size 触发可更及时控制文件体积,防止突发流量撑爆磁盘。
1、将原配置中的 daily 替换为:size 10M(单位必须为 K/M/G,大小写敏感)
2、可同时保留时间维度控制,例如:daily size 10M —— 满足任一条件即触发切割
3、若需最小触发阈值,添加:minsize 5M,表示仅当文件大于 5MB 且到达 daily 时间点才切割
四、添加 postrotate 脚本确保 ThinkPHP 日志句柄刷新
ThinkPHP 使用 file_put_contents 等函数持续写入日志,Logrotate 默认 rename 操作可能导致 PHP 进程继续向已重命名的旧文件写入。通过 postrotate 发送信号或重载应用可强制其打开新日志文件,但 ThinkPHP 无内置 reload 接口,需采用兼容方式。
1、在配置块内追加以下脚本段:
postrotate
if [ -f "/path/to/runtime/log/app.log" ]; then
touch /path/to/runtime/log/app.log
fi
endscript
2、该操作利用 touch 更新文件时间戳,配合 ThinkPHP 的日志驱动自动检测机制(部分版本支持),可促使下一次写入前重建句柄;若无效,可改用强制清空后重建:echo "" > /path/to/runtime/log/app.log
五、验证配置语法并强制执行测试
配置完成后必须立即验证,不可等待次日 cron 自动运行,否则故障无法及时发现。调试模式可模拟全过程而不改动真实文件,是安全验证的必要步骤。
1、运行调试命令:sudo logrotate -d /etc/logrotate.d/myapp-thinkphp
2、观察输出中是否包含:considering log file /path/to/runtime/log/app.log 及 rotating log /path/to/runtime/log/app.log
3、确认无 error 或 skipping 提示后,执行强制轮转:sudo logrotate -f /etc/logrotate.d/myapp-thinkphp
4、检查结果:ls -l /path/to/runtime/log/ 查看是否生成 app.log.1 文件,且 app.log 是否为空或时间戳已更新



















