docs/manual/mod/mod_cache_disk.xml.fr

<?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>