Eloquent リレーションシップはどのように定義しますか?

Question

Accepted Answer

**Eloquent リレーションシップ**はデータベーステーブル間の関連性をモデル化するもので、モデルのメソッドとして定義されます。Laravel はすべての一般的なリレーションシップタイプ（1対多、多対多、1対1など）をサポートしており、関連データへのエレガントなオブジェクト指向アクセスを提供します。

## 1対多（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
```

**多対多**はピボットテーブル（自動的に管理される）を使用し、`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`**は1対多（最も一般的）、**`belongsToMany`**は多対多（ピボットテーブルと`attach`/`detach`/`sync`を使用）、`hasOne`は1対1、ポリモーフィックリレーションは柔軟な関連付けです。これらは非自明なデータモデリングのために必要であり、Eloquent の最も強力でエレガントな機能の一つです。

リレーションシップにより、直感的でオブジェクト指向のアクセス（`$user->posts`、`$post->author`など）が可能になり、手動で JOIN を書く必要がなくなるため、大きな生産性向上につながります。

重要なのは、**`with()`による先読み込み**を理解して**N+1クエリ問題**（ループでリレーションシップにアクセスするたびに1レコードあたり1クエリが発生する深刻なパフォーマンス問題）を防ぐことです。リレーションシップは N+1 問題を簡単に招き込むため、これは必須知識です。

Eloquent リレーションシップをマスターすること（定義、関連データへのアクセス、N+1 を回避するための先読み込み）は、Laravel アプリケーションにおける効果的なデータモデリングとパフォーマンスの基盤となる、頻繁に使用される中核的な知識です。