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

Enabling Stateless API Routing تفعيل مسارات API عديمة الحالة

تفعيل مسارات الواجهات البرمجية بالأمر install:api وإنشاء متحكمات API وإرجاع استجابات JSON القياسية مع رموز حالة HTTP.
1 صفوف تعليمية
إطار العمل Laravel
0 مشاهدة

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

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

يعتمد إطار Laravel 12 هيكلة رشيقة يتم فيها تفعيل مسارات الواجهات البرمجية عند الحاجة عبر أمر install:api في Artisan. يقوم هذا الأمر بإنشاء ملف routes/api.php وتسجيل البادئة /api تلقائياً داخل bootstrap/app.php مع تطبيق مجموعة البرمجيات الوسيطة عديمة الحالة.

  • المعمارية عديمة الحالة (Stateless Architecture): لا تحتفظ مسارات API بحالة الجلسة على الخادم أو ملفات تعريف CSRF بين الطلبات.
  • البادئة التلقائية (Automatic Prefixing): يُسبق كل مسار معرّف داخل ملف routes/api.php بالبادئة /api تلقائياً.
  • الربط في التمهيد (Bootstrap Wiring): يربط إعداد withRouting في ملف bootstrap/app.php ملف مسارات API بأنبوب البرمجيات الوسيطة.
مخطط معماري يوضح بناء مسارات RESTful API ومتحكمات JSON في Laravel في إطار العمل Laravel 12
PHP
// Terminal: php artisan install:api
// bootstrap/app.php
return Application::configure(basePath: __DIR__)
    ->withRouting(
        api: __DIR__.'/../routes/api.php',
    )->create();