Changeset 300
- Timestamp:
- 01/04/08 16:56:43 (1 year ago)
- Files:
-
- docs/trunk/middleware.txt (modified) (11 diffs)
Legend:
- Unmodified
- Added
- Removed
- Modified
- Copied
- Moved
docs/trunk/middleware.txt
r287 r300 18 18 19 19 Pour activer un composant middleware, ajoutez-le à la liste 20 ``MIDDLEWARE_CLASSES`` dans vos rà šglages Django (settings.py). Dans la liste20 ``MIDDLEWARE_CLASSES`` dans vos réglages Django (settings.py). Dans la liste 21 21 ``MIDDLEWARE_CLASSES``, chaque composant est représenté par une chaîne de 22 22 caractÚres : le chemin Python complet vers le nom de la classe du middleware. … … 46 46 47 47 Active le systÚme de cache pour le site. S'il est activé, chaque page rendue par 48 Django sera cachée pour une durée égale au rà šglage ``CACHE_MIDDLEWARE_SECONDS``.48 Django sera cachée pour une durée égale au réglage ``CACHE_MIDDLEWARE_SECONDS``. 49 49 Voir la `documentation du cache`_. 50 50 … … 56 56 Ajoute quelques aménagements pour les perfectionnistes : 57 57 58 * Interdit l'accÚs aux "user agents" présents dans le rà šglage58 * Interdit l'accÚs aux "user agents" présents dans le réglage 59 59 ``DISALLOWED_USER_AGENTS``, qui doit être une liste de chaînes de caractÚres. 60 60 61 * ProcÚde aux réécritures d'URL en fonction des rà šglages ``APPEND_SLASH`` et61 * ProcÚde aux réécritures d'URL en fonction des réglages ``APPEND_SLASH`` et 62 62 ``PREPEND_WWW``. 63 63 … … 65 65 un slash et qu'elle n'est pas trouvée dans l'URLconf, une nouvelle URL est 66 66 formée en ajoutant un slash à la fin. Si cette nouvelle URL est trouvée dans 67 l'URLconf, Django redirige redirigela requête vers cette nouvelle URL. Sinon67 l'URLconf, Django redirige la requête vers cette nouvelle URL. Sinon 68 68 l'URL d'origine est traitée comme d'habitude. 69 69 … … 86 86 normaliser les URLs. 87 87 88 * GÚre les ETags en fonction du rà šglage ``USE_ETAGS``. Si ``USE_ETAGS`` est88 * GÚre les ETags en fonction du réglage ``USE_ETAGS``. Si ``USE_ETAGS`` est 89 89 positionné à ``True``, Django calculera un ETag pour chaque requête en 90 90 calculant la somme MD5 du contenu de la page, et s'occupera de renvoyer la … … 95 95 96 96 Envoie un en-tête HTTP ``X-View`` adapté aux requêtes HEAD qui viennent 97 d'adresses IP définies dans le rà šglage ``INTERNAL_IPS``. Utilisé par le systÚme97 d'adresses IP définies dans le réglage ``INTERNAL_IPS``. Utilisé par le systÚme 98 98 de documentation automatique de Django. 99 99 … … 114 114 ----------------------------------------------- 115 115 116 GÚre les opérations GET condition elles. Si la réponse a un en-tête ``ETag`` ou116 GÚre les opérations GET conditionnelles. Si la réponse a un en-tête ``ETag`` ou 117 117 ``Last-Modified`` et la requête a ``If-None-Match`` ou ``If-Modified-Since``, la 118 118 réponse est remplacée par un HttpNotModified. … … 131 131 n'êtes pas derriÚre un proxy reverse qui renseigne ``HTTP_X_FORWARDED_FOR`` 132 132 automatiquement, n'utilisez pas ce middleware. N'importe qui peut truquer la 133 valeur de ``HTTP_X_FORWARDED_FOR``, et parce que ce middlew re renseigne133 valeur de ``HTTP_X_FORWARDED_FOR``, et parce que ce middleware renseigne 134 134 ``REMOTE_ADDR`` sur la base de ``HTTP_X_FORWARDED_FOR``, ça signifie que 135 135 n'importe qui peut "falsifier" son adresse IP. N'utilisez ce middleware que si … … 201 201 Interface: ``process_request(self, request)`` 202 202 203 ``request`` est un objet ``HttpRequest``. Cette méthode est appelée à chaq ye203 ``request`` est un objet ``HttpRequest``. Cette méthode est appelée à chaque 204 204 requête , avant que Django ne décide quelle vue exécuter. 205 205 … … 267 267 * Les classes middleware peuvent se trouver où vous voulez dans votre chemin 268 268 de recherche Python. La seule chose qui importe à Django, c'est que le 269 rà šglage ``MIDDLEWARE_CLASSES`` indique le chemin vers celles-ci.269 réglage ``MIDDLEWARE_CLASSES`` indique le chemin vers celles-ci. 270 270 271 271 * N'hésitez pas à jeter un oeil aux middleware fournis par Django pour avoir … … 277 277 aux autres, contribuez à la communauté ! Faites-le nous savoir, et nous 278 278 regarderons s'il peut être ajouté à Django. 279 280 .. vim:tw=80:encoding=utf8:fileencoding=utf8:
