本文介绍在 laravel 中基于原始 sql 和变量累加机制，为按日聚合的下载数据高效添加累计总和字段（cumm_total_count），避免 php 层循环计算，兼顾性能与可读性。
本文介绍在 laravel 中基于原始 sql 和变量累加机制，为按日聚合的下载数据高效添加累计总和字段（cumm_total_count），避免 php 层循环计算，兼顾性能与可读性。
在 Laravel 中实现累计和（Cumulative Sum）时，若数据已按时间维度（如日期）完成聚合，直接在数据库层计算累计值是最优解——既减少传输数据量，又避免 PHP 端遍历带来的性能损耗。Laravel 原生 Eloquent 不支持窗口函数（如 SUM() OVER (ORDER BY ...)）在所有数据库驱动中的跨平台兼容（尤其 MySQL 5.7 及以下不支持），因此推荐使用带用户变量的原生 SQL 方案，兼顾兼容性与效率。
以下为完整、安全、可复用的实现方式：
use Illuminate\Support\Facades\DB;
$table = Downloads::getTableName();
$downloads = DB::select(<<<SQL
SELECT
date,
total_count,
@running_total := @running_total + total_count AS cumm_total_count
FROM (
SELECT
DATE(created_at) AS date,
COUNT(*) AS total_count
FROM `$table`
GROUP BY DATE(created_at)
ORDER BY date ASC
) AS grouped
CROSS JOIN (SELECT @running_total := 0) AS init
SQL
);✅ 关键说明：
- DATE(created_at) 替代 DATE_FORMAT(..., '%Y-%m-%d') 更简洁且语义清晰；
- 子查询 grouped 确保先完成每日计数并严格按日期升序排列（累计逻辑依赖顺序）；
- CROSS JOIN (SELECT @running_total := 0) 初始化变量，避免会话级变量残留风险；
- 使用反引号 `$table` 防止表名注入（前提是 getTableName() 返回可信值）；
⚠️ 注意事项：
- 此方案适用于 MySQL 5.6+；若使用 MySQL 8.0+ 或 PostgreSQL，更推荐标准窗口函数（如 SUM(total_count) OVER (ORDER BY date)），语义更清晰且线程安全；
- 切勿在 Eloquent 查询链中混用变量（如 ->selectRaw('@x := @x + ...')），因 Laravel 的查询构造器可能重排字段或干扰变量初始化；
- 如需分页或进一步关联，应将累计逻辑后置到应用层（即先获取分页数据，再用 PHP array_reduce() 计算局部累计）；
最终结果将精准返回三列：date（日期）、total_count（当日下载量）、cumm_total_count（截至当日的累计总量），完全匹配预期格式。该方案轻量、可靠，是 Laravel 中处理有序聚合累计场景的经典实践。
