العميل → الوسيط 1 → الوسيط 2 → الوسيط 3 → الراوتر/التحكم
العميل ← الوسيط 1 ← الوسيط 2 ← الوسيط 3 ← الراوتر/التحكم

php artisan make:middleware EnsureTokenIsValid

class EnsureTokenIsValid
{
    public function handle(Request $request, Closure $next): Response
    {
        if ($request->header('X-API-Key') !== config('app.api_key')) {
            return response()->json(['error' => 'مفتاح API غير صالح'], 401);
        }
        return $next($request);
    }
}

// قبل — ينفذ قبل الوصول للتحكم
class BeforeMiddleware
{
    public function handle(Request $request, Closure $next): Response
    {
        Log::info('بدأ الطلب', ['url' => $request->url()]);
        return $next($request);
    }
}

// بعد — ينفذ بعد استلام الرد من التحكم
class AfterMiddleware
{
    public function handle(Request $request, Closure $next): Response
    {
        $response = $next($request);
        Log::info('اكتمل الطلب', ['status' => $response->status()]);
        return $response;
    }
}

->withMiddleware(function (Middleware $middleware) {
    $middleware->alias([
        'auth' => Authenticate::class,
        'role' => CheckRole::class,
        'throttle' => ThrottleRequests::class,
    ]);
})

class CheckRole
{
    public function handle(Request $request, Closure $next, string ...$roles): Response
    {
        // التحقق من الدور
    }
}

// الاستخدام
Route::get('/admin', ...)->middleware('role:admin,super-admin');

RateLimiter::for('api', function (Request $request) {
    return Limit::perMinute(60)->by($request->user()?->id ?: $request->ip());
});

class TerminatingMiddleware
{
    public function terminate(Request $request, Response $response): void
    {
        Log::info('تم إنهاء الطلب بالكامل');
    }
}