ما هو الغرض من middleware في Next.js؟

Question

Accepted Answer

**Middleware** هو كود يعمل **قبل اكتمال الطلب** — على Edge، قبل أن تُعرّض الصفحة أو معالج المسار. يسمح لك بفحص وإعادة كتابة/إعادة توجيه الطلبات، وتعيين رؤوس البيانات، أو التحقق من المصادقة لعدة مسارات في مكان واحد.

## تعريف middleware

```ts
// middleware.ts (at the project root)
import { NextRequest, NextResponse } from "next/server";

export function middleware(req: NextRequest) {
  const token = req.cookies.get("session")?.value;

// protect /dashboard — redirect unauthenticated users to login
  if (req.nextUrl.pathname.startsWith("/dashboard") && !token) {
    return NextResponse.redirect(new URL("/login", req.url));
  }
  return NextResponse.next(); // allow the request to proceed
}

// only run on these paths (performance — don't run on every asset)
export const config = { matcher: ["/dashboard/:path*", "/account/:path*"] };
```

## ما يمكن لـ middleware القيام به

```ts
NextResponse.redirect(url);          // send the user elsewhere (auth gates)
NextResponse.rewrite(url);           // serve different content, URL unchanged (A/B, i18n)
NextResponse.next();                  // continue, optionally with modified headers
// req.geo / req.cookies / req.headers — inspect location, auth, etc.
```

الاستخدامات الشائعة: **التحكم في الوصول بناءً على المصادقة**، **إعادة التوجيه** (بناءً على اللغة/الموقع الجغرافي، www→apex)، **اختبار A/B** عبر إعادة الكتابة، وتعيين **رؤوس الأمان**، وأعلام الروبوت/الميزات.

## القيود الرئيسية

```text
⚠️ Runs on the EDGE runtime → no Node.js APIs (no fs, limited libraries)
⚠️ Must be FAST — it runs before every matched request; heavy work adds latency
⚠️ Can't access the database directly for complex auth — do lightweight checks
   (e.g. verify a JWT/cookie exists); do full auth in the page/handler
```

تكوين `matcher` مهم: قصر middleware على المسارات التي تحتاجه فقط، حتى لا يعمل على الأصول الثابتة ويبطئ كل شيء.

## لماذا هذا مهم

Middleware هو نقطة التحكم الوحيدة لمنطق الطلبات المتقاطعة — إعادة التوجيه للمصادقة، وتوجيه اللغة، وإعادة الكتابة، والرؤوس — مطبقة عبر العديد من المسارات دون تكرار الكود في كل صفحة.

معرفة قيود Edge الخاصة به (سريع، بدون واجهات برمجية Node، فحوصات خفيفة فقط) وتحديد نطاق `matcher` هو ما يسمح لك باستخدامه بشكل صحيح للتحكم في الوصول والمخاوف المتعلقة بالتوجيه.