شرح صفوف ومحتوى الفقرة
إن إرجاع نماذج Eloquent الخام مباشرة من المتحكم يربط عقد الواجهة البرمجية العامة بهيكلة جداول قاعدة البيانات الداخلية وقد يعرض الحقول الحساسة للتسريب. توفر موارد Eloquent API طبقة تحويل وسيطة وأنيقة تفصل بين نماذج البيانات ومخرجات JSON المرسلة للعملاء.
- فصل هيكلة القاعدة (Schema Decoupling): إمكانية تعديل أسماء أعمدة الجداول داخلياً دون كسر تطبيقات الهواتف أو الواجهات الأمامية.
- التغليف القياسي للبيانات (Data Envelope Wrapping): تغليف الموارد المفردة والمجموعات تلقائياً داخل مفتاح data موحد في أعلى الاستجابة.
- القائمة البيضاء للحقول (Explicit Field Whitelisting): لا يظهر في مخرجات JSON سوى الخصائص المصرح بها صراحة داخل دالة toArray.
PHP
// Without Resource (leaks internal schema):
// return Post::findOrFail($id);
// With Eloquent API Resource:
use App\Http\Resources\PostResource;
return new PostResource(Post::findOrFail($id));