Laravel リレーションがうまくいかない？

Question

前提・実現したいこと

Laravel 6系を使用しています。
今回、問い合わせ画面を作成するにあたり、「都道府県」のセレクトボックスを作成することになりました。
セレクトボックスの中身（「北海道」など）はDBに保存しています。
そこで、問い合わせテーブル「contacts」に「pref_id」という外部キーを設けて、都道府県テーブル「prefectures」とリレーションを持たせようとしているのですが、問い合わせ情報を取得するときに都道府県の内容が取得できないくて困っています

該当のソースコード

「都道府県」のマスタテーブルを作成するマイグレーションファイル

<?php

use Illuminate\Database\Migrations\Migration;
use Illuminate\Database\Schema\Blueprint;
use Illuminate\Support\Facades\Schema;

class CreatePrefecturesTable extends Migration
{
    /**
     * Run the migrations.
     *
     * @return void
     */
    public function up()
    {
        Schema::create('prefectures', function (Blueprint $table) {
            $table->increments('id');
            $table->integer('code')->default(0);
            $table->text('name');
        });
    }

    /**
     * Reverse the migrations.
     *
     * @return void
     */
    public function down()
    {
        Schema::dropIfExists('prefectures');
    }
}

「問い合わせ」のテーブルを作成するマイグレーションファイル

<?php

use Illuminate\Database\Migrations\Migration;
use Illuminate\Database\Schema\Blueprint;
use Illuminate\Support\Facades\Schema;

class CreateContactsTable extends Migration
{
    /**
     * Run the migrations.
     *
     * @return void
     */
    public function up()
    {
        Schema::create('contacts', function (Blueprint $table) {
            $table->increments('id');
            $table->timestamps();
            $table->string('first_name');
            $table->string('last_name');
            $table->string('email');
            $table->string('job_title');
            $table->string('city');   
            $table->string('country');
            $table->unsignedInteger('pref_id');
            $table->foreign('pref_id')->references('id')->on('prefectures'); 
        });
    }

    /**
     * Reverse the migrations.
     *
     * @return void
     */
    public function down()
    {
        Schema::dropIfExists('contacts');
    }
}

試したこと

「お問い合わせ」のモデルにbelongsToを定義しました。

<?php

namespace App\Models; 
use Illuminate\Database\Eloquent\Model;

class Contact extends Model
{
    protected $fillable = [
        'first_name', 'last_name', 'email', 'city', 'country', 'job_title', 'pref_id',
    ];
    public function prefecture(){
        return $this->belongsTo('App\Models\Prefecture');
    }
}

問い合わせのコントローラで全件データを取得しました。

class ContactController extends Controller
{
    /**
     * Display a listing of the resource.
     *
     * @return \Illuminate\Http\Response
     */
    public function index()
    {
        $contacts = Contact::all();
        var_dump($contacts);  
        return view('contacts.index', compact('contacts'));
    }

上記のように。var_dumpで全件確認してみたのですが、「お問い合わせ」のモデルでbelongsToした情報が取れないです。
データも登録されているのですが、リレーションの使い方に誤りがあるのでしょうか？

ご回答お願い致します。

Answer 1

Contactモデルのリレーション定義方法に誤りがありますよ。

Laravelのドキュメントには以下の記載があります。
https://readouble.com/laravel/6.x/ja/eloquent-relationships.html#one-to-many

Eloquentはリレーションメソッドの名前として、_に続けて主キーのカラム名をサフィックスとして付けた名前をデフォルトの外部キーとします。
しかしCommentモデルの外部キーがpost_idでなければ、belongsToメソッドの第２引数にカスタムキー名を指定してください。

多分こんな感じだと取得できそうです。

public function prefecture(){
    return $this->belongsTo('App\Models\Prefecture', 'pref_id');
}

Laravelのドキュメントは落ち着いて読めば簡単なことしか書いていないので、ハマったら確認しにいくのがよいですよ！

Comments

[eroeronnnnnn]

ありがとうございます！ドキュメントしっかり読みます。。