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

Protecting Routes with Sanctum Guard حماية مسارات API بحارس Sanctum

إصدار رموز الوصول Bearer Tokens عبر مكتبة Laravel Sanctum وحماية مسارات API بالبرمجية الوسيطة auth:sanctum وإدارة صلاحيات الرموز.
1 صفوف تعليمية
إطار العمل Laravel
0 مشاهدة

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

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

لقصر الوصول إلى نقاط النهاية البرمجية على العملاء المصادق عليهم، أرفق البرمجية الوسيطة auth:sanctum بالمسارات الفردية أو مجموعات المسارات داخل routes/api.php. عند إرسال رمز Bearer صالح، تعيد دالة $request->user كائن المستخدم المصادق عليه تلقائياً.

  • الحماية بالبرمجية الوسيطة (Middleware Protection): غلف نقاط النهاية الخاصة داخل مجموعة Route::middleware('auth:sanctum') في ملف routes/api.php.
  • جلب المستخدم الحالي (Resolving Current User): استرجع مالك الرمز عبر دالة $request->user داخل أي متحكم أو مسار محمي.
  • الرمز 401 لغير المصادق (HTTP 401 Unauthenticated): الطلبات التي تفتقر لرمز Bearer صالح مع رأس JSON تستقبل استجابة 401 فورية.
PHP
use App\Http\Controllers\Api\PostController;
use Illuminate\Http\Request;
use Illuminate\Support\Facades\Route;

Route::middleware('auth:sanctum')->group(function () {
    Route::get('/me', fn (Request $r) => $r->user());
    Route::apiResource('posts', PostController::class);
});