عرض مصدر Laravel/eloquent collections

<noinclude>{{DISPLAYTITLE:المجموعات في رابط الكائنات بالعلاقات Eloquent}}</noinclude>
== مقدمة ==
إنّ جميع مجموعات النتائج المتعددة المعادة من [[Laravel/eloquent|Eloquent]] هي كائنات من الصنف <code>Illuminate\Database\Eloquent\Collection</code>، بما فيها النتائج المستردة من التابع <code>get</code> أو من العلاقات. يرث صنف مجموعة [[Laravel/eloquent|Eloquent]] من [[Laravel/collections|الصنف الأساسي لمجموعة Laravel]]، وبالتالي ترث هذه المجموعات الكثير من التوابع التي تساعد بالعمل مع المصفوفات المستخدمة مع نماذج [[Laravel/eloquent|Eloquent]].

بالطبع، تعمل جميع المجموعات كمكررات، مما يمكّنك من المرور على عناصرها وكأنها مصفوفات عادية:<syntaxhighlight lang="php">
$users = App\User::where('active', 1)->get();

foreach ($users as $user) {
   echo $user->name;
}
</syntaxhighlight>لكنّ المجموعات أقوى بكثير من المصفوفات، إذ تزود الكثير من عمليات التقليص والتجميع التي يمكن سلسلتها ضمن واجهة متطورة. مثلاً، لنحذف جميع السجلات غير النشطة ونجمع الاسم الأول لكل من المستخدمين المتبقيين:<syntaxhighlight lang="php">
$users = App\User::all();

$names = $users->reject(function ($user) {
   return $user->active === false;
})
->map(function ($user) {
   return $user->name;
});
</syntaxhighlight>'''ملاحظة:''' بينما تعيد معظم توابع مجموعات [[Laravel/eloquent|Eloquent]] كائنا جديدا من صنف مجموعة [[Laravel/eloquent|Eloquent]]، تعيد التوابع <code>pluck</code> و <code>keys</code> و <code>zip</code> و <code>collapse</code> و <code>flatten</code> و <code>flip</code> كائنا من [[Laravel/collections|الصنف الأساسي للمجموعات]]. بالمثل، إذا أعاد التابع <code>map</code> مجموعة لا تحوي أي كائن من نموذج [[Laravel/eloquent|Eloquent]]، سيتم تحويله تلقائيًّا إلى الصنف الأساسي.

== التوابع المتاحة ==

=== الصنف الأساسي للمجموعات ===
كما ذُكر، جميع مجموعات [[Laravel/eloquent|Eloquent]] ترث من الصنف الأساسي لمجموعات [[Laravel]]؛ وبالتالي، تزوّد جميع التوابع القوية التي يزوّدها [[Laravel/collections|الصنف الأساسي للمجموعات]].

== المجموعات المخصصة ==
إذا أردت استخدام كائن مخصص من الصنف <code>Collection</code> مع توابعك المخصصة الخاصة، يمكنك إعادة تعيين التابع <code>newCollection</code> على صنف نموذجك:<syntaxhighlight lang="php">
<?php

namespace App;

use App\CustomCollection;
use Illuminate\Database\Eloquent\Model;

class User extends Model
{
   /**
    * إنشاء كائن جديد من صنف مجموعة Eloquent.
    *
    * @param  array $models
    * @return \Illuminate\Database\Eloquent\Collection
    */
   public function newCollection(array $models = [])
   {
       return new CustomCollection($models);
   }
}
</syntaxhighlight>بعد تعريف التابع <code>newCollection</code>، ستتلقى كائنًا من مجموعتك المخصصة عندما يعيد Eloquent كائن <code>Collection</code> من ذلك النموذج. إذا أردت استخدام صنف <code>Collection</code> مخصص لكل نماذجك، عرّف التابع <code>newCollection</code> على صنف نموذج أساسي الذي ترثه جميع نماذجك.

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