ThinkPHP 6.x 模型不支持原生滑动时间窗口统计,需用 date_format() 或 UNIX_TIMESTAMP() 手动构造时间维度并 group() 实现;whereTime() 固定日历切片且受数据库时区影响,易致数据错位或遗漏。

ThinkPHP模型里用group()和whereTime()做滑动时间窗口统计
直接说结论:ThinkPHP 6.x 的模型不支持原生“滑动窗口”分组(比如每24小时切一刀但起始点可偏移),必须靠date_format()或from_unixtime()手动构造日期维度,再配合group()实现近似效果。硬套whereTime('create_time', 'today')只能固定按日历日切片,没法滑动。
常见错误现象:whereTime('login_time', '>=', '-7 days') + group('date(login_time)') 看似能统计7天,但实际是按服务器本地日期分组——如果用户跨午夜活跃,同一次登录可能被拆到两天;更糟的是,凌晨0点后新一天开始,旧数据就不再计入“最近7天”,导致曲线跳变。
- 真正要滑动,得把时间转成“距今N天内”的整数天偏移,例如
floor((unix_timestamp() - unix_timestamp(create_time)) / 86400) - 或者用
date_format(create_time, '%Y-%m-%d')保证时区一致,但前提是数据库时区和应用层对齐 - ThinkPHP 6.1+ 支持
raw()写法:->field('date_format(create_time, "%Y-%m-%d") as day, count(*) as cnt'),再->group('day')
避免whereTime()和group()组合导致的时区错位
很多开发者以为whereTime('create_time', '>=', '-7 days')自动按当前时区算,其实它底层调的是 MySQL 的DATE_SUB(NOW(), INTERVAL 7 DAY),而NOW()返回的是数据库服务器时区时间——如果你的 DB 用 UTC,PHP 应用用 Asia/Shanghai,那这7天就少了8小时,凌晨活跃用户全被漏掉。
- 查清数据库时区:
SELECT @@time_zone;,不是SYSTEM就危险 - 统一方案:全部用 Unix 时间戳比较,
->where('create_time', '>=', time() - 7 * 86400),但注意create_time字段要是int类型;如果是datetime,得用->whereRaw('UNIX_TIMESTAMP(create_time) >= ?', [time() - 7 * 86400]) - 别信
whereTime('create_time', 'between', ['7 days ago', 'now']),它在不同版本解析逻辑不一致,5.1 和 6.0 行为可能不同
用Db::query()绕过模型限制做精确滑动窗口
当需要严格按“当前时刻往前推168小时”切片(比如每小时统计过去24小时活跃数),模型的group()根本不够用——它只能按固定格式分组,没法动态算每个桶的上下界。这时候该上原生 SQL。
立即学习“PHP免费学习笔记(深入)”;
- 示例:统计每小时的“过去24小时活跃用户数”(滑动):
SELECT DATE_FORMAT(FROM_UNIXTIME(ts), '%Y-%m-%d %H:00:00') AS hour_slot, COUNT(DISTINCT user_id) AS active_cnt FROM user_login_log WHERE ts >= UNIX_TIMESTAMP() - 86400 GROUP BY hour_slot ORDER BY hour_slot DESC
- 在 ThinkPHP 中:
Db::query($sql),别用table()->select(),后者会强制加表前缀、过滤字段,破坏原始聚合逻辑 - 注意
ts字段要是int类型且建了索引,否则UNIX_TIMESTAMP()函数会导致全表扫描
缓存滑动窗口结果时,键名必须包含时间精度
缓存键写成active_7days是大忌。这个键不会随时间自动失效,你得手动清理或设极短过期时间,但又怕并发请求打穿缓存。真正靠谱的是把窗口右边界固化进 key。
- 正确做法:
cache('active_last7days_' . date('YmdHi'), $data, 300),其中YmdHi精确到分钟,每分钟生成新 key - 如果只做每日统计,用
date('Ymd')就够了,但注意:别用date('Y-m-d'),斜杠在部分缓存驱动里会被当路径处理 - Redis 中大量时间戳 key 容易堆积,建议加个定时任务,每天删掉
active_last7days_*中早于当前时间7天的 key
滑动窗口真正的复杂点不在 SQL 写法,而在时间语义的一致性——从采集、存储、查询到缓存,每个环节的时区、精度、舍入方式都得对齐。漏掉一个,数据就漂了。


















