<-
Apache > Serveur HTTP > Documentation > Version 2.4 > Modules

Module Apache mod_cache_disk

Langues Disponibles:  en  |  fr  |  ja  |  ko 

Description:Module de stockage sur disque pour le filtre de mise en cache HTTP.
Statut:Extension
Identificateur�de�Module:cache_disk_module
Fichier�Source:mod_cache_disk.c

Sommaire

mod_cache_disk impl�mente un gestionnaire de stockage sur disque pour le module mod_cache.

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.

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.

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.

L'utilitaire htcacheclean 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.

Note :

mod_cache doit �tre charg� avant mod_cache_disk pour que ce dernier puisse fonctionner.

Note :

Lorsque la plate-forme la supporte, et si elle est activ�e via la directive EnableSendfile, mod_cache_disk utilise la fonctionnalit� sendfile pour servir les fichiers � partir du cache. Cependant, mod_cache_disk ignore la configuration de la directive EnableSendfile 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.

Directives

Voir aussi

top

CacheDirLength Directive

Description:Le nombre de caract�res des noms des sous-r�pertoires
Syntaxe:CacheDirLength longueur
D�faut:CacheDirLength 2
Contexte:configuration du serveur, serveur virtuel
Statut:Extension
Module:mod_cache_disk

la directive CacheDirLength 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 CacheDirLevels pour d�terminer une structure approximative de la hi�rarchie de cache.

Une valeur haute pour CacheDirLength combin�e avec une valeur basse pour CacheDirLevels g�n�rera une hi�rarchie relativement peu profonde, avec un grand nombre de sous-r�pertoires � chaque niveau.

La valeur du produit CacheDirLevels * CacheDirLength ne doit pas d�passer 20.

top

CacheDirLevels Directive

Description:Le nombre de niveaux de sous-r�pertoires que comportera le cache.
Syntaxe:CacheDirLevels niveaux
D�faut:CacheDirLevels 2
Contexte:configuration du serveur, serveur virtuel
Statut:Extension
Module:mod_cache_disk

La directive CacheDirLevels 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 CacheRoot.

Une valeur haute pour CacheDirLevels combin�e avec une valeur basse pour CacheDirLength g�n�rera une arborescence tr�s d�velopp�e, avec un petit nombre de sous-r�pertoires � chaque niveau.

La valeur du produit CacheDirLevels * CacheDirLength ne doit pas d�passer 20.

top

CacheMaxFileSize Directive

Description:>La taille maximale (en octets) d'un document pour pouvoir �tre stock� dans le cache
Syntaxe:CacheMaxFileSize octets
D�faut:CacheMaxFileSize 1000000
Contexte:configuration du serveur, serveur virtuel, r�pertoire, .htaccess
Statut:Extension
Module:mod_cache_disk

La directive CacheMaxFileSize 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.

      CacheMaxFileSize 64000
    
top

CacheMinFileSize Directive

Description:La taille minimale (en octets) d'un document pour pouvoir �tre stock� dans le cache
Syntaxe:CacheMinFileSize octets
D�faut:CacheMinFileSize 1
Contexte:configuration du serveur, serveur virtuel, r�pertoire, .htaccess
Statut:Extension
Module:mod_cache_disk

La directive CacheMinFileSize 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.

      CacheMinFileSize 64
    
top

CacheReadSize Directive

Description:La quantit� minimale (en octets) de donn�es � lire et � mettre en cache avant de les envoyer au client
Syntaxe:CacheReadSize octets
D�faut:CacheReadSize 0
Contexte:configuration du serveur, serveur virtuel, r�pertoire, .htaccess
Statut:Extension
Module:mod_cache_disk

La directive CacheReadSize 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.

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.

      CacheReadSize 102400
    
top

CacheReadTime Directive

Description:Le temps minimum (en millisecondes) qui doit s'�couler avant d'envoyer les donn�es au client
Syntaxe:CacheReadTime millisecondes
D�faut:CacheReadTime 0
Contexte:configuration du serveur, serveur virtuel, r�pertoire, .htaccess
Statut:Extension
Module:mod_cache_disk

La directive CacheReadTime 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.

La valeur par d�faut z�ro d�sactive cette option.

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 CacheReadSize, 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.

      CacheReadTime 1000
    
top

CacheRoot Directive

Description:La racine du r�pertoire dans lequel les fichiers du cache seront stock�s
Syntaxe:CacheRoot r�pertoire
Contexte:configuration du serveur, serveur virtuel
Statut:Extension
Module:mod_cache_disk

La directive CacheRoot permet de d�finir le nom du r�pertoire sur disque qui contiendra les fichiers du cache. Si le module mod_cache_disk a �t� charg� ou compil� dans le serveur Apache, cette directive doit �tre d�finie. L'absence de d�finition de la directive CacheRoot provoquera une erreur de traitement du fichier de configuration. Les directives CacheDirLevels et CacheDirLength permettent de d�finir la structure des sous-r�pertoires du r�pertoire racine sp�cifi�.

      CacheRoot c:/cacheroot
    

Langues Disponibles:  en  |  fr  |  ja  |  ko 

top

Commentaires

Notice:
This is not a Q&A section. Comments placed here should be pointed towards suggestions on improving the documentation or server, and may be removed again by our moderators if they are either implemented or considered invalid/off-topic. Questions on how to manage the Apache HTTP Server should be directed at either our IRC channel, #httpd, on Freenode, or sent to our mailing lists.