Next.js মিডলওয়্যার কী কাজে ব্যবহৃত হয়?

Question

Accepted Answer

**মিডলওয়্যার** হল এমন কোড যা একটি অনুরোধ সম্পন্ন হওয়ার **আগে চলে** — Edge-এ, পৃষ্ঠা বা রুট হ্যান্ডলার রেন্ডার হওয়ার আগে। এটি আপনাকে অনুরোধ পরিদর্শন করতে এবং পুনরায় লেখা/পুনর্নির্দেশ করতে, হেডার সেট করতে, বা এক জায়গায় অনেক রুটের জন্য প্রমাণীকরণ পরীক্ষা করতে দেয়।

## মিডলওয়্যার সংজ্ঞায়িত করা

```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*"] };
```

## মিডলওয়্যার কী করতে পারে

```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→শীর্ষ), পুনরায় লেখার মাধ্যমে **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` কনফিগ গুরুত্বপূর্ণ: মিডলওয়্যারকে শুধুমাত্র সেই রুটে সীমাবদ্ধ করুন যেগুলির প্রয়োজন, যাতে এটি স্থিত সম্পদে চলে না এবং সবকিছু ধীর না করে।

## এটি কেন গুরুত্বপূর্ণ

মিডলওয়্যার হল ক্রস-কাটিং অনুরোধ লজিকের জন্য একক চোকপয়েন্ট — প্রমাণীকরণ পুনর্নির্দেশ, স্থানীয় রুটিং, পুনরায় লেখা, এবং হেডার — প্রতিটি পৃষ্ঠায় কোড পুনরাবৃত্তি ছাড়াই অনেক রুটে প্রয়োগ করা হয়।

এর Edge সীমাবদ্ধতা (দ্রুত, কোন Node API নেই, শুধুমাত্র হালকা পরীক্ষা) এবং `matcher` স্কোপিং জানা হল যা আপনাকে গেটকিপিং এবং রুটিং সমস্যার জন্য এটি সঠিকভাবে ব্যবহার করতে দেয়।