Laravel Eloquent关联用于在模型间建立连接，如一对一和一对多关系。一对一通过hasOne和belongsTo实现，如用户与个人资料；一对多通过hasMany和belongsTo实现，如用户与文章。外键默认为模型名加_id，可自定义。使用with预加载避免N+1查询，has方法可筛选有关联数据的记录。掌握这些能应对多数业务场景。

Laravel Eloquent 是 Laravel 框架中用于数据库操作的核心组件之一，它提供了一种优雅且直观的方式来处理数据库记录。Eloquent ORM（对象关系映射）允许你通过 PHP 类来操作数据表，并支持模型之间的关联关系。掌握这些关联关系是构建复杂应用的关键。

什么是 Eloquent 关联？

Eloquent 关联让你可以在模型之间建立连接，比如一个用户拥有多个文章，一篇文章属于某个分类等。通过定义关联方法，你可以轻松访问相关数据，而无需手动编写 JOIN 查询。

常见的 Eloquent 关联类型包括：

• 一对一（One To One）
• 一对多（One To Many）
• 多对多（Many To Many）
• 反向关联（Belongs To）
• 远层一对多（Has Many Through）
• 多态关联（Polymorphic Relations）

本文重点讲解最常用的两种：一对一和一对多关系。

一对一关系（One To One）

一对一关系表示一个模型只对应另一个模型的一条记录。例如：每个用户（User）有一份个人资料（Profile）。

假设数据库结构如下：

• users 表：id, name, email
• profiles 表：id, user_id, phone, address

在 Profile 模型中定义 belongsTo 关系：

// app/Models/Profile.php
public function user()
{
    return $this->belongsTo(User::class);
}

在 User 模型中定义 hasOne 关系：

// app/Models/User.php
public function profile()
{
    return $this->hasOne(Profile::class);
}

使用示例：

$user = User::find(1);
echo $user->profile->phone; // 获取该用户的电话

$profile = Profile::find(1);
echo $profile->user->name; // 获取该资料所属用户姓名

如果外键不是 user_id，可以通过第二个参数指定：

return $this->hasOne(Profile::class, 'custom_user_id');

一对多关系（One To Many）

一对多关系表示一个模型可以拥有多个相关模型的实例。例如：一个用户可以发表多篇文章。

假设数据库结构如下：

• users 表：id, name, email
• posts 表：id, user_id, title, content

在 User 模型中定义 hasMany：

// app/Models/User.php
public function posts()
{
    return $this->hasMany(Post::class);
}

在 Post 模型中定义 belongsTo：

// app/Models/Post.php
public function user()
{
    return $this->belongsTo(User::class);
}

使用示例：

$user = User::with('posts')->find(1);
foreach ($user->posts as $post) {
    echo $post->title;
}

// 获取某篇文章的作者
$post = Post::find(1);
echo $post->user->name;

也可以添加条件限制关联查询结果：

return $this->hasMany(Post::class)->where('published', true);

这样就只会获取已发布的文章。

小贴士与常见问题

定义关联时注意命名规范：方法名通常用单数表示 belongsTo，复数表示 hasOne/hasMany。

使用 with() 方法进行预加载，避免 N+1 查询问题：

User::with('posts')->get(); // 推荐
User::all()->map(fn($u) => $u->posts); // 可能造成性能问题

可通过 has() 方法查询存在关联数据的记录：

// 获取有文章的用户
User::has('posts')->get();

// 获取至少有3篇文章的用户
User::has('posts', '>=', 3)->get();

基本上就这些。掌握一对一和一对多关系后，你就已经能处理大多数业务场景了。关键是理解谁“拥有”谁，外键放在哪张表，然后正确使用 belongsTo 和 hasOne/hasMany 方法。不复杂但容易忽略细节。