如何在 Laravel 中按订单状态筛选并统计热销商品

本文介绍如何在 laravel 中通过关联查询，仅统计已“发货”（delivered）状态订单中的商品销量，并获取销量前三的商品列表。

在构建电商后台仪表盘时，常需展示“最畅销商品”，但若直接对 order_details 表聚合统计（如 SUM(quantity)），会忽略订单实际履约状态——例如，待支付、已取消或未发货的订单不应计入真实销售表现。因此，必须将 order_details 与关联的 orders 表进行条件联查，仅纳入 order_status = 'delivered' 的订单数据。

✅ 正确实现方式（基于 Eloquent 关系）

假设你的 OrderDetails 模型已正确定义了与 Order 模型的关联（例如 belongsTo(Order::class, 'order_id')），且 Order 模型中 status 字段存储订单状态（值为 'delivered' 等字符串），则可使用 whereHas() 方法高效完成筛选：

$top_sell_items = OrderDetails::with(['product', 'order']) // 预加载 product 和关联 order（推荐使用更语义化的 'order' 而非 'orders'）
    ->whereHas('order', function ($query) {
        $query->where('status', 'delivered');
    })
    ->select('product_id', DB::raw('SUM(quantity) as total_quantity'))
    ->groupBy('product_id')
    ->orderBy('total_quantity', 'desc')
    ->take(3)
    ->get();

? 关键点说明： whereHas('order', ...) 确保仅选取所属订单状态为 'delivered' 的明细记录； with(['product', 'order']) 支持后续访问 $item->product->name 或 $item->order->created_at 等字段，提升可扩展性；列别名建议使用 total_quantity 替代 count，避免与 Eloquent 的 count() 方法语义混淆。

⚠️ 注意事项

关系命名一致性：确保 OrderDetails 模型中定义的关联方法名为 order()（单数，返回 belongsTo），而非 orders()（复数易引发误解）。若当前为 orders()，请先修正模型：
```
// 在 OrderDetails.php 中
public function order()
{
    return $this->belongsTo(Order::class, 'order_id');
}
```
数据库索引优化：为提升查询性能，建议在 orders.status 和 order_details.order_id 字段上建立联合索引：
```
CREATE INDEX idx_orders_status_order_id ON orders(status, id);
```
空结果处理：若无已发货订单，$top_sell_items 将为空集合，前端应做容错渲染（如显示“暂无已发货商品”）。

✅ 最终效果

执行后，$top_sell_items 将是一个包含 3 条 OrderDetails 实例的集合，每条均携带：

product_id（商品 ID）
total_quantity（该商品在所有已发货订单中的总销量）
product（预加载的完整 Product 模型）

你可轻松在 Blade 模板中遍历展示：

@foreach($top_sell_items as $item)
    {{ $item->product->name }} — {{ $item->total_quantity }} 件
@endforeach

此方案兼顾可读性、性能与 Laravel 最佳实践，是处理跨表状态过滤聚合统计的标准解法。

# php # laravel # 前端 # ai # red # count # 字符串 # class # 数据库 # 而非 # 加载 # 暂无 # 遍历 # 推荐使用 # 请先 # 将是 # 你可 # 不应 # 则可

返回目录在线咨询

上一篇：探究Cpanel建站打不开真相：文件上传路径错误如何修正？
下一篇：Java数组优点和缺点_动力节点Java学院整理

您的项目需求

*请认真填写需求信息，我们会在24小时内与您取得联系。

全网整合营销服务商

如何在 Laravel 中按订单状态筛选并统计热销商品

✅ 正确实现方式（基于 Eloquent 关系）

⚠️ 注意事项

✅ 最终效果

您的项目需求