ThinkPHP数据统计接口核心是正确使用count、sum、avg、max、min五个聚合方法，配合where前置条件、group分组、field时间格式化及json()强类型返回，避免原始SQL和类型错误。
ThinkPHP 实现数据统计接口，核心就一条：用好 count、sum、avg、max、min 这五个聚合方法，配合条件链式调用，直接返回数值，别绕弯写原始 SQL 或手动遍历。
统计接口必须返回 JSON，且字段类型要严格对齐
前端 ECharts 或其他图表库对数据类型敏感，count 返回的是整数，但如果你在控制器里拼接了字符串、用了 round() 处理 avg 却没强制转 (int) 或 (float)，前端解析时可能报错或显示 NaN。
- 正确做法：统一用
json()包裹，关键数值显式类型转换，比如'avg' => (float) round($m->avg('score'), 2) - 错误示范：
'avg' => $m->avg('score')—— 某些 PHP 版本下avg可能返回null或字符串，导致前端series.data初始化失败 - 别在返回数组里混入非数值字段（如说明文字），ECharts 不认；如有必要，放到
meta或info顶层键下
按时间分组统计（如每月、每日）必须用 group() + field() 组合
想查“每月订单量”，不能只靠 whereTime('create_time', 'month') —— 它只筛数据，不分组。真正要聚合，得手写 field 表达式并显式 group。
- MySQL 时间格式化要用
FROM_UNIXTIME（字段是 int 时间戳）或DATE_FORMAT（字段是 datetime）；ThinkPHP 不自动帮你转 - 示例（时间戳字段）：
Db::name('order')->field("COUNT(*) as count, FROM_UNIXTIME(create_time, '%Y-%m') as month")->group('month')->select() - 示例（datetime 字段）：
Db::name('order')->field("COUNT(*) as count, DATE_FORMAT(create_time, '%Y-%m') as month")->group('month')->select() - 漏掉
group就只返回一行总数，不是你想要的折线图数据源
带条件的统计必须把 where 放在聚合方法调用前
顺序错了结果就全错：where 必须在 count()、sum() 等之前调用，否则条件不生效。
立即学习“PHP免费学习笔记（深入）”；
- ✅ 正确：
Db::name('user')->where('status', 1)->count() - ❌ 错误：
Db::name('user')->count()->where('status', 1)——count()已执行并返回整数，后面再链where会报错或静默忽略 - 复杂条件别堆在一行，用变量分步写更可控：
$query = Db::name('log')->where('type', 'login');→$query->whereTime('create_time', 'today')->sum('duration') - 注意
whereTime的第二个参数大小写敏感，'today'有效，'Today'无效
高频统计接口要防缓存穿透和 Redis 类型错乱
如果统计接口被刷（比如暴露了 IP+路由维度的频次查询），没加缓存或缓存 key 设计不当，数据库或 Redis 都可能被打挂。
- 不要用
Cache::get($key)查不到就去 DB 查——这是缓存穿透；应该用Cache::remember($key, 60, function () { return Db::...->count(); }) - Redis 的
INCR返回的是字符串，Cache::inc()也是；后端接口若直接json(['count' => Cache::get($key)])，前端拿到的是字符串"42"，不是数字42 - 务必在返回前强转：
'count' => (int) Cache::get($key)，避免 ECharts 渲染异常 - 测试时 curl 直接打接口看原始响应体，比在浏览器里点来点去看控制台更快定位类型问题
真正卡住人的从来不是“怎么写个 count”，而是字段类型、分组逻辑、缓存生命周期这三处细节没对齐。一处处对照着检查，比重写逻辑更省时间。
