Apakah middleware dalam Django?

Question

Accepted Answer

**Middleware** ialah rangka kerja cangkuk (hook) yang memproses **setiap permintaan dan respons** secara global, terletak antara pelayan web dan view anda. Setiap middleware boleh memeriksa/mengubah permintaan semasa masuk dan respons semasa keluar — sesuai untuk tanggungjawab silang seperti pengesahan, pengepala keselamatan, sesi, dan pengelogan.

## Aliran permintaan/respons melalui middleware

```text
Request  → MW1 → MW2 → MW3 → VIEW
Response ← MW1 ← MW2 ← MW3 ← VIEW

Middleware wraps the view like layers of an onion:
  - on the way IN (request): top-to-bottom
  - on the way OUT (response): bottom-to-top (reverse order)
```

## Middleware terbina dalam Django (dalam settings.py)

```python
MIDDLEWARE = [
    "django.middleware.security.SecurityMiddleware",          # security headers (HSTS, etc.)
    "django.contrib.sessions.middleware.SessionMiddleware",   # enables request.session
    "django.middleware.common.CommonMiddleware",
    "django.middleware.csrf.CsrfViewMiddleware",              # CSRF protection
    "django.contrib.auth.middleware.AuthenticationMiddleware",# enables request.user
    "django.middleware.clickjacking.XFrameOptionsMiddleware", # clickjacking protection
]
# ORDER MATTERS — e.g. SessionMiddleware must come before AuthenticationMiddleware
```

Kebanyakan fungsi teras Django ialah middleware: sesi (`request.session`), pengesahan (`request.user`), perlindungan CSRF, dan pengepala keselamatan semuanya datang daripada middleware terbina dalam. **Susunan penting** — sesetengah middleware bergantung pada yang lain berjalan dahulu.

## Menulis middleware tersuai

```python
class TimingMiddleware:
    def __init__(self, get_response):
        self.get_response = get_response          # the next middleware/view

def __call__(self, request):
        # --- code here runs on the way IN (before the view) ---
        import time; start = time.time()

response = self.get_response(request)     # call the next layer (eventually the view)

# --- code here runs on the way OUT (after the view) ---
        response["X-Response-Time"] = f"{time.time() - start:.3f}s"
        return response
```

Satu middleware ialah callable: kod sebelum `self.get_response(request)` berjalan pada permintaan, kod selepasnya berjalan pada respons. Ini membolehkan anda bertindak sebelum dan selepas pelaksanaan view.

## Penggunaan middleware yang biasa

```text
✓ Authentication / setting request.user
✓ Security headers (CSP, HSTS, X-Frame-Options)
✓ Request/response logging, timing, metrics
✓ Sessions, locale/i18n detection, CORS
✓ Rate limiting, maintenance mode, custom request preprocessing
```

## Middleware berbanding view/decorator

```text
Middleware → GLOBAL, cross-cutting concerns affecting EVERY (or most) request
Decorators/view logic → per-view concerns specific to certain endpoints
→ Use middleware for app-wide behavior; decorators for selective behavior.
```

## Mengapa ia penting

Middleware adalah asas kepada cara Django memproses permintaan — memahaminya menjelaskan bagaimana banyak fungsi teras rangka kerja sebenarnya berfungsi dan menyediakan mekanisme yang betul untuk **tanggungjawab global dan silang**.

Mengenali bahawa sesi, pengesahan (`request.user`), perlindungan CSRF, dan pengepala keselamatan semuanya datang daripada middleware terbina dalam menyahkaburkan pengendalian permintaan Django dan menunjukkan mengapa ciri-ciri ini "berfungsi begitu sahaja." Memahami **aliran permintaan/respons berlapis bawang** (middleware membungkus view, memproses permintaan dari atas ke bawah dan respons dari bawah ke atas) dan bahawa **susunan penting** (sesetengah middleware bergantung pada yang lain, seperti pengesahan memerlukan sesi dahulu) adalah penting untuk mengkonfigurasi Django dengan betul dan menyahpepijat isu.

Keupayaan untuk **menulis middleware tersuai** bernilai untuk melaksanakan tingkah laku seluruh aplikasi dengan kemas — pengelogan, pemasaan, pengepala tersuai, penghadan kadar, mod penyelenggaraan — di satu tempat dan bukannya mengulanginya merentasi view.

Mengetahui bila untuk menggunakan middleware (tanggungjawab global yang mempengaruhi kebanyakan permintaan) berbanding decorator atau logik view (tanggungjawab setiap titik akhir) ialah keputusan seni bina yang utama.

Middleware ialah tempat Django mengendalikan pemprosesan permintaan/respons yang dikenakan merentasi seluruh aplikasi, menjadikannya pengetahuan yang penting dan relevan secara praktikal untuk kedua-dua memahami dalaman rangka kerja dan membina aplikasi yang berstruktur baik dengan pengasingan tanggungjawab silang yang wajar.