先生と生徒の会話形式で理解しよう

生徒

「先生、Laravelのマイグレーションでテーブルを作るときに“外部キー”ってよく見るんですが、どういう意味なんですか？」

先生

「いい質問ですね。外部キーは、データベースで“他のテーブルと関連づけるためのルール”なんです。」

生徒

「なるほど…でも、Laravelではどうやって設定するんですか？」

先生

「それじゃあ、Laravelで外部キー制約を設定する方法を、実際のコードを使って説明していきましょう！」

1. 外部キー制約とは？

まず、「外部キー制約（foreign key constraint）」とは、テーブル同士の関係を守るためのルールのことです。例えば、「投稿（posts）」と「ユーザー（users）」の関係を考えてみましょう。投稿は必ず誰かユーザーに属しているはずですよね。このとき、投稿テーブルに「user_id」というカラムを作り、それをユーザーテーブルの「id」に結びつけるのが外部キー制約です。

これによって、存在しないユーザーのIDを投稿テーブルに登録することを防げるので、データの整合性（データの矛盾がない状態）が保たれます。

2. Laravelで外部キー制約を設定する基本構文

Laravelでは、マイグレーションファイル内でforeignメソッドを使って外部キー制約を設定します。以下のように書きます。


$table->foreign('user_id')->references('id')->on('users');

このコードは「postsテーブルのuser_idカラムが、usersテーブルのidカラムを参照している」という意味になります。

3. 実際のマイグレーションファイルの例

次に、実際のマイグレーションで外部キーを設定する例を見てみましょう。例えば、postsテーブルを作る場合は次のようにします。


public function up(): void
{
    Schema::create('posts', function (Blueprint $table) {
        $table->id();
        $table->string('title');
        $table->text('content');
        $table->unsignedBigInteger('user_id');
        $table->foreign('user_id')->references('id')->on('users');
        $table->timestamps();
    });
}

このように書くことで、「user_id」がusersテーブルの「id」に紐づく関係をLaravelが自動的に管理してくれます。

4. onDeleteで関連データを自動削除する方法

外部キー制約のもう一つの便利なオプションがonDelete()です。これは「親データが削除されたときに、子データをどうするか」を指定する設定です。

例えば、ユーザーが削除されたときに、その人の投稿データも一緒に削除したい場合は次のように書きます。


$table->foreign('user_id')
      ->references('id')
      ->on('users')
      ->onDelete('cascade');

onDelete('cascade')は「親のレコードが削除されたら、子も一緒に削除する」という意味です。英語で“cascade”は「滝のように連鎖する」という意味なので、データも連鎖的に削除されるイメージです。

5. onDeleteの他のオプション一覧

Laravelでは、onDeleteに指定できる動作がいくつかあります。用途に応じて使い分けましょう。

cascade：親を削除したら子も削除
restrict：親が削除されるときに、子が存在すると削除を禁止
set null：親が削除されたら子の外部キーをNULLにする
no action：特に何もせず、データベースに任せる

たとえば、ユーザーが退会しても投稿は残したい場合、set nullを使えば良いでしょう。ただし、その場合はuser_idをnullable()にしておく必要があります。


$table->unsignedBigInteger('user_id')->nullable();
$table->foreign('user_id')
      ->references('id')
      ->on('users')
      ->onDelete('set null');