Django'da middleware nedir?

Question

Accepted Answer

**Middleware**, web sunucusu ile görünümleriniz arasında yer alarak, **her isteği ve yanıtı** küresel olarak işleyen bir hooks çerçevesidir. Her middleware, yolda gelen istekleri inceleyebilir/değiştirebilir ve dışarı çıkan yanıtları değiştirebilir — kimlik doğrulama, güvenlik başlıkları, oturumlar ve günlüğe kaydetme gibi kesişen endişeler için ideal.

## Middleware üzerinden istek/yanıt akışı

```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)
```

## Django'nun yerleşik middleware'i (settings.py'de)

```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
```

Django'nun temel işlevinin çoğu middleware'dir: oturumlar (`request.session`), kimlik doğrulama (`request.user`), CSRF koruması ve güvenlik başlıkları hepsi yerleşik middleware'den gelir. **Sıra önemlidir** — bazı middleware'ler önce diğerlerinin çalışmasına bağlıdır.

## Özel middleware yazma

```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
```

Middleware bir çağrılabilirdir: `self.get_response(request)` öncesindeki kod istekte, sonrasındaki kod yanıtta çalışır. Bu, görünüm yürütülmesinden önce ve sonra işlem yapmanıza olanak sağlar.

## Yaygın middleware kullanımları

```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 vs görünümler/dekoratörler

```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.
```

## Neden önemli

Middleware, Django'nun istekleri nasıl işlediğinin temeldir — bunun anlaşılması çerçevenin temel işlevselliğinin aslında nasıl çalıştığını açıklar ve **küresel, kesişen endişeler** için doğru mekanizmayı sağlar.

Oturumların, kimlik doğrulamanın (`request.user`), CSRF korumasının ve güvenlik başlıklarının hepsinin yerleşik middleware'den geldiğini fark etmek Django'nun istek işlemeyi demistifiye eder ve bu özelliklerin neden "sadece çalışır" olduğunu gösterir. **Soğan tabakası istek/yanıt akışını** anlamak (middleware görünümü sardığında, istekleri yukarıdan aşağıya ve yanıtları aşağıdan yukarıya işlediğinde) ve **sıranın önemli olduğunu** anlamak (bazı middleware'ler diğerlerine bağlıdır, örneğin kimlik doğrulama ilk olarak oturumlara ihtiyaç duyar) Django'yu doğru şekilde yapılandırmak ve sorunları ayıklamak için önemlidir.

**Özel middleware yazma** becerisi, uygulamada geniş davranışı temiz bir şekilde uygulamak için değerlidir — günlüğe kaydetme, zamanlama, özel başlıklar, hız sınırlaması, bakım modu — bunu görünümler arasında tekrarlamak yerine bir yerde.

Middleware ne zaman kullanacağınızı (çoğu isteği etkileyen küresel endişeler) versus dekoratörler veya görünüm mantığı (endpoint başına endişeler) bilmek önemli bir mimari kararıdır.

Middleware, Django'nun tüm uygulama genelinde geçerli olan istek/yanıt işlemesini yönettiği yerdir, bu da onu çerçevenin iç işleyişini anlamak ve kesişen endişelerin uygun şekilde ayrılmasıyla iyi yapılandırılmış uygulamalar oluşturmak için pratik açıdan ilgili bilgi yapar.