انتقل إلى محتوى الدرس

Creating JsonResource Classes إنشاء كلاسات JsonResource للنماذج

تحويل نماذج البيانات إلى استجابات JSON معيارية عبر Eloquent API Resources وتضمين العلاقات المشروطة بـ whenLoaded.
1 صفوف تعليمية
إطار العمل Laravel
0 مشاهدة

شرح صفوف ومحتوى الفقرة

الصف 1 شرح توضيحي

يمكنك توليد كلاس تحويل جديد باستخدام الأمر php artisan make:resource الذي ينشئ الملف داخل مجلد app/Http/Resources. داخل دالة toArray الخاصة بالمورد، يمرر المتغير $this الوصول للخصائص والدوال مباشرة إلى كائن نموذج Eloquent الأساسي.

  • مولد Artisan (Artisan Generator): نفذ الأمر php artisan make:resource PostResource لبناء كلاس تحويل لنموذج مفرد.
  • الوسيط الشفاف للنموذج (Transparent Model Proxy): استدع خصائص النموذج مثل $this->id و $this->title مباشرة داخل دالة toArray.
  • تنسيق الطوابع الزمنية (Formatted Timestamps): حوّل تواريخ Carbon إلى صيغة ISO-8601 القياسية قبل إرسالها لعملاء JSON.
PHP
namespace App\Http\Resources;
use Illuminate\Http\Resources\Json\JsonResource;

class PostResource extends JsonResource {
    public function toArray($request): array {
        return ['id' => $this->id];
    }
}