Serveur Apache HTTP Version 2.4
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 |
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.
mod_cache
doit �tre charg� avant
mod_cache_disk
pour que ce dernier puisse
fonctionner.
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.
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.
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.
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
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
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
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
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