mirror of
https://github.com/apache/httpd.git
synced 2025-04-18 22:24:07 +03:00
3f39775121
git-svn-id: https://svn.apache.org/repos/asf/httpd/httpd/trunk@1331786 13f79535-47bb-0310-9956-ffa450edef68
278 lines
12 KiB
Plaintext
278 lines
12 KiB
Plaintext
<?xml version="1.0"?>
|
|
<!DOCTYPE modulesynopsis SYSTEM "../style/modulesynopsis.dtd">
|
|
<?xml-stylesheet type="text/xsl" href="../style/manual.fr.xsl"?>
|
|
<!-- English Revision: 1330964 -->
|
|
<!-- French translation : Lucien GENTIS -->
|
|
<!-- Reviewed by : Vincent Deffontaines -->
|
|
|
|
<!--
|
|
Licensed to the Apache Software Foundation (ASF) under one or more
|
|
contributor license agreements. See the NOTICE file distributed with
|
|
this work for additional information regarding copyright ownership.
|
|
The ASF licenses this file to You under the Apache License, Version 2.0
|
|
(the "License"); you may not use this file except in compliance with
|
|
the License. You may obtain a copy of the License at
|
|
|
|
http://www.apache.org/licenses/LICENSE-2.0
|
|
|
|
Unless required by applicable law or agreed to in writing, software
|
|
distributed under the License is distributed on an "AS IS" BASIS,
|
|
WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
|
|
See the License for the specific language governing permissions and
|
|
limitations under the License.
|
|
-->
|
|
|
|
<modulesynopsis metafile="mod_cache_disk.xml.meta">
|
|
|
|
<name>mod_cache_disk</name>
|
|
<description>Module de stockage sur disque pour le filtre de mise en
|
|
cache HTTP.</description>
|
|
<status>Extension</status>
|
|
<sourcefile>mod_cache_disk.c</sourcefile>
|
|
<identifier>cache_disk_module</identifier>
|
|
|
|
<summary>
|
|
<p><module>mod_cache_disk</module> implémente un gestionnaire de
|
|
stockage sur disque pour le module <module>mod_cache</module>.</p>
|
|
|
|
<p>Les en-têtes et corps des réponses mises en cache sont stockés
|
|
séparément sur le disque, dans une structure de répertoires basée
|
|
sur le condensé md5 de l'URL mise en cache.</p>
|
|
|
|
<p>Plusieurs réponses au contenu négocié peuvent être stockées en
|
|
même temps, mais la mise en cache de contenus partiels n'est pas
|
|
supportée actuellement par ce module.</p>
|
|
|
|
<p>Les mises à jour atomiques du cache pour les fichiers d'en-tête
|
|
et de corps peuvent être effectuées sans verrouillage en
|
|
enregistrant les numéros d'inode et de périphérique du fichier de
|
|
corps dans le fichier d'en-tête. Ceci implique que les entrées du
|
|
cache déplacées manuellement dans le cache seront ignorées.</p>
|
|
|
|
<p>L'utilitaire <program>htcacheclean</program> permet de lister et
|
|
de supprimer les URLs du cache, ou de maintenir le cache en deçà de
|
|
certaines limites de taille et/ou de nombre d'inodes. L'utilitaire
|
|
peut être exécuté à la demande, ou automatiquement pour assurer un
|
|
contrôle continu des tailles des répertoires.</p>
|
|
|
|
<note><title>Note :</title>
|
|
<p><module>mod_cache</module> doit être chargé avant
|
|
<module>mod_cache_disk</module> pour que ce dernier puisse
|
|
fonctionner.</p>
|
|
</note>
|
|
<note><title>Note :</title>
|
|
<p>Lorsque la plate-forme la supporte, et si elle est activée via la
|
|
directive <directive module="core">EnableSendfile</directive>,
|
|
<module>mod_cache_disk</module> utilise la fonctionnalité sendfile
|
|
pour servir les fichiers à partir du cache. Cependant,
|
|
<module>mod_cache_disk</module> ignore la configuration de la
|
|
directive <directive module="core">EnableSendfile</directive> dans
|
|
un contexte de répertoire ou de fichier .htaccess, car le module ne
|
|
dispose pas des définitions correspondantes lorsque la requête est
|
|
servie depuis le cache.</p>
|
|
</note>
|
|
</summary>
|
|
<seealso><module>mod_cache</module></seealso>
|
|
<seealso><module>mod_cache_socache</module></seealso>
|
|
<seealso><a href="../caching.html">Guide de la mise en cache</a></seealso>
|
|
|
|
<directivesynopsis>
|
|
<name>CacheRoot</name>
|
|
<description>La racine du répertoire dans lequel les fichiers du cache
|
|
seront stockés</description>
|
|
<syntax>CacheRoot <var>répertoire</var></syntax>
|
|
<contextlist><context>server config</context><context>virtual host</context>
|
|
</contextlist>
|
|
|
|
<usage>
|
|
<p>La directive <directive>CacheRoot</directive> permet de définir
|
|
le nom du répertoire sur disque qui contiendra les fichiers du
|
|
cache. Si le module <module>mod_cache_disk</module> a été chargé ou
|
|
compilé dans le serveur Apache, cette directive <em>doit</em> être
|
|
définie. L'absence de définition de la directive
|
|
<directive>CacheRoot</directive> provoquera une erreur de traitement
|
|
du fichier de configuration. Les directives <directive
|
|
module="mod_cache_disk">CacheDirLevels</directive> et <directive
|
|
module="mod_cache_disk">CacheDirLength</directive> permettent de
|
|
définir la structure des sous-répertoires du répertoire racine
|
|
spécifié.</p>
|
|
|
|
<highlight language="config">
|
|
CacheRoot c:/cacheroot
|
|
</highlight>
|
|
</usage>
|
|
</directivesynopsis>
|
|
|
|
<directivesynopsis>
|
|
<name>CacheDirLevels</name>
|
|
<description>Le nombre de niveaux de sous-répertoires que comportera le
|
|
cache.</description>
|
|
<syntax>CacheDirLevels <var>niveaux</var></syntax>
|
|
<default>CacheDirLevels 2</default>
|
|
<contextlist><context>server config</context><context>virtual host</context>
|
|
</contextlist>
|
|
|
|
<usage>
|
|
<p>La directive <directive>CacheDirLevels</directive> permet de
|
|
définir le nombre de niveaux de sous-répertoires que comportera le
|
|
cache. Les données du cache seront stokées au niveau correspondant
|
|
par rapport au répertoire <directive module="mod_cache_disk"
|
|
>CacheRoot</directive>.</p>
|
|
<p>Une valeur haute pour <directive>CacheDirLevels</directive>
|
|
combinée avec une valeur basse pour
|
|
<directive>CacheDirLength</directive> générera une arborescence
|
|
très développée, avec un petit nombre de sous-répertoires à chaque
|
|
niveau.</p>
|
|
|
|
<note>
|
|
<p>La valeur du produit <directive>CacheDirLevels</directive> *
|
|
<directive module="mod_cache_disk">CacheDirLength</directive> ne
|
|
doit pas dépasser 20.</p>
|
|
</note>
|
|
|
|
</usage>
|
|
</directivesynopsis>
|
|
|
|
<directivesynopsis>
|
|
<name>CacheDirLength</name>
|
|
<description>Le nombre de caractères des noms des
|
|
sous-répertoires</description>
|
|
<syntax>CacheDirLength <var>longueur</var></syntax>
|
|
<default>CacheDirLength 2</default>
|
|
<contextlist><context>server config</context><context>virtual host</context>
|
|
</contextlist>
|
|
|
|
<usage>
|
|
<p>la directive <directive>CacheDirLength</directive> permet de
|
|
définir le nombre de caractères que comportera chaque nom de
|
|
sous-répertoire de la hiérarchie du cache. On peut l'utiliser en
|
|
conjonction avec <directive>CacheDirLevels</directive> pour
|
|
déterminer une structure approximative de la hiérarchie de
|
|
cache.</p>
|
|
<p>Une valeur haute pour <directive>CacheDirLength</directive>
|
|
combinée avec une valeur basse pour
|
|
<directive>CacheDirLevels</directive> générera une hiérarchie
|
|
relativement peu profonde, avec un grand nombre de sous-répertoires
|
|
à chaque niveau.</p>
|
|
|
|
<note>
|
|
<p>La valeur du produit <directive>CacheDirLevels</directive> *
|
|
<directive module="mod_cache_disk">CacheDirLength</directive> ne
|
|
doit pas dépasser 20.</p>
|
|
</note>
|
|
|
|
</usage>
|
|
</directivesynopsis>
|
|
|
|
<directivesynopsis>
|
|
<name>CacheMinFileSize</name>
|
|
<description>La taille minimale (en octets) d'un document pour pouvoir
|
|
être stocké dans le cache</description>
|
|
<syntax>CacheMinFileSize <var>octets</var></syntax>
|
|
<default>CacheMinFileSize 1</default>
|
|
<contextlist><context>server config</context><context>virtual host</context>
|
|
<context>directory</context><context>.htaccess</context>
|
|
</contextlist>
|
|
|
|
<usage>
|
|
<p>La directive <directive>CacheMinFileSize</directive> permet de
|
|
définir la taille minimale d'un document, en octets, pour que
|
|
celui-ci puisse faire l'objet d'un stockage dans le cache.</p>
|
|
|
|
<highlight language="config">
|
|
CacheMinFileSize 64
|
|
</highlight>
|
|
</usage>
|
|
</directivesynopsis>
|
|
|
|
<directivesynopsis>
|
|
<name>CacheMaxFileSize</name>
|
|
<description>>La taille maximale (en octets) d'un document pour pouvoir
|
|
être stocké dans le cache</description>
|
|
<syntax>CacheMaxFileSize <var>octets</var></syntax>
|
|
<default>CacheMaxFileSize 1000000</default>
|
|
<contextlist><context>server config</context><context>virtual host</context>
|
|
<context>directory</context><context>.htaccess</context>
|
|
</contextlist>
|
|
|
|
<usage>
|
|
<p>La directive <directive>CacheMaxFileSize</directive> permet de
|
|
définir la taille maximale d'un document, en octets, pour que
|
|
celui-ci puisse faire l'objet d'un stockage dans le cache.</p>
|
|
|
|
<highlight language="config">
|
|
CacheMaxFileSize 64000
|
|
</highlight>
|
|
</usage>
|
|
</directivesynopsis>
|
|
<directivesynopsis>
|
|
<name>CacheReadSize</name>
|
|
<description>La quantité minimale (en octets) de données à lire et à
|
|
mettre en cache avant de les envoyer au client</description>
|
|
<syntax>CacheReadSize <var>octets</var></syntax>
|
|
<default>CacheReadSize 0</default>
|
|
<contextlist><context>server config</context>
|
|
<context>virtual host</context>
|
|
<context>directory</context>
|
|
<context>.htaccess</context>
|
|
</contextlist>
|
|
|
|
<usage>
|
|
<p>La directive <directive>CacheReadSize</directive> permet de
|
|
définir la quantité minimale de données, en octets, à lire depuis le
|
|
serveur d'arrière-plan avant de les envoyer au client. Avec la
|
|
valeur par défaut zéro, toute donnée de toutes tailles est envoyée
|
|
au client dès qu'elle est disponible. Avec une valeur non nulle, le
|
|
cache disque met en tampon au moins la quantité de données
|
|
correspondante avant d'envoyer la réponse au client. Les
|
|
performances peuvent s'en trouver améliorées lorsqu'on met en cache
|
|
du contenu en provenance d'un mandataire inverse.</p>
|
|
|
|
<p>Cette directive ne prend effet que lorsque les données sont
|
|
enregistrées dans le cache, et non lorsque les données sont servies à
|
|
partir du cache.</p>
|
|
|
|
<highlight language="config">
|
|
CacheReadSize 102400
|
|
</highlight>
|
|
</usage>
|
|
</directivesynopsis>
|
|
|
|
<directivesynopsis>
|
|
<name>CacheReadTime</name>
|
|
<description>Le temps minimum (en millisecondes) qui doit s'écouler
|
|
avant d'envoyer les données au client</description>
|
|
<syntax>CacheReadTime <var>millisecondes</var></syntax>
|
|
<default>CacheReadTime 0</default>
|
|
<contextlist><context>server config</context>
|
|
<context>virtual host</context>
|
|
<context>directory</context>
|
|
<context>.htaccess</context>
|
|
</contextlist>
|
|
|
|
<usage>
|
|
<p>La directive <directive>CacheReadTime</directive> permet de
|
|
définir le temps minimum qui doit s'écouler avant d'essayer
|
|
d'envoyer des données au client. Pendant ce temps, les données sont
|
|
mises en tampon avant de pouvoir être envoyées au client. Les
|
|
performances peuvent s'en trouver améliorées lorsqu'on met en cache
|
|
du contenu en provenance d'un mandataire inverse.</p>
|
|
|
|
<p>La valeur par défaut zéro désactive cette option.</p>
|
|
|
|
<p>Cette directive ne prend effet que lorsque les données sont
|
|
enregistrées dans le cache, et non lorsque les données sont servies à
|
|
partir du cache. Il est recommandé d'harmoniser l'utilisation de cette
|
|
directive avec celle de la directive <directive
|
|
module="mod_cache_disk">CacheReadSize</directive>, afin de s'assurer
|
|
que le serveur n'effectue pas une mise en tampon excessive au cas
|
|
où les données arriveraient plus vite que prévu.</p>
|
|
|
|
<highlight language="config">
|
|
CacheReadTime 1000
|
|
</highlight>
|
|
</usage>
|
|
</directivesynopsis>
|
|
|
|
</modulesynopsis>
|