From: Lucien Gentis Date: Sat, 12 Jan 2019 15:37:32 +0000 (+0000) Subject: fr doc rebuild. X-Git-Tag: 2.4.38~33 X-Git-Url: http://git.ipfire.org/cgi-bin/gitweb.cgi?a=commitdiff_plain;h=fe9c4886a018bcd4c27d4fd9d78e2cfa6bc6539d;p=thirdparty%2Fapache%2Fhttpd.git fr doc rebuild. git-svn-id: https://svn.apache.org/repos/asf/httpd/httpd/branches/2.4.x@1851176 13f79535-47bb-0310-9956-ffa450edef68 --- diff --git a/docs/manual/mod/mod_cache.html.fr.utf8 b/docs/manual/mod/mod_cache.html.fr.utf8 index 51465dbb253..d42711c559d 100644 --- a/docs/manual/mod/mod_cache.html.fr.utf8 +++ b/docs/manual/mod/mod_cache.html.fr.utf8 @@ -211,14 +211,13 @@ LoadModule cache_module modules/mod_cache.so peut arriver pendant ce laps de temps, et provoquer une tempête de requêtes susceptibles de saturer le processus d'arrière-plan de manière soudaine et imprédictible.

-

Pour contenir cette tempête, on peut utiliser la directive - CacheLock afin de définir un répertoire où - seront créés à la volée des verrous pour les URLs. - Ces verrous sont utilisés comme autant d'indications - par les autres requêtes, soit pour empêcher une tentative de mise en - cache (un autre processus est en train de récupérer l'entité), soit - pour indiquer qu'une entrée périmée est en cours de mise à jour - (pendant ce temps, c'est le contenu périmé qui sera renvoyé). +

Pour contenir cette tempête, on peut utiliser la directive CacheLock afin de définir un répertoire où + seront créés à la volée des verrous pour les URLs. Ces + verrous sont utilisés comme autant d'indications par les + autres requêtes, soit pour empêcher une tentative de mise en cache (un autre + processus est en train de récupérer l'entité), soit pour indiquer qu'une + entrée périmée est en cours de mise à jour (pendant ce temps, c'est le contenu + périmé qui sera renvoyé).

Mise en cache initiale d'une entrée

@@ -251,12 +250,11 @@ LoadModule cache_module modules/mod_cache.so verrou éventuel sera ignoré, la requête du client sera honorée immédiatement, et l'entrée du cache mise à jour.

-

Comme mécanisme de sécurité supplémentaire, la durée de vie - maximale des verrous est configurable. Lorsque cette limite est - atteinte, le verrou est supprimé et une autre requête peut alors en - créer un nouveau. Cette durée de vie peut être définie via la - directive CacheLockMaxAge, et sa valeur par - défaut est de 5 secondes. +

Comme mécanisme de sécurité supplémentaire, la durée de vie maximale des + verrous est configurable. Lorsque cette limite est atteinte, le verrou est + supprimé et une autre requête peut alors en créer un nouveau. Cette durée de + vie peut être définie via la directive CacheMaxExpire, et sa valeur par défaut est + de 5 secondes.

Exemple de configuration

@@ -397,11 +395,10 @@ lorsqu'aucune date d'expiration n'a été spécifiée. Module:mod_cache

La directive CacheDefaultExpire permet de - spécifier un temps par défaut, en secondes, pendant lequel sera - conservé dans le cache un document qui ne possède ni date - d'expiration, ni date de dernière modification. La valeur de cette - directive est écrasée par la valeur de la directive - CacheMaxExpire si cette dernière est + spécifier un temps par défaut, en secondes, pendant lequel sera conservé + dans le cache un document qui ne possède ni date d'expiration, ni date de + dernière modification. La valeur de cette directive n'est pas + écrasée par la valeur de la directive CacheMaxExpire, même si cette dernière est utilisée.

CacheDefaultExpire 86400
@@ -419,10 +416,10 @@ lorsqu'aucune date d'expiration n'a été spécifiée. Module:mod_cache Compatibilité:Disponible depuis la version 2.3.9 d'Apache -

Lorsque la directive CacheDetailHeader est définie à on, un - en-tête X-Cache-Detail est ajouté à la réponse et - contient les raisons précises d'une décision d'utilisation du cache - vis à vis de cette dernière.

+

Lorsque la directive CacheDetailHeader est définie à + on, un en-tête X-Cache-Detail est ajouté à la réponse et + contient les raisons précises d'une décision d'utilisation du cache vis à vis + de cette dernière.

Ceci peut s'avérer utile au cours du développement de services RESTful mis en cache pour obtenir des informations supplémentaires à @@ -431,9 +428,10 @@ lorsqu'aucune date d'expiration n'a été spécifiée. Cache-Control et d'autres en-têtes ont été correctement utilisés par le service et le client.

-

Si le gestionnaire normal est utilisé, cette directive peut se - situer dans une section <Directory> ou <Location>. Si c'est le gestionnaire - rapide qui est utilisé, elle doit se situer dans un contexte de +

Si le gestionnaire normal est utilisé, cette directive peut se situer dans + une section <Directory> ou + <Location>. Si c'est le + gestionnaire rapide qui est utilisé, elle doit se situer dans un contexte de serveur principal ou de serveur virtuel, sinon elle sera ignorée.

# Active l'en-tête X-Cache-Detail
@@ -464,10 +462,10 @@ spécifiées
     

Exemple

CacheDisable "/fichiers_locaux"
-

Si la directive se trouve à l'intérieur d'une section <Location>, le chemin doit être spécifié en - dessous de la Location, et si le mot "on" est utilisé, la mise en - cache sera désactivée pour l'ensemble de l'arborescence concernée - par la section Location.

+

Si la directive se trouve à l'intérieur d'une section <Location>, le chemin doit être + spécifié en dessous de la Location, et si le mot "on" est utilisé, la mise + en cache sera désactivée pour l'ensemble de l'arborescence concernée par la + section Location.

Exemple

<Location "/foo">
     CacheDisable on
@@ -500,13 +498,12 @@ en mandat direct dans les versions 2.2 et antérieures.
     

La directive CacheEnable enjoint mod_cache de mettre en cache l'URL précisée par chaîne URL, ainsi que les URLs de niveaux inférieurs. Le - gestionnaire de stockage du cache est spécifié à l'aide de - l'argument type de cache. La directive - CacheEnable peut être placée à l'intérieur d'une - section <Location> ou <LocationMatch> pour indiquer que le - contenu considéré peut être mis en cache. Si type de cache - a pour valeur disk, mod_cache - utilisera le gestionnaire de stockage sur disque implémenté par + gestionnaire de stockage du cache est spécifié à l'aide de l'argument + type de cache. La directive CacheEnable + peut être placée à l'intérieur d'une section <Location> ou <LocationMatch> pour indiquer que le contenu + considéré peut être mis en cache. Si type de cache a pour valeur + disk, mod_cache utilisera le gestionnaire de + stockage sur disque implémenté par mod_cache_disk. Pour que mod_cache utilise le gestionnaire de stockage basé sur le cache d'objets partagés implémenté par mod_cache_socache, @@ -517,13 +514,14 @@ en mandat direct dans les versions 2.2 et antérieures. ci-dessous), tous les gestionnaires de stockage possibles seront lancés, jusqu'au premier d'entre eux qui traitera effectivement la requête. - L'ordre dans lequel les gestionnaires de stockage sont lancés est - déterminé par l'ordre dans lequel apparaissent les directives - CacheEnable dans le fichier de - configuration. Les directives CacheEnable - situées à l'intérieur de sections <Location> ou <LocationMatch> sont traitées avant les - directives CacheEnable définies au niveau - global.

+ L'ordre dans lequel les gestionnaires de stockage sont lancés est déterminé + par l'ordre dans lequel apparaissent les directives + CacheEnable dans le fichier de configuration. Les + directives CacheEnable situées à l'intérieur de + sections <Location> ou + <LocationMatch> sont + traitées avant les directives CacheEnable définies au + niveau global.

En fonctionnement du type serveur mandataire direct, chaîne URL doit au moins débuter par un protocole pour lequel la mise @@ -586,7 +584,7 @@ Apache Module:mod_cache Compatibilité:Disponible depuis la version 2.3.9 d'Apache -

Lorsque la directive CacheHeader est définie à on, un +

Lorsque la directive CacheHeader est définie à on, un en-tête X-Cache est ajouté à la réponse et contient l'état du cache pour cette dernière. Si le gestionnaire normal est utilisé, cette directive peut se situer dans une section @@ -627,8 +625,8 @@ le contenu au client depuis le cache Module:mod_cache

Normalement, les requêtes contenant des en-têtes tels que - Cache-Control: no-cache ou Pragma: no-cache ne sont pas servies - depuis le cache. La directive + Cache-Control: no-cache ou Pragma: no-cache ne sont pas + servies depuis le cache. La directive CacheIgnoreCacheControl permet de modifier ce comportement. Avec CacheIgnoreCacheControl On, le serveur tentera de servir la ressource depuis le @@ -723,11 +721,10 @@ Modified. cours des traitements liés à mod_include par exemple), ou n'existe tout simplement pas. La directive CacheIgnoreNoLastMod permet de spécifier si - les documents ne possèdant pas de date de dernière modification - doivent être mis en cache, même sans date de dernière modification. - Si le document ne possède ni date d'expiration, ni date de dernière - modification, la valeur spécifiée par la directive - CacheDefaultExpire servira à générer une date + les documents ne possèdant pas de date de dernière modification doivent être + mis en cache, même sans date de dernière modification. Si le document ne + possède ni date d'expiration, ni date de dernière modification, la valeur + spécifiée par la directive CacheDefaultExpire servira à générer une date d'expiration.

@@ -809,19 +806,18 @@ l'URL lors de la mise en cache Description:Remplace l'URL de base des clés du cache mandatées en inverse Syntaxe:CacheKeyBaseURL URL -Défaut:CacheKeyBaseURL http://example.com Contexte:configuration globale, serveur virtuel Statut:Extension Module:mod_cache Compatibilité:Disponible depuis la version 2.3.9 d'Apache -

Lorsque la directive CacheKeyBaseURL est utilisée, l'URL - spécifiée sera utilisée comme URL de base pour calculer l'URL des clés - du cache dans la configuration du mandataire inverse. Par défaut, - c'est le protocole/nom d'hôte/port du serveur virtuel courant qui sera - utilisé pour construire la clé de cache. Dans le cas d'un cluster de - machines, si toutes les entrées du cache doivent posséder la même clé, - cette directive permet de spécifier une nouvelle URL de base.

+

Lorsque la directive CacheKeyBaseURL est utilisée, + l'URL spécifiée sera utilisée comme URL de base pour calculer l'URL des clés + du cache dans la configuration du mandataire inverse. Par défaut, c'est le + protocole/nom d'hôte/port du serveur virtuel courant qui sera utilisé pour + construire la clé de cache. Dans le cas d'un cluster de machines, si toutes + les entrées du cache doivent posséder la même clé, cette directive permet de + spécifier une nouvelle URL de base.

# Remplace l'URL de base de la clé de cache.
 CacheKeyBaseURL "http://www.example.com/"
@@ -862,8 +858,8 @@ fonction de la date de dernière modification. 3:00pm, la date d'expiration calculée sera 3:00pm + 1 heure = 4:00pm. - Si le délai d'expiration est supérieur à celui spécifié par la - directive CacheMaxExpire, c'est ce dernier + Si le délai d'expiration est supérieur à celui spécifié par la directive + CacheMaxExpire, c'est ce dernier qui l'emporte.

CacheLastModifiedFactor 0.5
@@ -968,9 +964,9 @@ document Statut:Extension Module:mod_cache -

La directive CacheMaxExpire permet de - spécifier le nombre maximum de secondes pendant lequel les documents - HTTP suceptibles d'être mis en cache seront conservés sans vérifier +

La directive CacheMinExpire permet de + spécifier le nombre minimum de secondes pendant lequel les documents + HTTP susceptibles d'être mis en cache seront conservés sans vérifier leur contenu sur le serveur d'origine. Elle n'est prise en compte que dans le cas où le document ne possède aucune date d'expiration valide.

@@ -991,7 +987,7 @@ document Compatibilité:Disponible à partir de la version 2.3.3 du serveur HTTP Apache -

La directive CacheQuickHandler permet de contrôler +

La directive CacheQuickHandler permet de contrôler la phase au cours de laquelle la mise en cache est effectuée.

Avec la configuration par défaut, le cache agit au cours de la @@ -1039,14 +1035,13 @@ AddOutputFilterByType CACHE;INCLUDES;DEFLATE text/html

Module:mod_cache Compatibilité:Disponible depuis la version 2.3.9 d'Apache -

Lorsque la directive CacheStaleOnError est définie à on, et - si des données non mises à jour sont disponibles dans le cache, ce +

Lorsque la directive CacheStaleOnError est définie à + on, et si des données non mises à jour sont disponibles dans le cache, ce dernier renverra ces données, plutôt qu'une éventuelle réponse 5xx en - provenance du serveur d'arrière-plan. Alors que l'en-tête - Cache-Control envoyé par les clients sera respecté, et que les clients - recevront donc dans ce cas la réponse 5xx brute à leur requête, cette - réponse 5xx renvoyée au client n'invalidera pas le contenu dans le - cache.

+ provenance du serveur d'arrière-plan. Alors que l'en-tête Cache-Control envoyé + par les clients sera respecté, et que les clients recevront donc dans ce cas + la réponse 5xx brute à leur requête, cette réponse 5xx renvoyée au client + n'invalidera pas le contenu dans le cache.

# Sert des données non mises à jour en cas d'erreur.
 CacheStaleOnError on
@@ -1091,7 +1086,7 @@ l'entête Cache-Control: a pour valeur no-store. Module:mod_cache

Normalement, les requêtes ou réponses dont l'en-tête - Cache-Control: a pour valeur no-store ne sont pas stockées dans le + Cache-Control: no-store ne sont pas stockées dans le cache. La directive CacheStoreNoStore permet de modifier ce comportement. Si CacheStoreNoStore est définie à On, le @@ -1132,12 +1127,11 @@ marquées comme privées Statut:Extension Module:mod_cache -

Normalement, les réponse comportant un en-tête Cache-Control: - dont la valeur est private ne seront pas stockées dans le cache. La - directive CacheStorePrivate permet de - modifier ce comportement. Si - CacheStorePrivate est définie à On, le - serveur tentera de mettre la ressource en cache, même si elle +

Normalement, les réponse comportant un en-tête Cache-Control: + private ne seront pas stockées dans le cache. La directive + CacheStorePrivate permet de modifier ce comportement. + Si CacheStorePrivate est définie à On, le serveur + tentera de mettre la ressource en cache, même si elle contient des en-têtes ayant pour valeur private. Les ressources nécessitant une autorisation ne sont jamais mises en cache.

diff --git a/docs/manual/mod/mod_cache.xml.ja b/docs/manual/mod/mod_cache.xml.ja index 3cfe9e8dbff..d96ab9132ce 100644 --- a/docs/manual/mod/mod_cache.xml.ja +++ b/docs/manual/mod/mod_cache.xml.ja @@ -1,7 +1,7 @@ - + + + +