本文详解如何基于 laravel eloquent 关系模型，高效统计每个推荐人（sponsor）在指定时间段内产生的销售订单，并按商品价格的固定比例（如 10%）自动计算其应得返佣总额。
本文详解如何基于 laravel eloquent 关系模型，高效统计每个推荐人（sponsor）在指定时间段内产生的销售订单，并按商品价格的固定比例（如 10%）自动计算其应得返佣总额。
在构建分销或推荐激励系统时，一个核心需求是：准确、可扩展地计算每位推荐人（sponsor）所促成销售对应的返佣金额。假设你已建立 sales 表记录每笔交易，并通过 sponsor_id 字段关联推荐人（该字段可为空），同时 products 表存储商品价格。此时，单纯遍历销售记录再手动关联计算不仅低效，也难以应对数据量增长和时间范围筛选等实际场景。
✅ 推荐方案：利用 Eloquent 关系 + 聚合查询（推荐）
最佳实践是避免 N+1 查询与 PHP 层循环累加，转而使用数据库原生聚合能力，在 SQL 层完成分组、关联、求和与百分比计算。以下是结构清晰、性能优异的实现方式：
1. 模型关系定义（确保基础关联正确）
// app/Models/User.php
class User extends Model
{
// 推荐人 → 其促成的销售（一对多）
public function sponsoredSales()
{
return $this->hasMany(Sale::class, 'sponsor_id', 'id');
}
}
// app/Models/Sale.php
class Sale extends Model
{
protected $fillable = ['user_id', 'product_id', 'sponsor_id'];
// 销售 → 对应商品（用于获取 price）
public function product()
{
return $this->belongsTo(Product::class);
}
// 销售 → 推荐人（可选，用于反向验证）
public function sponsor()
{
return $this->belongsTo(User::class, 'sponsor_id');
}
}2. 核心查询：按 sponsor_id 分组，汇总返佣
use Illuminate\Support\Facades\DB;
$rewardRate = 0.10; // 10% 返佣率
$start = now()->subMonth(); // 示例：过去一个月
$end = now();
$rewards = DB::table('sales')
->select(
'sales.sponsor_id',
'users.name as sponsor_name',
DB::raw('COUNT(*) as total_sales'),
DB::raw('SUM(products.price) as total_sales_amount'),
DB::raw('SUM(products.price) * ? as reward_amount', [$rewardRate])
)
->join('products', 'sales.product_id', '=', 'products.id')
->join('users', 'sales.sponsor_id', '=', 'users.id') // 只匹配有 sponsor_id 的记录
->whereBetween('sales.created_at', [$start, $end])
->groupBy('sales.sponsor_id', 'users.name')
->orderByDesc('reward_amount')
->get();
// 输出示例：
// [
// { sponsor_id: 30, sponsor_name: "张三", total_sales: 2, total_sales_amount: 280.00, reward_amount: 28.00 },
// { sponsor_id: 31, sponsor_name: "李四", total_sales: 1, total_sales_amount: 150.00, reward_amount: 15.00 }
// ]? 关键说明：
- JOIN users 确保仅统计有效 sponsor_id（自动过滤 NULL）；
- SUM(products.price) * ? 直接在数据库中完成乘法，精度高、无 PHP 类型转换风险；
- GROUP BY 是聚合统计的基石，缺失将导致单条结果而非每人一条。
3. 进阶：支持无销售记录的推荐人（显示 0 返佣）
若需展示所有注册推荐人（含未产生销售者），改用 LEFT JOIN 并配合 COALESCE：
$rewards = DB::table('users')
->select(
'users.id as sponsor_id',
'users.name as sponsor_name',
DB::raw('COALESCE(COUNT(sales.id), 0) as total_sales'),
DB::raw('COALESCE(SUM(products.price), 0) as total_sales_amount'),
DB::raw('COALESCE(SUM(products.price), 0) * ? as reward_amount', [$rewardRate])
)
->leftJoin('sales', function ($join) use ($start, $end) {
$join->on('users.id', '=', 'sales.sponsor_id')
->whereBetween('sales.created_at', [$start, $end]);
})
->leftJoin('products', 'sales.product_id', '=', 'products.id')
->where('users.is_sponsor', true) // 假设有标识字段
->groupBy('users.id', 'users.name')
->get();⚠️ 注意事项与最佳实践
- 空值安全：sponsor_id IS NOT NULL 条件必须显式处理，否则 JOIN 可能意外排除数据；
- 索引优化：务必为 sales.sponsor_id、sales.created_at、sales.product_id 及 products.id 添加数据库索引；
- 精度控制：货币计算建议使用 DECIMAL(10,2) 类型存储价格，并在 SQL 中用 ROUND(..., 2) 保证两位小数；
- 时区一致性：确保 created_at 字段与应用时区配置（config/app.php 中的 'timezone'）一致，避免时间范围错位；
- 权限隔离：生产环境需校验当前用户是否有权查看某推荐人的返佣数据，避免越权访问。
通过以上设计，你不仅能精准、高效地完成返佣统计，还能轻松扩展为周报、佣金结算、排行榜等高级功能——真正的“一次建模，长期复用”。
