FastAPI-তে middleware কীভাবে কাজ করে?

Question

Accepted Answer

**Middleware** FastAPI-তে এমন কোড যা **প্রতিটি request এবং response**-এর জন্য চলে — আপনার endpoints-কে মোড়িয়ে logging, timing, CORS এবং headers যোগ করার মতো cross-cutting concerns পরিচালনা করতে। FastAPI Starlette-র middleware সিস্টেম ব্যবহার করে (এটি ASGI-ভিত্তিক)।

## কাস্টম middleware লেখা

```python
import time

@app.middleware("http")
async def add_timing(request: Request, call_next):
    start = time.time()
    response = await call_next(request)        # call the endpoint (and any inner middleware)
    response.headers["X-Process-Time"] = str(time.time() - start)   # modify the response
    return response
```

প্যাটার্নটি হল: `await call_next(request)`-এর আগের কোড **ভিতরের** দিকে চলে (endpoint-এর আগে), `call_next` endpoint-কে আহ্বান করে, এবং এর পরের কোড **বাইরের** দিকে চলে (response সংশোধন করে)। এটি প্রতিটি request-কে মোড়িয়ে দেয় — এখানে সমস্ত responses-এ একটি timing header যোগ করা হচ্ছে।

## Request/response প্রবাহ

```text
Request  → MW1 → MW2 → endpoint
Response ← MW1 ← MW2 ← endpoint
Middleware wraps the endpoint; runs in order on the way in, reverse on the way out.
```

## বিল্ট-ইন / সাধারণ middleware

```python
from fastapi.middleware.cors import CORSMiddleware
from fastapi.middleware.gzip import GZipMiddleware

app.add_middleware(CORSMiddleware, allow_origins=["https://app.example.com"], ...)  # CORS
app.add_middleware(GZipMiddleware, minimum_size=1000)                               # compression
```

Middleware সাধারণত `add_middleware`-এর মাধ্যমে যোগ করা হয় — CORS (ক্রস-অরিজিন requests অনুমতি), GZip (responses সংকুচিত করা), এবং trusted-host চেক সাধারণ বিল্ট-ইন।

## সাধারণ middleware ব্যবহার

```text
✓ Logging / request timing / metrics
✓ CORS (cross-origin request handling)
✓ Adding security or custom headers
✓ Response compression (GZip)
✓ Request ID / correlation ID injection
```

## Middleware বনাম dependencies

```text
Middleware   → runs for ALL requests; works at the raw request/response level (headers,
               timing, the whole response). Best for truly global concerns.
Dependencies → per-endpoint (or grouped) logic with access to parsed params, DI, and
               typed values. Best for auth, validation, shared parameters.
→ Use middleware for global cross-cutting concerns; dependencies for endpoint logic.
```

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

Middleware হল FastAPI-তে **গ্লোবাল, cross-cutting concerns**-এর জন্য সঠিক প্রক্রিয়া — এমন লজিক যা প্রতিটি request এবং response-এ প্রয়োগ করা উচিত, যেমন logging, request timing, CORS, compression এবং custom headers।

এটি বোঝা অ্যাপ্লিকেশনগুলি সঠিকভাবে কাঠামোবদ্ধ করার জন্য গুরুত্বপূর্ণ: middleware সমস্ত endpoints-কে মোড়িয়ে দেয় (আগে এবং পরে চলে, request এবং response উভয়ই সংশোধন করার ক্ষমতা সহ), যা এটিকে অ্যাপ-ব্যাপী আচরণের জন্য আদর্শ করে তোলে যা প্রতিটি endpoint-এ পুনরাবৃত্তি করা ক্লান্তিকর এবং ত্রুটি-প্রবণ হবে।

**Middleware** (গ্লোবাল, raw request/response স্তর) এবং **dependencies** (প্রতি-endpoint, parsed/typed মান এবং DI-তে অ্যাক্সেস সহ — auth এবং validation-এর জন্য আরও ভাল)-এর মধ্যে পার্থক্য জানা সঠিক সরঞ্জাম নির্বাচনের চাবিকাঠি।

CORS এবং compression-এর মতো সাধারণ চাহিদা built-in middleware দ্বারা পরিচালিত হয়, যখন custom middleware logging এবং instrumentation কভার করে — এটিকে ভালভাবে-কাঠামোবদ্ধ, observable APIs তৈরি করার জন্য ব্যবহারিক, ঘন ঘন ব্যবহৃত জ্ঞান করে তোলে।