mod_expires.html.fr revision 5d90035b1bd7f5157dbc8e9e5f3009529815add1
<?xml version="1.0" encoding="ISO-8859-1"?>
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Strict//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-strict.dtd">
XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
This file is generated from xml source: DO NOT EDIT
XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
-->
<title>mod_expires - Serveur Apache HTTP</title>
<link href="/style/css/manual.css" rel="stylesheet" media="all" type="text/css" title="Main stylesheet" />
<link href="/style/css/manual-loose-100pc.css" rel="alternate stylesheet" media="all" type="text/css" title="No Sidebar - Default font size" />
<body>
<div id="page-header">
<p class="menu"><a href="/mod/">Modules</a> | <a href="/mod/directives.html">Directives</a> | <a href="/faq/">FAQ</a> | <a href="/glossary.html">Glossaire</a> | <a href="/sitemap.html">Plan du site</a></p>
<p class="apache">Serveur Apache HTTP Version 2.5</p>
<div id="path">
<a href="http://www.apache.org/">Apache</a> > <a href="http://httpd.apache.org/">Serveur HTTP</a> > <a href="http://httpd.apache.org/docs/">Documentation</a> > <a href="../">Version 2.5</a> > <a href="./">Modules</a></div>
<div id="page-content">
<div id="preamble"><h1>Module Apache mod_expires</h1>
<div class="toplang">
<p><span>Langues Disponibles: </span><a href="/en/mod/mod_expires.html" hreflang="en" rel="alternate" title="English"> en </a> |
<a href="/ja/mod/mod_expires.html" hreflang="ja" rel="alternate" title="Japanese"> ja </a> |
<a href="/ko/mod/mod_expires.html" hreflang="ko" rel="alternate" title="Korean"> ko </a></p>
</div>
<div class="outofdate">Cette traduction peut �tre p�rim�e. V�rifiez la version
anglaise pour les changements r�cents.</div>
<table class="module"><tr><th><a href="module-dict.html#Description">Description:</a></th><td>G�n�ration des en-t�tes HTTP <code>Expires</code> et
<code>Cache-Control</code> en fonction de crit�res sp�cifi�s par
l'utilisateur</td></tr>
<tr><th><a href="module-dict.html#ModuleIdentifier">Identificateur�de�Module:</a></th><td>expires_module</td></tr>
<tr><th><a href="module-dict.html#SourceFile">Fichier�Source:</a></th><td>mod_expires.c</td></tr></table>
<h3>Sommaire</h3>
<p>Ce module permet de contr�ler la d�finition de l'en-t�te HTTP
<code>Expires</code> et la directive <code>max-age</code> de
l'en-t�te HTTP <code>Cache-Control</code> dans les r�ponses du
serveur. La date d'expiration peut �tre d�finie soit par rapport �
la date de derni�re modification du fichier source, soit
par rapport � l'heure d'acc�s du client.</p>
<p>Ces en-t�tes HTTP permettent d'informer le client quant � la
validit� et � la persistence du document. S'il est pr�sent dans le
cache, et tant qu'il n'est pas arriv� � expiration, le document sera
servi � partir de ce dernier, plut�t qu'� partir du document source.
Apr�s expiration, la copie du document dans le cache sera consid�r�e
comme "expir�e" et donc invalide, et une nouvelle copie devra �tre
obtenue � partir du document source.</p>
<p>Pour modifier les directives de contr�le du cache autres
que <code>max-age</code> (voir la <a href="http://www.w3.org/Protocols/rfc2616/rfc2616-sec14.html#sec14.9">RFC
2616 section 14.9</a>), vous pouvez utiliser la directive <code class="directive"><a href="/mod/mod_headers.html#header">Header</a></code>.</p>
<p>Lorsque l'en-t�te <code>Expires</code> est d�j� pr�sent dans la
r�ponse g�n�r�e par le serveur, par exemple s'il a �t� cr�� par un
script CGI ou un serveur original via un serveur mandataire, ce
module n'ajoute aucun en-t�te <code>Expires</code> ou
<code>Cache-Control</code>.</p>
</div>
<div id="quickview"><h3 class="directives">Directives</h3>
<ul id="toc">
</ul>
<h3>Sujets</h3>
<ul id="topics">
l'intervalle</a></li>
</ul></div>
<div class="section">
<h2><a name="AltSyn" id="AltSyn">Autre syntaxe de d�finition de
l'intervalle</a></h2>
<p>Pour une syntaxe plus lisible, on peut aussi utiliser les
directives <code class="directive"><a href="#expiresdefault">ExpiresDefault</a></code> et <code class="directive"><a href="#expiresbytype">ExpiresByType</a></code> comme suit :</p>
<div class="example"><p><code>
ExpiresDefault "<base> [plus] {<num>
<type>}*"<br />
{<num> <type>}*"
</code></p></div>
<p>o� <base> peut �tre :</p>
<ul>
<li><code>access</code></li>
<li><code>now</code> (�quivalent �
'<code>access</code>')</li>
<li><code>modification</code></li>
</ul>
<p>Le mot-cl� <code>plus</code> est optionnel. <num> doit
correspondre � une valeur enti�re [compatible avec
<code>atoi()</code>], et <type> peut �tre choisi parmi :</p>
<ul>
<li><code>years</code></li>
<li><code>months</code></li>
<li><code>weeks</code></li>
<li><code>days</code></li>
<li><code>hours</code></li>
<li><code>minutes</code></li>
<li><code>seconds</code></li>
</ul>
<p>Par exemple, pour faire expirer par d�faut les documents 1 mois
apr�s leur acc�s, on peut utiliser une des directives suivantes :</p>
<div class="example"><p><code>
ExpiresDefault "access plus 1 month"<br />
ExpiresDefault "access plus 4 weeks"<br />
ExpiresDefault "access plus 30 days"
</code></p></div>
<p>La date d'expiration peut �tre d�finie plus pr�cis�ment en
ajoutant plusieurs clauses'<num> <type>' :</p>
<div class="example"><p><code>
days 2 hours"<br />
minutes"
</code></p></div>
<p>Notez que si vous utilisez une configuration bas�e sur la date de
modification, l'en-t�te Expires ne sera pas ajout� � un contenu qui
ne provient pas directement d'un fichier sur disque ; et ceci tout
simplement parce que ce type de contenu ne poss�de pas de date de
modification.</p>
</div>
<div class="directive-section"><h2><a name="ExpiresActive" id="ExpiresActive">ExpiresActive</a> <a name="expiresactive" id="expiresactive">Directive</a></h2>
<table class="directive">
<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Active la g�n�ration d'en-t�tes
<code>Expires</code></td></tr>
<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>ExpiresActive On|Off</code></td></tr>
<tr><th><a href="directive-dict.html#Default">D�faut:</a></th><td><code>ExpiresActive Off</code></td></tr>
<tr><th><a href="directive-dict.html#Context">Contexte:</a></th><td>configuration du serveur, serveur virtuel, r�pertoire, .htaccess</td></tr>
</table>
<p>Cette directive permet d'activer ou de d�sactiver la g�n�ration
des en-t�tes <code>Expires</code> et <code>Cache-Control</code> pour
les documents concern�s ; en d'autres termes, si cette directive se
trouve dans un fichier <code>.htaccess</code>, par exemple, elle ne
s'applique qu'aux documents g�n�r�s � partir du r�pertoire
consid�r�. Si elle est d�finie � <code>Off</code>, 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 <code>.htaccess</code> qui l'emporterait sur le fichier de
configuration du serveur). Si elle est d�finie � <code>On</code>,
les en-t�tes seront ajout�s aux documents servis en fonction des
crit�res d�finis par les directives <code class="directive"><a href="#expiresbytype">ExpiresByType</a></code> et <code class="directive"><a href="#expiresdefault">ExpiresDefault</a></code> (<em>voir plus
loin</em>).</p>
<p>Notez que cette directive ne permet pas de garantir qu'un en-t�te
<code>Expires</code> ou <code>Cache-Control</code> 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.</p>
</div>
<div class="directive-section"><h2><a name="ExpiresByType" id="ExpiresByType">ExpiresByType</a> <a name="expiresbytype" id="expiresbytype">Directive</a></h2>
<table class="directive">
<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>D�finition de la valeur de l'en-t�te <code>Expires</code>
en fonction du type MIME</td></tr>
<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>ExpiresByType <var>type MIME</var>
<var><code>secondes</var></code></td></tr>
<tr><th><a href="directive-dict.html#Context">Contexte:</a></th><td>configuration du serveur, serveur virtuel, r�pertoire, .htaccess</td></tr>
</table>
<p>Cette directive permet de d�finir la valeur de l'en-t�te
<code>Expires</code> et de la directive <code>max-age</code> de
l'en-t�te <code>Cache-Control</code> g�n�r�s pour les documents du
argument d�finit le nombre de secondes qui seront ajout�es � un
temps de base pour calculer la date d'expiration.
<code>Cache-Control: max-age</code> se calcule en soustrayant la
date de la requ�te de la date d'expiration et s'exprime en
secondes.</p>
<p>Le champ <code><var><code></var></code> permet de sp�cifier
quel temps doit �tre utilis� comme temps de base; <code>M</code>
signifie que c'est la date
de derni�re modification du fichier qui doit �tre utilis�e comme
temps de base, alors que <code>A</code> signifie que c'est le moment
o� le client a acc�d� au document qui doit �tre utilis� comme temps
de base.</p>
<p>La diff�rence d'effet est subtile. Si on utilise <code>M</code>,
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 <code>A</code>, 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).</p>
<div class="example"><h3>Exemple :</h3><p><code>
# active la g�n�ration des en-t�tes Expires<br />
ExpiresActive On<br />
# les images GIF expirent au bout d'un mois dans le cache du
# client<br />
# les documents HTML restent valables une semaine apr�s leur date
# de derni�re modification<br />
</code></p></div>
<p>Notez que cette directive ne produit d'effet que si
<code>ExpiresActive On</code> a �t� sp�cifi�. Elle l'emporte, mais
<em>seulement</em> pour le type MIME sp�cifi�, sur toute date
d'expiration d�finie par la directive <code class="directive"><a href="#expiresdefault">ExpiresDefault</a></code>.</p>
<p>Vous pouvez aussi d�finir le mode de calcul de la date
d'expiration en utilisant une <a href="#AltSyn">syntaxe
alternative</a>, comme d�crit plus haut dans ce document.</p>
</div>
<div class="directive-section"><h2><a name="ExpiresDefault" id="ExpiresDefault">ExpiresDefault</a> <a name="expiresdefault" id="expiresdefault">Directive</a></h2>
<table class="directive">
<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Mode de calcul par d�faut de la date
d'expiration</td></tr>
<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>ExpiresDefault <var><code>secondes</var></code></td></tr>
<tr><th><a href="directive-dict.html#Context">Contexte:</a></th><td>configuration du serveur, serveur virtuel, r�pertoire, .htaccess</td></tr>
</table>
<p>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 <code class="directive"><a href="#expiresbytype">ExpiresByType</a></code>. 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 <a href="#AltSyn">syntaxe alternative</a>.</p>
</div>
</div>
<div class="bottomlang">
<p><span>Langues Disponibles: </span><a href="/en/mod/mod_expires.html" hreflang="en" rel="alternate" title="English"> en </a> |
<a href="/ja/mod/mod_expires.html" hreflang="ja" rel="alternate" title="Japanese"> ja </a> |
<a href="/ko/mod/mod_expires.html" hreflang="ko" rel="alternate" title="Korean"> ko </a></p>
</div><div id="footer">
<p class="apache">Copyright 2012 The Apache Software Foundation.<br />Autoris� sous <a href="http://www.apache.org/licenses/LICENSE-2.0">Apache License, Version 2.0</a>.</p>
<p class="menu"><a href="/mod/">Modules</a> | <a href="/mod/directives.html">Directives</a> | <a href="/faq/">FAQ</a> | <a href="/glossary.html">Glossaire</a> | <a href="/sitemap.html">Plan du site</a></p></div>
</body></html>