Module Apache mod_expires

ExpiresActive Directive

Cette directive permet d'activer ou de d�sactiver la g�n�ration des en-t�tes Expires et Cache-Control pour les documents concern�s ; en d'autres termes, si cette directive se trouve dans un fichier .htaccess, par exemple, elle ne s'applique qu'aux documents g�n�r�s � partir du r�pertoire consid�r�. Si elle est d�finie � Off, les en-t�tes ne seront g�n�r�s pour aucun document du domaine consid�r� (sauf surcharge de la configuration � un niveau inf�rieur, comme un fichier .htaccess qui l'emporterait sur le fichier de configuration du serveur). Si elle est d�finie � On, les en-t�tes seront ajout�s aux documents servis en fonction des crit�res d�finis par les directives ExpiresByType et ExpiresDefault (voir plus loin).

Notez que cette directive ne permet pas de garantir qu'un en-t�te Expires ou Cache-Control sera g�n�r�. Si les crit�res ne sont pas respect�s, aucun en-t�te ne sera g�n�r�, et la directive produira le m�me effet que si elle n'avait pas �t� d�finie.

ExpiresByType Directive

Cette directive permet de d�finir la valeur de l'en-t�te Expires et de la directive max-age de l'en-t�te Cache-Control g�n�r�s pour les documents du type MIME sp�cifi� (par exemple, text/html). Le second argument d�finit le nombre de secondes qui seront ajout�es � un temps de base pour calculer la date d'expiration. Cache-Control: max-age se calcule en soustrayant la date de la requ�te de la date d'expiration et s'exprime en secondes.

Le champ <code> permet de sp�cifier quel temps doit �tre utilis� comme temps de base; M signifie que c'est la date de derni�re modification du fichier qui doit �tre utilis�e comme temps de base, alors que A signifie que c'est le moment o� le client a acc�d� au document qui doit �tre utilis� comme temps de base.

La diff�rence d'effet est subtile. Si on utilise M, toutes les copies existantes du document dans tous les caches expireront au m�me moment, ce qui peut convenir par exemple pour une notice hebdomadaire qui correspond toujours � la m�me URL. Si on utilise A, la date d'expiration sera diff�rente pour chaque client, ce qui peut convenir pour des fichiers d'images qui ne changent pas tr�s souvent, et en particulier pour un ensemble de documents en relation qui se r�f�rent tous aux m�mes images (ces images sont alors acc�d�es de mani�re r�p�titive dans un intervalle de temps assez court).

# active la g�n�ration des en-t�tes Expires
ExpiresActive On
# les images GIF expirent au bout d'un mois dans le cache du
# client
ExpiresByType image/gif A2592000
# les documents HTML restent valables une semaine apr�s leur date
# de derni�re modification
ExpiresByType text/html M604800

Notez que cette directive ne produit d'effet que si ExpiresActive On a �t� sp�cifi�. Elle l'emporte, mais seulement pour le type MIME sp�cifi�, sur toute date d'expiration d�finie par la directive ExpiresDefault.

Vous pouvez aussi d�finir le mode de calcul de la date d'expiration en utilisant une syntaxe alternative, comme d�crit plus haut dans ce document.

ExpiresDefault Directive

Cette directive permet de d�finir le mode de calcul par d�faut de la date d'expiration pour tous les documents du domaine consid�r�. Elle peut �tre annul�e pour certains types de documents par la directive ExpiresByType. Voir la description de cette derni�re directive pour plus de d�tails � propos de la syntaxe de l'argument, ainsi que la description de la syntaxe alternative.