عرض مصدر Laravel/eloquent relationships

<noinclude>{{DISPLAYTITLE:العلاقات في رابط الكائنات بالعلاقات Eloquent}}</noinclude>
== مقدمة ==
في معظم الأحيان، تكون جداول قواعد البيانات مرتبطة ببعضها البعض. على سبيل المثال، قد يكون لمقالة ما الكثير من التعليقات، أو قد تكون الطلبيّة مرتبطة بالمستخدم الذي قام بها. يجعل [[Laravel/eloquent|Eloquent]] العمل مع هذه العلاقات أمرًا سهلًا، ويدعم عدة أنواع من العلاقات المختلفة:
* واحد إلى واحد (One To One)
* واحد إلى كثير (One To Many)
* كثير إلى كثير (Many To Many)
* الكثير ضمن (Has Many Through)
* العلاقات متعددة الأشكال (Polymorphic Relationships)
* علاقات الكثير إلى كثير متعددة الأشكال (Many To Many Polymorphic Relationships)

== تعريف العلاقات ==
تعرّف العلاقات كتوابع في أصناف نماذج [[Laravel/eloquent|Eloquent]]. وبما أنّ العلاقات تلعب دور [[Laravel/queries|منشئ الاستعلامات]] (كما هو الحال في النماذج نفسها)، فإنّ تعريف العلاقات كتوابع يسهّل سلسلة التوابع ويزوّد بإمكانات الاستعلام. على سبيل المثال، يمكننا أن نسلسل قيودًا إضافية على العلاقة <code>posts</code> التالية:<syntaxhighlight lang="php">
$user->posts()->where('active', 1)->get();
</syntaxhighlight>لكن قبل المضي قدمًا بكيفية استخدام العلاقات، لنلقِ نظرة على كيفية تعريف كل نوع من العلاقات.

=== واحد إلى واحد One to One ===
إن علاقة الواحد إلى واحد هي علاقة بسيطة ججدًّا وأساسية. على سبيل المثال، قد يكون نموذج المستخدم <code>User</code> مرتبطًا بنموذج هاتف <code>Phone</code> وحيد. لتعريف هذه العلاقة، نعرف التابع <code>phone</code> في النموذج <code>User</code>. يجب على التابع <code>phone</code> أن يستدعي التابع <code>hasOne</code> ويعيد نتيجته:<syntaxhighlight lang="php">
<?php

namespace App;

use Illuminate\Database\Eloquent\Model;

class User extends Model
{
   /**
    * قراءة سجل الهاتف المرتبط بالمستخدم.
    */
   public function phone()
   {
       return $this->hasOne('App\Phone');
   }
}
</syntaxhighlight>الوسيط الأول الممرر للتابع <code>hasOne</code> هو اسم النموذج المرتبط. بعد تعريف العلاقة، يمكننا استرداد السجل المرتبط باستخدام الخاصّيات الديناميكية لـ Eloquent. تمكّنك الخاصيات الديناميكية من الوصول إلى توابع العلاقات وكأنّها خاصيات معرفة في النموذج:<syntaxhighlight lang="php">
$phone = User::find(1)->phone;
</syntaxhighlight>يحدد [[Laravel/eloquent|Eloquent]] المفتاح الأجنبي للعلاقة بناءً على اسم النموذج. في هذه الحالة، يُعتقد أن يملك النموذج <code>Phone</code> على حقل المفتاح الأجنبي <code>user_id</code>. إذا أردت أن تعدّل هذا العرف، يمكنك تمرير وسيط ثاني للتابع <code>hasOne</code>:<syntaxhighlight lang="php">
return $this->hasOne('App\Phone', 'foreign_key');
</syntaxhighlight>علاوةً على ذلك، يعتقد [[Laravel/eloquent|Eloquent]] أن المفتاح الأجنبي يجب أن يقابله الحقل <code>id</code> (أو الـ <code>primaryKey</code> المعدل) من الأب. مما يعني أنّ Eloquent سيبحث عن القيمة <code>id</code> الخاصة بالمستخدم في الحقل <code>user_id</code> الخاص بالنموذج <code>Phone</code>. في حال أردت من العلاقة أن تنظر في قيمة مختلفة عن <code>id</code>، يمكنك تمرير وسيط ثالث للتابع <code>hasOne</code> يحدد المفتاح المعدل:<syntaxhighlight lang="php">
return $this->hasOne('App\Phone', 'foreign_key', 'local_key');
</syntaxhighlight>

==== تعريف معكوس العلاقة ====
الآن يمكننا الوصول للسجل <code>Phone</code> من النموذج <code>User</code>. لنعرّف الآن العلاقة على النموذج <code>Phone</code> التي تمكننا من الوصول للمستخدم <code>User</code> الذي يملك الهاتف. يمكننا تعريف معكوس العلاقة <code>hasOne</code> عن طريق التابع <code>belongsTo</code>:<syntaxhighlight lang="php">
<?php

namespace App;

use Illuminate\Database\Eloquent\Model;

class Phone extends Model
{
   /**
    * قراءة المستخدم الذي يملك الهاتف.
    */
   public function user()
   {
       return $this->belongsTo('App\User');
   }
}
</syntaxhighlight>في المثال أعلاه، سيحاول [[Laravel/eloquent|Eloquent]] أن تقارن الحقل <code>user_id</code> من النموذج <code>Phone</code> بالحقل <code>id</code> من النموذج <code>User</code>. يحدد Eloquent الاسم الافتراضي للمفتاح الرئيسي بالنظر إلى اسم العلاقة وجمعها مع "<code>id_</code>"، لكن في حال كان المفتاح الأجنبي على النموذج <code>Phone</code> ليس <code>user_id</code>، يمكنك تمرير الاسم المختلف بالوسيط الثاني للتابع <code>belongsTo</code>:<syntaxhighlight lang="php">
public function user()
{
   return $this->belongsTo('App\User', 'foreign_key');
}
</syntaxhighlight>في حال كان النموذج الأب لا يملك الحقل <code>id</code> كالمفتاح الرئيسي له، أو أردت دمج النموذج الإبن إلى حقل ثاني، يمكنك تمرير وسيط ثالث للتابع <code>belongsTo</code> يحدد المفتاح الرئيسي المعدل للجدول الأب:<syntaxhighlight lang="php">
public function user()
{
   return $this->belongsTo('App\User', 'foreign_key', 'other_key');
}
</syntaxhighlight>

=== واحد إلى كثير One to Many ===
تمكّنك العلاقة "واحد إلى كثير" من تعريف العلاقات التي يكون السجل الواحد فيها مرتبطًا بالعديد من السجلات الأخرى من النماذج الأخرى.مثلًا، قد تملك المقالة عددًا لا نهائيًّا من التعليقات. كما هو الحال مع كل علاقات [[Laravel/eloquent|Eloquent]] الأخرى، يمكن تعريف العلاقة واحد إلى كثير بتعريف تابع في نموذج Eloquent:<syntaxhighlight lang="php">
<?php

namespace App;

use Illuminate\Database\Eloquent\Model;

class Post extends Model
{
   /**
    * قراءة التعليقات الخاصة بالمقالة.
    */
   public function comments()
   {
       return $this->hasMany('App\Comment');
   }
}
</syntaxhighlight>تذكر، يحدد [[Laravel/eloquent|Eloquent]] المفتاح الأجنبي المناسب تلقائيًّا على النموذج <code>Comment</code>. كعرف متخذ، يأخذ Eloquent اسم النموذج الأب في صيغة snake case ويجمعه مع "<code>id_</code>". لذا في هذا المثال، يعتقد [[Laravel/eloquent|Eloquent]] أن المفتاح الأجنبي في النموذج <code>Comment</code> هو <code>post_id</code>.

بعد تعريف العلاقة، يمكننا الوصول لمجموعة التعليقات المرتبطة بالمقالة عن طريق الوصول للخاصية <code>comments</code>. تذكر، بما أن [[Laravel/eloquent|Eloquent]] يزودنا بالخاصيات الديناميكية، يمكننا الوصول إلى توابع العلاقات وكأنها خاصيات:<syntaxhighlight lang="php">
$comments = App\Post::find(1)->comments;

foreach ($comments as $comment) {

  //

}
</syntaxhighlight>وبالطبع، بما أن جميع العلاقات تلعب دور منشئ الاستعلامات، يمكننا إضافة قيود إضافية إلى التعليقات المستردة من التابع <code>comments</code> عن طريق سلسلة الشروط على الاستعلام:<syntaxhighlight lang="php">
$comment = App\Post::find(1)->comments()->where('title', 'foo')->first();
</syntaxhighlight>كما هو الحال بالتابع <code>hasOne</code>، يمكنك تعديل عرف المفاتيح الأجنبية والرئيسية عن طريق تمرير الوسيطين الإضافيين إلى التابع <code>hasMany</code>:<syntaxhighlight lang="php">
return $this->hasMany('App\Comment', 'foreign_key');

return $this->hasMany('App\Comment', 'foreign_key', 'local_key');
</syntaxhighlight>

==== تعريف معكوس العلاقة ====
يمكننا الآن الوصول للتعليقات المتعلقة بالمقالة. لنعرّف الآن العلاقة التي تمكننا من الوصول للمقالة المرتبطة بالتعليق. لتعريف معكوس العلاقة <code>hasMany</code>، عرّف تابعًا في النموذج الإبن يستدعي التابع <code>belongsTo</code>:<syntaxhighlight lang="php">
<?php

namespace App;

use Illuminate\Database\Eloquent\Model;

class Comment extends Model
{
   /**
    * قراءة المقالة التي تملك التعليق.
    */
   public function post()
   {
       return $this->belongsTo('App\Post');
   }
}
</syntaxhighlight>بعد تعريف العلاقة، يمكننا الوصول للنموذج <code>Post</code> المتعلق بالنموذج <code>Comment</code> عن طريق الوصول للخاصية الديناميكية <code>post</code>:<syntaxhighlight lang="php">
$comment = App\Comment::find(1);

echo $comment->post->title;
</syntaxhighlight>في المثال أعلاه، يحاول [[Laravel/eloquent|Eloquent]] مطابقة الحقل <code>post_id</code> من النموذج <code>Comment</code> بالحقل <code>id</code> من النموذج <code>Post</code>. يحدد Eloquent الاسم الافتراضي للمفتاح الأجنبي بالنظر إلى اسم تابع العلاقة وجمعه بـ "<code>_</code>" مسبوقة باسم المفتاح الرئيسي. لكن في حال كان المفتاح الأجنبي في النموذج <code>Comment</code> ليس <code>post_id</code>، يمكنك تمرير الاسم المعدل للمفتاح الأجنبي بالوسيط الثاني للتابع <code>belongsTo</code>:<syntaxhighlight lang="php">
public function post()
{
   return $this->belongsTo('App\Post', 'foreign_key');
}
</syntaxhighlight>إذا لم يكن النموذج الأب يملك حقل <code>id</code> كالمفتاح الرئيسي له، أو في حال أردت دمج النموذج الابن بحقل مختلف، يمكنك تمرير وسيط ثالث للتابع <code>belongsTo</code> يحدد المفتاح الرئيسي المعدل للجدول الاب:<syntaxhighlight lang="php">
public function post()
{
   return $this->belongsTo('App\Post', 'foreign_key', 'other_key');
}
</syntaxhighlight>

=== كثير إلى كثير Many to Many ===
إن العلاقات "كثير إلى كثير" أكثر تعقيدًا من العلاقات <code>hasOne</code> و <code>hasMany</code>. أبسط مثال على هذه العلاقة هو المستخدم الذي يملك عدة أدوار، والدور المشترك من أكثر من مستخدم. مثلًا، قد يملك العديد من المستخدمين الدور "Admin". لتعريف هذه العلاقة، يجب وجود ثلاث جداول في قاعدة المعطيات: <code>users</code> و <code>roles</code> و <code>role_user</code>. إن الجدول <code>role_user</code> (المدعو بجدول الكسر) مشتق من الترتيب الأبجدي لأسماء النماذج المرتبطة، ويحتوي على الحقلين <code>user_id</code> و <code>role_id</code>.

يمكن تعريف العلاقات كثير إلى كثير عن طريق تعريف تابع يعيد نتيجة التابع <code>belongsToMany</code>. مثلًا، لنعرّف التابع <code>roles</code> على نموذج المستخدم <code>User</code>:<syntaxhighlight lang="php">
<?php

namespace App;

use Illuminate\Database\Eloquent\Model;

class User extends Model
{
   /**
    * الأدوار المرتبطة بالمستخدم.
    */
   public function roles()
   {
       return $this->belongsToMany('App\Role');
   }
}
</syntaxhighlight>بعد تعريف العلاقة، يمكن الوصول إلى أدوار المستخدم عن طريق الخاصية الديناميكية <code>roles</code>:<syntaxhighlight lang="php">
$user = App\User::find(1);

foreach ($user->roles as $role) {

  //

}
</syntaxhighlight>وبالطبع كما هو الحال مع جميع أنواع العلاقات، يمكنك استدعاء التابع <code>roles</code> وسلسلة شروط الاستعلام على العلاقة كالتالي:<syntaxhighlight lang="php">
$roles = App\User::find(1)->roles()->orderBy('name')->get();
</syntaxhighlight>وكما ذُكر سابقًا، لتحديد اسم الجدول المستخدم لكسر العلاقة، يدمج [[Laravel/eloquent|Eloquent]] أسماء النموذجين بترتيب أبجدي. لكن يمكنك تعديل ذلك العرف عن طريق تمرير الوسيط الثاني للتابع <code>belongsToMany</code>:<syntaxhighlight lang="php">
return $this->belongsToMany('App\Role', 'role_user');
</syntaxhighlight>إضافةً إلى تعديل اسم جدول الكسر، يمكنك تعديل أسماء حقول المفاتيح الأجنبية في الجدول عن طريق تمرير الوسائط الإضافية للتابع <code>belongsToMany</code>. يمثل الوسيط الثالث اسم المفتاح الأجنبي للنموذج الذي تعرف العلاقة عليه، بينما يمثل الوسيط الرابع اسم المفتاح الأجنبي للنموذج الذي تدمج فيه:<syntaxhighlight lang="php">
return $this->belongsToMany('App\Role', 'role_user', 'user_id', 'role_id');
</syntaxhighlight>

==== تعريف معكوس العلاقة ====
لتعريف معكوس علاقة الكثير إلى كثير، يمكنك إنشاء استدعاء مماثل للتابع <code>belongsToMany</code> على النموذج المرتبط. بالاستكمال مع مثال الأدوار، لنعرّف التابع <code>users</code> على النموذج <code>Role</code>:<syntaxhighlight lang="php">
<?php

namespace App;

use Illuminate\Database\Eloquent\Model;

class Role extends Model
{
   /**
    * المستخدمون الذين ينتمون للدور.
    */
   public function users()
   {
       return $this->belongsToMany('App\User');
   }
}
</syntaxhighlight>نلاحظ أن العلاقة معرّفة تمامًا مثلما عُرّفت في النموذج <code>User</code>، باستثناء تمرير النموذج <code>App\User</code>. بما أننا نعيد استعمال التابع <code>belongsToMany</code>، جميع تعديلات المفاتيح الأجنبية وأسماء الجداول تكون متاحة عند تعريف معكوس علاقة الكثير إلى كثير.

==== استرداد حقول الجداول الوسيطيّة ====
كما تعلّمت مسبقًا، فإن العمل مع علاقات الكثير إلى الكثير يتطلّب وجود جدول كسر أو جدول وسيطي. يزوّد [[Laravel/eloquent|Eloquent]] بطريقة سهلة للتعامل مع هذا الجدول. على سبيل المثال، لنفرض أن كائن المستخدم <code>User</code> يمتلك العديد من كائنات الأدوار <code>Role</code> المرتبطة به. بعد الوصول لهذه العلاقة، يمكننا الوصول للجدول الوسيطي عن طريق الخاصية <code>pivot</code> على النماذج:<syntaxhighlight lang="php">
$user = App\User::find(1);

foreach ($user->roles as $role) {
   echo $role->pivot->created_at;
}
</syntaxhighlight>لاحظ أن كل سجل <code>Role</code> نحصل عليه يمتلك خاصية <code>pivot</code>. هذه الخاصية تحتوي على نموذج يمثل الجدول الوسيطي، ويمكن استخدامه مثل أي نموذج Eloquent آخر.

افتراضيًّا، سيحتوي الكائن <code>pivot</code> فقط على مفاتيح النماذج. في حال كان الجدول الوسيطي يمتلك خاصيات إضافية، يجب أن تحددها عند تعريف العلاقة:<syntaxhighlight lang="php">
return $this->belongsToMany('App\Role')->withPivot('column1', 'column2');
</syntaxhighlight>وفي حال أردت أن يحتوي الجدول الوسيطي على الحقول الزمنية <code>created_at</code> و <code>updated_at</code>، استخدم التابع <code>withTimestamps</code> على تعريف العلاقة:<syntaxhighlight lang="php">
return $this->belongsToMany('App\Role')->withTimestamps();
</syntaxhighlight>

==== تخصيص اسم الخاصية pivot ====
كما ذُكر آنفًا، يمكن الوصول للجدول الوسيطي من خلال الخاصية <code>pivot</code>. لكن يمكنك تخصيص اسم هذه الخاصية لعكس المغزى منها بشكل أفضل ضمن تطبيقك.

على سبيل المثال، قد يمكّن تطبيقك من المستخدمين أن يقوموا بالتسجيل بالتدوينات الصوتية (podcasts)، قد تملك علاقة كثير إلى كثير بين المستخدمين والتدوينات الصوتية. إن كانت هذه الحالة، قد تحتاج إلى تسمية كائن الجدول الوسيطي بـ <code>subscription</code> بدلًا من <code>pivot</code>. يمكن تحقيق ذلك من خلال التابع <code>as</code> المستخدم عند تعريف العلاقة:<syntaxhighlight lang="php">
return $this->belongsToMany('App\Podcast')
               ->as('subscription')
               ->withTimestamps();
</syntaxhighlight>بعد ذلك، يمكنك الوصول لبيانات الجدول الوسيطي باستخدام الاسم المخصص:<syntaxhighlight lang="php">
$users = User::with('podcasts')->get();

foreach ($users->flatMap->podcasts as $podcast) {
   echo $podcast->subscription->created_at;
}
</syntaxhighlight>

==== ترشيح العلاقات باستخدام حقول الجداول الوسيطية ====
يمكنك ترشيح نتائج استعلام العلاقة <code>belongsTo</code> عن طريق التوابع <code>wherePivot</code> و <code>wherePivotIn</code> وذلك عند تعريف العلاقة:<syntaxhighlight lang="php">
return $this->belongsToMany('App\Role')->wherePivot('approved', 1);

return $this->belongsToMany('App\Role')->wherePivotIn('priority', [1, 2]);
</syntaxhighlight>

==== تعريف نماذج مخصّصة للجداول الوسيطية ====
في حال أردت أن تعرّف نماذج مخصصة لتمثيل الجدول الوسيطي في علاقتك، يمكنك استخدام التابع <code>using</code> عند تعريف العلاقة. يجب على نماذج الجداول الوسيطية أن ترث من الصنف <code>Illuminate\Database\Eloquent\Relations\Pivot</code>، بينما يجب على نماذج الجداول الوسيطية للعلاقات متعددة الأشكال أن ترث من الصنف <code>Illuminate\Database\Eloquent\Relations\MorphPivot</code>. مثلًا، يمكننا تعريف علاقة الأدوار باستخدام النموذج الوسيطي <code>UserRole</code>:<syntaxhighlight lang="php">
<?php

namespace App;

use Illuminate\Database\Eloquent\Model;

class Role extends Model
{
   /**
    * المستخدمون الذين ينتمون للدور.
    */
   public function users()
   {
       return $this->belongsToMany('App\User')->using('App\UserRole');
   }
}
</syntaxhighlight>عند تعريف النموذج <code>UserRole</code>، سنرث من الصنف <code>Pivot</code>:<syntaxhighlight lang="php">
<?php

namespace App;

use Illuminate\Database\Eloquent\Relations\Pivot;

class UserRole extends Pivot
{

  //

}
</syntaxhighlight>

=== الكثير ضمن (Has Many Through) ===
تمكّنك علاقة "الكثير ضمن" من الوصول بشكل سريع للعلاقات المتباعدة والتي يفصل بينها علاقات وسيطية. مثلًا، قد يملك نموذج البلد <code>Country</code> العديد من المنشورات <code>Post</code> ضمن النموذج الوسيطي <code>User</code>. في هذا المثال، يمكنك الوصول للمنشورات الموافقة للبلد المحدد بسهولة. لنلقِ نظرة على الجداول التي تشكّل هذه العلاقة:<syntaxhighlight lang="text">
countries
   id - integer
   name - string


users
   id - integer
   country_id - integer
   name - string


posts
   id - integer
   user_id - integer
   title - string
</syntaxhighlight>بالرغم من أن الجدول <code>posts</code> لا يمتلك حقل <code>country_id</code>، تمكّنك العلاقة <code>hasManyThrough</code> من الوصول إلى منشورات البلد من خلال ‎<code>$country->posts</code>. لتنفيذ هذا الاستعلام، ينظر [[Laravel/eloquent|Eloquent]] إلى الحقل <code>country_id</code> على الجدول <code>users</code>. بعد العثور على المفاتيح المطابقة، تستخدم هذه المفاتيح للاستعلام في الجدول <code>posts</code>.

والآن بما أننا اطّلعنا على هيكلية الجداول المشكّلة للعلاقة، يمكننا تعريف العلاقة على النموذج <code>Country</code>:<syntaxhighlight lang="php">
<?php

namespace App;

use Illuminate\Database\Eloquent\Model;

class Country extends Model
{
   /**
    * قراءة منشورات البلد.
    */
   public function posts()
   {
       return $this->hasManyThrough('App\Post', 'App\User');
   }
}
</syntaxhighlight>يحدد أول وسيط ممرر للتابع <code>hasManyThrough</code> اسم النموذج الأخير المراد الوصول إليه، بينما يحدد الوسيط الثاني اسم النموذج الوسيط.

ستُستخدم أعراف Eloquent التقليدية للتعامل مع المفاتيح الأجنبية في هذه الحالة. في حال أردت تعديل أسماء المفاتيح الأجنبية لهذه العلاقة، يمكنك تمرير وسائط افتراضية للتابع <code>hasManyThrough</code>. يمثل الوسيط الثالث اسم المفتاح الأجنبي على النموذج الوسيطي، بينما يمثل الوسيط الرابع اسم المفتاح الأجنبي على النموذج الأخير المراد الوصول إليه. يمثل الوسيط الخامس اسم المفتاح الرئيسي للنموذج الأساسي، بينما يمثل الوسيط السادس اسم المفتاح الرئيسي للنموذج الوسيطي:<syntaxhighlight lang="php">
class Country extends Model
{
   public function posts()
   {
       return $this->hasManyThrough(
           'App\Post',
           'App\User',
           'country_id', // المفتاح الأجنبي على جدول المستخدمين users..
           'user_id', // المفتاح الأجنبي على جدول المنشورات posts..
           'id', // المفتاح الرئيسي على جدول البلدان countries..
           'id' // المفتاح الرئيسي على جدول المستخدمين users..
       );
   }
}
</syntaxhighlight>

=== العلاقات متعددة الأشكال (Polymorphic Relationships) ===

==== هيكلية الجداول ====
تمكّنك العلاقات متعددة الأشكال من ربط نموذج وحيد بأكثر من نموذج آخر على علاقة واحدة. على سبيل المثال، تخيّل أن مستخدمي تطبيقك يمكنهم التعليق (comment) على المنشورات (posts) والفيديوهات (videos). باستخدام العلاقات متعددة الأشكال، يمكنك استخدام جدول <code>comments</code> وحيد للعلاقتين الاثنين. لنطّلع أولًا على هيكلية الجداول المطلوبة لتنفيذ العلاقة:<syntaxhighlight lang="text">
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
</syntaxhighlight>تجدر الملاحظة أن هناك حقلين أساسيين على جدول التعليقات <code>comments</code> وهما <code>commentable_id</code> و <code>commentable_type</code>. يمثل الحقل <code>commentable_id</code> المفتاح الأجنبي للمنشور (post) أو الفيديو (video)، بينما يمثل الحقل <code>commentable_type</code> اسم الصنف المالك للعلاقة، حيث يحدد Eloquent أي من النماذج يجب أن تعاد من العلاقة بناءً على الحقل <code>commentable_type</code>.

==== هيكلية النماذج ====
لنطّلع الآن على تعريفات النماذج المطلوبة لتعريف هذه العلاقة:<syntaxhighlight lang="php">
<?php

namespace App;

use Illuminate\Database\Eloquent\Model;

class Comment extends Model
{
   /**
    * قراءة جميع السجلات القابلة للتعليق.
    */
   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');
   }
}
</syntaxhighlight>

==== استرداد العلاقات متعددة الأشكال ====
بعد تعريف الجداول والنماذج، يمكنك الوصول للعلاقات باستخدام النماذج. مثلًا، للوصول إلى تعليقات منشور ما، يمكننا استخدام الخاصية الديناميكية <code>comments</code>:<syntaxhighlight lang="php">
$post = App\Post::find(1);

foreach ($post->comments as $comment) {

  //

}
</syntaxhighlight>يمكنك أيضًا الوصول إلى مالك العلاقة متعددة الأشكال من النموذج متعدد الأشكال عن طريق الوصول إلى اسم التابع الذي يستدعي <code>morphTo</code>، وهو التابع <code>commentable</code> الموجود في النموذج <code>Comment</code> في حالتنا. إذًا يمكننا الوصول إليه كخاصية ديناميكية:<syntaxhighlight lang="php">
$comment = App\Comment::find(1);

$commentable = $comment->commentable;
</syntaxhighlight>ستعيد العلاقة <code>commentable</code> إما كائن <code>Post</code> أو كائن <code>Video</code> بناءً على نوع مالك العلاقة.

==== أنواع مخصصة للعلاقات متعددة الأشكال ====
افتراضيًّا، يستخدم Laravel الاسم الكامل للصنف لتخزينه اسمًا لنوع النموذج المرتبط. مثلًا، بالنظر إلى المثال أعلاه الذي يكون فيه التعليق <code>Comment</code> مرتبطًا إما بمنشور <code>Post</code> أو فيديو <code>Video</code>، يحتوي الحقل <code>commentable_type</code> إما على القيمة <code>App\Post</code> أو القيمة <code>App\Video</code>. لكن يمكنك تجاوز هذا العرف للفصل بين قاعدة البيانات وهيكلية تطبيقك الداخلية. في هذه الحالة، يمكن تعريف ما يسمى بجدول الأشكال للعلاقة، وذلك لإخبار Eloquent باستخدام أسماء مختلفة لكل نموذج بدلًا من اسم صنف النموذج نفسه:<syntaxhighlight lang="php">
use Illuminate\Database\Eloquent\Relations\Relation;

Relation::morphMap([
   'posts' => 'App\Post',
   'videos' => 'App\Video',
]);
</syntaxhighlight>يمكنك تسجيل الـ <code>morphMap</code> في التابع <code>boot</code> الخاص بمزود الخدمة الرئيسي <code>AppServiceProvider</code>، أو إنشاء مزود خدمة منفصل إذا أردت.

=== علاقات الكثير إلى كثير متعددة الأشكال (Many To Many Polymorphic Relationships) ===

==== هيكلية الجداول ====
إضافةً إلى العلاقات متعددة الأشكال التقليدية، يمكنك تعريف علاقات "كثير إلى كثير" متعددة الأشكال. مثلًا، قد يشترك النموذجان <code>Post</code> و <code>Video</code> بعلاقة متعددة الأشكال إلى نموذج الوسم <code>Tag</code>. باستخدام علاقات الكثير إلى كثير متعددة الأشكال، يمكنك الحصول على قائمة وحيدة بالوسوم (tags) الفريدة المشتركة بين المنشورات (posts) والفيديوهات (videos). لنطّلع أولاً على هيكلية الجداول:<syntaxhighlight lang="text">
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
</syntaxhighlight>

==== هيكلية النماذج ====
الآن، يمكننا تعريف العلاقة على النماذج. سيمتلك النموذجان <code>Post</code> و <code>Video</code> التابع <code>tags</code> الذي يستدعي التابع <code>morphToMany</code>:<syntaxhighlight lang="php">
<?php

namespace App;

use Illuminate\Database\Eloquent\Model;

class Post extends Model
{
   /**
    * قراءة وسوم المنشور.
    */
   public function tags()
   {
       return $this->morphToMany('App\Tag', 'taggable');
   }
}
</syntaxhighlight>

==== تعريف معكوس العلاقة ====
الآن، يمكنك تعريف تابع لكل نموذج مرتبط على النموذج <code>Tag</code>. لذا في هذا المثال، سنعرّف التابعين <code>posts</code> و <code>videos</code>:<syntaxhighlight lang="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');
   }
}
</syntaxhighlight>

==== استرداد العلاقة ====
بعد تعريف الجداول والنماذج، يمكنك الوصول للعلاقة باستخدام نماذجك. مثلًا، للوصول إلى الوسوم المرتبطة بمنشور ما، يمكنك استخدام الخاصية الديناميكية <code>tags</code>:<syntaxhighlight lang="php">
$post = App\Post::find(1);

foreach ($post->tags as $tag) {

  //

}
</syntaxhighlight>يمكنك أيضًا الوصول إلى مالك العلاقة متعددة الأشكال من النموذج متعدد الأشكال وذلك بالوصول إلى اسم التابع الذي ينفذ استدعاء للتابع <code>morphedByMany</code>. في هذه الحالة، يمكن الوصول لأحد التابعين <code>posts</code> أو <code>videos</code> على النموذج <code>Tag</code>. لذلك، سنصل إلى هذه التوابع كخاصيات ديناميكية:<syntaxhighlight lang="php">
$tag = App\Tag::find(1);

foreach ($tag->videos as $video) {

  //

}
</syntaxhighlight>

== الاستعلام عن العلاقات ==
بما أن جميع أنواع العلاقات المعرفة بـ [[Laravel/eloquent|Eloquent]] تكون توابع، يمكنك استدعاء هذه التوابع للوصول إلى كائن العلاقة دون تنفيذ استعلام العلاقة بحد ذاته. علاوةً على ذلك، جميع أنواع علاقات Eloquent تخدم [[Laravel/queries|كمنشئي استعلامات]]، مما يمكّنك من سلسلة قيود الاستعلام على استعلام العلاقة قبل تنفيذ الاستعلام البنيوي SQL الأخير على قاعدة البيانات.

مثلًا، لنتخيل نظام مدونة يكون فيه نموذج المستخدم <code>User</code> مرتبطًا بأكثر من منشور <code>Post</code>:<syntaxhighlight lang="php">
<?php

namespace App;

use Illuminate\Database\Eloquent\Model;

class User extends Model
{
   /**
    * قراءة جميع منشورات المستخدم.
    */
   public function posts()
   {
       return $this->hasMany('App\Post');
   }
}
</syntaxhighlight>يمكنك الاستعلام عن العلاقة <code>posts</code> وإضافة قيود إضافية على العلاقة كالتالي:<syntaxhighlight lang="php">
$user = App\User::find(1);

$user->posts()->where('active', 1)->get();
</syntaxhighlight>يمكنك استخدام أي تابع من توابع [[Laravel/queries|منشئ الاستعلامات]] على العلاقة، لذا تأكد من قراءتك لتوثيق منشئ الاستعلامات لتعلم هذه التوابع المتاحة للاستخدام.

=== توابع العلاقات والخاصيات الديناميكية ===
في حال لم ترد أن تضف قيودًا إضافية للاستعلام العلائقي، يمكنك الوصول إلى العلاقة كما وأنها خاصية. بالاستكمال مع مثال المستخدم والمنشورات، يمكنك الوصول إلى منشورات المستخدم كالتالي:<syntaxhighlight lang="php">
$user = App\User::find(1);

foreach ($user->posts as $post) {

  //

}
</syntaxhighlight>إن الخاصيات الديناميكية تتبع "التحميل الكسول (Lazy Loading)"، مما يعني أنه ستُحمّل العلاقة فقط عندما تحتاجها. بسبب ذلك، يلجأ المبرمجون لتحميل يسمى بـ "التحميل الحثيث (Eager Loading)" لتحميل العلاقات بشكل مسبق. يقلل التحميل الحريص من كمية الاستعلامات الفعلية التي  تُنفّذ على قاعدة البيانات، مما يخدم في تسريع عمل التطبيق.

=== الاستعلام عن وجود العلاقة ===
عند الوصول إلى سجل من نموذج، قد تحتاج إلى تحديد نتائجك بناءً على وجود أحد العلاقات. مثلًا، لنفرض أنك تريد استرداد كل المنشورات التي تملك تعليقًا واحدًا على الأقل. لتحقيق ذلك، يمكنك تمرير اسم العلاقة للتوابع <code>has</code> و <code>orHas</code>:<syntaxhighlight lang="php">
// استرداد جميع المنشورات التي تملك تعلقًا واحدًا على الأقل..
$posts = App\Post::has('comments')->get();
</syntaxhighlight>يمكنك أيضًا تحديد عملية ورقم لتخصيص الاستعلام بشكل أكبر:<syntaxhighlight lang="php">
// استرداد جميع المنشورات التي تملك ثلاث تعليقات أو أكثر..
$posts = App\Post::has('comments', '>=', 3)->get();
</syntaxhighlight>يمكن تحقيق تعليمات الـ <code>has</code> المتداخلة أيضًا باستخدام نمط النقطة (dot). مثلًا، لاسترداد جميع المنشورات التي تملك تعليقًا واحدًا وصوتًا واحدًا على الاقل:<syntaxhighlight lang="php">
// استرداد جميع المنشورات التي تملك تعليقاً واحداً على الأقل وصوتاً..
$posts = App\Post::has('comments.votes')->get();
</syntaxhighlight>إذا أردت أن تحظى بقوة أكبر، يمكنك استخدام التابعين <code>whereHas</code> و <code>orWhereHas</code> لإضافة قيود where على استعلامات <code>has</code>. تمكّنك هذه التوابع من إضافة قيود مخصصة على قيود العلاقة، كالتحقق من محتوى التعليق:<syntaxhighlight lang="php">
// استرداد جميع المنشورات التي تملك تعليقًا واحدًا على الأقل يحتوي على كلمات مثل foo%..
$posts = App\Post::whereHas('comments', function ($query) {
   $query->where('content', 'like', 'foo%');
})->get();
</syntaxhighlight>

=== الاستعلام عن عدم وجود العلاقة ===
عند الوصول إلى سجل من نموذج، قد تحتاج إلى تحديد نتائجك بناءً على عدم وجود أحد العلاقات. مثلًا، لنفرض أنك تريد استرداد كل المنشورات التي لا تملك أي تعليق. لتحقيق ذلك، يمكنك تمرير اسم العلاقة للتوابع <code>doesntHave</code> و <code>orDoesntHave</code>:<syntaxhighlight lang="php">
$posts = App\Post::doesntHave('comments')->get();
</syntaxhighlight>إذا أردت أن تحظى بقوة أكبر، يمكنك استخدام التابعين <code>whereDoesntHave</code> و <code>orWhereDoesntHave</code> لإضافة قيود where على استعلامات <code>doesntHave</code>. تمكّنك هذه التوابع من إضافة قيود مخصصة على قيود العلاقة، كالتحقق من محتوى التعليق:<syntaxhighlight lang="php">
$posts = App\Post::whereDoesntHave('comments', function ($query) {
   $query->where('content', 'like', 'foo%');
})->get();
</syntaxhighlight>يمكن تحقيق التعليمات المتداخلة أيضًا باستخدام نمط النقطة (dot). مثلًا، يستردّ الاستعلام التالي كل المنشورات مع التعليقات المنشأة من معلّقين غير محظورين:<syntaxhighlight lang="php">
$posts = App\Post::whereDoesntHave('comments.author', function ($query) {
   $query->where('banned', 1);
})->get();
</syntaxhighlight>

=== تعداد النماذج المرتبطة ===
إذا أردت الحصول على عدد النماذج المرتبطة دون تحميلها، يمكنك استخدام التابع <code>withCount</code>، الذي سيضيف حقل <code>count_{علاقة}</code> للنموذج الناتج. مثال:<syntaxhighlight lang="php">
$posts = App\Post::withCount('comments')->get();

foreach ($posts as $post) {
   echo $post->comments_count;
}
</syntaxhighlight>يمكنك إضافة "العدادات" إلى أكثر من علاقة واحدة، ويمكنك إضافة شروط للعدادات:<syntaxhighlight lang="php">
$posts = App\Post::withCount(['votes', 'comments' => function ($query) {
   $query->where('content', 'like', 'foo%');
}])->get();

echo $posts[0]->votes_count;

echo $posts[0]->comments_count;
</syntaxhighlight>يمكنك أيضًا تخصيص اسم حقل العداد الناتج، مما يتيح لك إضافة أكثر من عداد لنفس العلاقة:<syntaxhighlight lang="php">
$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;
</syntaxhighlight>

== التحميل الحثيث Eager loading ==
عند الوصول لعلاقات [[Laravel/eloquent|Eloquent]] كخاصيات، تُحمّل بيانات العلاقة بشكل كسول، مما يعني عدم تحميل البيانات ريثما نصل إلى خاصية العلاقة. لكن، يمكن لـ [[Laravel/eloquent|Eloquent]] أن يحمّل العلاقات بشكل "حثيث" أو مسبق عند الاستعلام عن العلاقة الأب. يؤدي التحميل الحريص إلى إلغاء مشكلة الـ N + 1 استعلام. لتمثيل هذه المشكلة، لنفرض نموذج كتاب <code>Book</code> مرتبط بكاتب <code>Author</code>:<syntaxhighlight lang="php">
<?php

namespace App;

use Illuminate\Database\Eloquent\Model;

class Book extends Model
{
   /**
    * Get the author that wrote the book.
    */
   public function author()
   {
       return $this->belongsTo('App\Author');
   }
}
</syntaxhighlight>لنستردّ الآن جميع الكتب وكتّابها:<syntaxhighlight lang="php">
$books = App\Book::all();

foreach ($books as $book) {
   echo $book->author->name;
}
</syntaxhighlight>سينفّذ هذا التكرار استعلام واحد لاسترداد كل الكتب، واستعلام واحد من أجل كل كتاب لاسترداد الكاتب. لذا إذا كان لدينا 25 كتاب، سيقوم هذا التكرار بتنفيذ 26 استعلام: 1 من أجل استرداد كل الكتب، و 25 استعلام من أجل استرداد كاتب كل كتاب.

لحسن الحظ، يمكن استخدام التحميل الحثيث لتقليل عدد الاستعلامات هذا إلى استعلامين فقط. عند الاستعلام، يمكنك تحديد العلاقة التي ستُحمّل بشكل حثيث باستخدام التابع <code>with</code>:<syntaxhighlight lang="php">
$books = App\Book::with('author')->get();

foreach ($books as $book) {
   echo $book->author->name;
}
</syntaxhighlight>من أجل هذه العملية، سينفّذ استعلامين فقط:<syntaxhighlight lang="sql">
select * from books

select * from authors where id in (1, 2, 3, 4, 5, ...)
</syntaxhighlight>

=== التحميل الحثيث لأكثر من علاقة ===
قد تحتاج بعض الأوقات إلى أن تتحمل التحميل الحثيث لأكثر من علاقة باستخدام عملية واحدة. لتحقيق ذلك، مرّر عدة وسائط للتابع <code>with</code>:<syntaxhighlight lang="php">
$books = App\Book::with(['author', 'publisher'])->get();
</syntaxhighlight>

=== التحميل الحثيث المتداخل ===
للتحميل الحثيث للعلاقات المتداخلة، يمكنك استخدام صيغة النقطة (dot). على سبيل المثال، لنحمل كل كتّاب الكتب وكل معلومات الاتصال الشخصية الخاصة بالكتّاب، وذلك في عملية Eloquent وحيدة:<syntaxhighlight lang="php">
$books = App\Book::with('author.contacts')->get();
</syntaxhighlight>

=== التحميل الحثيث لحقول محددة ===
قد تحتاج بعض الأوقات إلى تحميل حقول محددة فقط ضمن عملية التحميل الحثيث لنماذجك. لهذا السبب، يتيح Eloquent تحديد الحقول التي تريد أن تحمل من العلاقة:<syntaxhighlight lang="php">
$users = App\Book::with('author:id,name')->get();
</syntaxhighlight>'''ملاحظة:''' عند استخدام هذه الميزة، يجب دائمًا تحميل الحقل <code>id</code> من العلاقة التي تحمّلها.

=== إضافة القيود إلى التحميل الحثيث ===
قد تحتاج بعض الأوقات إلى التحميل الحثيث لبعض العلاقات، وإلى إضافة قيود إضافية لاستعلام التحميل الحثيث. إليك مثال:<syntaxhighlight lang="php">
$users = App\User::with(['posts' => function ($query) {
   $query->where('title', 'like', '%first%');
}])->get();
</syntaxhighlight>في هذا المثال، سيقوم Eloquent بالتحميل الحريص للمنشورات التي تملك عنوانًا (<code>title</code>) محتويًا للكلمة <code>first</code>. بالطبع، يمكنك استخدام توابع [[Laravel/queries|منشئ الاستعلامات]] الأخرى لتخصيص عملية التحميل الحثيث بشكل أكبر:<syntaxhighlight lang="php">
$users = App\User::with(['posts' => function ($query) {
   $query->orderBy('created_at', 'desc');
}])->get();
</syntaxhighlight>

=== التحميل الحثيث الكسول ===
قد تحتاج في بعض الأوقات إلى التحميل الحثيث لعلاقة ما بعد تحميل النموذج الأب الخاص بها. مثلًا، يكون ذلك مفيدًا عندما تريد تحميل علاقة ما بناءً على شرط محدد:<syntaxhighlight lang="php">
$books = App\Book::all();

if ($someCondition) {
   $books->load('author', 'publisher');
}
</syntaxhighlight>إذا أردت إضافة قيود إضافية على استعلام التحميل الحثيث، يمكنك تمرير مصفوفة تمثّل مفاتيحها أسماء العلاقات التي تريد تحميلها، وقيمها تحمل نطاقات مغلقة تستقبل كائنًا من الاستعلام:<syntaxhighlight lang="php">
$books->load(['author' => function ($query) {
   $query->orderBy('published_date', 'asc');
}]);
</syntaxhighlight>لتحميل علاقة ما فقط إن لم تُحمّل مسبقًا، يمكنك استخدام التابع <code>loadMissing</code>:<syntaxhighlight lang="php">
public function format(Book $book)
{
   $book->loadMissing('author');

   return [
       'name' => $book->name,
       'author' => $book->author->name
   ];
}
</syntaxhighlight>

== إضافة وتعديل النماذج المرتبطة ==

=== تابع الحفظ Save ===
يزوّد Eloquent بتوابع مساعدة لإضافة سجلات جديدة للعلاقات. مثلًا، قد تحتاج إلى إضافة تعليق (<code>Comment</code>) جديد إلى منشور ما (<code>Post</code>). بدلًا من تعيين الحقل <code>post_id</code> يدويًّا على سجل <code>Comment</code>، يمكنك تمرير التعليق مباشرةً إلى التابع <code>save</code> الخاص بالعلاقة:<syntaxhighlight lang="php">
$comment = new App\Comment(['message' => 'A new comment.']);

$post = App\Post::find(1);

$post->comments()->save($comment);
</syntaxhighlight>لاحظ أننا لم نصل إلى العلاقة <code>comments</code> كخاصية ديناميكية. بدلًا من ذلك، استدعينا التابع <code>comments</code> للحصول على كائن العلاقة. يضيف التابع <code>save</code> الحقل <code>post_id</code> المناسب إلى السجل <code>Comment</code> الجديد تلقائيًّا .

إذا أردت حفظ مجموعة من السجلات المرتبطة، يمكنك استخدام التابع <code>saveMany</code>:<syntaxhighlight lang="php">
$post = App\Post::find(1);

$post->comments()->saveMany([
   new App\Comment(['message' => 'A new comment.']),
   new App\Comment(['message' => 'Another comment.']),
]);
</syntaxhighlight>

=== تابع الإنشاء Create ===
إضافةً إلى التوابع <code>save</code> و <code>saveMany</code>، يمكنك استخدام التابع <code>create</code> الذي يقبل مصفوفة من الخواص وينشئ السجل ويضيفه إلى قاعدة البيانات. مجددًا، الفرق بين التابعين <code>save</code> و <code>create</code> هو أن التابع <code>save</code> يقبل كائن من نموذج Eloquent كامل، بينما التابع <code>create</code> يقبل مصفوفة PHP بسيطة:<syntaxhighlight lang="php">
$post = App\Post::find(1);

$comment = $post->comments()->create([
   'message' => 'A new comment.',
]);
</syntaxhighlight>'''ملاحظة:''' قبل استخدام التابع <code>create</code>، لا تنسَ مراجعة التوثيق الخاص [[Laravel/eloquent|بالتعيين الجماعي للخاصيات]].

يمكنك استخدام التابع <code>createMany</code> لإنشاء مجموعة من السجلات المرتبطة:<syntaxhighlight lang="php">
$post = App\Post::find(1);

$post->comments()->createMany([
   [
       'message' => 'A new comment.',
   ],
   [
       'message' => 'Another new comment.',
   ],
]);
</syntaxhighlight>

=== علاقة الانتماء (Belongs To) ===
عند تحديث علاقة انتماء (<code>belongsTo</code>)، يمكنك استخدام التابع <code>associate</code>. يعيّن هذا التابع المفتاح الأجنبي على السجل الابن:<syntaxhighlight lang="php">
$account = App\Account::find(10);

$user->account()->associate($account);

$user->save();
</syntaxhighlight>عند إزالة علاقة انتماء، يمكنك استخدام التابع <code>dissociate</code>. يعيّن هذا التابع المفتاح الأجنبي إلى <code>null</code>:<syntaxhighlight lang="php">
$user->account()->dissociate();

$user->save();
</syntaxhighlight>

==== النماذج الافتراضية ====
يمكن لعلاقة الانتماء أن تحدد نموذج افتراضي للعلاقة المعادة عندما تكون <code>null</code>. يدعى ذلك النمط [[wikipedia:Null_object_pattern|بنمط الكائنات الفارغة]] <code>null</code>، ويساعد على إزالة القيود الإضافية في برنامجك. في المثال التالي، تعيد العلاقة <code>user</code> كائنًا من <code>App\User</code> فارغًا عند عدم وجود مستخدم مرتبط بالمنشور:<syntaxhighlight lang="php">
/**
* قراءة كاتب المنشور.
*/
public function user()
{
   return $this->belongsTo('App\User')->withDefault();
}
</syntaxhighlight>لإضافة حقول افتراضية على النموذج الافتراضي، يمكنك تمرير مصفوفة أو نطاق مغلق إلى التابع <code>withDefault</code>:<syntaxhighlight lang="php">
/**
* قراءة كاتب المنشور.
*/
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';
   });
}
</syntaxhighlight>

=== العلاقات كثير إلى كثير Many to Many ===

==== الربط / فك الربط ====
يزود [[Laravel/eloquent|Eloquent]] أيضًا بمجموعة من التوابع المساعدة لجعل العمل مع السجلات المرتبطة سهلًا. مثلًا، لنفرض أنّه يمكن للمستخدم أن يملك عدة أدوار، ولكل دور عدة مستخدمين. لربط المستخدم بدور عن طريق إضافة سجل إلى الجدول الوسيطي الذي يربط العلاقة، يمكن استخدام التابع <code>attach</code>:<syntaxhighlight lang="php">
$user = App\User::find(1);

$user->roles()->attach($roleId);
</syntaxhighlight>عند ربط النموذج بعلاقة، يمكنك تمرير مصفوفة بالخاصيات التي ستُضاف إلى الجدول الوسيطي:<syntaxhighlight lang="php">
$user->roles()->attach($roleId, ['expires' => $expires]);
</syntaxhighlight>بالطبع، من الضروري أحيانًا أن يُزال المستخدم من دور محدد. لإزالة سجل علاقة كثير إلى كثير، يمكن استخدام التابع <code>detach</code>. يزيل التابع <code>detach</code> السجل المناسب من الجدول الوسيطي للعلاقة، لكن سيبقى كلا السجلّين في قاعدة البيانات:<syntaxhighlight lang="php">
// إزالة دور واحد من المستخدم...
$user->roles()->detach($roleId);

// إزالة جميع أدوار المستخدم...
$user->roles()->detach();
</syntaxhighlight>للسهولة، يقبل التابعان <code>attach</code> و <code>detach</code> مصفوفة من المفاتيح الرئيسية IDs:<syntaxhighlight lang="php">
$user = App\User::find(1);

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

$user->roles()->attach([
   1 => ['expires' => $expires],
   2 => ['expires' => $expires]
]);
</syntaxhighlight>

==== مزامنة الارتباطات ====
يمكنك استخدام التابع <code>sync</code> لإنشاء علاقات الكثير إلى كثير. يقبل التابع <code>sync</code> مصفوفة من المفاتيح الرئيسية لوضعها في الجدول الوسيطي. ستُزال المفاتيح الرئيسية غير الموجودة في المصفوفة الممررة من الجدول الوسيطي. لذا بعد استكمال العملية، سيُحتفظ بالمفاتيح الرئيسية الممررة للتابع بالمصفوفة فقط ضمن الجدول الوسيطي:<syntaxhighlight lang="php">
$user->roles()->sync([1, 2, 3]);
</syntaxhighlight>يمكنك أيضًا تمرير خاصيات إضافية للجدول الوسيطي مع المفاتيح:<syntaxhighlight lang="php">
$user->roles()->sync([1 => ['expires' => true], 2, 3]);
</syntaxhighlight>إذا لم ترد من التابع <code>sync</code> أن يفك الارتباط، وإنما فقط إضافة المفاتيح الجديدة، يمكنك استخدام التابع <code>syncWithoutDetaching</code>:<syntaxhighlight lang="php">
$user->roles()->syncWithoutDetaching([1, 2, 3]);
</syntaxhighlight>

==== تبديل الارتباطات ====
تزود علاقات الكثير إلى كثير بتابع <code>toggle</code> الذي يبدل حالة الارتباط للمفاتيح المعطاة. في حال كان المفتاح المعطى مرتبطًا، سيفك ارتباطه؛ بالمثل، في حال كان غير مرتبط، سيربط:<syntaxhighlight lang="php">
$user->roles()->toggle([1, 2, 3]);
</syntaxhighlight>

==== حفظ بيانات إضافية في الجدول الوسيطي ====
عند العمل مع علاقات الكثير إلى كثير، يقبل التابع <code>save</code> مصفوفة بالخاصيات الإضافية التي يجب إضافتها للجدول الوسيطي، وذلك بالوسيط الثاني للتابع:<syntaxhighlight lang="php">
App\User::find(1)->roles()->save($role, ['expires' => $expires]);
</syntaxhighlight>

==== تعديل سجل في الجدول الوسيطي ====
إذا أردت تعديل سجل موجود مسبقًا في الجدول الوسيطي، يمكنك استخدام التابع <code>updateExistingPivot</code>. يقبل هذا التابع المفتاح الأجنبي لسجل الجدول الوسيطي، ومصفوفة الخاصيات الوسيطية:<syntaxhighlight lang="php">
$user = App\User::find(1);

$user->roles()->updateExistingPivot($roleId, $attributes);
</syntaxhighlight>

== تعديل بصمات الوقت للسجلات الآباء ==
عند تكوين علاقة انتماء <code>belongsTo</code> أو انتماء متعدد <code>belongsToMany</code>، كعلاقة التعليق والمنشور، من الضروري أحيانًا أن تُعدّل بصمات الوقت للأب عند تعديل السجل الابن. مثلًا، عند تعديل سجل <code>Comment</code>، يمكنك تلقائيًّا تعديل الحقل الزمني <code>updated_at</code> الخاص بالمنشور <code>Post</code> الأب للتعليق. لتحقيق ذلك، أضف الخاصية <code>touches</code> إلى النموذج الابن التي تحتوي مصفوفة بأسماء العلاقات التي يجب تعديل حقولها الزمنية تلقائيًّا:<syntaxhighlight lang="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');
   }
}
</syntaxhighlight>الآن، عند تعديل سجل تعليق <code>Comment</code>، سيعدل الحقل <code>updated_at</code> الخاص بالمنشور <code>Post</code> المالك للتعليق:<syntaxhighlight lang="php">
$comment = App\Comment::find(1);

$comment->text = 'Edit to this comment!';

$comment->save();
</syntaxhighlight>

== مصادر ==
* [https://laravel.com/docs/5.6/eloquent-relationships صفحة Eloquent: Relationships في توثيق Laravel الرسمي.]
[[تصنيف:Laravel|{{SUBPAGENAME}}]]
[[تصنيف:Laravel Eloquent ORM|{{SUBPAGENAME}}]]