thinkphp日志按天分目录需继承file驱动重写getlogname()方法,动态创建y/m/d子目录并确保runtime目录写权限,同时调整日志清理策略以支持递归删除。

日志目录路径由 log_path 配置决定,但仅设路径不够
ThinkPHP 默认把所有日志写进 runtime/log/,不自动按天分目录。直接改 log_path 只能换根目录,比如设成 runtime/log/{date}/ 是无效的——框架不会解析其中的 {date} 占位符。
真正起作用的是日志驱动的 file 类中对 getLogName() 的实现逻辑。它默认拼出 Y-m-d.log 文件名,但目录结构仍固定。要按天分目录,必须干预日志文件的生成路径。
- 修改入口或配置文件中的
log_path为动态值(如在app/common.php或public/index.php中设置) - 确保
log_path末尾带斜杠,且有写入权限 - 推荐用
date('Y/m/d')构造子目录,避免单日日志过多导致同一目录下文件数爆炸
重写 getLogName() 方法才能实现“年/月/日”三级目录
ThinkPHP 6.x 使用 think\log\driver\File,其 getLogName() 返回完整路径+文件名。原生方法只拼文件名,目录靠 $this->config['path'] 控制。所以最稳妥的方式是继承该类并覆盖此方法。
示例:在 app/common/log/File.php 中定义:
namespace app\common\log;
use think\log\driver\File as BaseFile;
class File extends BaseFile
{
protected function getLogName(): string
{
$date = date('Y/m/d');
$path = $this->config['path'] . $date . '/';
if (!is_dir($path)) {
mkdir($path, 0755, true);
}
return $path . date('Y-m-d') . '.log';
}
}
然后在 config/log.php 中指定驱动:
'default' => 'file',
'drivers' => [
'file' => [
'type' => \app\common\log\File::class,
'path' => runtime_path() . 'log/',
// 其他配置保持不变
],
],
注意 path 配置和运行时权限的耦合问题
即使代码里做了 mkdir($path, 0755, true),如果 PHP 进程用户(如 www-data、nginx)对父目录没有写权限,创建子目录会失败,日志直接丢失且无报错提示——这是线上最常被忽略的坑。
- 检查
runtime/目录是否可写:ls -ld runtime,确认组/用户有w权限 - 不要依赖
chmod -R 777 runtime,应限定为chown -R www-data:www-data runtime+chmod -R 755 runtime - 若用宝塔、Docker 等环境,需额外确认容器卷挂载或面板用户隔离是否阻断了目录创建
- 开启
error_log或phpinfo()确认open_basedir没限制runtime/log路径
按天分目录后,日志清理策略必须同步调整
原来 ThinkPHP 自带的 clear_log 命令(php think clear:log)只清 runtime/log/ 下的文件,不会递归进 2024/06/15/ 这类子目录。放任不管会导致磁盘缓慢涨满。
有两种实用解法:
- 改写
clear:log命令,用RecursiveDirectoryIterator扫描所有*/*.log并按时间删除(推荐) - 更轻量:在
app/command/ClearLog.php中复用原逻辑,但将glob($path . '*.log')改为array_merge(glob($path . '*/*.log'), glob($path . '*/*/*.log')) - 生产环境建议加定时任务:
find /path/to/runtime/log -name "*.log" -mtime +30 -delete,比 PHP 清理更稳定
多级目录带来的路径碎片化,会让自动化运维变得更敏感——别只顾着写得漂亮,忘了后续怎么收场。
php免费学习视频:立即使用
踏上前端学习之旅,开启通往精通之路!从前端基础到项目实战,循序渐进,一步一个脚印,迈向巅峰!











