1 <?xml version="1.0" encoding="ISO-8859-1"?>
2 <!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Strict//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-strict.dtd">
3 <html xmlns="http://www.w3.org/1999/xhtml" lang="fr" xml:lang="fr"><head><!--
4 XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
5 This file is generated from xml source: DO NOT EDIT
6 XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
8 <title>mod_expires - Serveur Apache HTTP</title>
9 <link href="../style/css/manual.css" rel="stylesheet" media="all" type="text/css" title="Main stylesheet" />
10 <link href="../style/css/manual-loose-100pc.css" rel="alternate stylesheet" media="all" type="text/css" title="No Sidebar - Default font size" />
11 <link href="../style/css/manual-print.css" rel="stylesheet" media="print" type="text/css" /><link rel="stylesheet" type="text/css" href="../style/css/prettify.css" />
12 <script src="../style/scripts/prettify.js" type="text/javascript">
15 <link href="../images/favicon.ico" rel="shortcut icon" /></head>
17 <div id="page-header">
18 <p class="menu"><a href="../mod/">Modules</a> | <a href="../mod/directives.html">Directives</a> | <a href="http://wiki.apache.org/httpd/FAQ">FAQ</a> | <a href="../glossary.html">Glossaire</a> | <a href="../sitemap.html">Plan du site</a></p>
19 <p class="apache">Serveur Apache HTTP Version 2.5</p>
20 <img alt="" src="../images/feather.gif" /></div>
21 <div class="up"><a href="./"><img title="<-" alt="<-" src="../images/left.gif" /></a></div>
23 <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>
24 <div id="page-content">
25 <div id="preamble"><h1>Module Apache mod_expires</h1>
27 <p><span>Langues Disponibles: </span><a href="../en/mod/mod_expires.html" hreflang="en" rel="alternate" title="English"> en </a> |
28 <a href="../fr/mod/mod_expires.html" title="Français"> fr </a> |
29 <a href="../ja/mod/mod_expires.html" hreflang="ja" rel="alternate" title="Japanese"> ja </a> |
30 <a href="../ko/mod/mod_expires.html" hreflang="ko" rel="alternate" title="Korean"> ko </a></p>
32 <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
33 <code>Cache-Control</code> en fonction de critères spécifiés par
34 l'utilisateur</td></tr>
35 <tr><th><a href="module-dict.html#Status">Statut:</a></th><td>Extension</td></tr>
36 <tr><th><a href="module-dict.html#ModuleIdentifier">Identificateur de Module:</a></th><td>expires_module</td></tr>
37 <tr><th><a href="module-dict.html#SourceFile">Fichier Source:</a></th><td>mod_expires.c</td></tr></table>
40 <p>Ce module permet de contrôler la définition de l'en-tête HTTP
41 <code>Expires</code> et la directive <code>max-age</code> de
42 l'en-tête HTTP <code>Cache-Control</code> dans les réponses du
43 serveur. La date d'expiration peut être définie soit par rapport à
44 la date de dernière modification du fichier source, soit
45 par rapport à l'heure d'accès du client.</p>
47 <p>Ces en-têtes HTTP permettent d'informer le client quant à la
48 validité et à la persistence du document. S'il est présent dans le
49 cache, et tant qu'il n'est pas arrivé à expiration, le document sera
50 servi à partir de ce dernier, plutôt qu'à partir du document source.
51 Après expiration, la copie du document dans le cache sera considérée
52 comme "expirée" et donc invalide, et une nouvelle copie devra être
53 obtenue à partir du document source.</p>
55 <p>Pour modifier les directives de contrôle du cache autres
56 que <code>max-age</code> (voir la <a href="http://www.w3.org/Protocols/rfc2616/rfc2616-sec14.html#sec14.9">RFC
57 2616 section 14.9</a>), vous pouvez utiliser la directive <code class="directive"><a href="../mod/mod_headers.html#header">Header</a></code>.</p>
59 <p>Lorsque l'en-tête <code>Expires</code> est déjà présent dans la
60 réponse générée par le serveur, par exemple s'il a été créé par un
61 script CGI ou un serveur original via un serveur mandataire, ce
62 module n'ajoute aucun en-tête <code>Expires</code> ou
63 <code>Cache-Control</code>.</p>
65 <div id="quickview"><h3 class="directives">Directives</h3>
67 <li><img alt="" src="../images/down.gif" /> <a href="#expiresactive">ExpiresActive</a></li>
68 <li><img alt="" src="../images/down.gif" /> <a href="#expiresbytype">ExpiresByType</a></li>
69 <li><img alt="" src="../images/down.gif" /> <a href="#expiresdefault">ExpiresDefault</a></li>
73 <li><img alt="" src="../images/down.gif" /> <a href="#AltSyn">Autre syntaxe de définition de
75 </ul><ul class="seealso"><li><a href="#comments_section">Commentaires</a></li></ul></div>
76 <div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
78 <h2><a name="AltSyn" id="AltSyn">Autre syntaxe de définition de
80 <p>Pour une syntaxe plus lisible, on peut aussi utiliser les
81 directives <code class="directive"><a href="#expiresdefault">ExpiresDefault</a></code> et <code class="directive"><a href="#expiresbytype">ExpiresByType</a></code> comme suit :</p>
83 <pre class="prettyprint lang-config">
84 ExpiresDefault "<var>base</var> [plus <var>num</var> <var>type</var>] [<var>num</var> <var>type</var>] ..."
85 ExpiresByType type/encoding "<var>base</var> [plus <var>num</var> <var>type</var>] [<var>num</var> <var>type</var>] ..."
89 <p>où <var>base</var> peut être :</p>
92 <li><code>access</code></li>
94 <li><code>now</code> (équivalent à
95 '<code>access</code>')</li>
97 <li><code>modification</code></li>
100 <p>Le mot-clé <code>plus</code> est optionnel. <var>num</var> doit
101 correspondre à une valeur entière [compatible avec
102 <code>atoi()</code>], et <var>type</var> peut être choisi parmi :</p>
105 <li><code>years</code></li>
106 <li><code>months</code></li>
107 <li><code>weeks</code></li>
108 <li><code>days</code></li>
109 <li><code>hours</code></li>
110 <li><code>minutes</code></li>
111 <li><code>seconds</code></li>
114 <p>Par exemple, pour faire expirer par défaut les documents 1 mois
115 après leur accès, on peut utiliser une des directives suivantes :</p>
116 <pre class="prettyprint lang-config">
117 ExpiresDefault "access plus 1 month"
118 ExpiresDefault "access plus 4 weeks"
119 ExpiresDefault "access plus 30 days"
124 <p>La date d'expiration peut être définie plus précisément en
125 ajoutant plusieurs clauses '<var>num</var> <var>type</var>' :</p>
127 <pre class="prettyprint lang-config">
128 ExpiresByType text/html "access plus 1 month 15 days 2 hours"
129 ExpiresByType image/gif "modification plus 5 hours 3 minutes"
133 <p>Notez que si vous utilisez une configuration basée sur la date de
134 modification, l'en-tête Expires ne sera pas ajouté à un contenu qui
135 ne provient pas directement d'un fichier sur disque ; et ceci tout
136 simplement parce que ce type de contenu ne possède pas de date de
139 <div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
140 <div class="directive-section"><h2><a name="ExpiresActive" id="ExpiresActive">ExpiresActive</a> <a name="expiresactive" id="expiresactive">Directive</a></h2>
141 <table class="directive">
142 <tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Active la génération d'en-têtes
143 <code>Expires</code></td></tr>
144 <tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>ExpiresActive On|Off</code></td></tr>
145 <tr><th><a href="directive-dict.html#Default">Défaut:</a></th><td><code>ExpiresActive Off</code></td></tr>
146 <tr><th><a href="directive-dict.html#Context">Contexte:</a></th><td>configuration du serveur, serveur virtuel, répertoire, .htaccess</td></tr>
147 <tr><th><a href="directive-dict.html#Override">AllowOverride:</a></th><td>Indexes</td></tr>
148 <tr><th><a href="directive-dict.html#Status">Statut:</a></th><td>Extension</td></tr>
149 <tr><th><a href="directive-dict.html#Module">Module:</a></th><td>mod_expires</td></tr>
151 <p>Cette directive permet d'activer ou de désactiver la génération
152 des en-têtes <code>Expires</code> et <code>Cache-Control</code> pour
153 les documents concernés ; en d'autres termes, si cette directive se
154 trouve dans un fichier <code>.htaccess</code>, par exemple, elle ne
155 s'applique qu'aux documents générés à partir du répertoire
156 considéré. Si elle est définie à <code>Off</code>, les en-têtes ne
157 seront générés pour aucun document du domaine considéré (sauf
158 surcharge de la configuration à un niveau inférieur, comme un
159 fichier <code>.htaccess</code> qui l'emporterait sur le fichier de
160 configuration du serveur). Si elle est définie à <code>On</code>,
161 les en-têtes seront ajoutés aux documents servis en fonction des
162 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
165 <p>Notez que cette directive ne permet pas de garantir qu'un en-tête
166 <code>Expires</code> ou <code>Cache-Control</code> sera généré. Si
167 les critères ne sont pas respectés, aucun en-tête ne sera généré, et
168 la directive produira le même effet que si elle n'avait pas été
172 <div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
173 <div class="directive-section"><h2><a name="ExpiresByType" id="ExpiresByType">ExpiresByType</a> <a name="expiresbytype" id="expiresbytype">Directive</a></h2>
174 <table class="directive">
175 <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>
176 en fonction du type MIME</td></tr>
177 <tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>ExpiresByType <var>type MIME</var>
178 <var><code>secondes</var></code></td></tr>
179 <tr><th><a href="directive-dict.html#Context">Contexte:</a></th><td>configuration du serveur, serveur virtuel, répertoire, .htaccess</td></tr>
180 <tr><th><a href="directive-dict.html#Override">AllowOverride:</a></th><td>Indexes</td></tr>
181 <tr><th><a href="directive-dict.html#Status">Statut:</a></th><td>Extension</td></tr>
182 <tr><th><a href="directive-dict.html#Module">Module:</a></th><td>mod_expires</td></tr>
184 <p>Cette directive permet de définir la valeur de l'en-tête
185 <code>Expires</code> et de la directive <code>max-age</code> de
186 l'en-tête <code>Cache-Control</code> générés pour les documents du
187 type MIME spécifié (par exemple, <code>text/html</code>). Le second
188 argument définit le nombre de secondes qui seront ajoutées à un
189 temps de base pour calculer la date d'expiration.
190 <code>Cache-Control: max-age</code> se calcule en soustrayant la
191 date de la requête de la date d'expiration et s'exprime en
194 <p>Le champ <code><var><code></var></code> permet de spécifier
195 quel temps doit être utilisé comme temps de base; <code>M</code>
196 signifie que c'est la date
197 de dernière modification du fichier qui doit être utilisée comme
198 temps de base, alors que <code>A</code> signifie que c'est le moment
199 où le client a accédé au document qui doit être utilisé comme temps
202 <p>La différence d'effet est subtile. Si on utilise <code>M</code>,
203 toutes les copies existantes du document dans tous les caches
204 expireront au même moment, ce qui peut convenir par exemple pour une
205 notice hebdomadaire qui correspond toujours à la même URL. Si on
206 utilise <code>A</code>, la date d'expiration sera différente pour
207 chaque client, ce qui peut convenir pour des fichiers d'images qui
208 ne changent pas très souvent, et en particulier pour un ensemble de
209 documents en relation qui se réfèrent tous aux mêmes images (ces
210 images sont alors accédées de manière répétitive dans un intervalle
211 de temps assez court).</p>
213 <div class="example"><h3>Exemple :</h3><pre class="prettyprint lang-config">
214 # active la génération des en-têtes Expires
216 # les images GIF expirent au bout d'un mois dans le cache du
218 ExpiresByType image/gif A2592000
219 # les documents HTML restent valables une semaine après leur date
220 # de dernière modification
221 ExpiresByType text/html M604800
225 <p>Notez que cette directive ne produit d'effet que si
226 <code>ExpiresActive On</code> a été spécifié. Elle l'emporte, mais
227 <em>seulement</em> pour le type MIME spécifié, sur toute date
228 d'expiration définie par la directive <code class="directive"><a href="#expiresdefault">ExpiresDefault</a></code>.</p>
230 <p>Vous pouvez aussi définir le mode de calcul de la date
231 d'expiration en utilisant une <a href="#AltSyn">syntaxe
232 alternative</a>, comme décrit plus haut dans ce document.</p>
235 <div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
236 <div class="directive-section"><h2><a name="ExpiresDefault" id="ExpiresDefault">ExpiresDefault</a> <a name="expiresdefault" id="expiresdefault">Directive</a></h2>
237 <table class="directive">
238 <tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Mode de calcul par défaut de la date
239 d'expiration</td></tr>
240 <tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>ExpiresDefault <var><code>secondes</var></code></td></tr>
241 <tr><th><a href="directive-dict.html#Context">Contexte:</a></th><td>configuration du serveur, serveur virtuel, répertoire, .htaccess</td></tr>
242 <tr><th><a href="directive-dict.html#Override">AllowOverride:</a></th><td>Indexes</td></tr>
243 <tr><th><a href="directive-dict.html#Status">Statut:</a></th><td>Extension</td></tr>
244 <tr><th><a href="directive-dict.html#Module">Module:</a></th><td>mod_expires</td></tr>
246 <p>Cette directive permet de définir le mode de calcul par défaut de
247 la date d'expiration pour tous les documents du domaine considéré.
248 Elle peut être annulée pour certains types de documents par la
249 directive <code class="directive"><a href="#expiresbytype">ExpiresByType</a></code>. Voir la description
250 de cette dernière directive pour plus de détails à propos de la
251 syntaxe de l'argument, ainsi que la description de la <a href="#AltSyn">syntaxe alternative</a>.</p>
255 <div class="bottomlang">
256 <p><span>Langues Disponibles: </span><a href="../en/mod/mod_expires.html" hreflang="en" rel="alternate" title="English"> en </a> |
257 <a href="../fr/mod/mod_expires.html" title="Français"> fr </a> |
258 <a href="../ja/mod/mod_expires.html" hreflang="ja" rel="alternate" title="Japanese"> ja </a> |
259 <a href="../ko/mod/mod_expires.html" hreflang="ko" rel="alternate" title="Korean"> ko </a></p>
260 </div><div class="top"><a href="#page-header"><img src="../images/up.gif" alt="top" /></a></div><div class="section"><h2><a id="comments_section" name="comments_section">Commentaires</a></h2><div class="warning"><strong>Notice:</strong><br />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 <a href="http://httpd.apache.org/lists.html">mailing lists</a>.</div>
261 <script type="text/javascript"><!--//--><![CDATA[//><!--
262 var comments_shortname = 'httpd';
263 var comments_identifier = 'http://httpd.apache.org/docs/trunk/mod/mod_expires.html';
265 if (w.location.hostname.toLowerCase() == "httpd.apache.org") {
266 d.write('<div id="comments_thread"><\/div>');
267 var s = d.createElement('script');
268 s.type = 'text/javascript';
270 s.src = 'https://comments.apache.org/show_comments.lua?site=' + comments_shortname + '&page=' + comments_identifier;
271 (d.getElementsByTagName('head')[0] || d.getElementsByTagName('body')[0]).appendChild(s);
274 d.write('<div id="comments_thread">Comments are disabled for this page at the moment.<\/div>');
276 })(window, document);
277 //--><!]]></script></div><div id="footer">
278 <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>
279 <p class="menu"><a href="../mod/">Modules</a> | <a href="../mod/directives.html">Directives</a> | <a href="http://wiki.apache.org/httpd/FAQ">FAQ</a> | <a href="../glossary.html">Glossaire</a> | <a href="../sitemap.html">Plan du site</a></p></div><script type="text/javascript"><!--//--><![CDATA[//><!--
280 if (typeof(prettyPrint) !== 'undefined') {