شرح صفوف ومحتوى الفقرة
إن إتقان الربط بين أفعال HTTP وأنماط الروابط ودوال المتحكم ورموز الحالة يضمن توافق واجهتك البرمجية في Laravel مع المعايير الهندسية القياسية. راجع دورة حياة نقطة النهاية الكاملة للمورد البرمجي قبل الانتقال لتنسيق المخرجات عبر موارد Eloquent API.
| وجه المقارنة الهندسي | الأسلوب المتزامن أو التقليدي | معيار Laravel 12 الحديث |
|---|---|---|
| تسجيل المسارات البرمجية | تعريف 5 مسارات منفصلة يدوياً لكل مورد في الملف | تصريح موحد عبر Route::apiResource في ملف routes/api.php |
| توليد كلاس المتحكم | متحكم ويب كامل يحتوي على دالتي create و edit غير المستخدمتين | استخدام الخيار --api لتوليد الدوال الخمس الخاصة ببيانات JSON |
| رموز حالة الإنشاء والحذف | إرجاع الرمز العام 200 لجميع عمليات الإضافة والحذف | تخصيص الرمز 201 للإنشاء والرمز 204 للحذف عبر noContent |
| مخرجات فشل التحقق | إعادة توجيه 302 لصفحة HTML عند حدوث خطأ في المدخلات | إرجاع استجابة JSON تلقائية بالرمز 422 عند إرسال رأس الرسالة Accept |
PHP
// Inspect registered API routes:
// php artisan route:list --path=api
Route::prefix('v1')->group(function () {
Route::apiResource('posts', PostController::class);
});
خلاصة المعرفة ومحطة الانتقال
ملخص الدرس
حصاد الدرسمراجعة مركّزة لأهم المفاهيم والقواعد الهندسية التي أتقنتها في هذا الدرس قبل التطبيق العملي
ماذا تعلّمت في هذا الدرس؟
أتقنت في هذا الدرس حول «بناء مسارات RESTful API ومتحكمات JSON في Laravel» مفاهيم تفعيل مسارات API عديمة الحالة، وإنشاء متحكمات موارد API القياسية، وتسجيل مسارات apiResource الموحدة وفق معايير Laravel 12 الحديثة.
الخطوة التالية والدرس القادم
انتقل الآن إلى الدرس التالي «تنسيق استجابات الواجهات البرمجية عبر Eloquent API Resources» للبناء التراكمي على ما تعلمته.