本文介绍如何使用 Laravel Collections 的 filter() 与 map() 方法，高效筛选外部 API 返回的商品数据，仅保留存在于预定义热门商品数组中的条目，并统一格式化为带首字母大写的 label 键的对象数组。
本文介绍如何使用 laravel collections 的 `filter()` 与 `map()` 方法，高效筛选外部 api 返回的商品数据，仅保留存在于预定义热门商品数组中的条目，并统一格式化为带首字母大写的 `label` 键的对象数组。
在实际开发中，我们常需对接第三方 API 获取商品列表（如 $prod['content']['data']），但业务逻辑仅允许展示一组预先配置的“热门商品”（如 laptop、printer 等）。此时，核心任务不是简单遍历，而是先过滤、再映射：先判断每个 API 商品是否属于白名单，再将其标准化为前端所需的结构。
以下是一个健壮、可读性强的实现方案（适用于 Laravel 9+，推荐使用 collect()）：
public function getTopProducts(array $prod): array
{
// 预定义热门商品（小写，便于不区分大小写匹配）
$topProds = collect(['laptop', 'printer', 'keyboard', 'monitor', 'usb adaptor']);
// 从 API 响应中提取原始商品数据（假设为字符串数组或含 'title' 字段的对象数组）
$apiItems = collect($prod['content']['data'] ?? []);
// 关键步骤：先 filter 再 map
return $apiItems
->filter(function ($item) use ($topProds) {
// 支持两种常见输入格式：
// 1. $item 是字符串（如 'laptop'）→ 直接检查
// 2. $item 是关联数组（如 ['title' => 'Laptop']）→ 转小写后检查
$key = is_string($item) ? $item : ($item['title'] ?? '');
return $topProds->contains(strtolower($key));
})
->map(function ($item) {
$label = is_string($item)
? ucwords($item)
: ucwords($item['title'] ?? '');
return ['label' => $label];
})
->values() // 重置索引，确保返回连续数字键数组
->all();
}✅ 关键要点说明：
- filter() 必须前置：map() 只做转换，不改变元素数量；filter() 才负责剔除不匹配项。原代码缺失 filter 导致所有数据都被处理。
- 大小写兼容性：使用 strtolower() 统一比对，避免 'Laptop' 与 'laptop' 匹配失败。
- 输入容错设计：同时支持纯字符串数组（如 ['laptop', 'paper']）和对象数组（如 [ ['title' => 'Keyboard'] ]），提升函数复用性。
- ->values()->all()：确保返回标准 PHP 索引数组（非 Collection 对象），符合 JSON 序列化及前端消费预期。
⚠️ 注意事项：
- 若 $prod['content']['data'] 结构深度复杂（如嵌套多层），建议先用 data_get() 提取字段，而非硬编码 $item['title']；
- 生产环境建议将 $topProds 抽离为配置项或常量，便于维护与国际化扩展；
- 如需高性能大批量处理，可考虑将 $topProds 转为 array_flip() 后的键值映射，使 isset() 检查替代 contains()（O(1) vs O(n)）。
该方案简洁、可测试、符合 Laravel 最佳实践，能稳定支撑商品白名单场景下的数据清洗与标准化输出。
