如何从API数据中筛选并格式化匹配预设热门商品列表的项-php教程-PHP中文网

如何从API数据中筛选并格式化匹配预设热门商品列表的项

本文介绍如何使用 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 最佳实践，能稳定支撑商品白名单场景下的数据清洗与标准化输出。