テーブルのつながりを、図で一気につかむ

親: User モデル(hasOne)

class User extends Model
{
    // ユーザーは1つのプロフィールを持つ
    public function profile()
    {
        return $this->hasOne(Profile::class);
        // 外部キーを明示するなら:
        // return $this->hasOne(Profile::class, 'user_id', 'id');
    }
}

子: Profile モデル(belongsTo = 逆向き)

class Profile extends Model
{
    // プロフィールは1人のユーザーに属する
    public function user()
    {
        return $this->belongsTo(User::class);
    }
}

親から子をたどる

$user = User::find(1);
$bio = $user->profile->bio;   // hasOne 経由でプロフィール取得

子から親をたどる(逆)

$profile = Profile::find(1);
$name = $profile->user->name; // belongsTo 経由でユーザー取得

親: User モデル(hasMany)

class User extends Model
{
    // ユーザーは複数の投稿を持つ
    public function posts()
    {
        return $this->hasMany(Post::class);
    }
}

子: Post モデル(belongsTo = 逆向き)

class Post extends Model
{
    // 投稿は1人のユーザーに属する
    public function user()
    {
        return $this->belongsTo(User::class);
    }
}

親から子の一覧をたどる

$user = User::find(1);

foreach ($user->posts as $post) {   // Collection(複数)が返る
    echo $post->title;
}

$count = $user->posts()->count();   // メソッド呼び出しで件数だけ取得

子から親をたどる / 子を作成

$post = Post::find(10);
echo $post->user->name;             // 投稿者の名前

// 親経由で子を作成すると user_id が自動でセットされる
$user->posts()->create(['title' => '初投稿']);

両側に belongsToMany を書く

class Post extends Model
{
    public function tags()
    {
        // 中間テーブル post_tag を介して多対多
        return $this->belongsToMany(Tag::class);
    }
}

class Tag extends Model
{
    public function posts()
    {
        return $this->belongsToMany(Post::class);
    }
}

たどる / 付け外し

$post = Post::find(1);

foreach ($post->tags as $tag) {   // 紐づく全タグ
    echo $tag->name;
}

$post->tags()->attach($tagId);    // 関連を1件追加(中間に行を作る)
$post->tags()->detach($tagId);    // 関連を1件削除
$post->tags()->sync([1, 2, 3]);   // この3つだけに一括で揃える

中間テーブルの追加情報(pivot)

// マイグレーションで中間テーブルに列を足しておくと…
return $this->belongsToMany(Tag::class)->withPivot('created_by')->withTimestamps();

foreach ($post->tags as $tag) {
    echo $tag->pivot->created_by;   // 中間テーブルの値に $tag->pivot でアクセス
}

Country モデル(User を経由して Post へ)

class Country extends Model
{
    // 国 → (users を経由) → その国のユーザーの全投稿
    public function posts()
    {
        return $this->hasManyThrough(
            Post::class,     // 最終的に欲しいモデル
            User::class      // 中間のモデル
            // 省略時: users.country_id と posts.user_id を推測して連結
        );
    }
}

国から一気に投稿を取得

$country = Country::find(1);

foreach ($country->posts as $post) {
    // その国に属する全ユーザーの投稿が、User を書かずに取れる
    echo $post->title;
}

子: Comment(morphTo)

class Comment extends Model
{
    // このコメントが「何に」付いているか(Post か Video か…)
    public function commentable()
    {
        return $this->morphTo();
        // commentable_id と commentable_type の2列を使う
    }
}

親: Post / Video(morphMany)

class Post extends Model
{
    public function comments()
    {
        return $this->morphMany(Comment::class, 'commentable');
    }
}

class Video extends Model
{
    public function comments()
    {
        return $this->morphMany(Comment::class, 'commentable');
    }
}

親からコメントをたどる / 子から親をたどる

$post = Post::find(1);
foreach ($post->comments as $c) {   // 記事のコメント
    echo $c->body;
}

$comment = Comment::find(5);
$parent = $comment->commentable;    // Post か Video が返る(実行時に決まる)

// 追加も同じ書き方で親の種類を問わない
$video->comments()->create(['body' => '面白い!']);

多対多版: morphToMany(タグを何にでも付ける)

class Post extends Model
{
    // タグを Post にも Video にも付けられる多対多ポリモーフィック
    public function tags()
    {
        return $this->morphToMany(Tag::class, 'taggable');
    }
}
// 中間テーブル taggables(tag_id, taggable_id, taggable_type)を使う