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