Yii2 中高效合并获奖者、用户与商品数据并构建 JSON 响应

2026-01-27

Yii2 中高效合并获奖者、用户与商品数据并构建 JSON 响应

本文介绍在 yii2 框架中，如何通过循环关联查询将 winners 模型与对应 user、product 数据结构化合并，生成符合 api 规范的嵌套数组，并最终输出为 json 响应。

在构建 JSON API 时，常需将主模型（如 Winners）与其关联的用户信息（User）和商品信息（Products）整合为统一的数据结构。直接使用 ArrayHelper::merge() 并不可取——它适用于扁平化合并键值对，而此处目标是按条目聚合多维度对象属性，形成清晰、可序列化的数组列表。

推荐做法是：先获取获奖记录集合，再逐条查询关联数据，并手动构造结构化子数组。示例如下：

$winners = Winners::find()->limit(8)->all();
$data = [];

foreach ($winners as $winner) {
    // 查询用户（注意：findIdentity 需传入有效 ID，建议增加空值校验）
    $user = $winner->user_id ? User::findIdentity($winner->user_id) : null;

    // 查询本地化商品（确保 $lang 已定义且 $winner->coupon 非空）
    $product = $winner->coupon 
        ? Products::find()
            ->localized($lang)
            ->where(['coupon' => $winner->coupon])
            ->one() 
        : null;

    // 构建每条获奖记录的标准化结构
    $data[] = [
        'id'         => $winner->id,
        'user_name'  => $user ? ($user->firstname . ' ' . $user->lastname) : 'Unknown',
        'user_email' => $user ? $user->email : null,
        'prize_image'=> $product ? $product->prize_image : null,
        'win_title'  => $product ? $product->win_title : 'No prize',
        'coupon'     => $winner->coupon,
        'created_at' => $winner->created_at,
    ];
}

// 返回 JSON 响应（Yii2 推荐方式）
return $this->asJson($data);

✅ 关键优势：