模型关联 · laravel 5.4

<article><h1>Eloquent: 关联</h1><ul><li><a href="#introduction">简介</a></li><li><a href="#defining-relationships">定义关联</a><ul><li><a href="#one-to-one">一对一</a></li><li><a href="#one-to-many">一对多</a></li><li><a href="#one-to-many-inverse">一对多（反向关联）</a></li><li><a href="#many-to-many">多对多</a></li><li><a href="#has-many-through">远层一对多</a></li><li><a href="#polymorphic-relations">多态关联</a></li><li><a href="#many-to-many-polymorphic-relations">多态多对多关联</a></li></ul></li><li><a href="#querying-relations">查找关联</a><ul><li><a href="#relationship-methods-vs-dynamic-properties">关联方法和动态属性</a></li><li><a href="#querying-relationship-existence">查找关联是否存在</a></li><li><a href="#counting-related-models">关联数据计数</a></li></ul></li><li><a href="#eager-loading">预加载</a><ul><li><a href="#constraining-eager-loads">预加载条件限制</a></li><li><a href="#lazy-eager-loading">延迟预加载</a></li></ul></li><li><a href="#inserting-and-updating-related-models">插入 & 更新关联模型</a><ul><li><a href="#the-save-method"><code class=" language-php">save</code> 方法</a></li><li><a href="#the-create-method"><code class=" language-php">create</code> 方法</a></li><li><a href="#updating-belongs-to-relationships">更新「从属」关联</a></li><li><a href="#updating-many-to-many-relationships">多对多关联</a></li></ul></li><li><a href="#touching-parent-timestamps">连动父级时间戳</a></li></ul><a name="introduction"></a><h2><a href="#introduction">简介</a></h2>数据表之间经常会互相进行关联。例如，一篇博客文章可能会有多条评论，或是一张订单可能对应一个下单客户。Eloquent 让管理和处理这些关联变得很容易，同时也支持多种类型的关联：<ul><li><a href="#one-to-one">一对一</a></li><li><a href="#one-to-many">一对多</a></li><li><a href="#many-to-many">多对多</a></li><li><a href="#has-many-through">远层一对多</a></li><li><a href="#polymorphic-relations">多态关联</a></li><li><a href="#many-to-many-polymorphic-relations">多态多对多关联</a></li></ul><a name="defining-relationships"></a><h2><a href="#defining-relationships">定义关联</a></h2>你可在 Eloquent 模型类内中，把 Eloquent 关联定义成方法（methods）。因为，关联就像 Eloquent 模型一样，也可以作为强大的 <a href="/docs/5.4/queries">查询语句构造器</a>，定义关联为方法，为其提供了强而有力的链式调用及查找功能。例如，我们可以在 <code class=" language-php">posts</code> 关联的链式调用中附加一个约束条件：<pre class=" language-php"><code class=" language-php">$user->posts()->where('active', 1)->get();</code></pre>不过，在深入了解使用关联之前，先让我们来学习如何定义每个类型：<a name="one-to-one"></a><h3>一对一</h3>「一对一」关联是一个非常基本的关联关系。举个例子，一个 <code class=" language-php">User</code> 模型会关联一个 <code class=" language-php">Phone</code> 模型。为了定义这种关联关系，我们需要在 <code class=" language-php">User</code> 模型中写一个 <code class=" language-php">phone</code> 方法。且 <code class=" language-php">phone</code> 方法应该调用 <code class=" language-php">hasOne</code> 方法并返回其结果：<pre class=" language-php"><code class=" language-php"><?php namespace App; use Illuminate\Database\Eloquent\Model; class User extends Model { /** * 获取与用户关联的电话号码 */ public function phone() { return $this->hasOne('App\Phone'); } }</code></pre>第一个传到 <code class=" language-php">hasOne</code> 方法里的参数是关联模型的类名。一旦定义好两者之间关联，我们就可以通过使用 Eloquent 的动态属性来获取关联记录。动态属性允许你访问关联方法，如同他们是定义在模型中的属性：<pre class=" language-php"><code class=" language-php">$phone = User::find(1)->phone;</code></pre>Eloquent 会假设对应关联的外键名称是基于模型名称的。在这个例子里，它会自动假设 <code class=" language-php">Phone</code> 模型拥有 <code class=" language-php">user_id</code> 外键。如果你想要重写这个约定，则可以传入第二个参数到 <code class=" language-php">hasOne</code> 方法里。<pre class=" language-php"><code class=" language-php">return $this->hasOne('App\Phone', 'foreign_key');</code></pre>此外，Eloquent 假设外键会和上层模型的 <code class=" language-php">id</code> 字段（或者自定义的 <code class=" language-php">$primaryKey</code>）的值相匹配。换句话说，Eloquent 会寻找用户的 <code class=" language-php">id</code> 字段与 <code class=" language-php">Phone</code> 模型的 <code class=" language-php">user_id</code> 字段的值相同的纪录。如果你想让关联使用 <code class=" language-php">id</code> 以外的值，则可以传递第三个参数至 <code class=" language-php">hasOne</code> 方法来指定你自定义的键：<pre class=" language-php"><code class=" language-php">return $this->hasOne('App\Phone', 'foreign_key', 'local_key');</code></pre><h4>定义反向关联</h4>所以，我们可以从 <code class=" language-php">User</code> 模型访问到 <code class=" language-php">Phone</code> 模型。现在，让我们在 <code class=" language-php">Phone</code> 模型上定义一个关联，此关联能够让我们访问拥有此电话的 <code class=" language-php">User</code> 模型。我们可以定义与 <code class=" language-php">hasOne</code> 关联相对应的 <code class=" language-php">belongsTo</code> 方法：<pre class=" language-php"><code class=" language-php"><?php namespace App; use Illuminate\Database\Eloquent\Model; class Phone extends Model { /** * 获取拥有该电话的用户模型。 */ public function user() { return $this->belongsTo('App\User'); } }</code></pre>在上述例子中，Eloquent 会尝试匹配 <code class=" language-php">Phone</code> 模型的 <code class=" language-php">user_id</code> 至 <code class=" language-php">User</code> 模型的 <code class=" language-php">id</code>。Eloquent 判断的默认外键名称参考自关联模型的方法名称，并会在方法名称后面加上 <code class=" language-php">_id</code>。当然，如果 <code class=" language-php">Phone</code> 模型的外键不是 <code class=" language-php">user_id</code>，则可以传递自定义键名作为 <code class=" language-php">belongsTo</code> 方法的第二个参数：<pre class=" language-php"><code class=" language-php">/** * 获取拥有该电话的用户模型。 */ public function user() { return $this->belongsTo('App\User', 'foreign_key'); }</code></pre>如果你的父级模型不是使用 <code class=" language-php">id</code> 作为主键，或是希望以不同的字段来连接下层模型，则可以传递第三个参数至 <code class=" language-php">belongsTo</code> 方法来指定父级数据表的自定义键：<pre class=" language-php"><code class=" language-php">/** * 获取拥有该电话的用户模型。 */ public function user() { return $this->belongsTo('App\User', 'foreign_key', 'other_key'); }</code></pre><a name="one-to-many"></a><h3>一对多</h3>一个「一对多」关联用于定义单个模型拥有任意数量的其它关联模型。例如，一篇博客文章可能会有无限多个评论。就像其它的 Eloquent 关联一样，可以通过在 Eloquent 模型中写一个函数来定义一对多关联：<pre class=" language-php"><code class=" language-php"><?php namespace App; use Illuminate\Database\Eloquent\Model; class Post extends Model { /** * 获取这篇博文下的所有评论。 */ public function comments() { return $this->hasMany('App\Comment'); } }</code></pre>切记，Eloquent 会自动判断 <code class=" language-php">Comment</code> 模型上正确的外键字段。按约定来说，Eloquent 会取用自身模型的名称的「Snake Case」，并在后方加上 <code class=" language-php">_id</code>。所以，以此例来说，Eloquent 会假设 <code class=" language-php">Comment</code> 模型的外键是 <code class=" language-php">post_id</code>。一旦关联被定义，则可以通过 <code class=" language-php">comments</code> 属性来访问评论的集合。切记，因为 Eloquent 提供了「动态属性」，因此我们可以对关联方法进行访问，就像他们是在模型中定义的属性一样：<pre class=" language-php"><code class=" language-php">$comments = App\Post::find(1)->comments; foreach ($comments as $comment) { // }</code></pre>当然，因为所有的关联也都提供了查询语句构造器的功能，因此你可以对获取到的评论进一步增加条件，通过调用 <code class=" language-php">comments</code> 方法然后在该方法后面链式调用查询条件:<pre class=" language-php"><code class=" language-php">$comments = App\Post::find(1)->comments()->where('title', 'foo')->first();</code></pre>就像 <code class=" language-php">hasOne</code> 方法，你也可以通过传递额外的参数至 <code class=" language-php">hasMany</code> 方法来重写外键与本地键：<pre class=" language-php"><code class=" language-php">return $this->hasMany('App\Comment', 'foreign_key'); return $this->hasMany('App\Comment', 'foreign_key', 'local_key');</code></pre><a name="one-to-many-inverse"></a><h3>一对多（反向关联）</h3>现在我们已经能访问到所有文章的评论，让我们来接着定义一个通过评论访问所属文章的关联。若要定义相对于 <code class=" language-php">hasMany</code> 的关联，可在子级模型定义一个叫做 <code class=" language-php">belongsTo</code> 方法的关联函数：<pre class=" language-php"><code class=" language-php"><?php namespace App; use Illuminate\Database\Eloquent\Model; class Comment extends Model { /** * 获取该评论所属的文章模型。 */ public function post() { return $this->belongsTo('App\Post'); } }</code></pre>一旦关联被定义之后，则可以通过 <code class=" language-php">post</code> 的「动态属性」来获取 <code class=" language-php">Comment</code> 模型相对应的 <code class=" language-php">Post</code> 模型：<pre class=" language-php"><code class=" language-php">$comment = App\Comment::find(1); echo $comment->post->title;</code></pre>在上述例子中，Eloquent 会尝试将 <code class=" language-php">Comment</code> 模型的 <code class=" language-php">post_id</code> 与 <code class=" language-php">Post</code> 模型的 <code class=" language-php">id</code> 进行匹配。Eloquent 判断的默认外键名称参考自关联模型的方法，并在方法名称后面加上 <code class=" language-php">_id</code>。当然，如果 <code class=" language-php">Comment</code> 模型的外键不是 <code class=" language-php">post_id</code>，则可以传递自定义键名作为 <code class=" language-php">belongsTo</code> 方法的第二个参数：<pre class=" language-php"><code class=" language-php">/** * 获取该评论所属的文章模型。 */ public function post() { return $this->belongsTo('App\Post', 'foreign_key'); }</code></pre>如果你的父级模型不是使用 <code class=" language-php">id</code> 作为主键，或是你希望以不同的字段来连接下层模型，则可以传递第三个参数给 <code class=" language-php">belongsTo</code> 方法来指定上层数据表的自定义键：<pre class=" language-php"><code class=" language-php">/** * 获取该评论所属的文章模型。 */ public function post() { return $this->belongsTo('App\Post', 'foreign_key', 'other_key'); }</code></pre><a name="many-to-many"></a><h3>多对多</h3>「多对多」关联要稍微比 <code class=" language-php">hasOne</code> 及 <code class=" language-php">hasMany</code> 关联复杂。如，一个用户可能拥有多种身份，而一种身份能同时被多个用户拥有。举例来说，很多用户都拥有「管理员」的身份。要定义这种关联，需要使用三个数据表：<code class=" language-php">users</code>、<code class=" language-php">roles</code> 和 <code class=" language-php">role_user</code>。<code class=" language-php">role_user</code> 表命名是以相关联的两个模型数据表来依照字母顺序命名，并包含了 <code class=" language-php">user_id</code> 和 <code class=" language-php">role_id</code> 字段。多对多关联通过编写一个在自身 Eloquent 类调用的 <code class=" language-php">belongsToMany</code> 的方法来定义。举个例子，让我们在 <code class=" language-php">User</code> 模型中定义 <code class=" language-php">roles</code> 方法：<pre class=" language-php"><code class=" language-php"><?php namespace App; use Illuminate\Database\Eloquent\Model; class User extends Model { /** * 属于该用户的身份。 */ public function roles() { return $this->belongsToMany('App\Role'); } }</code></pre>一旦关联被定义，则可以使用 <code class=" language-php">roles</code> 动态属性来访问用户的身份：<pre class=" language-php"><code class=" language-php">$user = App\User::find(1); foreach ($user->roles as $role) { // }</code></pre>当然，就如所有其它的关联类型一样，你也可以调用 <code class=" language-php">roles</code> 方法并在该关联之后链式调用查询条件：<pre class=" language-php"><code class=" language-php">$roles = App\User::find(1)->roles()->orderBy('name')->get();</code></pre>如前文提到那样，Eloquent 会合并两个关联模型的名称并依照字母顺序命名。当然你也可以随意重写这个约定。可通过传递第二个参数至 <code class=" language-php">belongsToMany</code> 方法来实现：<pre class=" language-php"><code class=" language-php">return $this->belongsToMany('App\Role', 'role_user');</code></pre>除了自定义合并数据表的名称，你也可以通过传递额外参数至 <code class=" language-php">belongsToMany</code> 方法来自定义数据表里的键的字段名称。第三个参数是你定义在关联中的模型外键名称，而第四个参数则是你要合并的模型外键名称：<pre class=" language-php"><code class=" language-php">return $this->belongsToMany('App\Role', 'role_user', 'user_id', 'role_id');</code></pre><h4>定义相对的关联</h4>要定义相对于多对多的关联，只需简单的放置另一个名为 <code class=" language-php">belongsToMany</code> 的方法到你关联的模型上。让我们接着以用户身份为例，在 <code class=" language-php">Role</code> 模型中定义 <code class=" language-php">users</code> 方法：<pre class=" language-php"><code class=" language-php"><?php namespace App; use Illuminate\Database\Eloquent\Model; class Role extends Model { /** * 属于该身份的用户。 */ public function users() { return $this->belongsToMany('App\User'); } }</code></pre>如你所见，此定义除了简单的参考 <code class=" language-php">App\User</code> 模型外，与 <code class=" language-php">User</code> 的对应完全相同。因为我们重复使用了 <code class=" language-php">belongsToMany</code> 方法，当定义相对于多对多的关联时，所有常用的自定义数据表与键的选项都是可用的。<h4>获取中间表字段</h4>正如你所知，要操作多对多关联需要一个中间数据表。Eloquent 提供了一些有用的方法来和这张表进行交互。例如，假设 <code class=" language-php">User</code> 对象关联到很多的 <code class=" language-php">Role</code> 对象。访问这些关联对象时，我们可以在模型中使用 <code class=" language-php">pivot</code> 属性来访问中间数据表的数据：<pre class=" language-php"><code class=" language-php">$user = App\User::find(1); foreach ($user->roles as $role) { echo $role->pivot->created_at; }</code></pre>注意我们取出的每个 <code class=" language-php">Role</code> 模型对象，都会被自动赋予 <code class=" language-php">pivot</code> 属性。此属性代表中间表的模型，它可以像其它的 Eloquent 模型一样被使用。默认情况下，<code class=" language-php">pivot</code> 对象只提供模型的键。如果你的 pivot 数据表包含了其它的属性，则可以在定义关联方法时指定那些字段：<pre class=" language-php"><code class=" language-php">return $this->belongsToMany('App\Role')->withPivot('column1', 'column2');</code></pre>如果你想要中间表自动维护 <code class=" language-php">created_at</code> 和 <code class=" language-php">updated_at</code> 时间戳，可在定义关联方法时加上 <code class=" language-php">withTimestamps</code> 方法：<pre class=" language-php"><code class=" language-php">return $this->belongsToMany('App\Role')->withTimestamps();</code></pre><h4>使用中间表来过滤关联数据</h4>你可以使用 <code class=" language-php">wherePivot</code> 和 <code class=" language-php">wherePivotIn</code> 来增加中间件表过滤条件：<pre class=" language-php"><code class=" language-php">return $this->belongsToMany('App\Role')->wherePivot('approved', 1); return $this->belongsToMany('App\Role')->wherePivotIn('priority', [1, 2]);</code></pre><h4>定义自定义中间表模型</h4>如果你想定义一个自定义模型来表示你中间表的关联，则可以在定义关联时调用 <code class=" language-php">using</code> 方法。所有用来表示中间表关联的自定义模型必须扩展自 <code class=" language-php">Illuminate\Database\Eloquent\Relations\Pivot</code> 类：<pre class=" language-php"><code class=" language-php"><?php namespace App; use Illuminate\Database\Eloquent\Model; class Role extends Model { /** * 属于该身份的用户。 */ public function users() { return $this->belongsToMany('App\User')->using('App\UserRole'); } }</code></pre><a name="has-many-through"></a><h3>远层一对多</h3>「远层一对多」提供了方便简短的方法来通过中间的关联获取远层的关联。例如，一个 <code class=" language-php">Country</code> 模型可能通过中间的 <code class=" language-php">Users</code> 模型关联到多个 <code class=" language-php">Posts</code> 模型。让我们来看看定义此种关联的数据表：<pre class=" language-php"><code class=" language-php">countries id - integer name - string users id - integer country_id - integer name - string posts id - integer user_id - integer title - string</code></pre>虽然 <code class=" language-php">posts</code> 本身不包含 <code class=" language-php">country_id</code> 字段，但 <code class=" language-php">hasManyThrough</code> 关联通过 <code class=" language-php">$country->posts</code> 来让我们可以访问一个国家的文章。若运行此查找，则 Eloquent 会检查中间表 <code class=" language-php">users</code> 的 <code class=" language-php">country_id</code>。在找到匹配的用户 ID 后，就会在 <code class=" language-php">posts</code> 数据表中使用它们来进行查找。现在我们已经检查完了关联的数据表结构，让我们来接着在 <code class=" language-php">Country</code> 模型中定义它：<pre class=" language-php"><code class=" language-php"><?php namespace App; use Illuminate\Database\Eloquent\Model; class Country extends Model { /** * 获取该国家的所有文章。 */ public function posts() { return $this->hasManyThrough('App\Post', 'App\User'); } }</code></pre><code class=" language-php">hasManyThrough</code> 方法的第一个参数为我们希望最终访问的模型名称，而第二个参数为中间模型的名称。当运行关联查找时，通常会使用 Eloquent 的外键约定。如果你想要自定义关联的键，则可以将它们传递至 <code class=" language-php">hasManyThrough</code> 方法的第三与第四个参数。第三个参数为中间模型的外键名称，而第四个参数为最终模型的外键名称，第五个参数则为本地键。<pre class=" language-php"><code class=" language-php">class Country extends Model { public function posts() { return $this->hasManyThrough( 'App\Post', 'App\User', 'country_id', 'user_id', 'id' ); } }</code></pre><a name="polymorphic-relations"></a><h3>多态关联</h3><h4>数据表结构</h4>多态关联允许一个模型在单个关联中从属一个以上其它模型。举个例子，想象一下使用你应用的用户可以「评论」文章和视频。使用多态关联关系，您可以使用一个 <code class=" language-php">comments</code> 数据表就可以同时满足两个使用场景。首先，让我们观察一下用来创建这关联的数据表结构：<pre class=" language-php"><code class=" language-php">posts id - integer title - string body - text videos id - integer title - string url - string comments id - integer body - text commentable_id - integer commentable_type - string</code></pre>有两个需要注意的字段是 <code class=" language-php">comments</code> 表中的 <code class=" language-php">commentable_id</code> 和 <code class=" language-php">commentable_type</code>。其中， <code class=" language-php">commentable_id</code> 用于存放文章或者视频的 id ，而 <code class=" language-php">commentable_type</code> 用于存放所属模型的类名。注意的是， <code class=" language-php">commentable_type</code> 是当我们访问 <code class=" language-php">commentable</code> 关联时， ORM 用于判断所属的模型是哪个「类型」。<h4>模型结构</h4>接着，让我们来查看创建这种关联所需的模型定义：<pre class=" language-php"><code class=" language-php"><?php namespace App; use Illuminate\Database\Eloquent\Model; class Comment extends Model { /** * 获取所有拥有的 commentable 模型。 */ public function commentable() { return $this->morphTo(); } } class Post extends Model { /** * 获取所有文章的评论。 */ public function comments() { return $this->morphMany('App\Comment', 'commentable'); } } class Video extends Model { /** * 获取所有视频的评论。 */ public function comments() { return $this->morphMany('App\Comment', 'commentable'); } }</code></pre><h4>获取多态关联</h4>一旦你的数据表及模型被定义，则可以通过模型来访问关联。例如，若要访问谋篇文章的所有评论，则可以简单的使用 <code class=" language-php">comments</code> 动态属性：<pre class=" language-php"><code class=" language-php">$post = App\Post::find(1); foreach ($post->comments as $comment) { // }</code></pre>你也可以从多态模型的多态关联中，通过访问调用 <code class=" language-php">morphTo</code> 的方法名称来获取拥有者，也就是此例子中 <code class=" language-php">Comment</code> 模型的 <code class=" language-php">commentable</code> 方法。所以，我们可以使用动态属性来访问这个方法：<pre class=" language-php"><code class=" language-php">$comment = App\Comment::find(1); $commentable = $comment->commentable;</code></pre><code class=" language-php">Comment</code> 模型的 <code class=" language-php">commentable</code> 关联会返回 <code class=" language-php">Post</code> 或 <code class=" language-php">Video</code> 实例，这取决于评论所属模型的类型。<h4>自定义多态关联的类型字段</h4>默认情况下，Laravel 会使用「包含命名空间的类名」作为多态表的类型区分，例如，<code class=" language-php">Comment</code> 属于 <code class=" language-php">Post</code> 或者 <code class=" language-php">Video</code> ， <code class=" language-php">commentable_type</code> 的默认值可以分别是 <code class=" language-php">App\Post</code> 或者 <code class=" language-php">App\Video</code> 。然而，你也许会想使用应用中的内部结构来对数据库进行解耦。在这个例子中，你可以定义一个「多态对照表」来指引 Eloquent 对各个模型使用自定义名称而非类名：<pre class=" language-php"><code class=" language-php">use Illuminate\Database\Eloquent\Relations\Relation; Relation::morphMap([ 'posts' => App\Post::class, 'videos' => App\Video::class, ]);</code></pre>你需要在你自己的 <code class=" language-php">AppServiceProvider</code> 中的 <code class=" language-php">boot</code> 函数注册这个 <code class=" language-php">morphMap</code> ，或者创建一个独立且满足你要求的服务提供者。<a name="many-to-many-polymorphic-relations"></a><h3>多态多对多关联</h3><h4>数据表结构</h4>除了一般的多态关联，你也可以定义「多对多」的多态关联。例如，博客的 <code class=" language-php">Post</code> 和 <code class=" language-php">Video</code> 模型可以共用多态关联至 <code class=" language-php">Tag</code> 模型。使用多对多的多态关联能够让你的博客文章及图片共用独立标签的单个列表。首先，让我们先来查看数据表结构：<pre class=" language-php"><code class=" language-php">posts id - integer name - string videos id - integer name - string tags id - integer name - string taggables tag_id - integer taggable_id - integer taggable_type - string</code></pre><h4>模型结构</h4>接着，我们已经准备好定义模型的关联。<code class=" language-php">Post</code> 及 <code class=" language-php">Video</code> 模型都会拥有 <code class=" language-php">tags</code> 方法，并在该方法内调用自身 Eloquent 类的 <code class=" language-php">morphToMany</code> 方法：<pre class=" language-php"><code class=" language-php"><?php namespace App; use Illuminate\Database\Eloquent\Model; class Post extends Model { /** * 获取该文章的所有标签。 */ public function tags() { return $this->morphToMany('App\Tag', 'taggable'); } }</code></pre><h4>定义相对的关联</h4>然后，在 <code class=" language-php">Tag</code> 模型上，你必须为每个要关联的模型定义一个方法。因此，在这个例子中，我们需要定义一个 <code class=" language-php">posts</code> 方法及一个 <code class=" language-php">videos</code> 方法：<pre class=" language-php"><code class=" language-php"><?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'); } }</code></pre><h4>获取关联</h4>一旦你的数据表及模型被定义，则可以通过你的模型来访问关联。例如，你可以简单的使用 <code class=" language-php">tags</code> 动态属性来访问文章的所有标签：<pre class=" language-php"><code class=" language-php">$post = App\Post::find(1); foreach ($post->tags as $tag) { // }</code></pre>你也可以从多态模型的多态关联中，通过访问运行调用 <code class=" language-php">morphedByMany</code> 的方法名称来获取拥有者。在此例子中，就是 <code class=" language-php">Tag</code> 模型的 <code class=" language-php">posts</code> 或 <code class=" language-php">videos</code> 方法。因此，你可以通过访问使用动态属性来访问这个方法：<pre class=" language-php"><code class=" language-php">$tag = App\Tag::find(1); foreach ($tag->videos as $video) { // }</code></pre><a name="querying-relations"></a><h2><a href="#querying-relations">查找关联</a></h2>所有类型的 Eloquent 关联都是通过方法来定义的，你可以通过调用这些方法来获得关联的一个实例，而不需要实际运行关联的查找。此外，所有类型的 Eloquent 关联也提供了 <a href="/docs/5.4/queries">查询语句构造器</a> 的功能，让你能够在数据库运行该 SQL 前，在关联查找后面链式调用条件。例如，假设有一个博客系统，其中 <code class=" language-php">User</code> 模型拥有许多关联的 <code class=" language-php">Post</code> 模型：<pre class=" language-php"><code class=" language-php"><?php namespace App; use Illuminate\Database\Eloquent\Model; class User extends Model { /** * 获取该用户的所有文章。 */ public function posts() { return $this->hasMany('App\Post'); } }</code></pre>你可以查找 <code class=" language-php">posts</code> 关联并增加额外的条件至关联，像这样：<pre class=" language-php"><code class=" language-php">$user = App\User::find(1); $user->posts()->where('active', 1)->get();</code></pre>你可以在关联中使用 <a href="/docs/5.4/queries">查询语句构造器</a> 中的任意方法，所以，欢迎查阅查询语句构造器的相关文档以便了解那些有助于你实现的方法。<a name="relationship-methods-vs-dynamic-properties"></a><h3>关联方法与动态属性</h3>如果你不需要增加额外的条件至 Eloquent 的关联查找，则可以简单的像访问属性一样来访问关联。例如我们刚刚的 <code class=" language-php">User</code> 及 <code class=" language-php">Post</code> 模型示例，我们可以像这样来访问所有用户的文章：<pre class=" language-php"><code class=" language-php">$user = App\User::find(1); foreach ($user->posts as $post) { // }</code></pre>动态属性是「延迟加载」的，意味着它们只会在被访问的时候才加载关联数据。正因为如此，开发者通常需要使用 <a href="#eager-loading">预加载</a> 来预先加载关联数据，关联数据将会在模型加载后被访问。预加载能有效减少你的 SQL 查询语句。<a name="querying-relationship-existence"></a><h3>查找关联是否存在</h3>当访问模型的纪录时，你可能希望根据关联的存在来对结果进行限制。比方说你想获取博客中那些至少拥有一条评论的文章。则可以通过传递名称至关联的 <code class=" language-php">has</code> 方法来实现：<pre class=" language-php"><code class=" language-php">// 获取那些至少拥有一条评论的文章... $posts = App\Post::has('comments')->get();</code></pre>你也可以制定运算符及数量来进一步自定义查找：<pre class=" language-php"><code class=" language-php">// 获取所有至少有三条评论的文章... $posts = Post::has('comments', '>=', 3)->get();</code></pre>也可以使用「点」符号来构造嵌套的 has 语句。例如，你可能想获取那些至少有一条评论被投票的文章：<pre class=" language-php"><code class=" language-php">// 获取所有至少有一条评论被评分的文章... $posts = Post::has('comments.votes')->get();</code></pre>如果你想要更高级的用法，则可以使用 <code class=" language-php">whereHas</code> 和 <code class=" language-php">orWhereHas</code> 方法，在 has 查找里设置「where」条件。此方法可以让你增加自定义条件至关联条件中，例如对评论内容进行检查：<pre class=" language-php"><code class=" language-php">// 获取那些至少有一条评论包含 foo 的文章 $posts = Post::whereHas('comments', function ($query) { $query->where('content', 'like', 'foo%'); })->get();</code></pre><a name="counting-related-models"></a><h3>关联数据计数</h3>如果你想对关联数据进行计数但又不想再发起单独的 SQL 请求，你可以使用 <code class=" language-php">withCount</code> 方法，此方法会在你的结果集中增加一个 <code class=" language-php">{relation}_count</code> 字段：<pre class=" language-php"><code class=" language-php">$posts = App\Post::withCount('comments')->get(); foreach ($posts as $post) { echo $post->comments_count; }</code></pre>你还可以像在查询语句中添加约束一样，获取多重关联的「计数」。<pre class=" language-php"><code class=" language-php">$posts = Post::withCount(['votes', 'comments' => function ($query) { $query->where('content', 'like', 'foo%'); }])->get(); echo $posts[0]->votes_count; echo $posts[0]->comments_count;</code></pre><a name="eager-loading"></a><h2><a href="#eager-loading">预加载</a></h2>当通过属性访问 Eloquent 关联时，该关联数据会被「延迟加载」。意味着该关联数据只有在你使用属性访问它时才会被加载。不过，Eloquent 可以在你查找上层模型时「预加载」关联数据。预加载避免了 N + 1 查找的问题。要说明 N + 1 查找的问题，可试想一个关联到 <code class=" language-php">Author</code> 的 <code class=" language-php">Book</code> 模型，如下所示：<pre class=" language-php"><code class=" language-php"><?php namespace App; use Illuminate\Database\Eloquent\Model; class Book extends Model { /** * 获取编写该书的作者。 */ public function author() { return $this->belongsTo('App\Author'); } }</code></pre>现在，让我们来获取所有书籍及其作者的数据：<pre class=" language-php"><code class=" language-php">$books = App\Book::all(); foreach ($books as $book) { echo $book->author->name; }</code></pre>上方的循环会运行一次查找并取回所有数据表上的书籍，接着每本书会运行一次查找作者的操作。因此，若存在着 25 本书，则循环就会执行 26 次查找：1 次是查找所有书籍，其它 25 次则是在查找每本书的作者。很幸运地，我们可以使用预加载来将查找的操作减少至 2 次。可在查找时使用 with 方法来指定想要预加载的关联数据：<pre class=" language-php"><code class=" language-php">$books = App\Book::with('author')->get(); foreach ($books as $book) { echo $book->author->name; }</code></pre>对于该操作则只会执行两条 SQL 语句：<pre class=" language-php"><code class=" language-php">select * from books select * from authors where id in (1, 2, 3, 4, 5, ...)</code></pre><h4>预加载多种关联</h4>有时你可能想要在单次操作中预加载多种不同的关联。要这么做，只需传递额外的参数至 <code class=" language-php">with</code> 方法即可：<pre class=" language-php"><code class=" language-php">$books = App\Book::with('author', 'publisher')->get();</code></pre><h4>嵌套预加载</h4>若要预加载嵌套关联，则可以使用「点」语法。例如，让我们在一个 Eloquent 语法中，预加载所有书籍的作者，及所有作者的个人联系方式：<pre class=" language-php"><code class=" language-php">$books = App\Book::with('author.contacts')->get();</code></pre><a name="constraining-eager-loads"></a><h3>预加载条件限制</h3>有时你可能想要预加载关联，并且指定预加载查询的额外条件。如下所示：<pre class=" language-php"><code class=" language-php">$users = App\User::with(['posts' => function ($query) { $query->where('title', 'like', '%first%'); }])->get();</code></pre>在这个例子里，Eloquent 只会预加载标题包含 <code class=" language-php">first</code> 的文章。当然，你也可以调用其它的 <a href="/docs/5.4/queries">查询语句构造器</a> 来进一步自定义预加载的操作：<pre class=" language-php"><code class=" language-php">$users = App\User::with(['posts' => function ($query) { $query->orderBy('created_at', 'desc'); }])->get();</code></pre><a name="lazy-eager-loading"></a><h3>延迟预加载</h3>有时你可能需要在上层模型被获取后才预加载关联。当你需要来动态决定是否加载关联模型时会很有帮助，如下所示：<pre class=" language-php"><code class=" language-php">$books = App\Book::all(); if ($someCondition) { $books->load('author', 'publisher'); }</code></pre>如果你想设置预加载查询的额外条件，则可以传递一个键值为你想要的关联的数组至 <code class=" language-php">load</code> 方法。这个数组的值应是用于接收查询实例的 <code class=" language-php">闭包</code> 实例：<pre class=" language-php"><code class=" language-php">$books->load(['author' => function ($query) { $query->orderBy('published_date', 'asc'); }]);</code></pre><a name="inserting-and-updating-related-models"></a><h2><a href="#inserting-and-updating-related-models">写入关联模型</a></h2><a name="the-save-method"></a><h3>Save 方法</h3>Eloquent 提供了便捷的方法来将新的模型增加至关联中。例如，将新的 <code class=" language-php">Comment</code> 写入至 <code class=" language-php">Post</code> 模型。除了手动设置 <code class=" language-php">Comment</code> 的 <code class=" language-php">post_id</code> 属性外，你也可以直接使用关联的 <code class=" language-php">save</code> 方法来写入 <code class=" language-php">Comment</code>：<pre class=" language-php"><code class=" language-php">$comment = new App\Comment(['message' => 'A new comment.']); $post = App\Post::find(1); $post->comments()->save($comment);</code></pre>注意我们并没有使用动态属性来访问 <code class=" language-php">comments</code> 关联。相反地，我们调用了 comments 方法来获取关联的实例。save 方法会自动在新的 <code class=" language-php">Comment</code> 模型中增加正确的 <code class=" language-php">post_id</code> 值。如果你需要保存多个关联模型，则可以使用 <code class=" language-php">saveMany</code> 方法：<pre class=" language-php"><code class=" language-php">$post = App\Post::find(1); $post->comments()->saveMany([ new App\Comment(['message' => 'A new comment.']), new App\Comment(['message' => 'Another comment.']), ]);</code></pre><a name="the-create-method"></a><h3>Create 方法</h3>除了 <code class=" language-php">save</code> 与 <code class=" language-php">saveMany</code> 方法外，你也可以使用 <code class=" language-php">create</code> 方法，该方法允许传入属性的数组来建立模型并写入数据库。<code class=" language-php">save</code> 与 <code class=" language-php">create</code> 的不同之处在于，<code class=" language-php">save</code> 允许传入一个完整的 Eloquent 模型实例，但 <code class=" language-php">create</code> 只允许传入原始的 PHP 数组：<pre class=" language-php"><code class=" language-php">$post = App\Post::find(1); $comment = $post->comments()->create([ 'message' => 'A new comment.', ]);</code></pre>在使用 create 方法前，请确认你已浏览了文档的 <a href="/docs/5.4/eloquent#mass-assignment">批量赋值</a> 章节。<a name="updating-belongs-to-relationships"></a><h3>更新「从属」关联</h3>当更新一个 <code class=" language-php">belongsTo</code> 关联时，可以使用 <code class=" language-php">associate</code> 方法。此方法会将外键设置到下层模型：<pre class=" language-php"><code class=" language-php">$account = App\Account::find(10); $user->account()->associate($account); $user->save();</code></pre>当删除一个 <code class=" language-php">belongsTo</code> 关联时，你可以使用 <code class=" language-php">dissociate</code> 方法。此方法会置该关联的外键为空 (null) ：<pre class=" language-php"><code class=" language-php">$user->account()->dissociate(); $user->save();</code></pre><a name="updating-many-to-many-relationships"></a><h3>多对多关联</h3><h4>附加与卸除</h4>当使用多对多关联时，Eloquent 提供了一些额外的辅助函数让操作关联模型更加方便。例如，让我们假设一个用户可以拥有多个身份，且每个身份都可以被多个用户拥有。要附加一个规则至一个用户，并连接模型以及将记录写入至中间表，则可以使用 <code class=" language-php">attach</code> 方法：<pre class=" language-php"><code class=" language-php">$user = App\User::find(1); $user->roles()->attach($roleId);</code></pre>当附加一个关联至模型时，你也可以传递一个需被写入至中间表的额外数据数组：<pre class=" language-php"><code class=" language-php">$user->roles()->attach($roleId, ['expires' => $expires]);</code></pre>当然，我们有时也需要来移除用户的身份。要移除一个多对多的纪录，可使用 <code class=" language-php">detach</code> 方法。<code class=" language-php">detach</code> 方法会从中间表中移除正确的纪录；当然，这两个模型依然会存在于数据库中：<pre class=" language-php"><code class=" language-php">// 移除用户身上某一身份... $user->roles()->detach($roleId); // 移除用户身上所有身份... $user->roles()->detach();</code></pre>为了方便，attach 与 detach 都允许传入 ID 数组：<pre class=" language-php"><code class=" language-php">$user = App\User::find(1); $user->roles()->detach([1, 2, 3]); $user->roles()->attach([1 => ['expires' => $expires], 2, 3]);</code></pre><h4>更新关联</h4>你也可以使用 <code class=" language-php">sync</code> 方法去创建一个多对多的关联。 <code class=" language-php">sync</code> 方法可以用数组形式的 IDs 插入中间的数据表。任何一个不存在于给定数组的 IDs 将会在中间表内被删除。所以，操作完成之后，只有那些在给定数组内的 IDs 会被保留在中间表中。<pre class=" language-php"><code class=" language-php">$user->roles()->sync([1, 2, 3]);</code></pre>你也可以通过 IDs 传递其他的附加中间表值：<pre class=" language-php"><code class=" language-php">$user->roles()->sync([1 => ['expires' => true], 2, 3]);</code></pre>如果你不想分离现有的 IDs ，你可以 <code class=" language-php">syncWithoutDetaching</code> 方法：<pre class=" language-php"><code class=" language-php">$user->roles()->syncWithoutDetaching([1, 2, 3]);</code></pre><h4>在中间表上保存额外数据</h4>处理多对多关联时， <code class=" language-php">save</code> 方法接收额外中间表属性数组作为第二个参数：<pre class=" language-php"><code class=" language-php">App\User::find(1)->roles()->save($role, ['expires' => $expires]);</code></pre><h4>更新中间表记录</h4>如果你需要更新中间表已存在的记录，可以使用 <code class=" language-php">updateExistingPivot</code> 方法。这个方法接收中间记录的外键和属性数组进行更新：<pre class=" language-php"><code class=" language-php">$user = App\User::find(1); $user->roles()->updateExistingPivot($roleId, $attributes);</code></pre><a name="touching-parent-timestamps"></a><h2><a href="#touching-parent-timestamps">连动父级时间戳</a></h2>当一个模型 <code class=" language-php">belongsTo</code> 或 <code class=" language-php">belongsToMany</code> 另一个模型时，像是一个 <code class=" language-php">Comment</code> 属于一个 <code class=" language-php">Post</code>。这对于子级模型被更新时，要更新父级的时间戳相当有帮助。举例来说，当一个 <code class=" language-php">Comment</code> 模型被更新时，你可能想要「连动」更新 <code class=" language-php">Post</code> 所属的 <code class=" language-php">updated_at</code> 时间戳。Eloquent 使得此事相当容易。只要在关联的下层模型中增加一个包含名称的 <code class=" language-php">touches</code> 属性即可：<pre class=" language-php"><code class=" language-php"><?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'); } }</code></pre>现在，当你更新一个 Comment 时，它所属的 Post 拥有的 <code class=" language-php">updated_at</code> 字段也会被同时更新，使其更方便的得知何时让一个 <code class=" language-php">Post</code> 模型的缓存失效：<pre class=" language-php"><code class=" language-php">$comment = App\Comment::find(1); $comment->text = 'Edit to this comment!'; $comment->save();</code></pre><h2>译者署名</h2><table><thead><tr><th>用户名</th><th>头像</th><th>职能</th><th>签名</th></tr></thead><tbody><tr><td><a href="https://laravel-china.org/users/79">@skyverd</a></td><td><img class="avatar-66 rm-style" src="https://dn-phphub.qbox.me/uploads/avatars/79_1427370664.jpeg?imageView2/1/w/100/h/100"></td><td>翻译</td><td>全桟工程师，<a href="https://skyverd.com">时光博客</a></td></tr></tbody></table></article>