modelのリレーションができない。

Question

以下のモデルトテーブル構造があります。

Employeeモデル

<?php

namespace App;

use Illuminate\Database\Eloquent\Model;

class Employee extends Model
{
    //
    protected $fillable = ['name', 'sex', 'dept_id'];

    //belongsTo設定
    public function dept()
    {
        return $this->belongsTo('App\Dept');
    }
}

Deptモデル

<?php

namespace App;

use Illuminate\Database\Eloquent\Model;

class Dept extends Model
{
    //
    protected $fillable = ['dept_cd', 'dept_name'];
    
    //hasMany設定
    public function employees()
    {
        return $this->hasMany('App\Employee');
    }
}

employeesテーブル

<?php

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

class CreateEmployeesTable extends Migration
{
    /**
     * Run the migrations.
     *
     * @return void
     */
    public function up()
    {
        Schema::create('employees', function (Blueprint $table) {
            $table->bigIncrements('id');
            $table->string('name');
            $table->tinyInteger('sex');
            $table->bigInteger('dept_id')->unsigned();
            $table->timestamps();
            $table->foreign('dept_id')->references('dept_id')->on('depts');
        });
    }

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

deptsテーブル

<?php

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

class CreateDeptsTable extends Migration
{
    /**
     * Run the migrations.
     *
     * @return void
     */
    public function up()
    {
        Schema::create('depts', function (Blueprint $table) {
            $table->bigIncrements('dept_id');
            $table->string('dept_cd');
            $table->string('dept_name');
            $table->timestamps();
        });
    }

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

問題と現状
まずテーブルをマイグレート時に外部キー制約はきちんとつけられています。（確認済み）

$employees = Employee::all();

を実行し

$employee->dept->dept_name

で部署名を取得しようとすると以下のエラーが出ます。

SQLSTATE[42S22]: Column not found: 1054 Unknown column 'depts.id' in 'where clause' (SQL: select * from `depts` where `depts`.`id` = 1 limit 1)"

調べて分かったこと
おそらくですが、deptメソッドを呼び出すときに自動的に参照先のidという名前を探しにいっているようです。

質問
①このようにmodelで結合させる場合、テーブル先の採番の列は常にidという名前から変更できないのでしょうか。

②①が正しいなら、参照先には常に自動生成のid(bigIncrements)ということになる気がするのですが。

補足
deptテーブルの採番のカラム名を
$table->bigIncrements('id');に変更しemployeesもそれに合わせて表示すると表示はされるようになりました。

Answer 1

belongsToの第三引数を利用してください。

return $this->belongsTo('App\Dept',"dept_id","dept_id");

Laravel5.8で、belongsToのメソッド内では、第三引数が設定されていない場合は、以下の命名規則にて外部キー名として自動設定されます。
larave HasRelationships.php

        if (is_null($foreignKey)) {
            $foreignKey = Str::snake($relation).'_'.$instance->getKeyName();
        }

Answer 2

https://readouble.com/laravel/5.7/ja/eloquent.html

こちらの「Eloquentモデル規約 > 主キー」に、ご質問の1,2ともに回答が書かれています。

主キー
Eloquentは更にテーブルの主キーがidというカラム名であると想定しています。この規約をオーバーライドする場合は、protectedのprimaryKeyプロパティを定義してください。

さらに、Eloquentは主キーを自動増分される整数値であるとも想定しています。つまり、デフォルト状態で主キーは自動的にintへキャストされます。自動増分ではない、もしくは整数値ではない主キーを使う場合、モデルにpublicの$incrementingプロパティを用意し、falseをセットしてください。主キーが整数でない場合は、モデルのprotectedの$keyTypeプロパティへstring値を設定してください。

つまり、今回の場合、deptテーブルの主キーが「dept_id」なので、
Deptモデルのプロパティ（＝クラス変数）として

protected $primaryKey = 'dept_id';

を記載すればOKです。

もしくは、Laravelのデフォルトに則るために「deptsテーブルの主キーをdept_id→idに変更する」でも良いかと思います。

Comments

[Chandler_Bing]

ありがとうございます。