Yii框架本身不提供开箱即用的报表生成器或图表渲染能力，但可通过yii\db\Query高效实现分组统计与聚合计算，配合前端图表库或导出组件构建完整报表功能。
Yii 框架本身不提供开箱即用的报表生成器或图表渲染能力，但它的 yii\db\Query 和 AR 查询构建器能高效完成聚合统计逻辑，配合前端图表库（如 Chart.js）或导出组件（如 yii2-export）即可实现完整报表功能。
如何用 yii\db\Query 做分组统计与聚合计算
直接写原生 SQL 容易出错且难维护，yii\db\Query 提供了安全、可链式调用的聚合方法。它比 AR 更轻量，适合只读统计场景，不触发模型验证和事件。
-
select()中必须显式写出聚合字段，例如['COUNT(*) as count', 'SUM(amount) as total']，不能只写* - 分组字段需同时出现在
select()和groupBy()中，否则 MySQL 5.7+ 会报ONLY_FULL_GROUP_BY错误 - 日期截断常用
DATE(created_at)或YEAR(created_at)，注意字段类型是DATETIME还是DATE，避免隐式转换失败 - 示例：按日统计订单数与总金额
$query = (new \yii\db\Query())
->select(['DATE(created_at) as date', 'COUNT(*) as count', 'SUM(total_price) as total'])
->from('order')
->where(['>=', 'created_at', '2026-04-01'])
->groupBy('DATE(created_at)')
->orderBy('date');
$rows = $query->all();
ActiveRecord::find() 能否用于报表？什么情况下要避免
可以，但仅限简单聚合；一旦涉及多表 JOIN、复杂 GROUP BY 或窗口函数，AR 就容易失控——它默认加载全部属性、触发 afterFind 事件、可能因关联关系引入冗余数据。
- 用 AR 做单表聚合（如
Article::find()->sum('view_count')）没问题，底层仍走yii\db\Query - 但
Article::find()->select(['status', 'COUNT(*)'])->groupBy('status')->asArray()->all()实际上绕过了 AR 实例化，等价于 Query，只是语法糖 - 若在
select()中漏掉非聚合字段（如写了'status'却没进groupBy），AR 不会报错，但结果不可靠，MySQL 可能随机返回某条记录的 status 值 - 涉及 LEFT JOIN 统计时，务必用
distinct防止因一对多导致重复计数，例如统计每个分类下的文章数：->select(['category.name', 'COUNT(DISTINCT article.id)'])
导出 Excel 报表时常见的内存与格式陷阱
Yii 自身不带导出功能，社区常用 yii2-export 扩展，但它默认把全部数据一次性加载进 PHP 内存，万级数据极易 OOM。
- 导出前务必用
Query+limit()/offset()分批查，或改用流式导出（如box/spout库配合fopen('php://output', 'w')） -
yii2-export的columns配置中，若字段名含空格或特殊字符（如'user_name'），需用引号包裹或改用attribute显式指定 - 数字型字段（如金额）导出后被 Excel 识别为文本，是因为 PHP 输出时加了制表符或全角空格；确保
str_replace(["\t", " "], '', $value)清洗后再写入 - 中文列头乱码？不是编码问题，而是
Content-Type缺少charset=utf-8，或 BOM 头未清除——用mb_convert_encoding($str, 'GBK', 'UTF-8')强转反而更糟，应统一 UTF-8 + BOM
缓存聚合结果提升报表响应速度
报表数据变化频率低（如日活、月销汇总），但实时查询压力大，必须缓存。Yii 的 cache() 方法只对 Query 生效，对 AR 的 all()/one() 无效。
- 缓存键建议包含业务维度，例如
'report_daily_order_202604'，避免所有报表共用一个 key 导致互相覆盖 - 不要缓存原始
$query->all()结果，而应缓存加工后的数组（如array_values($rows)），防止 Closure 或 PDOStatement 被序列化失败 - 缓存过期时间设为 1 小时足够，凌晨跑定时任务更新汇总表，再主动
Yii::$app->cache->delete($key)，比被动过期更可控 - 若用 Redis 作缓存后端，注意
yii\redis\Cache默认不支持数组自动序列化，需配置'serializer' => 'php'
聚合统计真正的难点不在写法，而在理解数据语义——COUNT 是去重还是计数？SUM 是否该排除退款订单？这些逻辑必须在 SQL 层就定死，不能甩给 PHP 循环处理，否则分页、缓存、导出都会崩。
