3e6b8c7840a46cdccd46b7a4b1902c2bc82f6cc2gryzor<!DOCTYPE modulesynopsis SYSTEM "/style/modulesynopsis.dtd">
3e6b8c7840a46cdccd46b7a4b1902c2bc82f6cc2gryzor<?xml-stylesheet type="text/xsl" href="/style/manual.fr.xsl"?>
a1d62218cdb0efd0f02da1b54fd3eda91a681d98nd<!-- English Revision: 1590566:1674195 (outdated) -->
3e6b8c7840a46cdccd46b7a4b1902c2bc82f6cc2gryzor<!-- French translation : Lucien GENTIS -->
3e6b8c7840a46cdccd46b7a4b1902c2bc82f6cc2gryzor<!-- Reviewed by : Vincent Deffontaines -->
3e6b8c7840a46cdccd46b7a4b1902c2bc82f6cc2gryzor Licensed to the Apache Software Foundation (ASF) under one or more
3e6b8c7840a46cdccd46b7a4b1902c2bc82f6cc2gryzor contributor license agreements. See the NOTICE file distributed with
3e6b8c7840a46cdccd46b7a4b1902c2bc82f6cc2gryzor this work for additional information regarding copyright ownership.
3e6b8c7840a46cdccd46b7a4b1902c2bc82f6cc2gryzor The ASF licenses this file to You under the Apache License, Version 2.0
3e6b8c7840a46cdccd46b7a4b1902c2bc82f6cc2gryzor (the "License"); you may not use this file except in compliance with
3e6b8c7840a46cdccd46b7a4b1902c2bc82f6cc2gryzor the License. You may obtain a copy of the License at
3e6b8c7840a46cdccd46b7a4b1902c2bc82f6cc2gryzor Unless required by applicable law or agreed to in writing, software
3e6b8c7840a46cdccd46b7a4b1902c2bc82f6cc2gryzor distributed under the License is distributed on an "AS IS" BASIS,
3e6b8c7840a46cdccd46b7a4b1902c2bc82f6cc2gryzor WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
3e6b8c7840a46cdccd46b7a4b1902c2bc82f6cc2gryzor See the License for the specific language governing permissions and
3e6b8c7840a46cdccd46b7a4b1902c2bc82f6cc2gryzor limitations under the License.
424edfaa5b21b17d739ebefa4c16966ed6310067lgentis<description>Filtre de mise en cache HTTP conforme à la RFC 2616</description>
3e6b8c7840a46cdccd46b7a4b1902c2bc82f6cc2gryzor <note type="warning">Ce module doit être utilisé avec précautions
3e6b8c7840a46cdccd46b7a4b1902c2bc82f6cc2gryzor car lorsque la directive <directive
3e6b8c7840a46cdccd46b7a4b1902c2bc82f6cc2gryzor module="mod_cache">CacheQuickHandler</directive> est définie à sa
3e6b8c7840a46cdccd46b7a4b1902c2bc82f6cc2gryzor valeur par défaut <strong>on</strong>, les directives <directive
699c9f9d20c0a2acd4617d802e90c447c4c33b00lgentis module="mod_access_compat">Allow</directive> and <directive
699c9f9d20c0a2acd4617d802e90c447c4c33b00lgentis module="mod_access_compat">Deny</directive> sont court-circuitées. Vous
3e6b8c7840a46cdccd46b7a4b1902c2bc82f6cc2gryzor ne devez donc pas activer la gestion rapide de la mise en cache pour
3e6b8c7840a46cdccd46b7a4b1902c2bc82f6cc2gryzor un contenu auquel vous souhaitez limiter l'accès en fonction du nom
3e6b8c7840a46cdccd46b7a4b1902c2bc82f6cc2gryzor d'hôte du client, de l'adresse IP ou d'une variable
3e6b8c7840a46cdccd46b7a4b1902c2bc82f6cc2gryzor d'environnement.</note>
424edfaa5b21b17d739ebefa4c16966ed6310067lgentis <p><module>mod_cache</module> implémente un <strong>filtre de mise
424edfaa5b21b17d739ebefa4c16966ed6310067lgentis en cache de contenu HTTP</strong> conforme à la <a
424edfaa5b21b17d739ebefa4c16966ed6310067lgentis href="http://www.ietf.org/rfc/rfc2616.txt">RFC 2616</a>, avec
424edfaa5b21b17d739ebefa4c16966ed6310067lgentis support de la mise en cache des réponses dont le contenu a été
424edfaa5b21b17d739ebefa4c16966ed6310067lgentis négocié et comportant l'en-tête Vary.</p>
424edfaa5b21b17d739ebefa4c16966ed6310067lgentis <p>La mise en cache conforme à la RFC 2616 fournit un mécanisme
424edfaa5b21b17d739ebefa4c16966ed6310067lgentis permettant de vérifier si un contenu expiré ou dépassé est encore à
424edfaa5b21b17d739ebefa4c16966ed6310067lgentis jour, et peut apporter un gain de performances significatif si le
424edfaa5b21b17d739ebefa4c16966ed6310067lgentis serveur original supporte les <strong>requêtes
424edfaa5b21b17d739ebefa4c16966ed6310067lgentis conditionnelles</strong> en prenant en compte l'en-tête de requête
424edfaa5b21b17d739ebefa4c16966ed6310067lgentis href="http://www.w3.org/Protocols/rfc2616/rfc2616-sec14.html#sec14.26">If-None-Match</a>.
424edfaa5b21b17d739ebefa4c16966ed6310067lgentis Le contenu n'est ainsi régénéré que lorsqu'il a été modifié, et non
424edfaa5b21b17d739ebefa4c16966ed6310067lgentis lorsqu'il a expiré.</p>
424edfaa5b21b17d739ebefa4c16966ed6310067lgentis <p>En tant que filtre, <module>mod_cache</module> peut être placé
424edfaa5b21b17d739ebefa4c16966ed6310067lgentis en face d'un contenu issu de tout gestionnaire, y compris
424edfaa5b21b17d739ebefa4c16966ed6310067lgentis <strong>des fichiers à accès séquentiel</strong> (servis depuis un
424edfaa5b21b17d739ebefa4c16966ed6310067lgentis disque lent mis en
424edfaa5b21b17d739ebefa4c16966ed6310067lgentis cache sur un gros disque), la sortie d'un <strong>script
424edfaa5b21b17d739ebefa4c16966ed6310067lgentis CGI</strong> ou d'un <strong>générateur de contenu
424edfaa5b21b17d739ebefa4c16966ed6310067lgentis dynamique</strong>, ou du contenu <strong>mandaté depuis un autre
424edfaa5b21b17d739ebefa4c16966ed6310067lgentis <p>Dans la configuration par défaut, <module>mod_cache</module>
424edfaa5b21b17d739ebefa4c16966ed6310067lgentis place le filtre de mise en cache aussi loin que possible dans la
424edfaa5b21b17d739ebefa4c16966ed6310067lgentis pile de filtres, utilisant le <strong>gestionnaire rapide</strong>
424edfaa5b21b17d739ebefa4c16966ed6310067lgentis pour court-circuiter tout traitement par requête lors de l'envoi du
424edfaa5b21b17d739ebefa4c16966ed6310067lgentis contenu au client. Dans ce mode opératoire,
424edfaa5b21b17d739ebefa4c16966ed6310067lgentis <module>mod_cache</module> peut être considéré comme un serveur
424edfaa5b21b17d739ebefa4c16966ed6310067lgentis mandataire avec cache fixé en tête du serveur web, alors qu'il
424edfaa5b21b17d739ebefa4c16966ed6310067lgentis s'exécute dans ce même serveur web.</p>
424edfaa5b21b17d739ebefa4c16966ed6310067lgentis <p>Lorsque le gestionnaire rapide est désactivé via la directive
424edfaa5b21b17d739ebefa4c16966ed6310067lgentis <directive module="mod_cache">CacheQuickHandler</directive>, il
424edfaa5b21b17d739ebefa4c16966ed6310067lgentis devient possible d'insérer le filtre <strong>CACHE</strong> à un
424edfaa5b21b17d739ebefa4c16966ed6310067lgentis point de la pile de filtres choisi par l'administrateur. Ceci permet
424edfaa5b21b17d739ebefa4c16966ed6310067lgentis de mettre en cache un contenu avant que celui-ci ne soit
424edfaa5b21b17d739ebefa4c16966ed6310067lgentis personnalisé par le filtre <module>mod_include</module>, ou
424edfaa5b21b17d739ebefa4c16966ed6310067lgentis éventuellement compressé par le filtre <module>mod_deflate</module>.</p>
424edfaa5b21b17d739ebefa4c16966ed6310067lgentis <p>Dans le mode de fonctionnement normal, <module>mod_cache</module>
424edfaa5b21b17d739ebefa4c16966ed6310067lgentis peut être contrôlé par les en-têtes <a
424edfaa5b21b17d739ebefa4c16966ed6310067lgentis href="http://www.w3.org/Protocols/rfc2616/rfc2616-sec14.html#sec14.9">Cache-Control</a>
424edfaa5b21b17d739ebefa4c16966ed6310067lgentis href="http://www.w3.org/Protocols/rfc2616/rfc2616-sec14.html#sec14.32">Pragma</a>
424edfaa5b21b17d739ebefa4c16966ed6310067lgentis envoyés par un client dans une requête, ou par un serveur dans une
424edfaa5b21b17d739ebefa4c16966ed6310067lgentis réponse. Dans des circonstances exceptionnelles,
424edfaa5b21b17d739ebefa4c16966ed6310067lgentis <module>mod_cache</module> peut cependant être configuré pour
424edfaa5b21b17d739ebefa4c16966ed6310067lgentis outrepasser ces en-têtes et forcer un comportement spécifique au
424edfaa5b21b17d739ebefa4c16966ed6310067lgentis site, bien qu'un tel comportement sera limité à ce cache seulement,
424edfaa5b21b17d739ebefa4c16966ed6310067lgentis et n'affectera pas les opérations des autres caches qui peuvent
424edfaa5b21b17d739ebefa4c16966ed6310067lgentis s'insérer entre le client et le serveur, et ce type de configuration
424edfaa5b21b17d739ebefa4c16966ed6310067lgentis ne doit donc être utiliser qu'en cas de nécessité absolue.</p>
424edfaa5b21b17d739ebefa4c16966ed6310067lgentis <p>La RFC 2616 permet au cache de renvoyer des données périmées
424edfaa5b21b17d739ebefa4c16966ed6310067lgentis pendant que l'entrée périmée correspondante est mise à jour depuis
424edfaa5b21b17d739ebefa4c16966ed6310067lgentis le serveur original, et <module>mod_cache</module> supporte cette
424edfaa5b21b17d739ebefa4c16966ed6310067lgentis fonctionnalité lorsque la directive <directive
424edfaa5b21b17d739ebefa4c16966ed6310067lgentis module="mod_cache">CacheLock</directive> est configurée en
424edfaa5b21b17d739ebefa4c16966ed6310067lgentis conséquence. De telles réponses comportent un en-tête HTTP <a
424edfaa5b21b17d739ebefa4c16966ed6310067lgentis href="http://www.w3.org/Protocols/rfc2616/rfc2616-sec14.html#sec14.46">Warning</a>
424edfaa5b21b17d739ebefa4c16966ed6310067lgentis contenant un code de réponse 110. La RFC 2616 permet aussi au cache
424edfaa5b21b17d739ebefa4c16966ed6310067lgentis de renvoyer des données périmées lorsque la tentative de mise à jour
424edfaa5b21b17d739ebefa4c16966ed6310067lgentis des données périmées renvoie une erreur 500 ou supérieure, et cette
424edfaa5b21b17d739ebefa4c16966ed6310067lgentis fonctionnalité est supportée par défaut par
424edfaa5b21b17d739ebefa4c16966ed6310067lgentis <module>mod_cache</module>. De telles réponses comportent un en-tête HTTP <a
424edfaa5b21b17d739ebefa4c16966ed6310067lgentis href="http://www.w3.org/Protocols/rfc2616/rfc2616-sec14.html#sec14.46">Warning</a>
424edfaa5b21b17d739ebefa4c16966ed6310067lgentis contenant un code de réponse 111.</p>
424edfaa5b21b17d739ebefa4c16966ed6310067lgentis <p><module>mod_cache</module> requiert les services d'un ou
424edfaa5b21b17d739ebefa4c16966ed6310067lgentis plusieurs modules de gestion de stockage. La distribution Apache de base
1db884f97626adc6cdca05468e9aad3868879f56lgentis inclut les modules de gestion de stockage suivants :</p>
424edfaa5b21b17d739ebefa4c16966ed6310067lgentis <dd>implémente un gestionnaire de stockage sur disque. Les en-têtes
424edfaa5b21b17d739ebefa4c16966ed6310067lgentis et corps sont stockés séparément sur le disque dans une structure de
424edfaa5b21b17d739ebefa4c16966ed6310067lgentis répertoires basée sur le condensé md5 de l'URL mise en cache.
424edfaa5b21b17d739ebefa4c16966ed6310067lgentis Plusieurs réponses à contenu négocié peuvent être stockées en même
424edfaa5b21b17d739ebefa4c16966ed6310067lgentis temps, mais la mise en cache de contenus partiels n'est pas
424edfaa5b21b17d739ebefa4c16966ed6310067lgentis supportée par ce module. L'utilitaire
424edfaa5b21b17d739ebefa4c16966ed6310067lgentis <program>htcacheclean</program> permet de lister et de supprimer les
424edfaa5b21b17d739ebefa4c16966ed6310067lgentis URLs mises en cache, et de maintenir le cache en deçà de
424edfaa5b21b17d739ebefa4c16966ed6310067lgentis certaines limites de taille et de nombre d'inodes.</dd>
5e6dcc287b64eb58282c020e8a91a8bfb6ac0339lgentis <dd>Implémente un gestionnaire de stockage basé sur un cache d'objets
5e6dcc287b64eb58282c020e8a91a8bfb6ac0339lgentis partagés. Les en-têtes et corps sont stockés ensemble sous une seule
5e6dcc287b64eb58282c020e8a91a8bfb6ac0339lgentis clé basée sur l'URL de la réponse mise en cache. Des réponses à
5e6dcc287b64eb58282c020e8a91a8bfb6ac0339lgentis contenus multiples négociés peuvent être stockées simultanément, mais
5e6dcc287b64eb58282c020e8a91a8bfb6ac0339lgentis ce module ne supporte pas la mise en cache de contenus partiels.</dd>
3e6b8c7840a46cdccd46b7a4b1902c2bc82f6cc2gryzor <p>Pour de plus amples détails, une description, et des exemples,
3e6b8c7840a46cdccd46b7a4b1902c2bc82f6cc2gryzor reportez-vous au <a href="/caching.html">Guide de la mise en
3e6b8c7840a46cdccd46b7a4b1902c2bc82f6cc2gryzor<section id="related"><title>Modules apparentés et directives</title>
3e6b8c7840a46cdccd46b7a4b1902c2bc82f6cc2gryzor <modulelist>
3e6b8c7840a46cdccd46b7a4b1902c2bc82f6cc2gryzor </modulelist>
3e6b8c7840a46cdccd46b7a4b1902c2bc82f6cc2gryzor <directivelist>
78f97ce162b66a0dbfd7af4dcd9984f162569b04minfrin <directive module="mod_cache_disk">CacheRoot</directive>
78f97ce162b66a0dbfd7af4dcd9984f162569b04minfrin <directive module="mod_cache_disk">CacheDirLevels</directive>
78f97ce162b66a0dbfd7af4dcd9984f162569b04minfrin <directive module="mod_cache_disk">CacheDirLength</directive>
78f97ce162b66a0dbfd7af4dcd9984f162569b04minfrin <directive module="mod_cache_disk">CacheMinFileSize</directive>
78f97ce162b66a0dbfd7af4dcd9984f162569b04minfrin <directive module="mod_cache_disk">CacheMaxFileSize</directive>
5e6dcc287b64eb58282c020e8a91a8bfb6ac0339lgentis <directive module="mod_cache_socache">CacheSocache</directive>
5e6dcc287b64eb58282c020e8a91a8bfb6ac0339lgentis <directive module="mod_cache_socache">CacheSocacheMaxTime</directive>
5e6dcc287b64eb58282c020e8a91a8bfb6ac0339lgentis <directive module="mod_cache_socache">CacheSocacheMinTime</directive>
5e6dcc287b64eb58282c020e8a91a8bfb6ac0339lgentis <directive module="mod_cache_socache">CacheSocacheMaxSize</directive>
5e6dcc287b64eb58282c020e8a91a8bfb6ac0339lgentis <directive module="mod_cache_socache">CacheSocacheReadSize</directive>
5e6dcc287b64eb58282c020e8a91a8bfb6ac0339lgentis <directive module="mod_cache_socache">CacheSocacheReadTime</directive>
3e6b8c7840a46cdccd46b7a4b1902c2bc82f6cc2gryzor </directivelist>
3e6b8c7840a46cdccd46b7a4b1902c2bc82f6cc2gryzor<section id="sampleconf"><title>Exemple de configuration</title>
e2f05529a1835546e17527f56074c023e6a47366lgentis# Exemple de configuration du cache
e2f05529a1835546e17527f56074c023e6a47366lgentis<IfModule mod_cache.c>
e2f05529a1835546e17527f56074c023e6a47366lgentis LoadModule cache_disk_module modules/mod_cache_disk.so
e2f05529a1835546e17527f56074c023e6a47366lgentis <IfModule mod_cache_disk.c>
e2f05529a1835546e17527f56074c023e6a47366lgentis CacheRoot c:/cacheroot
e2f05529a1835546e17527f56074c023e6a47366lgentis CacheEnable disk /
e2f05529a1835546e17527f56074c023e6a47366lgentis CacheDirLevels 5
e2f05529a1835546e17527f56074c023e6a47366lgentis CacheDirLength 3
e2f05529a1835546e17527f56074c023e6a47366lgentis </IfModule>
e2f05529a1835546e17527f56074c023e6a47366lgentis # Lorsqu'on sert de mandataire, on ne met pas en cache la liste
3662a9cd3c9e8c3fe6596be42c3459174293cb82lgentis# des mises à jour de sécurité
e2f05529a1835546e17527f56074c023e6a47366lgentis CacheDisable http://security.update.server/update-list/
e2f05529a1835546e17527f56074c023e6a47366lgentis</IfModule>
e2f05529a1835546e17527f56074c023e6a47366lgentis </highlight>
3e6b8c7840a46cdccd46b7a4b1902c2bc82f6cc2gryzor<section id="thunderingherd"><title>Eviter une tempête de requête</title>
3e6b8c7840a46cdccd46b7a4b1902c2bc82f6cc2gryzor <p>Lorsqu'une entrée du cache est périmée, <module>mod_cache</module>
3e6b8c7840a46cdccd46b7a4b1902c2bc82f6cc2gryzor soumet une requête conditionnelle au processus d'arrière-plan, qui est
3e6b8c7840a46cdccd46b7a4b1902c2bc82f6cc2gryzor censé confirmer la validité de l'entrée du cache, ou dans la négative
3e6b8c7840a46cdccd46b7a4b1902c2bc82f6cc2gryzor envoyer une entrée mise à jour.</p>
3e6b8c7840a46cdccd46b7a4b1902c2bc82f6cc2gryzor <p>Un court mais non négligeable laps de temps existe entre le moment
3e6b8c7840a46cdccd46b7a4b1902c2bc82f6cc2gryzor où l'entrée du cache est périmée, et le moment où elle est mise à
3e6b8c7840a46cdccd46b7a4b1902c2bc82f6cc2gryzor jour. Sur un serveur fortement chargé, un certain nombre de requêtes
3e6b8c7840a46cdccd46b7a4b1902c2bc82f6cc2gryzor peut arriver pendant ce laps de temps, et provoquer une
3e6b8c7840a46cdccd46b7a4b1902c2bc82f6cc2gryzor <strong>tempête</strong> de requêtes susceptibles de saturer le
3e6b8c7840a46cdccd46b7a4b1902c2bc82f6cc2gryzor processus d'arrière-plan de manière soudaine et imprédictible.</p>
3e6b8c7840a46cdccd46b7a4b1902c2bc82f6cc2gryzor <p>Pour contenir cette tempête, on peut utiliser la directive
3e6b8c7840a46cdccd46b7a4b1902c2bc82f6cc2gryzor <directive>CacheLock</directive> afin de définir un répertoire où
3e6b8c7840a46cdccd46b7a4b1902c2bc82f6cc2gryzor seront créés <strong>à la volée</strong> des verrous pour les URLs.
3e6b8c7840a46cdccd46b7a4b1902c2bc82f6cc2gryzor Ces verrous sont utilisés comme autant d'<strong>indications</strong>
3e6b8c7840a46cdccd46b7a4b1902c2bc82f6cc2gryzor par les autres requêtes, soit pour empêcher une tentative de mise en
3e6b8c7840a46cdccd46b7a4b1902c2bc82f6cc2gryzor cache (un autre processus est en train de récupérer l'entité), soit
3e6b8c7840a46cdccd46b7a4b1902c2bc82f6cc2gryzor pour indiquer qu'une entrée périmée est en cours de mise à jour
3e6b8c7840a46cdccd46b7a4b1902c2bc82f6cc2gryzor (pendant ce temps, c'est le contenu périmé qui sera renvoyé).
3e6b8c7840a46cdccd46b7a4b1902c2bc82f6cc2gryzor <title>Mise en cache initiale d'une entrée</title>
3e6b8c7840a46cdccd46b7a4b1902c2bc82f6cc2gryzor <p>Lorsqu'une entité est mise en cache pour la première fois, un
3e6b8c7840a46cdccd46b7a4b1902c2bc82f6cc2gryzor verrou est créé pour cette entité jusqu'à ce que la réponse ait été
3e6b8c7840a46cdccd46b7a4b1902c2bc82f6cc2gryzor entièrement mise en cache. Pendant la durée de vie du verrou, le
3e6b8c7840a46cdccd46b7a4b1902c2bc82f6cc2gryzor cache va empêcher une seconde tentative de mise en cache de la même
3e6b8c7840a46cdccd46b7a4b1902c2bc82f6cc2gryzor entité. Bien que cela ne suffise pas à contenir la tempête de
3e6b8c7840a46cdccd46b7a4b1902c2bc82f6cc2gryzor requêtes, toute tentative de mettre en cache la même entité
3e6b8c7840a46cdccd46b7a4b1902c2bc82f6cc2gryzor plusieurs fois simultanément est stoppée.
3e6b8c7840a46cdccd46b7a4b1902c2bc82f6cc2gryzor <title>Mise à jour d'une entrée périmée</title>
3e6b8c7840a46cdccd46b7a4b1902c2bc82f6cc2gryzor <p>Lorsqu'une entrée atteint la limite de sa durée de vie, et
3e6b8c7840a46cdccd46b7a4b1902c2bc82f6cc2gryzor devient par conséquent périmée, un verrou est créé pour cette entité
3e6b8c7840a46cdccd46b7a4b1902c2bc82f6cc2gryzor jusqu'à ce que la réponse ait été soit confirmée comme encore
3e6b8c7840a46cdccd46b7a4b1902c2bc82f6cc2gryzor valide, soit remplacée par le processus d'arrière-plan. Pendant la
3e6b8c7840a46cdccd46b7a4b1902c2bc82f6cc2gryzor durée de vie du verrou, une seconde requête entrante va provoquer le
3e6b8c7840a46cdccd46b7a4b1902c2bc82f6cc2gryzor renvoi de la donnée périmée, et la tempête de requêtes sera
3e6b8c7840a46cdccd46b7a4b1902c2bc82f6cc2gryzor contenue.</p>
3e6b8c7840a46cdccd46b7a4b1902c2bc82f6cc2gryzor <title>Verrous et en-tête Cache-Control: no-cache</title>
3e6b8c7840a46cdccd46b7a4b1902c2bc82f6cc2gryzor <p>Les verrous ne sont utilisés <strong>qu'à titre
3e6b8c7840a46cdccd46b7a4b1902c2bc82f6cc2gryzor indicatif</strong> pour enjoindre le cache à être plus coopératif
3e6b8c7840a46cdccd46b7a4b1902c2bc82f6cc2gryzor avec les serveurs d'arrière-plan, et il est possible de passer outre
3e6b8c7840a46cdccd46b7a4b1902c2bc82f6cc2gryzor si nécessaire. Si le client envoie une requête contenant un en-tête
3e6b8c7840a46cdccd46b7a4b1902c2bc82f6cc2gryzor Cache-Control imposant un nouveau téléchargement de l'entité, tout
3e6b8c7840a46cdccd46b7a4b1902c2bc82f6cc2gryzor verrou éventuel sera ignoré, la requête du client sera honorée
3e6b8c7840a46cdccd46b7a4b1902c2bc82f6cc2gryzor immédiatement, et l'entrée du cache mise à jour.</p>
3e6b8c7840a46cdccd46b7a4b1902c2bc82f6cc2gryzor <p>Comme mécanisme de sécurité supplémentaire, la durée de vie
3e6b8c7840a46cdccd46b7a4b1902c2bc82f6cc2gryzor maximale des verrous est configurable. Lorsque cette limite est
3e6b8c7840a46cdccd46b7a4b1902c2bc82f6cc2gryzor atteinte, le verrou est supprimé et une autre requête peut alors en
3e6b8c7840a46cdccd46b7a4b1902c2bc82f6cc2gryzor créer un nouveau. Cette durée de vie peut être définie via la
3e6b8c7840a46cdccd46b7a4b1902c2bc82f6cc2gryzor directive <directive>CacheLockMaxAge</directive>, et sa valeur par
3e6b8c7840a46cdccd46b7a4b1902c2bc82f6cc2gryzor défaut est de 5 secondes.
3e6b8c7840a46cdccd46b7a4b1902c2bc82f6cc2gryzor <example><title>Activation du verrouillage du cache</title>
e2f05529a1835546e17527f56074c023e6a47366lgentis# Active le verrouillage du cache
e2f05529a1835546e17527f56074c023e6a47366lgentis<IfModule mod_cache.c>
e2f05529a1835546e17527f56074c023e6a47366lgentis CacheLock on
e2f05529a1835546e17527f56074c023e6a47366lgentis CacheLockMaxAge 5
e2f05529a1835546e17527f56074c023e6a47366lgentis</IfModule>
e2f05529a1835546e17527f56074c023e6a47366lgentis </highlight>
3e6b8c7840a46cdccd46b7a4b1902c2bc82f6cc2gryzor<section id="finecontrol"><title>Contrôle fin via le filtre CACHE</title>
3e6b8c7840a46cdccd46b7a4b1902c2bc82f6cc2gryzor <p>Dans son mode de fonctionnement par défaut, le cache s'exécute sous
3e6b8c7840a46cdccd46b7a4b1902c2bc82f6cc2gryzor la forme d'un gestionnaire rapide, court-circuitant la majorité des
3e6b8c7840a46cdccd46b7a4b1902c2bc82f6cc2gryzor traitements du serveur et fournissant ainsi une mise en cache
3e6b8c7840a46cdccd46b7a4b1902c2bc82f6cc2gryzor possédant les plus hautes performances disponibles.</p>
3e6b8c7840a46cdccd46b7a4b1902c2bc82f6cc2gryzor <p>Dans ce mode, le cache <strong>s'incruste</strong> devant le
424edfaa5b21b17d739ebefa4c16966ed6310067lgentis serveur, comme si un mandataire de mise en cache indépendant RFC 2616
3e6b8c7840a46cdccd46b7a4b1902c2bc82f6cc2gryzor était placé devant ce dernier.</p>
3e6b8c7840a46cdccd46b7a4b1902c2bc82f6cc2gryzor <p>Bien que que ce mode offre les meilleures performances, les
3e6b8c7840a46cdccd46b7a4b1902c2bc82f6cc2gryzor administrateurs peuvent souhaiter, dans certaines circonstances,
3e6b8c7840a46cdccd46b7a4b1902c2bc82f6cc2gryzor effectuer des traitements sur la requête après que cette dernière ait
3e6b8c7840a46cdccd46b7a4b1902c2bc82f6cc2gryzor été mise en cache, comme ajouter du contenu personnalisé à la page
3e6b8c7840a46cdccd46b7a4b1902c2bc82f6cc2gryzor mise en cache, ou appliquer des restrictions d'autorisations au
3e6b8c7840a46cdccd46b7a4b1902c2bc82f6cc2gryzor contenu. Pour y parvenir, l'administrateur sera alors souvent forcé de
3e6b8c7840a46cdccd46b7a4b1902c2bc82f6cc2gryzor placer des serveurs mandataires inverses indépendants soit derrière,
3e6b8c7840a46cdccd46b7a4b1902c2bc82f6cc2gryzor soit devant le serveur de mise en cache.</p>
3e6b8c7840a46cdccd46b7a4b1902c2bc82f6cc2gryzor <p>Pour résoudre ce problème, la directive <directive
3e6b8c7840a46cdccd46b7a4b1902c2bc82f6cc2gryzor module="mod_cache">CacheQuickHandler</directive> peut être définie à
3e6b8c7840a46cdccd46b7a4b1902c2bc82f6cc2gryzor <strong>off</strong>, afin que le serveur traite toutes les phases
3e6b8c7840a46cdccd46b7a4b1902c2bc82f6cc2gryzor normalement exécutées par une requête non mise en cache, y compris les
3e6b8c7840a46cdccd46b7a4b1902c2bc82f6cc2gryzor phases <strong>d'authentification et d'autorisation</strong>.</p>
3e6b8c7840a46cdccd46b7a4b1902c2bc82f6cc2gryzor <p>En outre, l'administrateur peut éventuellement spécifier le
3e6b8c7840a46cdccd46b7a4b1902c2bc82f6cc2gryzor <strong>point précis dans la chaîne de filtrage</strong> où devra
3e6b8c7840a46cdccd46b7a4b1902c2bc82f6cc2gryzor intervenir la mise en cache en ajoutant le filtre
3e6b8c7840a46cdccd46b7a4b1902c2bc82f6cc2gryzor <strong>CACHE</strong> à la chaîne de filtrage en sortie.</p>
3e6b8c7840a46cdccd46b7a4b1902c2bc82f6cc2gryzor <p>Par exemple, pour mettre en cache le contenu avant d'appliquer une
3e6b8c7840a46cdccd46b7a4b1902c2bc82f6cc2gryzor compression à la réponse, placez le filtre <strong>CACHE</strong>
3e6b8c7840a46cdccd46b7a4b1902c2bc82f6cc2gryzor avant le filtre <strong>DEFLATE</strong> comme dans l'exemple suivant
e2f05529a1835546e17527f56074c023e6a47366lgentis# Mise en cache du contenu avant la compression optionnelle
e2f05529a1835546e17527f56074c023e6a47366lgentisCacheQuickHandler off
e2f05529a1835546e17527f56074c023e6a47366lgentis </highlight>
3e6b8c7840a46cdccd46b7a4b1902c2bc82f6cc2gryzor <p>Une autre possibilité consiste à mettre en cache le contenu avant
3e6b8c7840a46cdccd46b7a4b1902c2bc82f6cc2gryzor l'ajout de contenu personnalisé via <module>mod_include</module> (ou
3e6b8c7840a46cdccd46b7a4b1902c2bc82f6cc2gryzor tout autre filtre de traitement de contenu). Dans l'exemple suivant,
3e6b8c7840a46cdccd46b7a4b1902c2bc82f6cc2gryzor les modèles contenant des balises comprises par
3e6b8c7840a46cdccd46b7a4b1902c2bc82f6cc2gryzor <module>mod_include</module> sont mis en cache avant d'être
3e6b8c7840a46cdccd46b7a4b1902c2bc82f6cc2gryzor interprétés :</p>
e2f05529a1835546e17527f56074c023e6a47366lgentis# Mise en cache du contenu avant l'intervention de mod_include et
3662a9cd3c9e8c3fe6596be42c3459174293cb82lgentis # mod_deflate
e2f05529a1835546e17527f56074c023e6a47366lgentisCacheQuickHandler off
e2f05529a1835546e17527f56074c023e6a47366lgentisAddOutputFilterByType CACHE;INCLUDES;DEFLATE text/html
e2f05529a1835546e17527f56074c023e6a47366lgentis </highlight>
3e6b8c7840a46cdccd46b7a4b1902c2bc82f6cc2gryzor <p>Vous pouvez insérer le filtre <strong>CACHE</strong> en tout point
3e6b8c7840a46cdccd46b7a4b1902c2bc82f6cc2gryzor de la chaîne de filtrage. Dans l'exemple suivant, le contenu est mis
3e6b8c7840a46cdccd46b7a4b1902c2bc82f6cc2gryzor en cache après avoir été interprété par <module>mod_include</module>,
3e6b8c7840a46cdccd46b7a4b1902c2bc82f6cc2gryzor mais avant d'être traité par <module>mod_deflate</module> :</p>
e2f05529a1835546e17527f56074c023e6a47366lgentis# Mise en cache du contenu entre les interventions de mod_include et
3662a9cd3c9e8c3fe6596be42c3459174293cb82lgentis # mod_deflate
e2f05529a1835546e17527f56074c023e6a47366lgentisCacheQuickHandler off
e2f05529a1835546e17527f56074c023e6a47366lgentisAddOutputFilterByType INCLUDES;CACHE;DEFLATE text/html
e2f05529a1835546e17527f56074c023e6a47366lgentis </highlight>
3e6b8c7840a46cdccd46b7a4b1902c2bc82f6cc2gryzor <note type="warning"><title>Avertissement :</title>Si pour une raison
3e6b8c7840a46cdccd46b7a4b1902c2bc82f6cc2gryzor ou pour une autre, le point d'insertion du filtre
3e6b8c7840a46cdccd46b7a4b1902c2bc82f6cc2gryzor <strong>CACHE</strong> dans la chaîne de filtrage est modifié, vous
3e6b8c7840a46cdccd46b7a4b1902c2bc82f6cc2gryzor devez <strong>vider votre cache</strong> pour être sûr que les données
3e6b8c7840a46cdccd46b7a4b1902c2bc82f6cc2gryzor servies soient à jour. En effet, <module>mod_cache</module> n'est pas
3e6b8c7840a46cdccd46b7a4b1902c2bc82f6cc2gryzor en mesure d'effectuer cette opération à votre place.</note>
3016c72ae8173bcfc0989ff1b297d4f27f445108lgentis<section id="status"><title>Etat du cache et journalisation</title>
3016c72ae8173bcfc0989ff1b297d4f27f445108lgentis <p>Lorsque <module>mod_cache</module> a décidé s'il devait ou non
3016c72ae8173bcfc0989ff1b297d4f27f445108lgentis servir une entité depuis le cache, les raisons précises de cette
3016c72ae8173bcfc0989ff1b297d4f27f445108lgentis décision sont enregistrées dans l'environnement du sous-processus
3016c72ae8173bcfc0989ff1b297d4f27f445108lgentis interne à la requête sous la clé <strong>cache-status</strong>.
3016c72ae8173bcfc0989ff1b297d4f27f445108lgentis Cette information peut être journalisée via la directive <directive
3016c72ae8173bcfc0989ff1b297d4f27f445108lgentis module="mod_log_config">LogFormat</directive> comme suit :</p>
3016c72ae8173bcfc0989ff1b297d4f27f445108lgentis LogFormat "%{cache-status}e ..."
e2f05529a1835546e17527f56074c023e6a47366lgentis </highlight>
3016c72ae8173bcfc0989ff1b297d4f27f445108lgentis <p>En fonction de la décision prise, l'information est aussi écrite
f6edf426ed6b8912be700db47d65a001d091909flgentis dans l'environnement du sous-processus sous une des quatre clés
3016c72ae8173bcfc0989ff1b297d4f27f445108lgentis suivantes :</p>
3016c72ae8173bcfc0989ff1b297d4f27f445108lgentis <dt>cache-hit</dt><dd>Le contenu a été servi depuis le cache.</dd>
3016c72ae8173bcfc0989ff1b297d4f27f445108lgentis <dt>cache-revalidate</dt><dd>Le contenu du cache était périmé, a été
3016c72ae8173bcfc0989ff1b297d4f27f445108lgentis mis à jour avec succès, puis servi depuis le cache.</dd>
3016c72ae8173bcfc0989ff1b297d4f27f445108lgentis <dt>cache-miss</dt><dd>Le contenu n'était pas dans le cache et a été
3016c72ae8173bcfc0989ff1b297d4f27f445108lgentis servi directement depuis le serveur demandé.</dd>
f6edf426ed6b8912be700db47d65a001d091909flgentis <dt>cache-invalidate</dt><dd>L'entité du cache est devenue invalide
f6edf426ed6b8912be700db47d65a001d091909flgentis suite à une requête d'un type autre que GET ou HEAD.</dd>
3016c72ae8173bcfc0989ff1b297d4f27f445108lgentis <p>Il est alors possible d'envisager une journalisation conditionnelle
3016c72ae8173bcfc0989ff1b297d4f27f445108lgentis du traitement des requêtes par rapport au cache comme dans l'exemple
3016c72ae8173bcfc0989ff1b297d4f27f445108lgentis suivant :</p>
e2f05529a1835546e17527f56074c023e6a47366lgentisCustomLog cached-requests.log common env=cache-hit
e2f05529a1835546e17527f56074c023e6a47366lgentisCustomLog uncached-requests.log common env=cache-miss
e2f05529a1835546e17527f56074c023e6a47366lgentisCustomLog revalidated-requests.log common env=cache-revalidate
e2f05529a1835546e17527f56074c023e6a47366lgentisCustomLog invalidated-requests.log common env=cache-invalidate
e2f05529a1835546e17527f56074c023e6a47366lgentis </highlight>
f6edf426ed6b8912be700db47d65a001d091909flgentis <p>Pour les concepteurs de modules, une accroche (hook) nommée
f6edf426ed6b8912be700db47d65a001d091909flgentis <var>cache_status</var> est disponible et permet aux modules de
f6edf426ed6b8912be700db47d65a001d091909flgentis répondre aux résultats de la vérification du cache ci-dessus de manière
f6edf426ed6b8912be700db47d65a001d091909flgentis personnalisée.</p>
3e6b8c7840a46cdccd46b7a4b1902c2bc82f6cc2gryzor<directivesynopsis>
3e6b8c7840a46cdccd46b7a4b1902c2bc82f6cc2gryzor<description>Active la mise en cache des URLs spécifiées en utilisant le
3e6b8c7840a46cdccd46b7a4b1902c2bc82f6cc2gryzorgestionnaire de stockage précisé</description>
5d3ecd7c0aff8e1b9268d5783b555aca3ba93d9algentis<syntax>CacheEnable <var>type de cache</var> [<var>chaîne
3e6b8c7840a46cdccd46b7a4b1902c2bc82f6cc2gryzor<contextlist><context>server config</context><context>virtual host</context>
3e6b8c7840a46cdccd46b7a4b1902c2bc82f6cc2gryzor</contextlist>
63edd358d6b6fda4f9dfa96effa972bf996b77f8lgentis<compatibility>Une chaîne URL telle que '/' s'appliquait à tout contenu
63edd358d6b6fda4f9dfa96effa972bf996b77f8lgentisen mandat direct dans les versions 2.2 et antérieures.</compatibility>
3e6b8c7840a46cdccd46b7a4b1902c2bc82f6cc2gryzor <p>La directive <directive>CacheEnable</directive> enjoint
3e6b8c7840a46cdccd46b7a4b1902c2bc82f6cc2gryzor <module>mod_cache</module> de mettre en cache l'URL précisée par
3e6b8c7840a46cdccd46b7a4b1902c2bc82f6cc2gryzor <var>chaîne URL</var>, ainsi que les URLs de niveaux inférieurs. Le
3e6b8c7840a46cdccd46b7a4b1902c2bc82f6cc2gryzor gestionnaire de stockage du cache est spécifié à l'aide de
5d3ecd7c0aff8e1b9268d5783b555aca3ba93d9algentis <directive>CacheEnable</directive> peut être placée à l'intérieur d'une
5d3ecd7c0aff8e1b9268d5783b555aca3ba93d9algentis section <directive type="section">Location</directive> ou <directive
5d3ecd7c0aff8e1b9268d5783b555aca3ba93d9algentis type="section">LocationMatch</directive> pour indiquer que le
5d3ecd7c0aff8e1b9268d5783b555aca3ba93d9algentis contenu considéré peut être mis en cache. Si <var>type de cache</var>
3e6b8c7840a46cdccd46b7a4b1902c2bc82f6cc2gryzor a pour valeur <code>disk</code>, <module>mod_cache</module>
3e6b8c7840a46cdccd46b7a4b1902c2bc82f6cc2gryzor utilisera le gestionnaire de stockage sur disque implémenté par
5e6dcc287b64eb58282c020e8a91a8bfb6ac0339lgentis <module>mod_cache_disk</module>. Pour que <module>mod_cache</module>
5e6dcc287b64eb58282c020e8a91a8bfb6ac0339lgentis utilise le gestionnaire de stockage basé sur le cache d'objets
5e6dcc287b64eb58282c020e8a91a8bfb6ac0339lgentis partagés implémenté par <module>mod_cache_socache</module>,
5e6dcc287b64eb58282c020e8a91a8bfb6ac0339lgentis spécifiez <code>socache</code> comme valeur du paramètre <var>type
3e6b8c7840a46cdccd46b7a4b1902c2bc82f6cc2gryzor <p>Si les différentes directives <directive>CacheEnable</directive>
3e6b8c7840a46cdccd46b7a4b1902c2bc82f6cc2gryzor spécifient des URLs qui se recoupent (comme dans l'exemple
3e6b8c7840a46cdccd46b7a4b1902c2bc82f6cc2gryzor ci-dessous), tous les gestionnaires de stockage possibles seront
3e6b8c7840a46cdccd46b7a4b1902c2bc82f6cc2gryzor lancés, jusqu'au premier d'entre eux qui traitera effectivement la
3e6b8c7840a46cdccd46b7a4b1902c2bc82f6cc2gryzor requête.
3e6b8c7840a46cdccd46b7a4b1902c2bc82f6cc2gryzor L'ordre dans lequel les gestionnaires de stockage sont lancés est
3e6b8c7840a46cdccd46b7a4b1902c2bc82f6cc2gryzor déterminé par l'ordre dans lequel apparaissent les directives
3e6b8c7840a46cdccd46b7a4b1902c2bc82f6cc2gryzor <directive>CacheEnable</directive> dans le fichier de
5d3ecd7c0aff8e1b9268d5783b555aca3ba93d9algentis configuration. Les directives <directive>CacheEnable</directive>
5d3ecd7c0aff8e1b9268d5783b555aca3ba93d9algentis situées à l'intérieur de sections <directive
5d3ecd7c0aff8e1b9268d5783b555aca3ba93d9algentis type="section">LocationMatch</directive> sont traitées avant les
5d3ecd7c0aff8e1b9268d5783b555aca3ba93d9algentis directives <directive>CacheEnable</directive> définies au niveau
5d3ecd7c0aff8e1b9268d5783b555aca3ba93d9algentis global.</p>
3e6b8c7840a46cdccd46b7a4b1902c2bc82f6cc2gryzor <p>En fonctionnement du type serveur mandataire direct, <var>chaîne
63edd358d6b6fda4f9dfa96effa972bf996b77f8lgentis URL</var> doit au moins débuter par un protocole pour lequel la mise
63edd358d6b6fda4f9dfa96effa972bf996b77f8lgentis en cache doit être activée.</p>
bcdb9ce8fbec6b772244eb2eb533b2a42b998361lgentis# Mise en cache de contenu (gestionnaire normal seulement)
bcdb9ce8fbec6b772244eb2eb533b2a42b998361lgentisCacheQuickHandler off
e2f05529a1835546e17527f56074c023e6a47366lgentis<Location /foo>
e2f05529a1835546e17527f56074c023e6a47366lgentis CacheEnable disk
e2f05529a1835546e17527f56074c023e6a47366lgentis</Location>
bcdb9ce8fbec6b772244eb2eb533b2a42b998361lgentis# Mise en cache via une expression rationnelle (gestionnaire normal seulement)
bcdb9ce8fbec6b772244eb2eb533b2a42b998361lgentisCacheQuickHandler off
e2f05529a1835546e17527f56074c023e6a47366lgentis<LocationMatch foo$>
e2f05529a1835546e17527f56074c023e6a47366lgentis CacheEnable disk
e2f05529a1835546e17527f56074c023e6a47366lgentis</LocationMatch>
63edd358d6b6fda4f9dfa96effa972bf996b77f8lgentis# Mise en cache de tous les contenus, à l'exception des URLs
63edd358d6b6fda4f9dfa96effa972bf996b77f8lgentis# mandatées en direct (gestionnaire normal ou rapide)
e2f05529a1835546e17527f56074c023e6a47366lgentisCacheEnable disk /
bcdb9ce8fbec6b772244eb2eb533b2a42b998361lgentis# Mise en cache des URLs FTP mandatées (gestionnaire normal ou rapide)
e2f05529a1835546e17527f56074c023e6a47366lgentisCacheEnable disk ftp://
63edd358d6b6fda4f9dfa96effa972bf996b77f8lgentis# Mise en cache des contenus mandatés en direct depuis www.example.org (gestionnaire normal ou rapide)
e2f05529a1835546e17527f56074c023e6a47366lgentis </highlight>
3e6b8c7840a46cdccd46b7a4b1902c2bc82f6cc2gryzor <p>Un nom d'hôte commençant par un caractère <strong>"*"</strong>
3e6b8c7840a46cdccd46b7a4b1902c2bc82f6cc2gryzor correspondra à tout nom d'hôte se terminant par le suffixe
3e6b8c7840a46cdccd46b7a4b1902c2bc82f6cc2gryzor considéré. Un nom d'hôte commençant par un caractère
3e6b8c7840a46cdccd46b7a4b1902c2bc82f6cc2gryzor <strong>"."</strong> correspondra à tout nom d'hôte contenant le
3e6b8c7840a46cdccd46b7a4b1902c2bc82f6cc2gryzor composant de nom de domaine qui suit ce caractère.</p>
e2f05529a1835546e17527f56074c023e6a47366lgentis# Correspond à www.example.org et fooexample.org
e2f05529a1835546e17527f56074c023e6a47366lgentisCacheEnable disk http://*example.org/
e2f05529a1835546e17527f56074c023e6a47366lgentis# Correspond à www.example.org, mais pas à fooexample.org
e2f05529a1835546e17527f56074c023e6a47366lgentisCacheEnable disk http://.example.org/
e2f05529a1835546e17527f56074c023e6a47366lgentis </highlight>
3e6b8c7840a46cdccd46b7a4b1902c2bc82f6cc2gryzor <p>Depuis la version 2.2.12, on peut définir la variable
3e6b8c7840a46cdccd46b7a4b1902c2bc82f6cc2gryzor d'environnement <code>no-cache</code> pour une définition plus fine
3e6b8c7840a46cdccd46b7a4b1902c2bc82f6cc2gryzor des ressources à mettre en cache.</p>
3e6b8c7840a46cdccd46b7a4b1902c2bc82f6cc2gryzor<seealso><a href="/env.html">Les variables d'environnement dans
3e6b8c7840a46cdccd46b7a4b1902c2bc82f6cc2gryzor</directivesynopsis>
3e6b8c7840a46cdccd46b7a4b1902c2bc82f6cc2gryzor<directivesynopsis>
3e6b8c7840a46cdccd46b7a4b1902c2bc82f6cc2gryzor<description>Désactive la mise en cache des URLs
3e6b8c7840a46cdccd46b7a4b1902c2bc82f6cc2gryzorspécifiées</description>
3e6b8c7840a46cdccd46b7a4b1902c2bc82f6cc2gryzor<syntax>CacheDisable <var>chaîne-url</var> | <var>on</var></syntax>
3e6b8c7840a46cdccd46b7a4b1902c2bc82f6cc2gryzor<contextlist><context>server config</context><context>virtual host</context>
5d3ecd7c0aff8e1b9268d5783b555aca3ba93d9algentis<context>directory</context><context>.htaccess</context>
3e6b8c7840a46cdccd46b7a4b1902c2bc82f6cc2gryzor</contextlist>
3e6b8c7840a46cdccd46b7a4b1902c2bc82f6cc2gryzor <p>La directive <directive>CacheDisable</directive> enjoint
3e6b8c7840a46cdccd46b7a4b1902c2bc82f6cc2gryzor <module>mod_cache</module> de <em>ne pas</em> mettre en cache l'URL
3e6b8c7840a46cdccd46b7a4b1902c2bc82f6cc2gryzor spécifiée par <var>chaîne URL</var>, ainsi que les URLs de niveaux
3e6b8c7840a46cdccd46b7a4b1902c2bc82f6cc2gryzor inférieurs.</p>
3e6b8c7840a46cdccd46b7a4b1902c2bc82f6cc2gryzor CacheDisable /fichiers_locaux
e2f05529a1835546e17527f56074c023e6a47366lgentis </highlight>
3e6b8c7840a46cdccd46b7a4b1902c2bc82f6cc2gryzor <p>Si la directive se trouve à l'intérieur d'une section <directive
3e6b8c7840a46cdccd46b7a4b1902c2bc82f6cc2gryzor type="section">Location</directive>, le chemin doit être spécifié en
3e6b8c7840a46cdccd46b7a4b1902c2bc82f6cc2gryzor dessous de la Location, et si le mot "on" est utilisé, la mise en
3e6b8c7840a46cdccd46b7a4b1902c2bc82f6cc2gryzor cache sera désactivée pour l'ensemble de l'arborescence concernée
3e6b8c7840a46cdccd46b7a4b1902c2bc82f6cc2gryzor par la section Location.</p>
e2f05529a1835546e17527f56074c023e6a47366lgentis<Location /foo>
e2f05529a1835546e17527f56074c023e6a47366lgentis CacheDisable on
e2f05529a1835546e17527f56074c023e6a47366lgentis</Location>
e2f05529a1835546e17527f56074c023e6a47366lgentis </highlight>
3e6b8c7840a46cdccd46b7a4b1902c2bc82f6cc2gryzor <p>Avec les versions 2.2.12 et ultérieures, on peut définir la
3e6b8c7840a46cdccd46b7a4b1902c2bc82f6cc2gryzor variable d'environnement <code>no-cache</code> pour une définition
3e6b8c7840a46cdccd46b7a4b1902c2bc82f6cc2gryzor plus fine des ressources à mettre en cache.</p>
3e6b8c7840a46cdccd46b7a4b1902c2bc82f6cc2gryzor<seealso><a href="/env.html">Les variables d'environnement dans
3e6b8c7840a46cdccd46b7a4b1902c2bc82f6cc2gryzor</directivesynopsis>
3e6b8c7840a46cdccd46b7a4b1902c2bc82f6cc2gryzor<directivesynopsis>
3e6b8c7840a46cdccd46b7a4b1902c2bc82f6cc2gryzor<description>La durée maximale en secondes de mise en cache d'un
3e6b8c7840a46cdccd46b7a4b1902c2bc82f6cc2gryzordocument</description>
3e6b8c7840a46cdccd46b7a4b1902c2bc82f6cc2gryzor<default>CacheMaxExpire 86400 (une journée)</default>
3e6b8c7840a46cdccd46b7a4b1902c2bc82f6cc2gryzor<contextlist><context>server config</context><context>virtual host</context>
3016c72ae8173bcfc0989ff1b297d4f27f445108lgentis<context>directory</context><context>.htaccess</context>
3e6b8c7840a46cdccd46b7a4b1902c2bc82f6cc2gryzor</contextlist>
3e6b8c7840a46cdccd46b7a4b1902c2bc82f6cc2gryzor <p>La directive <directive>CacheMaxExpire</directive> permet de
3e6b8c7840a46cdccd46b7a4b1902c2bc82f6cc2gryzor spécifier le nombre maximum de secondes pendant lequel les documents
3e6b8c7840a46cdccd46b7a4b1902c2bc82f6cc2gryzor HTTP suceptibles d'être mis en cache seront conservés sans vérifier
3e6b8c7840a46cdccd46b7a4b1902c2bc82f6cc2gryzor leur contenu sur le serveur d'origine. Ce nombre de secondes
3e6b8c7840a46cdccd46b7a4b1902c2bc82f6cc2gryzor correspond donc à la durée maximale pendant laquelle un document ne
3e6b8c7840a46cdccd46b7a4b1902c2bc82f6cc2gryzor sera pas à jour. L'utilisation de cette valeur maximale est forcée,
3e6b8c7840a46cdccd46b7a4b1902c2bc82f6cc2gryzor même si le document possède une date d'expiration.</p>
3e6b8c7840a46cdccd46b7a4b1902c2bc82f6cc2gryzor CacheMaxExpire 604800
e2f05529a1835546e17527f56074c023e6a47366lgentis </highlight>
3e6b8c7840a46cdccd46b7a4b1902c2bc82f6cc2gryzor</directivesynopsis>
3e6b8c7840a46cdccd46b7a4b1902c2bc82f6cc2gryzor<directivesynopsis>
3e6b8c7840a46cdccd46b7a4b1902c2bc82f6cc2gryzor<description>La durée minimale en secondes de mise en cache d'un
3e6b8c7840a46cdccd46b7a4b1902c2bc82f6cc2gryzordocument</description>
3e6b8c7840a46cdccd46b7a4b1902c2bc82f6cc2gryzor<contextlist><context>server config</context><context>virtual host</context>
3016c72ae8173bcfc0989ff1b297d4f27f445108lgentis<context>directory</context><context>.htaccess</context>
3e6b8c7840a46cdccd46b7a4b1902c2bc82f6cc2gryzor</contextlist>
3e6b8c7840a46cdccd46b7a4b1902c2bc82f6cc2gryzor <p>La directive <directive>CacheMaxExpire</directive> permet de
3e6b8c7840a46cdccd46b7a4b1902c2bc82f6cc2gryzor spécifier le nombre maximum de secondes pendant lequel les documents
3e6b8c7840a46cdccd46b7a4b1902c2bc82f6cc2gryzor HTTP suceptibles d'être mis en cache seront conservés sans vérifier
3e6b8c7840a46cdccd46b7a4b1902c2bc82f6cc2gryzor leur contenu sur le serveur d'origine. Elle n'est prise en compte
3e6b8c7840a46cdccd46b7a4b1902c2bc82f6cc2gryzor que dans le cas où le document ne possède aucune date d'expiration
3e6b8c7840a46cdccd46b7a4b1902c2bc82f6cc2gryzor valide.</p>
3e6b8c7840a46cdccd46b7a4b1902c2bc82f6cc2gryzor CacheMinExpire 3600
e2f05529a1835546e17527f56074c023e6a47366lgentis </highlight>
3e6b8c7840a46cdccd46b7a4b1902c2bc82f6cc2gryzor</directivesynopsis>
3e6b8c7840a46cdccd46b7a4b1902c2bc82f6cc2gryzor<directivesynopsis>
3e6b8c7840a46cdccd46b7a4b1902c2bc82f6cc2gryzor<description>La durée par défaut de mise en cache d'un document
3e6b8c7840a46cdccd46b7a4b1902c2bc82f6cc2gryzorlorsqu'aucune date d'expiration n'a été spécifiée.</description>
3e6b8c7840a46cdccd46b7a4b1902c2bc82f6cc2gryzor<syntax>CacheDefaultExpire <var>secondes</var></syntax>
3e6b8c7840a46cdccd46b7a4b1902c2bc82f6cc2gryzor<default>CacheDefaultExpire 3600 (une heure)</default>
3e6b8c7840a46cdccd46b7a4b1902c2bc82f6cc2gryzor<contextlist><context>server config</context><context>virtual host</context>
3016c72ae8173bcfc0989ff1b297d4f27f445108lgentis<context>directory</context><context>.htaccess</context>
3e6b8c7840a46cdccd46b7a4b1902c2bc82f6cc2gryzor</contextlist>
3e6b8c7840a46cdccd46b7a4b1902c2bc82f6cc2gryzor <p>La directive <directive>CacheDefaultExpire</directive> permet de
3e6b8c7840a46cdccd46b7a4b1902c2bc82f6cc2gryzor spécifier un temps par défaut, en secondes, pendant lequel sera
3e6b8c7840a46cdccd46b7a4b1902c2bc82f6cc2gryzor conservé dans le cache un document qui ne possède ni date
3e6b8c7840a46cdccd46b7a4b1902c2bc82f6cc2gryzor d'expiration, ni date de dernière modification. La valeur de cette
3e6b8c7840a46cdccd46b7a4b1902c2bc82f6cc2gryzor directive est écrasée par la valeur de la directive
3e6b8c7840a46cdccd46b7a4b1902c2bc82f6cc2gryzor <directive>CacheMaxExpire</directive> si cette dernière est
3e6b8c7840a46cdccd46b7a4b1902c2bc82f6cc2gryzor utilisée.</p>
3e6b8c7840a46cdccd46b7a4b1902c2bc82f6cc2gryzor CacheDefaultExpire 86400
e2f05529a1835546e17527f56074c023e6a47366lgentis </highlight>
3e6b8c7840a46cdccd46b7a4b1902c2bc82f6cc2gryzor</directivesynopsis>
3e6b8c7840a46cdccd46b7a4b1902c2bc82f6cc2gryzor<directivesynopsis>
3e6b8c7840a46cdccd46b7a4b1902c2bc82f6cc2gryzor<description>Ignore le fait qu'une réponse ne possède pas d'en-tête Last
3e6b8c7840a46cdccd46b7a4b1902c2bc82f6cc2gryzorModified.</description>
3e6b8c7840a46cdccd46b7a4b1902c2bc82f6cc2gryzor<contextlist><context>server config</context><context>virtual host</context>
3016c72ae8173bcfc0989ff1b297d4f27f445108lgentis<context>directory</context><context>.htaccess</context>
3e6b8c7840a46cdccd46b7a4b1902c2bc82f6cc2gryzor</contextlist>
3e6b8c7840a46cdccd46b7a4b1902c2bc82f6cc2gryzor <p>Normalement, les documents qui ne possèdent pas de date de
3e6b8c7840a46cdccd46b7a4b1902c2bc82f6cc2gryzor dernière modification ne sont pas mis en cache. Dans certaines
3e6b8c7840a46cdccd46b7a4b1902c2bc82f6cc2gryzor circonstances, la date de dernière modification est supprimée (au
3e6b8c7840a46cdccd46b7a4b1902c2bc82f6cc2gryzor cours des traitements liés à <module>mod_include</module> par
3e6b8c7840a46cdccd46b7a4b1902c2bc82f6cc2gryzor exemple), ou n'existe tout simplement pas. La directive
3e6b8c7840a46cdccd46b7a4b1902c2bc82f6cc2gryzor <directive>CacheIgnoreNoLastMod</directive> permet de spécifier si
3e6b8c7840a46cdccd46b7a4b1902c2bc82f6cc2gryzor les documents ne possèdant pas de date de dernière modification
3e6b8c7840a46cdccd46b7a4b1902c2bc82f6cc2gryzor doivent être mis en cache, même sans date de dernière modification.
3e6b8c7840a46cdccd46b7a4b1902c2bc82f6cc2gryzor Si le document ne possède ni date d'expiration, ni date de dernière
3e6b8c7840a46cdccd46b7a4b1902c2bc82f6cc2gryzor modification, la valeur spécifiée par la directive
3e6b8c7840a46cdccd46b7a4b1902c2bc82f6cc2gryzor <directive>CacheDefaultExpire</directive> servira à générer une date
3e6b8c7840a46cdccd46b7a4b1902c2bc82f6cc2gryzor d'expiration.
3e6b8c7840a46cdccd46b7a4b1902c2bc82f6cc2gryzor CacheIgnoreNoLastMod On
e2f05529a1835546e17527f56074c023e6a47366lgentis </highlight>
3e6b8c7840a46cdccd46b7a4b1902c2bc82f6cc2gryzor</directivesynopsis>
3e6b8c7840a46cdccd46b7a4b1902c2bc82f6cc2gryzor<directivesynopsis>
3e6b8c7840a46cdccd46b7a4b1902c2bc82f6cc2gryzor<description>Ignore les en-têtes de requête enjoignant de ne pas servir
3e6b8c7840a46cdccd46b7a4b1902c2bc82f6cc2gryzorle contenu au client depuis le cache</description>
3e6b8c7840a46cdccd46b7a4b1902c2bc82f6cc2gryzor<contextlist><context>server config</context><context>virtual host</context>
3e6b8c7840a46cdccd46b7a4b1902c2bc82f6cc2gryzor</contextlist>
3e6b8c7840a46cdccd46b7a4b1902c2bc82f6cc2gryzor <p>Normalement, les requêtes contenant des en-têtes tels que
3e6b8c7840a46cdccd46b7a4b1902c2bc82f6cc2gryzor Cache-Control: no-cache ou Pragma: no-cache ne sont pas servies
3e6b8c7840a46cdccd46b7a4b1902c2bc82f6cc2gryzor depuis le cache. La directive
3e6b8c7840a46cdccd46b7a4b1902c2bc82f6cc2gryzor <directive>CacheIgnoreCacheControl</directive> permet de modifier ce
3e6b8c7840a46cdccd46b7a4b1902c2bc82f6cc2gryzor comportement. Avec <directive>CacheIgnoreCacheControl
3e6b8c7840a46cdccd46b7a4b1902c2bc82f6cc2gryzor On</directive>, le serveur tentera de servir la ressource depuis le
dfb30ad72e3edf034d86c44c31ad9c8b1c41f178lgentis cache, même si la requête contient un en-tête
dfb30ad72e3edf034d86c44c31ad9c8b1c41f178lgentis no-cache.</p>
3e6b8c7840a46cdccd46b7a4b1902c2bc82f6cc2gryzor CacheIgnoreCacheControl On
e2f05529a1835546e17527f56074c023e6a47366lgentis </highlight>
3e6b8c7840a46cdccd46b7a4b1902c2bc82f6cc2gryzor Cette directive permet de servir des ressources depuis le cache,
3e6b8c7840a46cdccd46b7a4b1902c2bc82f6cc2gryzor même si le client a demandé à ce qu'il n'en soit pas ainsi. Le
3e6b8c7840a46cdccd46b7a4b1902c2bc82f6cc2gryzor contenu servi est ainsi susceptible d'être périmé.
3e6b8c7840a46cdccd46b7a4b1902c2bc82f6cc2gryzor<seealso><directive module="mod_cache">CacheStorePrivate</directive></seealso>
3e6b8c7840a46cdccd46b7a4b1902c2bc82f6cc2gryzor<seealso><directive module="mod_cache">CacheStoreNoStore</directive></seealso>
3e6b8c7840a46cdccd46b7a4b1902c2bc82f6cc2gryzor</directivesynopsis>
3e6b8c7840a46cdccd46b7a4b1902c2bc82f6cc2gryzor<directivesynopsis>
3e6b8c7840a46cdccd46b7a4b1902c2bc82f6cc2gryzor<description>Ignore la chaîne de paramètres lors de la mise en
3e6b8c7840a46cdccd46b7a4b1902c2bc82f6cc2gryzorcache</description>
3e6b8c7840a46cdccd46b7a4b1902c2bc82f6cc2gryzor<contextlist><context>server config</context><context>virtual host</context>
3e6b8c7840a46cdccd46b7a4b1902c2bc82f6cc2gryzor</contextlist>
3e6b8c7840a46cdccd46b7a4b1902c2bc82f6cc2gryzor <p>Normalement, les requêtes comportant une chaîne de paramètres
3e6b8c7840a46cdccd46b7a4b1902c2bc82f6cc2gryzor sont mises en cache séparément si leurs chaînes de paramètres
3e6b8c7840a46cdccd46b7a4b1902c2bc82f6cc2gryzor diffèrent.
3e6b8c7840a46cdccd46b7a4b1902c2bc82f6cc2gryzor En accord avec la RFC 2616/13.9, cette mise en cache n'est effectuée
3e6b8c7840a46cdccd46b7a4b1902c2bc82f6cc2gryzor séparément que si une date d'expiration est spécifiée. La directive
3e6b8c7840a46cdccd46b7a4b1902c2bc82f6cc2gryzor <directive>CacheIgnoreQueryString</directive> permet la mise en
3e6b8c7840a46cdccd46b7a4b1902c2bc82f6cc2gryzor cache de requêtes même si aucune date d'expiration est spécifiée, et
3e6b8c7840a46cdccd46b7a4b1902c2bc82f6cc2gryzor de renvoyer une réponse depuis la cache même si les chaînes de
3e6b8c7840a46cdccd46b7a4b1902c2bc82f6cc2gryzor paramètres diffèrent. Du point de vue du cache, la requête est
3e6b8c7840a46cdccd46b7a4b1902c2bc82f6cc2gryzor traitée comme si elle ne possèdait pas de chaîne de paramètres
3e6b8c7840a46cdccd46b7a4b1902c2bc82f6cc2gryzor lorsque cette directive est activée.</p>
3e6b8c7840a46cdccd46b7a4b1902c2bc82f6cc2gryzor CacheIgnoreQueryString On
e2f05529a1835546e17527f56074c023e6a47366lgentis </highlight>
3e6b8c7840a46cdccd46b7a4b1902c2bc82f6cc2gryzor</directivesynopsis>
3e6b8c7840a46cdccd46b7a4b1902c2bc82f6cc2gryzor<directivesynopsis>
3e6b8c7840a46cdccd46b7a4b1902c2bc82f6cc2gryzor<description>Le facteur utilisé pour générer une date d'expiration en
3e6b8c7840a46cdccd46b7a4b1902c2bc82f6cc2gryzorfonction de la date de dernière modification.</description>
3e6b8c7840a46cdccd46b7a4b1902c2bc82f6cc2gryzor<syntax>CacheLastModifiedFactor <var>flottant</var></syntax>
3e6b8c7840a46cdccd46b7a4b1902c2bc82f6cc2gryzor<contextlist><context>server config</context><context>virtual host</context>
3016c72ae8173bcfc0989ff1b297d4f27f445108lgentis<context>directory</context><context>.htaccess</context>
3e6b8c7840a46cdccd46b7a4b1902c2bc82f6cc2gryzor</contextlist>
3e6b8c7840a46cdccd46b7a4b1902c2bc82f6cc2gryzor <p>Si un document ne possède pas de date d'expiration, elle peut
3e6b8c7840a46cdccd46b7a4b1902c2bc82f6cc2gryzor être calculée en fonction de la date de dernière modification, si
3e6b8c7840a46cdccd46b7a4b1902c2bc82f6cc2gryzor elle existe. La directive
3e6b8c7840a46cdccd46b7a4b1902c2bc82f6cc2gryzor <directive>CacheLastModifiedFactor</directive> permet de spécifier
3e6b8c7840a46cdccd46b7a4b1902c2bc82f6cc2gryzor un <var>facteur</var> à utiliser pour la génération de cette date
3e6b8c7840a46cdccd46b7a4b1902c2bc82f6cc2gryzor d'expiration au sein de la formule suivante :
3e6b8c7840a46cdccd46b7a4b1902c2bc82f6cc2gryzor <code>délai-expiration = durée-depuis-date-dernière-modification *
3e6b8c7840a46cdccd46b7a4b1902c2bc82f6cc2gryzor date-expiration = date-courante + délai-expiration</code>
3e6b8c7840a46cdccd46b7a4b1902c2bc82f6cc2gryzor Par exemple, si la dernière modification du document date de 10
3e6b8c7840a46cdccd46b7a4b1902c2bc82f6cc2gryzor heures, et si <var>facteur</var> a pour valeur 0.1, le délai
3e6b8c7840a46cdccd46b7a4b1902c2bc82f6cc2gryzor d'expiration sera de 10*0.1 = 1 heure. Si l'heure courante est
3e6b8c7840a46cdccd46b7a4b1902c2bc82f6cc2gryzor 3:00pm, la date d'expiration calculée sera 3:00pm + 1 heure =
3e6b8c7840a46cdccd46b7a4b1902c2bc82f6cc2gryzor Si le délai d'expiration est supérieur à celui spécifié par la
3e6b8c7840a46cdccd46b7a4b1902c2bc82f6cc2gryzor directive <directive>CacheMaxExpire</directive>, c'est ce dernier
3e6b8c7840a46cdccd46b7a4b1902c2bc82f6cc2gryzor qui l'emporte.</p>
3e6b8c7840a46cdccd46b7a4b1902c2bc82f6cc2gryzor CacheLastModifiedFactor 0.5
e2f05529a1835546e17527f56074c023e6a47366lgentis </highlight>
3e6b8c7840a46cdccd46b7a4b1902c2bc82f6cc2gryzor</directivesynopsis>
3e6b8c7840a46cdccd46b7a4b1902c2bc82f6cc2gryzor<directivesynopsis>
3e6b8c7840a46cdccd46b7a4b1902c2bc82f6cc2gryzor<description>Ne pas stocker le(s) en-tête(s) spécifié(s) dans le cache.
3e6b8c7840a46cdccd46b7a4b1902c2bc82f6cc2gryzor</description>
3e6b8c7840a46cdccd46b7a4b1902c2bc82f6cc2gryzor<syntax>CacheIgnoreHeaders <var>en-tête</var> [<var>en-tête</var>] ...</syntax>
3e6b8c7840a46cdccd46b7a4b1902c2bc82f6cc2gryzor<contextlist><context>server config</context><context>virtual host</context>
3e6b8c7840a46cdccd46b7a4b1902c2bc82f6cc2gryzor</contextlist>
3e6b8c7840a46cdccd46b7a4b1902c2bc82f6cc2gryzor <p>En accord avec la RFC 2616, les en-têtes HTTP hop-by-hop ne sont
3e6b8c7840a46cdccd46b7a4b1902c2bc82f6cc2gryzor pas stockés dans le cache. Les en-têtes HTTP suivant sont des
3e6b8c7840a46cdccd46b7a4b1902c2bc82f6cc2gryzor en-têtes hop-by-hop, et en tant que tels, ne sont en <em>aucun</em>
3e6b8c7840a46cdccd46b7a4b1902c2bc82f6cc2gryzor cas stockés dans le cache, quelle que soit la définition de la
3e6b8c7840a46cdccd46b7a4b1902c2bc82f6cc2gryzor directive <directive>CacheIgnoreHeaders</directive> :</p>
3e6b8c7840a46cdccd46b7a4b1902c2bc82f6cc2gryzor <p>La directive <directive>CacheIgnoreHeaders</directive> permet de
3e6b8c7840a46cdccd46b7a4b1902c2bc82f6cc2gryzor spécifier quels en-têtes HTTP ne doivent pas être stockés dans le
3e6b8c7840a46cdccd46b7a4b1902c2bc82f6cc2gryzor cache. Par exemple, il peut s'avérer pertinent dans certains cas de
3e6b8c7840a46cdccd46b7a4b1902c2bc82f6cc2gryzor ne pas stocker les cookies dans le cache.</p>
3e6b8c7840a46cdccd46b7a4b1902c2bc82f6cc2gryzor <p>La directive <directive>CacheIgnoreHeaders</directive> accepte
3e6b8c7840a46cdccd46b7a4b1902c2bc82f6cc2gryzor une liste d'en-têtes HTTP séparés par des espaces, qui ne doivent
3e6b8c7840a46cdccd46b7a4b1902c2bc82f6cc2gryzor pas être stockés dans le cache. Si les en-têtes hop-by-hop sont les
3e6b8c7840a46cdccd46b7a4b1902c2bc82f6cc2gryzor seuls à ne pas devoir être stockés dans le cache (le comportement
3e6b8c7840a46cdccd46b7a4b1902c2bc82f6cc2gryzor compatible RFC 2616), la directive
3e6b8c7840a46cdccd46b7a4b1902c2bc82f6cc2gryzor <directive>CacheIgnoreHeaders</directive> peut être définie à
3e6b8c7840a46cdccd46b7a4b1902c2bc82f6cc2gryzor CacheIgnoreHeaders Set-Cookie
e2f05529a1835546e17527f56074c023e6a47366lgentis </highlight>
3e6b8c7840a46cdccd46b7a4b1902c2bc82f6cc2gryzor CacheIgnoreHeaders None
e2f05529a1835546e17527f56074c023e6a47366lgentis </highlight>
3e6b8c7840a46cdccd46b7a4b1902c2bc82f6cc2gryzor Si des en-têtes nécessaires à la bonne gestion du cache, comme
3e6b8c7840a46cdccd46b7a4b1902c2bc82f6cc2gryzor <code>Expires</code>, ne sont pas stockés suite à la définition
3e6b8c7840a46cdccd46b7a4b1902c2bc82f6cc2gryzor d'une directive <directive>CacheIgnoreHeaders</directive>, le
3e6b8c7840a46cdccd46b7a4b1902c2bc82f6cc2gryzor comportement de mod_cache sera imprévisible.
3e6b8c7840a46cdccd46b7a4b1902c2bc82f6cc2gryzor</directivesynopsis>
3e6b8c7840a46cdccd46b7a4b1902c2bc82f6cc2gryzor<directivesynopsis>
3e6b8c7840a46cdccd46b7a4b1902c2bc82f6cc2gryzor<description>Ignore les identifiants de session définis encodés dans
3e6b8c7840a46cdccd46b7a4b1902c2bc82f6cc2gryzorl'URL lors de la mise en cache
3e6b8c7840a46cdccd46b7a4b1902c2bc82f6cc2gryzor</description>
3e6b8c7840a46cdccd46b7a4b1902c2bc82f6cc2gryzor<syntax>CacheIgnoreURLSessionIdentifiers <var>identifiant</var>
3e6b8c7840a46cdccd46b7a4b1902c2bc82f6cc2gryzor<default>CacheIgnoreURLSessionIdentifiers None</default>
3e6b8c7840a46cdccd46b7a4b1902c2bc82f6cc2gryzor<contextlist><context>server config</context><context>virtual host</context>
3e6b8c7840a46cdccd46b7a4b1902c2bc82f6cc2gryzor</contextlist>
3e6b8c7840a46cdccd46b7a4b1902c2bc82f6cc2gryzor <p>Certaines applications encodent l'identifiant de session dans
3e6b8c7840a46cdccd46b7a4b1902c2bc82f6cc2gryzor l'URL comme dans l'exemple suivant :
3e6b8c7840a46cdccd46b7a4b1902c2bc82f6cc2gryzor <li><code>/une-application/image.gif;jsessionid=123456789</code></li>
3e6b8c7840a46cdccd46b7a4b1902c2bc82f6cc2gryzor <li><code>/une-application/image.gif?PHPSESSIONID=12345678</code></li>
3e6b8c7840a46cdccd46b7a4b1902c2bc82f6cc2gryzor <p>Ceci implique la mise en cache des ressources séparément pour
3e6b8c7840a46cdccd46b7a4b1902c2bc82f6cc2gryzor chaque session, ce qui n'est en général pas souhaité. La directive
3e6b8c7840a46cdccd46b7a4b1902c2bc82f6cc2gryzor <directive>CacheIgnoreURLSessionIdentifiers</directive> permet de
3e6b8c7840a46cdccd46b7a4b1902c2bc82f6cc2gryzor définir une liste d'identifiants qui seront supprimés de la clé
3e6b8c7840a46cdccd46b7a4b1902c2bc82f6cc2gryzor utilisée pour identifier une entité dans le cache, de façon à ce que
3e6b8c7840a46cdccd46b7a4b1902c2bc82f6cc2gryzor les ressources ne soient pas stockées séparément pour chaque
3e6b8c7840a46cdccd46b7a4b1902c2bc82f6cc2gryzor <p><code>CacheIgnoreURLSessionIdentifiers None</code> vide la liste
3e6b8c7840a46cdccd46b7a4b1902c2bc82f6cc2gryzor des identifiants ignorés. Autrement, chaque identifiant spécifié est
3e6b8c7840a46cdccd46b7a4b1902c2bc82f6cc2gryzor ajouté à la liste.</p>
3e6b8c7840a46cdccd46b7a4b1902c2bc82f6cc2gryzor CacheIgnoreURLSessionIdentifiers jsessionid
e2f05529a1835546e17527f56074c023e6a47366lgentis </highlight>
3e6b8c7840a46cdccd46b7a4b1902c2bc82f6cc2gryzor CacheIgnoreURLSessionIdentifiers None
e2f05529a1835546e17527f56074c023e6a47366lgentis </highlight>
3e6b8c7840a46cdccd46b7a4b1902c2bc82f6cc2gryzor</directivesynopsis>
3016c72ae8173bcfc0989ff1b297d4f27f445108lgentis<directivesynopsis>
3016c72ae8173bcfc0989ff1b297d4f27f445108lgentis<description>Tente de mettre en cache les réponses que le serveur
3016c72ae8173bcfc0989ff1b297d4f27f445108lgentisconsidère comme arrivées à expiration</description>
3016c72ae8173bcfc0989ff1b297d4f27f445108lgentis<contextlist><context>server config</context><context>virtual host</context>
3016c72ae8173bcfc0989ff1b297d4f27f445108lgentis<context>directory</context><context>.htaccess</context>
3016c72ae8173bcfc0989ff1b297d4f27f445108lgentis</contextlist>
3016c72ae8173bcfc0989ff1b297d4f27f445108lgentis <p>Depuis la version 2.2.4, les réponses qui sont arrivées à
3016c72ae8173bcfc0989ff1b297d4f27f445108lgentis expiration ne sont pas stockées dans le cache. La directive
3016c72ae8173bcfc0989ff1b297d4f27f445108lgentis <directive>CacheStoreExpired</directive> permet de modifier ce
3016c72ae8173bcfc0989ff1b297d4f27f445108lgentis comportement. Avec <directive>CacheStoreExpired</directive> On, le
3016c72ae8173bcfc0989ff1b297d4f27f445108lgentis serveur tente de mettre en cache la ressource si elle est périmée.
3016c72ae8173bcfc0989ff1b297d4f27f445108lgentis Les requêtes suivantes vont déclencher une requête si-modifié-depuis
3016c72ae8173bcfc0989ff1b297d4f27f445108lgentis de la part du serveur d'origine, et la réponse sera renvoyée à
3016c72ae8173bcfc0989ff1b297d4f27f445108lgentis partir du cache si la ressource d'arrière-plan n'a pas été modifiée.</p>
3016c72ae8173bcfc0989ff1b297d4f27f445108lgentis CacheStoreExpired On
e2f05529a1835546e17527f56074c023e6a47366lgentis </highlight>
3016c72ae8173bcfc0989ff1b297d4f27f445108lgentis</directivesynopsis>
3e6b8c7840a46cdccd46b7a4b1902c2bc82f6cc2gryzor<directivesynopsis>
3e6b8c7840a46cdccd46b7a4b1902c2bc82f6cc2gryzor<description>Tente de mettre en cache des réponses que le serveur a
3e6b8c7840a46cdccd46b7a4b1902c2bc82f6cc2gryzormarquées comme privées</description>
3e6b8c7840a46cdccd46b7a4b1902c2bc82f6cc2gryzor<contextlist><context>server config</context><context>virtual host</context>
3016c72ae8173bcfc0989ff1b297d4f27f445108lgentis<context>directory</context><context>.htaccess</context>
3e6b8c7840a46cdccd46b7a4b1902c2bc82f6cc2gryzor</contextlist>
3e6b8c7840a46cdccd46b7a4b1902c2bc82f6cc2gryzor <p>Normalement, les réponse comportant un en-tête Cache-Control:
3e6b8c7840a46cdccd46b7a4b1902c2bc82f6cc2gryzor dont la valeur est private ne seront pas stockées dans le cache. La
3e6b8c7840a46cdccd46b7a4b1902c2bc82f6cc2gryzor directive <directive>CacheStorePrivate</directive> permet de
3e6b8c7840a46cdccd46b7a4b1902c2bc82f6cc2gryzor modifier ce comportement. Si
3e6b8c7840a46cdccd46b7a4b1902c2bc82f6cc2gryzor <directive>CacheStorePrivate</directive> est définie à On, le
3e6b8c7840a46cdccd46b7a4b1902c2bc82f6cc2gryzor serveur tentera de mettre la ressource en cache, même si elle
dfb30ad72e3edf034d86c44c31ad9c8b1c41f178lgentis contient un en-tête private.</p>
3e6b8c7840a46cdccd46b7a4b1902c2bc82f6cc2gryzor CacheStorePrivate On
e2f05529a1835546e17527f56074c023e6a47366lgentis </highlight>
3e6b8c7840a46cdccd46b7a4b1902c2bc82f6cc2gryzor Cette directive autorise la mise en cache même si le serveur
3e6b8c7840a46cdccd46b7a4b1902c2bc82f6cc2gryzor indique que la ressource ne doit pas être mise en cache. Elle
3e6b8c7840a46cdccd46b7a4b1902c2bc82f6cc2gryzor n'est de ce fait appropriée que dans le cas d'un cache
3e6b8c7840a46cdccd46b7a4b1902c2bc82f6cc2gryzor 'privé'.
3e6b8c7840a46cdccd46b7a4b1902c2bc82f6cc2gryzor<seealso><directive module="mod_cache">CacheIgnoreCacheControl</directive></seealso>
3e6b8c7840a46cdccd46b7a4b1902c2bc82f6cc2gryzor<seealso><directive module="mod_cache">CacheStoreNoStore</directive></seealso>
3e6b8c7840a46cdccd46b7a4b1902c2bc82f6cc2gryzor</directivesynopsis>
3e6b8c7840a46cdccd46b7a4b1902c2bc82f6cc2gryzor<directivesynopsis>
3e6b8c7840a46cdccd46b7a4b1902c2bc82f6cc2gryzor<description>Tente de mettre en cache les requêtes ou réponses dont
3e6b8c7840a46cdccd46b7a4b1902c2bc82f6cc2gryzorl'entête Cache-Control: a pour valeur no-store.</description>
3e6b8c7840a46cdccd46b7a4b1902c2bc82f6cc2gryzor<contextlist><context>server config</context><context>virtual host</context>
3016c72ae8173bcfc0989ff1b297d4f27f445108lgentis<context>directory</context><context>.htaccess</context>
3e6b8c7840a46cdccd46b7a4b1902c2bc82f6cc2gryzor</contextlist>
3e6b8c7840a46cdccd46b7a4b1902c2bc82f6cc2gryzor <p>Normalement, les requêtes ou réponses dont l'en-tête
3e6b8c7840a46cdccd46b7a4b1902c2bc82f6cc2gryzor Cache-Control: a pour valeur no-store ne sont pas stockées dans le
ef2866ecdf4b74d8666fcb55833214f7496bbb35lgentis cache. La directive <directive>CacheStoreNoStore</directive> permet
3e6b8c7840a46cdccd46b7a4b1902c2bc82f6cc2gryzor de modifier ce comportement. Si
ef2866ecdf4b74d8666fcb55833214f7496bbb35lgentis <directive>CacheStoreNoStore</directive> est définie à On, le
3e6b8c7840a46cdccd46b7a4b1902c2bc82f6cc2gryzor serveur tente de mettre la ressource en cache même si elle contient
dfb30ad72e3edf034d86c44c31ad9c8b1c41f178lgentis un en-tête no-store.</p>
3e6b8c7840a46cdccd46b7a4b1902c2bc82f6cc2gryzor CacheStoreNoStore On
e2f05529a1835546e17527f56074c023e6a47366lgentis </highlight>
3e6b8c7840a46cdccd46b7a4b1902c2bc82f6cc2gryzor Selon la RFC 2616, la valeur d'en-tête no-store est censée
3e6b8c7840a46cdccd46b7a4b1902c2bc82f6cc2gryzor "prévenir la suppression ou la rétention par inadvertance
3e6b8c7840a46cdccd46b7a4b1902c2bc82f6cc2gryzor d'informations sensibles (par exemple, sur des bandes de
3e6b8c7840a46cdccd46b7a4b1902c2bc82f6cc2gryzor sauvegarde)". Autrement dit, l'activation de la directive
3e6b8c7840a46cdccd46b7a4b1902c2bc82f6cc2gryzor <directive>CacheStoreNoCache</directive> pourrait provoquer le
3e6b8c7840a46cdccd46b7a4b1902c2bc82f6cc2gryzor stockage d'informations sensibles dans le cache. Vous avez donc
3e6b8c7840a46cdccd46b7a4b1902c2bc82f6cc2gryzor été prévenus.
3e6b8c7840a46cdccd46b7a4b1902c2bc82f6cc2gryzor<seealso><directive module="mod_cache">CacheIgnoreCacheControl</directive></seealso>
3e6b8c7840a46cdccd46b7a4b1902c2bc82f6cc2gryzor<seealso><directive module="mod_cache">CacheStorePrivate</directive></seealso>
3e6b8c7840a46cdccd46b7a4b1902c2bc82f6cc2gryzor</directivesynopsis>
3e6b8c7840a46cdccd46b7a4b1902c2bc82f6cc2gryzor<directivesynopsis>
3e6b8c7840a46cdccd46b7a4b1902c2bc82f6cc2gryzor<description>Active la protection contre les tempêtes de requêtes.</description>
3e6b8c7840a46cdccd46b7a4b1902c2bc82f6cc2gryzor<contextlist><context>server config</context><context>virtual host</context>
3e6b8c7840a46cdccd46b7a4b1902c2bc82f6cc2gryzor</contextlist>
3e6b8c7840a46cdccd46b7a4b1902c2bc82f6cc2gryzor <p>La directive <directive>CacheLock</directive> active la protection
3e6b8c7840a46cdccd46b7a4b1902c2bc82f6cc2gryzor contre les tempêtes de requêtes pour l'espace d'adressage donné.</p>
3e6b8c7840a46cdccd46b7a4b1902c2bc82f6cc2gryzor <p>La configuration minimale pour activer le verrouillage contre les
76f2a8a1a43991bf3b20227cafb4f3d7e108c567lgentis tempêtes de requêtes dans le répertoire par
76f2a8a1a43991bf3b20227cafb4f3d7e108c567lgentis défaut des fichiers run-time est
3e6b8c7840a46cdccd46b7a4b1902c2bc82f6cc2gryzor la suivante :</p>
e2f05529a1835546e17527f56074c023e6a47366lgentis# Active le verrouillage du cache
e2f05529a1835546e17527f56074c023e6a47366lgentisCacheLock on
e2f05529a1835546e17527f56074c023e6a47366lgentis </highlight>
76f2a8a1a43991bf3b20227cafb4f3d7e108c567lgentis <p>Les verrous sont des fichiers vides qui n'existent que pour les
76f2a8a1a43991bf3b20227cafb4f3d7e108c567lgentis URLs présentes dont le contenu est périmé ; ils consomment dont bien
76f2a8a1a43991bf3b20227cafb4f3d7e108c567lgentis moins de ressources que le cache disque traditionnel.</p>
3e6b8c7840a46cdccd46b7a4b1902c2bc82f6cc2gryzor</directivesynopsis>
3e6b8c7840a46cdccd46b7a4b1902c2bc82f6cc2gryzor<directivesynopsis>
3e6b8c7840a46cdccd46b7a4b1902c2bc82f6cc2gryzor<description>Définit le répertoire des verrous.</description>
3e6b8c7840a46cdccd46b7a4b1902c2bc82f6cc2gryzor<syntax>CacheLockPath <var>répertoire</var></syntax>
3e6b8c7840a46cdccd46b7a4b1902c2bc82f6cc2gryzor<contextlist><context>server config</context><context>virtual host</context>
3e6b8c7840a46cdccd46b7a4b1902c2bc82f6cc2gryzor</contextlist>
3e6b8c7840a46cdccd46b7a4b1902c2bc82f6cc2gryzor <p>La directive <directive>CacheLockPath</directive> permet de
76f2a8a1a43991bf3b20227cafb4f3d7e108c567lgentis spécifier le répertoire dans lequel les verrous sont
76f2a8a1a43991bf3b20227cafb4f3d7e108c567lgentis créés. Si <var>répertoire</var> n'est pas un
76f2a8a1a43991bf3b20227cafb4f3d7e108c567lgentis chemin absolu, il sera relatif au répertoire défini par la directive
76f2a8a1a43991bf3b20227cafb4f3d7e108c567lgentis <directive module="core">DefaultRuntimeDir</directive>.</p>
3e6b8c7840a46cdccd46b7a4b1902c2bc82f6cc2gryzor</directivesynopsis>
3e6b8c7840a46cdccd46b7a4b1902c2bc82f6cc2gryzor<directivesynopsis>
3e6b8c7840a46cdccd46b7a4b1902c2bc82f6cc2gryzor<description>Définit la durée de vie maximale d'un verrou de cache.</description>
3e6b8c7840a46cdccd46b7a4b1902c2bc82f6cc2gryzor<contextlist><context>server config</context><context>virtual host</context>
3e6b8c7840a46cdccd46b7a4b1902c2bc82f6cc2gryzor</contextlist>
3e6b8c7840a46cdccd46b7a4b1902c2bc82f6cc2gryzor <p>La directive <directive>CacheLockMaxAge</directive> permet de
3e6b8c7840a46cdccd46b7a4b1902c2bc82f6cc2gryzor spécifier la durée de vie maximale d'un verrou de cache.</p>
3e6b8c7840a46cdccd46b7a4b1902c2bc82f6cc2gryzor <p>Un verrou plus ancien que cette valeur exprimée en secondes sera
3e6b8c7840a46cdccd46b7a4b1902c2bc82f6cc2gryzor ignoré, et la prochaine requête entrante sera alors en mesure de
3e6b8c7840a46cdccd46b7a4b1902c2bc82f6cc2gryzor recréer le verrou. Ce mécanisme permet d'éviter les mises à jour trop
3e6b8c7840a46cdccd46b7a4b1902c2bc82f6cc2gryzor longues initiées par des clients lents.</p>
3e6b8c7840a46cdccd46b7a4b1902c2bc82f6cc2gryzor</directivesynopsis>
3e6b8c7840a46cdccd46b7a4b1902c2bc82f6cc2gryzor<directivesynopsis>
3e6b8c7840a46cdccd46b7a4b1902c2bc82f6cc2gryzor <description>Exécute le cache à partir d'un gestionnaire rapide.</description>
3e6b8c7840a46cdccd46b7a4b1902c2bc82f6cc2gryzor <contextlist><context>server config</context><context>virtual host</context>
3e6b8c7840a46cdccd46b7a4b1902c2bc82f6cc2gryzor </contextlist>
5e6dcc287b64eb58282c020e8a91a8bfb6ac0339lgentis <compatibility>Disponible à partir de la version 2.3.3 du serveur HTTP
6b779ab5be3e1a57d8e98951dc8614a312fcefa9lgentis Apache</compatibility>
3e6b8c7840a46cdccd46b7a4b1902c2bc82f6cc2gryzor module="mod_cache">CacheQuickHandler</directive> permet de contrôler
3e6b8c7840a46cdccd46b7a4b1902c2bc82f6cc2gryzor la phase au cours de laquelle la mise en cache est effectuée.</p>
3e6b8c7840a46cdccd46b7a4b1902c2bc82f6cc2gryzor <p>Avec la configuration par défaut, le cache agit au cours de la
3e6b8c7840a46cdccd46b7a4b1902c2bc82f6cc2gryzor phase du gestionnaire rapide. Cette phase court-circuite la majorité
3e6b8c7840a46cdccd46b7a4b1902c2bc82f6cc2gryzor des traitements du serveur, et constitue le mode d'opération le plus
3e6b8c7840a46cdccd46b7a4b1902c2bc82f6cc2gryzor performant pour un serveur typique. Le cache
3e6b8c7840a46cdccd46b7a4b1902c2bc82f6cc2gryzor <strong>s'incruste</strong> devant le serveur, et la majorité des
3e6b8c7840a46cdccd46b7a4b1902c2bc82f6cc2gryzor traitements du serveur est court-circuitée.</p>
3e6b8c7840a46cdccd46b7a4b1902c2bc82f6cc2gryzor <p>Lorsque cette directive est définie à off, le cache agit comme un
3e6b8c7840a46cdccd46b7a4b1902c2bc82f6cc2gryzor gestionnaire normal, et est concerné par toutes les phases de
3e6b8c7840a46cdccd46b7a4b1902c2bc82f6cc2gryzor traitement d'une requête. Bien que ce mode soit moins performant que
3e6b8c7840a46cdccd46b7a4b1902c2bc82f6cc2gryzor le mode par défaut, il permet d'utiliser le cache dans les cas où un
3e6b8c7840a46cdccd46b7a4b1902c2bc82f6cc2gryzor traitement complet de la requête est nécessaire, comme par exemple
3e6b8c7840a46cdccd46b7a4b1902c2bc82f6cc2gryzor lorsque le contenu est soumis à autorisation.</p>
e2f05529a1835546e17527f56074c023e6a47366lgentis# Exécute le cache comme un gestionnaire normal
e2f05529a1835546e17527f56074c023e6a47366lgentisCacheQuickHandler off
e2f05529a1835546e17527f56074c023e6a47366lgentis </highlight>
3e6b8c7840a46cdccd46b7a4b1902c2bc82f6cc2gryzor <p>Lorsque le gestionnaire rapide est désactivé, l'administrateur a
3e6b8c7840a46cdccd46b7a4b1902c2bc82f6cc2gryzor aussi la possibilité de choisir avec précision le point de la chaîne
3e6b8c7840a46cdccd46b7a4b1902c2bc82f6cc2gryzor de filtrage où la mise en cache sera effectuée, en utilisant le
e2f05529a1835546e17527f56074c023e6a47366lgentis# Mise en cache du contenu avant l'intervention de mod_include et
e2f05529a1835546e17527f56074c023e6a47366lgentis # mod_deflate
e2f05529a1835546e17527f56074c023e6a47366lgentisCacheQuickHandler off
e2f05529a1835546e17527f56074c023e6a47366lgentisAddOutputFilterByType CACHE;INCLUDES;DEFLATE text/html
e2f05529a1835546e17527f56074c023e6a47366lgentis </highlight>
3e6b8c7840a46cdccd46b7a4b1902c2bc82f6cc2gryzor <p>Si le filtre CACHE est spécifié plusieurs fois, c'est la dernière
3e6b8c7840a46cdccd46b7a4b1902c2bc82f6cc2gryzor instance qui sera prise en compte.</p>
3e6b8c7840a46cdccd46b7a4b1902c2bc82f6cc2gryzor</directivesynopsis>
3016c72ae8173bcfc0989ff1b297d4f27f445108lgentis<directivesynopsis>
3016c72ae8173bcfc0989ff1b297d4f27f445108lgentis<description>Ajoute un en-tête X-Cache à la réponse.</description>
3016c72ae8173bcfc0989ff1b297d4f27f445108lgentis</contextlist>
3016c72ae8173bcfc0989ff1b297d4f27f445108lgentis<compatibility>Disponible depuis la version 2.3.9 d'Apache</compatibility>
3016c72ae8173bcfc0989ff1b297d4f27f445108lgentis module="mod_cache">CacheHeader</directive> est définie à on, un
3016c72ae8173bcfc0989ff1b297d4f27f445108lgentis en-tête <strong>X-Cache</strong> est ajouté à la réponse et contient
3016c72ae8173bcfc0989ff1b297d4f27f445108lgentis l'état du cache pour cette dernière. Si le gestionnaire normal est
9f47982d4f9350397f1f62f04f1ba744ad5b6fa5lgentis utilisé, cette directive peut se situer dans une section
9f47982d4f9350397f1f62f04f1ba744ad5b6fa5lgentis <directive type="section" module="core">Directory</directive> ou
9f47982d4f9350397f1f62f04f1ba744ad5b6fa5lgentis <directive type="section" module="core">Location</directive>. Si c'est
3016c72ae8173bcfc0989ff1b297d4f27f445108lgentis gestionnaire rapide qui est utilisé, elle doit se situer dans un
3016c72ae8173bcfc0989ff1b297d4f27f445108lgentis contexte de serveur principal ou de serveur virtuel, sinon elle sera
3016c72ae8173bcfc0989ff1b297d4f27f445108lgentis ignorée.</p>
3016c72ae8173bcfc0989ff1b297d4f27f445108lgentis <dt><strong>HIT</strong></dt><dd>Le contenu était à jour et a été
3016c72ae8173bcfc0989ff1b297d4f27f445108lgentis servi depuis le cache.</dd>
3016c72ae8173bcfc0989ff1b297d4f27f445108lgentis <dt><strong>REVALIDATE</strong></dt><dd>Le contenu était périmé, a
3016c72ae8173bcfc0989ff1b297d4f27f445108lgentis été mis à jour, puis a été servi depuis le cache.</dd>
3016c72ae8173bcfc0989ff1b297d4f27f445108lgentis <dt><strong>MISS</strong></dt><dd>Le contenu n'a pas été servi
3016c72ae8173bcfc0989ff1b297d4f27f445108lgentis depuis le cache, mais directement depuis le serveur demandé.</dd>
e2f05529a1835546e17527f56074c023e6a47366lgentis# Active l'en-tête X-Cache
e2f05529a1835546e17527f56074c023e6a47366lgentisCacheHeader on
e2f05529a1835546e17527f56074c023e6a47366lgentis </highlight>
e2f05529a1835546e17527f56074c023e6a47366lgentis X-Cache: HIT from localhost
e2f05529a1835546e17527f56074c023e6a47366lgentis </highlight>
3016c72ae8173bcfc0989ff1b297d4f27f445108lgentis</directivesynopsis>
3016c72ae8173bcfc0989ff1b297d4f27f445108lgentis<directivesynopsis>
3016c72ae8173bcfc0989ff1b297d4f27f445108lgentis<description>Ajoute un en-tête X-Cache-Detail à la réponse.</description>
3016c72ae8173bcfc0989ff1b297d4f27f445108lgentis</contextlist>
3016c72ae8173bcfc0989ff1b297d4f27f445108lgentis<compatibility>Disponible depuis la version 2.3.9 d'Apache</compatibility>
3016c72ae8173bcfc0989ff1b297d4f27f445108lgentis module="mod_cache">CacheDetailHeader</directive> est définie à on, un
3016c72ae8173bcfc0989ff1b297d4f27f445108lgentis en-tête <strong>X-Cache-Detail</strong> est ajouté à la réponse et
3016c72ae8173bcfc0989ff1b297d4f27f445108lgentis contient les raisons précises d'une décision d'utilisation du cache
3016c72ae8173bcfc0989ff1b297d4f27f445108lgentis vis à vis de cette dernière.</p>
3016c72ae8173bcfc0989ff1b297d4f27f445108lgentis <p>Ceci peut s'avérer utile au cours du développement de services
3016c72ae8173bcfc0989ff1b297d4f27f445108lgentis RESTful mis en cache pour obtenir des informations supplémentaires à
3016c72ae8173bcfc0989ff1b297d4f27f445108lgentis propos des décisions vis à vis du cache écrites dans les en-têtes de
3016c72ae8173bcfc0989ff1b297d4f27f445108lgentis la réponse. Il est ainsi possible de vérifier si
3016c72ae8173bcfc0989ff1b297d4f27f445108lgentis <code>Cache-Control</code> et d'autres en-têtes ont été correctement
3016c72ae8173bcfc0989ff1b297d4f27f445108lgentis utilisés par le service et le client.</p>
3016c72ae8173bcfc0989ff1b297d4f27f445108lgentis <p>Si le gestionnaire normal est utilisé, cette directive peut se
9f47982d4f9350397f1f62f04f1ba744ad5b6fa5lgentis module="core">Directory</directive> ou <directive type="section"
9f47982d4f9350397f1f62f04f1ba744ad5b6fa5lgentis module="core">Location</directive>. Si c'est le gestionnaire
3016c72ae8173bcfc0989ff1b297d4f27f445108lgentis rapide qui est utilisé, elle doit se situer dans un contexte de
3016c72ae8173bcfc0989ff1b297d4f27f445108lgentis serveur principal ou de serveur virtuel, sinon elle sera ignorée.</p>
e2f05529a1835546e17527f56074c023e6a47366lgentis# Active l'en-tête X-Cache-Detail
e2f05529a1835546e17527f56074c023e6a47366lgentisCacheDetailHeader on
e2f05529a1835546e17527f56074c023e6a47366lgentis </highlight>
3016c72ae8173bcfc0989ff1b297d4f27f445108lgentis X-Cache-Detail: "conditional cache hit: entity refreshed" from localhost<br />
3016c72ae8173bcfc0989ff1b297d4f27f445108lgentis</directivesynopsis>
3016c72ae8173bcfc0989ff1b297d4f27f445108lgentis<directivesynopsis>
3016c72ae8173bcfc0989ff1b297d4f27f445108lgentis<description>Remplace l'URL de base des clés du cache mandatées en
3016c72ae8173bcfc0989ff1b297d4f27f445108lgentisinverse</description>
3016c72ae8173bcfc0989ff1b297d4f27f445108lgentis<default>CacheKeyBaseURL http://example.com</default>
3016c72ae8173bcfc0989ff1b297d4f27f445108lgentis</contextlist>
3016c72ae8173bcfc0989ff1b297d4f27f445108lgentis<compatibility>Disponible depuis la version 2.3.9 d'Apache</compatibility>
3016c72ae8173bcfc0989ff1b297d4f27f445108lgentis module="mod_cache">CacheKeyBaseURL</directive> est utilisée, l'URL
3016c72ae8173bcfc0989ff1b297d4f27f445108lgentis spécifiée sera utilisée comme URL de base pour calculer l'URL des clés
3016c72ae8173bcfc0989ff1b297d4f27f445108lgentis du cache dans la configuration du mandataire inverse. Par défaut,
3016c72ae8173bcfc0989ff1b297d4f27f445108lgentis c'est le protocole/nom d'hôte/port du serveur virtuel courant qui sera
3016c72ae8173bcfc0989ff1b297d4f27f445108lgentis utilisé pour construire la clé de cache. Dans le cas d'un cluster de
3016c72ae8173bcfc0989ff1b297d4f27f445108lgentis machines, si toutes les entrées du cache doivent posséder la même clé,
3016c72ae8173bcfc0989ff1b297d4f27f445108lgentis cette directive permet de spécifier une nouvelle URL de base.</p>
e2f05529a1835546e17527f56074c023e6a47366lgentis# Remplace l'URL de base de la clé de cache.
e2f05529a1835546e17527f56074c023e6a47366lgentis </highlight>
3016c72ae8173bcfc0989ff1b297d4f27f445108lgentis <note type="warning">Prenez garde en définissant cette directive. Si
3016c72ae8173bcfc0989ff1b297d4f27f445108lgentis deux serveurs virtuels distincts possèdent accidentellement la même
3016c72ae8173bcfc0989ff1b297d4f27f445108lgentis URL de base, les entrées en provenance d'un serveur virtuel seront
3016c72ae8173bcfc0989ff1b297d4f27f445108lgentis servies par l'autre.</note>
3016c72ae8173bcfc0989ff1b297d4f27f445108lgentis</directivesynopsis>
3016c72ae8173bcfc0989ff1b297d4f27f445108lgentis<directivesynopsis>
3016c72ae8173bcfc0989ff1b297d4f27f445108lgentis<description>Sert du contenu non à jour à la place de réponses 5xx.</description>
3016c72ae8173bcfc0989ff1b297d4f27f445108lgentis</contextlist>
3016c72ae8173bcfc0989ff1b297d4f27f445108lgentis<compatibility>Disponible depuis la version 2.3.9 d'Apache</compatibility>
3016c72ae8173bcfc0989ff1b297d4f27f445108lgentis module="mod_cache">CacheStaleOnError</directive> est définie à on, et
3016c72ae8173bcfc0989ff1b297d4f27f445108lgentis si des données non mises à jour sont disponibles dans le cache, ce
3016c72ae8173bcfc0989ff1b297d4f27f445108lgentis dernier renverra ces données, plutôt qu'une éventuelle réponse 5xx en
3016c72ae8173bcfc0989ff1b297d4f27f445108lgentis provenance du serveur d'arrière-plan. Alors que l'en-tête
3016c72ae8173bcfc0989ff1b297d4f27f445108lgentis Cache-Control envoyé par les clients sera respecté, et que les clients
3016c72ae8173bcfc0989ff1b297d4f27f445108lgentis recevront donc dans ce cas la réponse 5xx brute à leur requête, cette
3016c72ae8173bcfc0989ff1b297d4f27f445108lgentis réponse 5xx renvoyée au client n'invalidera pas le contenu dans le
3016c72ae8173bcfc0989ff1b297d4f27f445108lgentis cache. </p>
e2f05529a1835546e17527f56074c023e6a47366lgentis# Sert des données non mises à jour en cas d'erreur.
e2f05529a1835546e17527f56074c023e6a47366lgentisCacheStaleOnError on
e2f05529a1835546e17527f56074c023e6a47366lgentis </highlight>
3016c72ae8173bcfc0989ff1b297d4f27f445108lgentis</directivesynopsis>
3e6b8c7840a46cdccd46b7a4b1902c2bc82f6cc2gryzor</modulesynopsis>