本文介绍如何使用 Laravel 的 Collection 工具高效筛选外部 API 返回的商品数据，仅保留存在于预设热门商品数组中的项，并统一转换为带首字母大写的 label 字段的标准结构。
本文介绍如何使用 laravel 的 collection 工具高效筛选外部 api 返回的商品数据，仅保留存在于预设热门商品数组中的项，并统一转换为带首字母大写的 `label` 字段的标准结构。
在实际开发中，我们常需对接第三方 API 获取商品列表（如 $prod['content']['data']），但业务逻辑仅允许展示一组预先定义的“热门商品”（如 laptop、printer 等）。此时，核心任务是：先过滤（filter）再映射（map）——即先判断每个 API 商品是否在白名单中，再按指定格式构造输出。
以下是一个完整、可直接集成的解决方案（基于 Laravel 9+ Collection）：
public function getTopProducts(array $prod): array
{
// 定义热门商品白名单（小写、空格兼容）
$topProds = collect(['laptop', 'printer', 'keyboard', 'monitor', 'usb adaptor']);
// 从 API 响应中提取原始商品标题（假设为 'title' 字段，且为字符串）
$rawItems = collect($prod['content']['data'])
->pluck('title') // 提取所有 title 值，得到纯字符串集合
->map(fn($title) => strtolower(trim($title))); // 标准化：转小写 + 去空格
// 过滤出仅存在于白名单中的商品，并映射为标准格式
return $rawItems
->filter(fn($item) => $topProds->contains($item))
->map(fn($item) => ['label' => ucwords($item)])
->values() // 重置键名，确保返回连续数字索引数组
->all();
}
✅ 关键要点说明：
- 标准化处理：API 返回的 title 可能含大小写混用或前后空格（如 'USB ADAPTOR' 或 ' keyboard '），务必通过 strtolower() 和 trim() 统一为小写无空格形式，才能与 $topProds 准确比对；
- filter() 在 map() 之前：先缩小数据集再转换结构，显著提升性能，尤其在数据量较大时；
- ucwords() 替代硬编码：自动将 'usb adaptor' → 'Usb Adaptor'，避免手动维护映射表；
- ->values()->all()：确保返回标准 PHP 索引数组（而非 Collection 对象），符合前端 JSON 序列化预期。
⚠️ 注意事项：
- 若 API 中 title 字段可能为空或非字符串（如 null、int），建议在 pluck('title') 后添加 ->filter() 去除无效值；
- 白名单 $topProds 可提取为类常量或配置项，便于多处复用和统一管理；
- 如需支持模糊匹配（如忽略连字符、缩写），应替换 contains() 为自定义正则匹配逻辑。
该方案简洁、健壮且符合 Laravel 最佳实践，兼顾可读性与执行效率。
大量免费API接口：立即使用
涵盖生活服务API、金融科技API、企业工商API、等相关的API接口服务。免费API接口可安全、合规地连接上下游，为数据API应用能力赋能！
