Laravelのリレーションについて

Question

色々とググってみたのですが、
どうもこのポイントに言及している記事が見当たらなかったので。

例えば、hasMany()でPerson(1),Hobby(多)を以下のように定義します。

# モデル
public function hobbies()
{
	return $this->hasMany( 'App\Models\Hobby' );
}

# モデル
public function people()
{
	return $this->belongTo( 'App\Models\Person' );
}

# コントローラ
$aaa = $user->hobbies; // ~\Eloquent\Collectionインスタンス
$bbb = $user->hobbies(); // ~\Eloquent\HasManyインスタンス(?)

この３つ目の$bbbに格納されているHasManyインスタンス(?)というものがよく分かりません。

ちなみにきっかけは$user->hobbies()->fill()のようにfill()が使えなかったので、
(ただ、$user->hobbies()->create()は使える)
デバッグしてHasManyインスタンス(?)らしきものを見つけました。
ただ、調べていたのですが、どうもHasManyインスタンス(?)がなにものなのか、
ここの部分をピンポイントで説明してくれているサイトがなかったのでこちらで質問を致しました。

わかる方がいらっしゃればご教授お願い致します。

Comments

[m.ts10806]

＞色々とググってみた
どのようなキーワードで探してどのような記事を書いたか記載願います。
でないと回答で提示された情報が「既にみた」となれば二度手間三度手間になりますし、
その探し方が正しいのか、読んだ記事が正しいのか、理解できているのかがわかればアドバイスの仕方も的確になります。

Answer 1

端的にいうと 「リレーションオブジェクト」 です。

• 【Laravel】 第1回 Eloquent ソースコードリーディング - モデルの取得 - Qiita
• 【Laravel】 第2回 Eloquent ソースコードリーディング - リレーションの取得 - Qiita

↑の説明は SELECT による取得時の話ですが，

$user->hobbies()->create()

のように使う場合， $user->hobbies() で user_id が埋められた状態になり， ->create() でそれを引き継いでモデルを作成する，と考えると良さそうです。

database/HasOneOrMany.php at master · illuminate/database

HasMany の基底クラスである HasOneOrMany の実装を見ると何をやっているか一目瞭然です。

/**
 * Create a new instance of the related model.
 *
 * @param  array  $attributes
 * @return \Illuminate\Database\Eloquent\Model
 */
public function create(array $attributes = [])
{
    return tap($this->related->newInstance($attributes), function ($instance) {
        $this->setForeignAttributesForCreate($instance);
        $instance->save();
    });
}

$this->related に Hobby モデルの仮のインスタンス（テーブルクラス代わりのモデルインスタンス）が入っており，newInstance($attributes) で意味のあるモデルインスタンスを生成しています。そしてsetForeignAttributesForCreate() で外部キーがセットされ，そのままモデルの save() が呼ばれています。

Comments

[mpyw]

Eloquent に関しては，（少々難易度は高いですが）詳しく理解したかったら「本体のソースコードを読みましょう」という流れにならざるを得ないですね。公式ドキュメントはそんなに詳しく解説してくれないので…

[mikeross]

良い具合に仕組みレベルまで解説いただきありがとうございます。よく分かりました。
まさにリレーションオブジェクトという固有名詞を知らなかったので
検索に時間がかかっていたのですが、下記のサイトでもかなり詳しく解説がありました。

https://qiita.com/katsunory/items/d4757b8d9ac099a5291e

[mikeross]

他にも「動的プロパティ」「リレーションメソッド」など、自分の中で新しいキーワードがインプットされ
それぞれの立ち位置が整理されました。
(別の疑問ですが、この手の解説が少ないのですが、逆にみなさんはこのあたりを理解されて使っているのですかね...?)

[mpyw]

理解せずに使っている人のほうが多いと思いますｗ

[mikeross]

みなさん勇者ですね(笑)

Answer 2

$user->hobbies()->get(); // <-getが重要

と

$user->hobbies;

と

Hobby::where('user_id', $user->id)->get();

はだいたい一緒です。これらは全てEloquent\Collectionです。

感覚的には、()がある場合は、リレーションの途中式の状態で取得する（その他、create、saveもできる）
ない場合は、普通にgetした時と一緒、と考えればいいと思います。

Answer 3

以下のクラス名が何なのかという点と
テーブル定義の情報がないので説明以前の問題かもしれません。
public function hobbies()
public function people()

情報の追記などがあると記述の指摘などをしてくれる人がいるかもしれないですね。

ドキュメントの１対多を参照
https://readouble.com/laravel/5.5/ja/eloquent-relationships.html#one-to-many

親から子のモデルを1対多で使えるようにするなら
以下のようなモデルのクラスになるかとおもいます。
ex.)

<?php

namespace App;

use Illuminate\Database\Eloquent\Model;

class Person extends Model
{
    /**
     * 人に対しての趣味を取得
     */
    public function hobbies()
    {
        return $this->hasMany('App\Hobby');
    }
}

Hobbyのテーブルにはperson_idの外部キーがあること。
PersonテーブルのidとHobbyテーブルのperson_idが一致するデータを
hobbies()関数を実行すると取得できるという解釈でいいと思います。

コントローラーで利用するときには以下のような使い方

// 使い方Aパターン
use App\Person; // クラス外に記述し以下のような書き方をする

$hobbies = $person->hobbies()->where('name', 'me')->first();

//　使い方Bパターン
$hobbies = App\Person::find(1)->hobbies()->where('name', 'me')->first();

ひとつひとつの記述をおおまかに書きましたが参考まで。
もう少し情報があると詳しく説明してくれる人がいるかも。

何がやりたくてどのように記述すればいいのかという点を突き詰めるといいと思います。