Module Apache mod_file_cache

Utilisation de mod_file_cache

mod_file_cache g�re la mise en cache d'une liste de fichiers d�finie de mani�re statique via une des directives MMapFile ou CacheFile au niveau de la configuration du serveur principal.

Les deux directives ne sont pas support�es par toutes les plates-formes. Par exemple, Apache pour Windows ne supporte pas actuellement la directive MMapFile, alors que d'autres plates-formes, comme AIX, supportent les deux. Vous recevrez un message d'erreur dans le journal des erreurs du serveur si vous essayez d'utiliser une directive non support�e. Si vous utilisez une directive non support�e, le serveur d�marrera, mais les fichiers ne seront pas mis en cache. Sur les plates-formes qui supportent les deux directives, vous devez faire des essais afin de d�terminer quelle directive vous convient le mieux.

Directive MMapFile

La directive MMapFile du module mod_file_cache permet de transf�rer en m�moire une liste statique de fichiers � l'aide de l'appel syst�me mmap(). Cet appel syst�me est disponible sur la plupart des plates-formes de style Unix, mais pas sur toutes. Il existe parfois des limites sp�cifiques au syst�me quant � la taille et au nombre de fichiers qui peuvent �tre mmap()�s, et l'exp�rimentation est probablement la m�thode la plus simple pour d�terminer ces limites.

Ce mmap()age n'est effectu� qu'une seul fois au d�marrage ou red�marrage du serveur. Ainsi, chaque fois qu'un des fichiers charg�s en m�moire est modifi� au niveau du syst�me de fichiers, vous devez red�marrer le serveur (voir la documentation sur l'Arr�t et red�marrage). Pour bien insister sur ce point, si des fichiers sont modifi�s sur disque, et si vous ne red�marrez pas le serveur, vous allez finir par servir des contenus compl�tement obsol�tes. Vous devez mettre � jour les fichiers en renommant l'ancienne version et en enregistrant la nouvelle sur disque. Pour y parvenir, on peut utiliser des outils comme rdist et mv. La raison pour laquelle ce module ne prend pas en compte les modifications de fichiers r�side dans le fait que cette v�rification n�cessiterait un appel � stat() � chaque acc�s, et en fin de compte, l'augmentation de la consommation de ressources finirait par aller contre le but initial de r�duire les entr�es/sorties.

Directive CacheFile

La directive CacheFile du module mod_file_cache permet d'associer un gestionnaire ou descripteur de fichier � chaque fichier �num�r� dans la directive de configuration et place ces gestionnaires de fichiers ouverts dans le cache. Lorsqu'un des fichier est demand�, le serveur s�lectionne son gestionnaire dans le cache et le transmet � l'API sendfile() (ou TransmitFile() sous Windows).

Cette mise en cache des gestionnaire n'est effectu�e qu'une seule fois au d�marrage ou red�marrage du syst�me. Ainsi, chaque fois qu'un des fichiers charg�s en m�moire est modifi� au niveau du syst�me de fichiers, vous devez red�marrer le serveur (voir la documentation sur l'Arr�t et red�marrage). Pour bien insister sur ce point, si des fichiers sont modifi�s sur disque, et si vous ne red�marrez pas le serveur, vous allez finir par servir des contenus compl�tement obsol�tes. Vous devez mettre � jour les fichiers en renommant l'ancienne version et en enregistrant la nouvelle sur disque. Pour y parvenir, on peut utiliser des outils comme rdist et mv.