belongsToMany()

ビロングズトゥーメニー（リレーション）

意味多対多の関連付け

belongsToMany()とは？

belongsToMany()メソッドは、Laravelで多対多のリレーションを定義するために使用されます。両方のモデルが互いに複数の関連を持つ関係を表現します。例えば、ユーザーが複数の役割を持ち、役割も複数のユーザーを持つ場合などに使用します。

belongsToMany()の具体的な使い方

ユーザーと役割の多対多関係定義

<?php

namespace App\Models;

use Illuminate\Database\Eloquent\Model;

class User extends Model
{
    public function roles()
    {
        return $this->belongsToMany(Role::class, 'user_roles', 'user_id', 'role_id')
                    ->withTimestamps();
    }
}

// 使用例
$user = User::find(1);
$roles = $user->roles;

foreach ($roles as $role) {
    echo "役割: {$role->name}\n";
}

👇出力結果

役割: 管理者
役割: エディター
役割: 一般ユーザー

この例では、UserモデルとRoleモデルの多対多関係を定義しています。中間テーブル名を'user_roles'と指定し、外部キーも明示的に指定しています。withTimestamps()メソッドで中間テーブルのタイムスタンプも自動的に管理します。使用例では、ユーザーに関連付けられた全ての役割を取得して表示しています。

belongsToMany()に関するよくある質問

Q. 中間テーブル名のカスタマイズは？

A. デフォルトでは、2つのモデル名をアルファベット順に連結し、_でつないだ名前が使用されます。カスタムの中間テーブル名を指定する場合は、belongsToMany()の第二引数に指定できます。例：return $this->belongsToMany(Role::class, 'user_roles');

Q. 外部キーのカラム名変更は可能？

A. はい、belongsToMany()の第3引数と第4引数で指定できます。例：return $this->belongsToMany(Role::class, 'user_roles', 'user_id', 'role_id');

Q. 追加の中間テーブルカラムは？

A. 中間テーブルに追加のカラムがある場合、withPivot()メソッドを使用して取得できます。例：return $this->belongsToMany(Role::class)->withPivot('active', 'created_by');

belongsToMany()が学べる書籍の紹介

「プログラミング単語帳」を使って、プログラミングの単語を英単語のように学習してみませんか？
プログラミング単語帳には、LaravelのbelongsToMany()やsync()、hasManyThrough()、hasOne()、などのような実務でよく使われる単語が数百以上収録されています。
この書籍には、プログラミングの単語の意味や読み方、単語の使い方がわかる例文などが掲載されており、いつでもどこでもプログラミングの学習ができます。

よく使われる単語にだけ絞って学習することができるので、効率的にプログラミングが学習できます。