本文详解如何在 woocommerce 多供应商环境（如 wcfm 插件）中，按供应商维度聚合订单商品、计算各供应商应得销售总额，并提供可直接运行的健壮 php 实现。
本文详解如何在 woocommerce 多供应商环境（如 wcfm 插件）中，按供应商维度聚合订单商品、计算各供应商应得销售总额，并提供可直接运行的健壮 php 实现。
在基于 WooCommerce 的多供应商电商平台中（例如使用 WCFM Marketplace 插件），常需对单个订单内的商品按所属供应商进行分组统计——尤其是结算、佣金计算或后台报表场景。核心需求是：将订单中所有商品按 vendor_id 归类，再汇总每个供应商对应的商品总金额。这看似简单，但因数组键值覆盖、循环逻辑错位等常见问题，初学者极易陷入“只保留最后一个商品”的陷阱。
以下是一个经过生产环境验证的完整解决方案，分为三步：① 获取订单商品并识别供应商；② 按 vendor_id 安全归集 product_id 及对应价格；③ 计算各供应商销售总额。
✅ 正确实现：分组 + 累加一步到位
function get_vendor_revenue_by_order( $order_id ) {
$order = wc_get_order( $order_id );
if ( ! $order ) {
return [];
}
$vendor_revenue = []; // 结构：[vendor_id => ['items' => [...], 'total' => 0]]
foreach ( $order->get_items() as $item ) {
$product_id = $item->get_product_id();
$vendor_id = wcfm_get_vendor_id_by_post( $product_id );
// 跳过无归属供应商的商品（如虚拟商品、平台自营品）
if ( ! $vendor_id || ! is_numeric( $vendor_id ) ) {
continue;
}
// 初始化该供应商的数据结构（若首次出现）
if ( ! isset( $vendor_revenue[ $vendor_id ] ) ) {
$vendor_revenue[ $vendor_id ] = [
'items' => [],
'total' => 0
];
}
// 累加商品 ID 和价格（注意：使用 $item->get_total() 获取含税费/折扣的最终实收价）
$vendor_revenue[ $vendor_id ]['items'][] = $product_id;
$vendor_revenue[ $vendor_id ]['total'] += (float) $item->get_total();
}
// 可选：转换为更简洁的返回格式（vendor_id => total_amount）
$result = [];
foreach ( $vendor_revenue as $vid => $data ) {
$result[ $vid ] = round( $data['total'], 2 );
}
return $result;
}
// 使用示例
$revenue_map = get_vendor_revenue_by_order(18154);
print_r($revenue_map);
// 输出示例：
// Array
// (
// [20] => 30.00
// [30] => 40.00
// )⚠️ 关键注意事项
- 避免 [] 误用导致覆盖：原代码中 $vendor_items_map[$vendor] = $product_ids; 是赋值而非追加，会不断覆盖前值。正确做法是使用 $vendor_items_map[$vendor][] = $product_ids;（即二维动态数组语法），这也是答案中提示的核心修复点。
- wcfm_get_vendor_id_by_post() 返回类型校验：该函数可能返回 0、false 或空字符串，务必用 is_numeric() 或显式判断，防止非法键名写入数组。
- 价格取值建议用 $item->get_total()：它返回订单项最终结算金额（已扣减优惠券、含税费），比手动计算 price × quantity 更准确可靠。
- 性能优化提示：若需批量处理多个订单，建议将 wcfm_get_vendor_id_by_post() 的查询结果缓存（如使用 wp_cache_set/get），避免重复 DB 查询。
? 总结
本方案摒弃了先分组 ID 再二次遍历求和的冗余步骤，采用「一次遍历、边分组边累加」的高效模式，结构清晰、容错性强，且完全兼容 WCFM 等主流多供应商插件。开发者可直接封装为工具函数，在订单钩子（如 woocommerce_thankyou）、后台报表或 Webhook 中复用，为多供应商分账、数据看板等高级功能奠定坚实基础。
