您如何定义 Eloquent 关系？

Question

您如何定义 Eloquent 关系？

Accepted Answer

**Eloquent relationships** 对数据库表之间的关系进行建模，定义为模型上的方法。Laravel 支持所有常见的关系类型——一对多、多对多、一对一等——为您提供对相关数据的优雅的面向对象的访问。

## 一对多 (hasMany / belongsTo)

```php
class User extends Model {
    public function posts() {              // a user HAS MANY posts
        return $this->hasMany(Post::class);
    }
}
class Post extends Model {
    public function author() {              // a post BELONGS TO a user (inverse)
        return $this->belongsTo(User::class);
    }
}

// access related data as properties (lazy-loaded)
$user->posts;          // a Collection of the user's Posts
$post->author;          // the Post's User
$user->posts()->where('published', true)->get();   // query the relationship
```

最常见的关系：一个父对象 `hasMany` 多个子对象，每个子对象 `belongsTo` 父对象。将关系作为属性访问会返回相关的模型。

## 多对多 (belongsToMany)

```php
class Post extends Model {
    public function tags() {                // posts and tags — many-to-many
        return $this->belongsToMany(Tag::class);   // uses a pivot table (post_tag)
    }
}
$post->tags;                    // the post's tags
$post->tags()->attach($tagId);   // add an association
$post->tags()->detach($tagId);   // remove
$post->tags()->sync([1, 2, 3]);  // set exactly these
```

**Many-to-many** 使用中间表（自动管理），用 `attach`/`detach`/`sync` 来管理关联。

## 其他关系类型

```php
$this->hasOne(Profile::class);          // one-to-one
$this->hasManyThrough(...);              // has-many through an intermediate model
$this->morphMany(Comment::class, 'commentable');   // POLYMORPHIC (comments on posts OR videos)
```

## 预加载 (避免 N+1!)

```php
// ❌ N+1: a query per post to get each author
$posts = Post::all();
foreach ($posts as $post) { echo $post->author->name; }

// ✅ eager load with with() — fetches authors in ONE extra query
$posts = Post::with('author')->get();
```

使用 `with()` 来**预加载**关系，防止 N+1 查询问题。

## 为什么这很重要

Eloquent 关系对于在 Laravel 中处理关系型数据至关重要——几乎每个应用都有相关的实体（用户和帖子、帖子和标签、订单和项目），因此理解如何定义和使用关系是基础知识。

了解关系类型以及何时使用每种类型——**`hasMany`/`belongsTo`** 用于一对多（最常见），**`belongsToMany`** 用于多对多（使用中间表和 `attach`/`detach`/`sync`），`hasOne` 用于一对一，以及多态关系用于灵活的关联——对于建模任何非平凡的数据都是必要的，是 Eloquent 最强大、最优雅的功能之一。

关系为您提供直观的面向对象的方式来访问相关数据（`$user->posts`、`$post->author`），而无需手动编写 join，这是一个巨大的生产力优势。

至关重要的是，理解**使用 `with()` 进行预加载**来防止 **N+1 查询问题**（在循环中访问关系会为每条记录触发一个查询——严重的性能问题）是必不可少的，因为关系很容易导致 N+1 问题。

掌握 Eloquent 关系——定义它们、访问相关数据以及通过预加载来避免 N+1——是核心、频繁使用的知识，它支撑了 Laravel 应用中的有效数据建模和性能。