本文介绍在 laravel 中不使用循环的前提下，将 `with()` 预加载的关联模型（如 `role`）字段（如 `role_name`、`role_category`）直接合并到主模型（如 `user`）的 json/数组输出中，实现结构扁平化。核心方案是结合访问器（accessors）与 `$appends` 或运行时 `append()`。

在 Laravel 中，当使用 ->with('role') 加载关联关系后，role 默认以嵌套对象形式存在于结果中（如 "role": { "role_name": "Admin" }），但实际 API 或前端常需扁平结构（如直接 "role_name": "Admin"）。手动 foreach 提取字段不仅冗余，还违背 Eloquent 的声明式设计哲学。正确做法是利用 Laravel 的 访问器（Accessors） 与 序列化追加机制。

✅ 推荐方案：使用访问器 + $appends

在 App\Models\User 模型中添加以下代码：

// app/Models/User.php
protected $appends = ['role_name', 'role_category'];

public function getRoleNameAttribute()
{
    return $this->relationLoaded('role') ? $this->role->role_name : null;
}

public function getRoleCategoryAttribute()
{
    return $this->relationLoaded('role') ? $this->role->role_category : null;
}

✅ 关键点说明：

• relationLoaded('role') 确保仅在 role 已预加载（即 with('role') 生效）时才访问关联属性，避免 N+1 查询或空指针异常；
• $appends 数组声明后，toArray() 或 toJson() 会自动包含这些计算字段；
• 字段名（如 role_name）将直接出现在最终数组顶层，与原生字段同级。

? 替代方案：运行时动态追加（按需使用）

若该扁平化行为仅在特定接口需要（而非全局），可避免污染模型定义，改用链式 append()：

$users = User::where('active', 1)
    ->whereHas('role', function ($query) use ($column, $role) {
        $query->where('role_'.$column, $role);
    })
    ->with('role:id,role_name,role_category')
    ->orderBy('users.id')
    ->get([
        'id',
        'email',
        'phone_number',
        'id_role',
        'firstname',
        'lastname',
        'verified',
        'active',
        'id_configuration',
        'external_service_id',
    ])
    ->map(function ($user) {
        return $user->append(['role_name', 'role_category'])->toArray();
    });

⚠️ 注意：append() 必须在 toArray() 之前调用；若使用 ->get()->toArray()，请确保 append() 在集合每个模型上执行（如上例的 map）。

? 补充技巧：批量处理与性能优化

• 若 role 关系已通过 with() 预加载，访问器中无需额外查询，性能无损；
• 对于多对一关系（如本例中一个用户一个角色），此方案安全可靠；若为一对多（如 posts），需明确语义（如取首条 posts.0.title），此时建议自定义访问器逻辑；
• 如需支持 API 资源（ApiResource），可在资源类中直接映射：'role_name' => $this->role->role_name，更灵活可控。

✅ 最终效果验证

经上述任一方案处理后，$users->toArray() 将输出完全符合预期的扁平结构：

[
  {
    "id": 968,
    "email": "[email protected]",
    "phone_number": "123",
    "id_role": 4,
    "firstname": "Name",
    "lastname": "TEST User",
    "verified": 0,
    "active": 1,
    "id_configuration": 1,
    "external_service_id": 123,
    "role_name": "Admin",
    "role_category": "Company"
  }
]

——简洁、可维护、零循环，真正发挥 Laravel Eloquent 的声明式优势。