شرح صفوف ومحتوى الفقرة
لتحويل مجموعة من النماذج أو نتائج استعلام مرقم، مرر البيانات إلى الدالة الثابتة PostResource::collection. عند تمرير كائن ترقيم ناتج عن دالة paginate، يحتفظ Laravel تلقائياً بكائني links و meta الوصفية ويلحقهما بجانب مصفوفة data.
- دالة المجموعة الثابتة (Static Collection Method): تحوّل PostResource::collection كل عنصر في المجموعة وفق نفس قواعد المورد المفرد.
- البيانات الوصفية للترقيم (Pagination Metadata): تمرير نتائج paginate يضيف تلقائياً رقم الصفحة الحالية والإجمالي وروابط التنقل.
- كلاسات المجموعات المخصصة (Dedicated Collection Classes): استخدم الخيار --collection لتوليد كلاس ResourceCollection عند الحاجة لإضافة بيانات وصفية عامة.
PHP
// In PostController@index:
public function index()
{
$posts = Post::with('author')->paginate(10);
return PostResource::collection($posts);
}