逆相関関係を定義する

次に、Tag モデル上の各相関モデルのメソッドを定義する必要があります。この例では、posts メソッドと videos メソッドを定義します。

<?php
    namespace App;
    use Illuminate\Database\Eloquent\Model;
    class Tag extends Model{ 
     /**
     * 获取被打上此标签的所有文章。
     */   
      public function posts() 
         {    
             return $this->morphedByMany('App\Post', 'taggable');  
          }   
     /**
     * 获取被打上此标签的所有视频。
     */   
      public function videos()  
        {       
         return $this->morphedByMany('App\Video', 'taggable');  
         }
     }

Get the association

Once定義済みのデータベース テーブルとモデルを作成したら、モデルを通じてリレーションシップにアクセスできます。たとえば、tags 動的プロパティを使用して、記事のすべてのタグにアクセスできます。

$post = App\Post::find(1);foreach ($post->tags as $tag) { 
   //
}

また、morphedByMany メソッド呼び出しを実行するメソッド名にアクセスすることもできます。多態性モデル Model から所有権を取得します。この例では、Tag モデルの posts または videos メソッドです。これらのメソッドには、動的プロパティと同様にアクセスできます:

$tag = App\Tag::find(1);foreach ($tag->videos as $video) {
    //
 }

Custom Polymorphic Type

デフォルトでは、Laravel ストアに関連付けられたモデル完全修飾クラス名を使用した型。上記の 1 対多の例では、Comment は Post または Video に属する可能性があるため、デフォルトの commentable_type は次のようになります。 App\Post または App\Video です。ただし、データベースをアプリケーションの内部構造から切り離したい場合があります。この場合、「モーフ マッピング」を定義して、対応するクラス名の代わりにカスタム名を使用するように Eloquent に指示できます。

use Illuminate\Database\Eloquent\Relations\Relation;
Relation::morphMap([ 
   'posts' => 'App\Post',    
   'videos' => 'App\Video',
 ]);

AppServiceProvider の で実行できます。 boot 関数に morphMap を登録するか、別のサービス プロバイダーを作成します。

クエリ アソシエーション

Eloquent アソシエーションのすべてのタイプはメソッドによって定義されているため、代わりにこれらのメソッドを呼び出すことができます。関連するクエリを実際に実行する必要はありません。さらに、すべての Eloquent リレーション タイプはクエリ ビルダーとして機能するため、データベースで SQL を実行する前に一連の呼び出しを通じて制約を継続的に追加できます。

たとえば、ブログ システムの User モデルに関連する Post モデルが多数あるとします。

<?php
    namespace App;
    use Illuminate\Database\Eloquent\Model;
    class User extends Model{    
    /**
     * 获取该用户的所有文章。
     */  
     public function posts()  
       {     
          return $this->hasMany('App\Post');   
        }
    }

クエリを実行すると、posts関連付けを行い、それに制約を追加します。

$user = App\User::find(1);
$user->posts()->where('active', 1)->get();

関連付けに対して任意のクエリ ビルダー メソッドを使用できます。クエリ ビルダーのドキュメントを参照して、役立つメソッドを学習してください。

リレーション メソッドと動的プロパティ

Eloquent 相関クエリに追加の制約を追加する必要がない場合は、プロパティのようにリレーションシップにアクセスできます。たとえば、User および Post サンプル モデルを引き続き使用すると、次のようにユーザーのすべての投稿にアクセスできます。

$user = App\User::find(1);
foreach ($user->posts as $post) {
    //
  }

動的属性は「遅延読み込み」されます。これは、関連するデータに実際にアクセスした場合にのみロードされることを意味します。したがって、開発者は多くの場合、preloading を使用して、モデルのロード後にアクセスすることがわかっている関係をプリロードします。モデルの関連付けを読み込むときに実行する必要がある SQL クエリの場合、即時読み込みによりクエリの実行数が大幅に削減されます。

has メソッドと orHas メソッドに関連付け名を渡すことができます:

// 获取至少存在一条评论的所有文章...
$posts = App\Post::has('comments')->get();

// 获取评论超过三条的文章...
$posts = App\Post::has('comments', '>=', 3)->get();

has ステートメントを構築することもできます。たとえば、少なくとも 1 つのコメントが含まれる記事を取得して投票できます。

// 获取拥有至少一条带有投票评论的文章...
$posts = App\Post::has('comments.votes')->get();

whereHas メソッドと orWhereHas メソッドを使用して、 「where」条件 Go to has クエリ。これらのメソッドを使用すると、コメントの内容をチェックするなど、関連付けにカスタム制約を追加できます。

use Illuminate\Database\Eloquent\Builder;
// 获取至少带有一条评论内容包含 foo% 关键词的文章...
$posts = App\Post::whereHas('comments', function ($query)
 { 
    $query->where('content', 'like', 'foo%');})->get();
    // 获取至少带有十条评论内容包含 foo% 关键词的文章...
    $posts = App\Post::whereHas('comments', function ($query)
     { 
        $query->where('content', 'like', 'foo%');
      }, '>=', 10)->get();

doesntHave と orDoesntHave にコメントがない記事を取得したいとします。これを行うには、関連名を doesntHave と orDoesntHave に渡します。

$posts = App\Post::doesntHave('comments')->get();

use Illuminate\Database\Eloquent\Builder;
$posts = App\Post::whereDoesntHave('comments', function (Builder $query)
 {  
   $query->where('content', 'like', 'foo%');
 })->get();

「ドット」構文を使用して、ネストされた関連付けクエリを実行することもできます。たとえば、次のクエリは、禁止されていない著者からのコメントを含む記事を取得します:

use Illuminate\Database\Eloquent\Builder;
$posts = App\Post::whereDoesntHave('comments.author', function (Builder $query) 
{   
 $query->where('banned', 1);
})->get();

関連モデル数

実際に結果をロードせずに、関連する結果の統計的な数のみを計算したい場合は、 ## に配置される withCount メソッドを使用できます。結果モデルの {relation}_count 列の数。例は次のとおりです。

$posts = App\Post::withCount('comments')->get();
foreach ($posts as $post) {
    echo $post->comments_count;
   }

$posts = App\Post::withCount(['votes', 'comments' => function ($query)
 { 
    $query->where('content', 'like', 'foo%');
  }])->get();
    echo $posts[0]->votes_count;echo $posts[0]->comments_count;

$posts = App\Post::withCount([
    'comments',    
    'comments as pending_comments_count' => function ($query) { 
           $query->where('approved', false);   
      }])->get();
   echo $posts[0]->comments_count;
    echo $posts[0]->pending_comments_count;

withCount クエリと select クエリを一緒に組み立てる場合は、## の後に withCount を必ず呼び出してください。 #select メソッド :

$query = App\Post::select(['title', 'body'])->withCount('comments');
echo $posts[0]->title;
echo $posts[0]->body;
echo $posts[0]->comments_count;

属性モードで Eloquent アソシエーションにアクセスする場合、関連するデータは「遅延」ロードです。この方法では、プロパティに初めてアクセスするまで、関連付けられたデータは実際には読み込まれません。ただし、Eloquent は、親モデルをクエリするときに、子関係を「プリロード」できます。積極的な読み込みにより、N 1 クエリの問題を軽減できます。 N 1 クエリの問題を説明するために、

モデルが Author:

<?php
    namespace App;
    use Illuminate\Database\Eloquent\Model;
    class Book extends Model{  
      /**
     * 获取书籍作者。
     */ 
      public function author() 
         {    
             return $this->belongsTo('App\Author');   
          }
       }

$books = App\Book::all();
foreach ($books as $book) 
{ 
   echo $book->author->name;
}

このループは、すべての書籍を取得するクエリを実行し、次に書籍ごとに著者を取得するクエリを実行します。書籍が 25 冊ある場合、このループは 26 のクエリを実行します。1 つは書籍をクエリし、25 の追加クエリは各書籍の著者をクエリします。

ありがたいことに、熱心な読み込みを使用して操作をわずか 2 つのクエリに凝縮することができました。クエリ時に、

メソッドを使用して、プリロードする関連付けを指定できます:

$books = App\Book::with('author')->get();
foreach ($books as $book) {
    echo $book->author->name;
  }

select * from books
select * from authors where id in (1, 2, 3, 4, 5, ...)

場合によっては、1 回の操作で複数の異なる関連付けをプリロードする必要がある場合があります。これを実現するには、複数の関連する名前で構成される配列パラメーターを

メソッドに渡すだけです:

$books = App\Book::with(['author', 'publisher'])->get();

を使用できます。 Dot」構文は、ネストされた関連付けをプリロードします。たとえば、Eloquent ステートメントですべての本の著者とその連絡先情報をプリロードします。

$books = App\Book::with('author.contacts')->get();

リレーションシップのすべての列を取得する必要があるとは限りません。 。この場合、Eloquent では、関連付けのために取得したい列を指定できます:

$users = App\Book::with('author:id,name')->get();

列。

プリロードの制約を追加する

次の例のように、リレーションシップをプリロードし、追加のクエリ条件をプリロード クエリに追加することが必要な場合があります。

$users = App\User::with(['posts' => function ($query) { 
   $query->where('title', 'like', '%first%');
  }])->get();

この例では、Eloquent はtitle 列に first キーワードが含まれる記事のみをプリロードします。他のクエリ ビルダー メソッドを呼び出して、プリロード操作をさらにカスタマイズすることもできます。

$users = App\User::with(['posts' => function ($query) {
    $query->orderBy('created_at', 'desc');
  }])->get();

{note} プリロードを制約する場合、limit および take# は使用できません ##クエリコンストラクターメソッド。

モデルがロードされた後に、積極的なロードを実行したい場合もあります。たとえば、関連データを動的にロードしたい場合は、

メソッドが非常に役立ちます。

$books = App\Book::all();
if ($someCondition) {
    $books->load('author', 'publisher');
  }

クロージャ関数です。クロージャのパラメータは query 例:

$books->load(['author' => function ($query) {
    $query->orderBy('published_date', 'asc');
   }]);

メソッドを使用できます:

public function format(Book $book){
    $book->loadMissing('author');    
    return [    
        'name' => $book->name,        
        'author' => $book->author->name   
       ];
   }

関係と、その関係が返すさまざまなエンティティの入れ子になった関係をすばやくロードする場合は、loadMorph メソッドを使用できます。 このメソッドは、

リレーションシップの名前を最初のパラメーターとして受け取り、2 番目のパラメーターはモデル配列とリレーションシップ配列を受け取ります。このアプローチを説明するために、次のモデル例を見てください:

<?php
    use Illuminate\Database\Eloquent\Model;
    class ActivityFeed extends Model{   
     /**
     * Get the parent of the activity feed record.
     */   
   public function parentable() 
      {    
          return $this->morphTo(); 
       }
    }

、Photo、および Post# を想定します。 # # モデルは ActivityFeed モデルを作成できます。さらに、Event モデルが Calendar モデルに属し、Photo モデルが Tag モデルに関連付けられていると仮定します。 Post モデルは Author モデルに属します。 これらのモデル定義と関係を使用すると、ActivityFeed

parentable モデルとそれぞれのネストされた関係を一度に読み込むことができます:

$activities = ActivityFeed::with('parentable')
    ->get()    
    ->loadMorph('parentable', [ 
           Event::class => ['calendar'],        
           Photo::class => ['tags'],        
           Post::class => ['author'],   
          ]);

##

保存メソッド

Eloquent は、新しいモデルに関連付けを追加するための便利な方法を提供します。たとえば、新しい Comment を Post モデルに追加する必要がある場合があります。 Comment の post_id 属性を手動で設定する必要はありません。 save メソッドを使用して、Comment を直接挿入できます。関連モデル:

$comment = new App\Comment(['message' => 'A new comment.']);
$post = App\Post::find(1);
$post->comments()->save($comment);

comments 関連付けにアクセスするために動的属性を使用しないことに注意してください。代わりに、comments メソッドを呼び出して、関連付けられたインスタンスを取得します。 save メソッドは、適切な post_id 値を Comment モデルに自動的に追加します。

複数の関連モデルを保存する必要がある場合は、saveMany メソッドを使用できます:

$post = App\Post::find(1);
$post->comments()->saveMany([ 
   new App\Comment(['message' => 'A new comment.']),    
   new App\Comment(['message' => 'Another comment.']),
 ]);

モデルと関連データを再帰的に保存します

モデルとそのすべての関連データを 保存したい場合は、push メソッドを使用できます:

$post = App\Post::find(1);
$post->comments[0]->message = 'Message';
$post->comments[0]->author->name = 'Author Name';$post->push();

save と saveMany に加えてメソッドのほかに、create メソッドを使用することもできます。プロパティの配列を受け取り、モデルを作成してデータベースに挿入します。また、save メソッドと create メソッドの違いは、save メソッドは完全な Eloquent モデル インスタンスを受け入れるのに対し、create## メソッドは受け入れられることです。 # その後、通常の PHP 配列を受け入れます:

$post = App\Post::find(1);
$comment = $post->comments()->create([
    'message' => 'A new comment.',
  ]);

create

メソッドを使用する前に、このドキュメントのバッチ割り当ての章を必ず確認してください。

メソッドを使用して、複数の関連モデルを作成することもできます。

$post = App\Post::find(1);$post->comments()->createMany([
    [  
          'message' => 'A new comment.',  
     ],    
     [    
           'message' => 'Another new comment.',  
     ],
  ]);

、 を使用することもできます。 firstOrNew、firstOrCreate、および updateOrCreate メソッドを使用して、リレーショナル モデルを作成および更新します。

Association

関連付けを更新するときは、associate メソッドを使用できます。このメソッドは、子モデルに外部キーを設定します。

$account = App\Account::find(10);
$user->account()->associate($account);$user->save();

関連付けを削除するときは、dissociate メソッドを使用できます。このメソッドは、関連付けられた外部キーを null:

$user->account()->dissociate();$user->save();

Default Model

belongsTo リレーションシップを使用すると、デフォルト モデルを指定できます。指定されたリレーションシップが null の場合、デフォルト モデルが返されます。このモードは Null オブジェクト モード と呼ばれ、コード内の不要なチェックを減らすことができます。以下の例では、公開された投稿の作成者が見つからない場合、user リレーションシップは空の App\User モデルを返します:

/**
 * 获取帖子的作者。
 */
 public function user(){
     return $this->belongsTo('App\User')->withDefault();
   }

デフォルト モデル プロパティを追加するには、配列またはコールバック メソッドを withDefault に渡すことができます:

/**
 * 获取帖子的作者。
 */
 public function user(){
     return $this->belongsTo('App\User')->withDefault([ 
            'name' => 'Guest Author', 
          ]);
       }
 /**
 * 获取帖子的作者。
 */
 public function user(){
     return $this->belongsTo('App\User')->withDefault(function ($user) {
             $user->name = 'Guest Author'; 
            });
        }

attach メソッドを使用して完了できます:

$user = App\User::find(1);
$user->roles()->attach($roleId);

$user->roles()->attach($roleId, ['expires' => $expires]);

detach を使用すると、多対多の関連レコードを削除できます。 detach メソッドは中間テーブルに対応するレコードを削除しますが、これら 2 つのモデルはデータベースに残ります:

// 移除用户的一个角色...
$user->roles()->detach($roleId);
// 移除用户的所有角色...
$user->roles()->detach();

attach と detach では、ID の配列を渡すこともできます。

$user = App\User::find(1);
$user->roles()->detach([1, 2, 3]);
$user->roles()->attach([
    1 => ['expires' => $expires],    
    2 => ['expires' => $expires]
  ]);

sync メソッドを使用して、多数の ID を構築することもできます。 -対多の関連付け。 sync メソッドは ID の配列を受け取り、中間テーブルのレコードを置き換えます。中間テーブルのレコードのうち、ID 配列にないレコードはすべて削除されます。したがって、操作が完了した後は、指定された配列の ID のみが中間テーブルに保持されます:

$user->roles()->sync([1, 2, 3]);

$user->roles()->sync([1 => ['expires' => true], 2, 3]);

syncWithoutDetaching メソッドを使用できます:

$user->roles()->syncWithoutDetaching([1, 2, 3]);

toggle メソッドは、指定された ID 配列の接続状態を「切り替える」ために使用されます。指定された ID が既に中間テーブルに追加されている場合は、その ID が削除されます。同様に、指定された ID が削除されている場合は、追加されます:

$user->roles()->toggle([1, 2, 3]);

App\User::find(1)->roles()->save($role, ['expires' => $expires]);

$user = App\User::find(1);
$user->roles()->updateExistingPivot($roleId, $attributes);

<?php
    namespace App;
    use Illuminate\Database\Eloquent\Model;
    class Comment extends Model{ 
       /**
     * 要触发的所有关联关系
     *
     * @var array
     */  
      protected $touches = ['post'];   
     /**
     * 评论所属的文章
     */   
     public function post() 
        {     
           return $this->belongsTo('App\Post');  
         }
      }

$comment = App\Comment::find(1);
$comment->text = 'Edit to this comment!';
$comment->save();