Laravel 5 Eloquent：如何将关联模型字段加入父模型返回数据集

首先得先确认你的User模型里的关联方法是不是正确的，比如如果User和Teacher是一对一的关系（一个User对应一个Teacher），那在User.php里应该有这样的关联方法：

public function teacher()
{
    // 这里根据你的实际外键调整，比如teachers表的user_id关联users表的id
    return $this->hasOne(Teacher::class, 'user_id', 'id');
}

接下来分几种常见场景给你解决方案：

1. 直接查询时加载关联字段（保持嵌套结构） #

如果你想让返回的User对象里保留user.teacher.address的嵌套结构，不用手动join表，用Eloquent的关联加载最方便：

$users = User::select('id', 'firstname', 'lastname')
    // 加载teacher关联，同时只选取需要的address字段（注意要带上关联外键user_id，不然Eloquent没法关联）
    ->with(['teacher' => function ($query) {
        $query->select('id', 'user_id', 'address');
    }])
    ->get();

这样查出来的每个User实例里，$user->teacher->address就能正常访问到地址字段了。

2. 使用Join方式将address放到根属性（如果不需要嵌套） #

如果你之前尝试的是把address直接放到User的根属性里，那得先关联teachers表再查询，不然直接选teachers.address会因为表没关联而报错：

$users = User::select('users.firstname', 'users.lastname', 'teachers.address')
    // 同样要根据实际外键调整关联条件
    ->join('teachers', 'users.id', '=', 'teachers.user_id')
    ->get();

这时候$user->address就能拿到值，但结构不是你要的嵌套形式，所以更推荐第一种方法。

3. 全局自动加载关联字段 #

如果每次查询User都需要返回teacher的address，可以在User模型里设置$with属性，自动加载关联：

class User extends Model
{
    use Notifiable;
    
    // 自动加载teacher关联的指定字段
    protected $with = ['teacher:id,user_id,address'];
    
    public function teacher()
    {
        return $this->hasOne(Teacher::class);
    }
}

之后不管你用User::find(1)还是User::all()，都会自动带上teacher的address字段。

4. API场景：用资源类定义返回结构（最规范） #

如果是做API接口，推荐用Laravel的API资源来统一返回结构，避免重复代码：

先创建User资源：

php artisan make:resource UserResource

然后在app/Http/Resources/UserResource.php里定义返回结构：

public function toArray($request)
{
    return [
        'firstname' => $this->firstname,
        'lastname' => $this->lastname,
        'teacher' => [
            'address' => $this->teacher?->address, // 用null安全运算符处理Teacher不存在的情况
        ],
    ];
}

返回的时候直接用：

return UserResource::collection(User::all());

这样返回的JSON结构完全符合你想要的user.firstname、user.lastname、user.teacher.address形式。

你之前用addSelect(DB::raw('teachers.address AS address'))失败的原因，大概率是没有提前join teachers表，Eloquent不知道要关联哪个表，所以直接选字段会报错。如果想用这种方式，记得先join表哦~

内容的提问来源于stack exchange，提问作者user3467896