Ana içeriğe geç

İleri Seviye Middleware

🌐 Translation by AI and humans

This translation was made by AI guided by humans. 🤝

It could have mistakes of misunderstanding the original meaning, or looking unnatural, etc. 🤖

You can improve this translation by helping us guide the AI LLM better.

English version

Ana tutorial'da uygulamanıza Özel Middleware eklemeyi gördünüz.

Ardından CORSMiddleware ile CORS'u yönetmeyi de okudunuz.

Bu bölümde diğer middleware'leri nasıl kullanacağımıza bakacağız.

ASGI middleware'leri ekleme

FastAPI, Starlette üzerine kurulu olduğu ve ASGI spesifikasyonunu uyguladığı için, herhangi bir ASGI middleware'ini kullanabilirsiniz.

Bir middleware'in çalışması için özellikle FastAPI ya da Starlette için yazılmış olması gerekmez; ASGI spec'ine uyduğu sürece yeterlidir.

Genel olarak ASGI middleware'leri, ilk argüman olarak bir ASGI app almayı bekleyen class'lar olur.

Dolayısıyla üçüncü taraf ASGI middleware'lerinin dokümantasyonunda muhtemelen şöyle bir şey yapmanızı söylerler:

from unicorn import UnicornMiddleware

app = SomeASGIApp()

new_app = UnicornMiddleware(app, some_config="rainbow")

Ancak FastAPI (aslında Starlette) bunu yapmanın daha basit bir yolunu sunar; böylece dahili middleware'ler server hatalarını doğru şekilde ele alır ve özel exception handler'lar düzgün çalışır.

Bunun için app.add_middleware() kullanırsınız (CORS örneğindeki gibi).

from fastapi import FastAPI
from unicorn import UnicornMiddleware

app = FastAPI()

app.add_middleware(UnicornMiddleware, some_config="rainbow")

app.add_middleware() ilk argüman olarak bir middleware class'ı alır ve middleware'e aktarılacak ek argümanları da kabul eder.

Entegre middleware'ler

FastAPI, yaygın kullanım senaryoları için birkaç middleware içerir; şimdi bunları nasıl kullanacağımıza bakacağız.

Teknik Detaylar

Bir sonraki örneklerde from starlette.middleware.something import SomethingMiddleware kullanmanız da mümkündür.

FastAPI, size (geliştirici olarak) kolaylık olsun diye fastapi.middleware içinde bazı middleware'leri sağlar. Ancak mevcut middleware'lerin çoğu doğrudan Starlette'ten gelir.

HTTPSRedirectMiddleware

Gelen tüm request'lerin https veya wss olmasını zorunlu kılar.

http veya ws olarak gelen herhangi bir request, bunun yerine güvenli şemaya redirect edilir.

from fastapi import FastAPI
from fastapi.middleware.httpsredirect import HTTPSRedirectMiddleware

app = FastAPI()

app.add_middleware(HTTPSRedirectMiddleware)


@app.get("/")
async def main():
    return {"message": "Hello World"}

TrustedHostMiddleware

HTTP Host Header saldırılarına karşı korunmak için, gelen tüm request'lerde Host header'ının doğru ayarlanmış olmasını zorunlu kılar.

from fastapi import FastAPI
from fastapi.middleware.trustedhost import TrustedHostMiddleware

app = FastAPI()

app.add_middleware(
    TrustedHostMiddleware, allowed_hosts=["example.com", "*.example.com"]
)


@app.get("/")
async def main():
    return {"message": "Hello World"}

Aşağıdaki argümanlar desteklenir:

  • allowed_hosts - Hostname olarak izin verilmesi gereken domain adlarının listesi. *.example.com gibi wildcard domain'ler subdomain eşleştirmesi için desteklenir. Herhangi bir hostname'e izin vermek için allowed_hosts=["*"] kullanın veya middleware'i hiç eklemeyin.
  • www_redirect - True olarak ayarlanırsa, izin verilen host'ların www olmayan sürümlerine gelen request'ler www sürümlerine redirect edilir. Varsayılanı True'dur.

Gelen bir request doğru şekilde doğrulanmazsa 400 response gönderilir.

GZipMiddleware

Accept-Encoding header'ında "gzip" içeren herhangi bir request için GZip response'larını yönetir.

Middleware hem standart hem de streaming response'ları ele alır.

from fastapi import FastAPI
from fastapi.middleware.gzip import GZipMiddleware

app = FastAPI()

app.add_middleware(GZipMiddleware, minimum_size=1000, compresslevel=5)


@app.get("/")
async def main():
    return "somebigcontent"

Aşağıdaki argümanlar desteklenir:

  • minimum_size - Bayt cinsinden bu minimum boyuttan küçük response'lara GZip uygulama. Varsayılanı 500'dür.
  • compresslevel - GZip sıkıştırması sırasında kullanılır. 1 ile 9 arasında bir tamsayıdır. Varsayılanı 9'dur. Daha düşük değer daha hızlı sıkıştırma ama daha büyük dosya boyutları üretir; daha yüksek değer daha yavaş sıkıştırma ama daha küçük dosya boyutları üretir.

Diğer middleware'ler

Başka birçok ASGI middleware'i vardır.

Örneğin:

Diğer mevcut middleware'leri görmek için Starlette'in Middleware dokümanlarına ve ASGI Awesome List listesine bakın.