granicus.if.org Git - apache/blob - docs/manual/mod/mod_expires.html.fr

   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
   7       -->
   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">
  13 </script>
  14
  15 <link href="../images/favicon.ico" rel="shortcut icon" /></head>
  16 <body>
  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="&lt;-" alt="&lt;-" src="../images/left.gif" /></a></div>
  22 <div id="path">
  23 <a href="http://www.apache.org/">Apache</a> &gt; <a href="http://httpd.apache.org/">Serveur HTTP</a> &gt; <a href="http://httpd.apache.org/docs/">Documentation</a> &gt; <a href="../">Version 2.5</a> &gt; <a href="./">Modules</a></div>
  24 <div id="page-content">
  25 <div id="preamble"><h1>Module Apache mod_expires</h1>
  26 <div class="toplang">
  27 <p><span>Langues Disponibles: </span><a href="../en/mod/mod_expires.html" hreflang="en" rel="alternate" title="English">&nbsp;en&nbsp;</a> |
  28 <a href="../fr/mod/mod_expires.html" title="Français">&nbsp;fr&nbsp;</a> |
  29 <a href="../ja/mod/mod_expires.html" hreflang="ja" rel="alternate" title="Japanese">&nbsp;ja&nbsp;</a> |
  30 <a href="../ko/mod/mod_expires.html" hreflang="ko" rel="alternate" title="Korean">&nbsp;ko&nbsp;</a></p>
  31 </div>
  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>
  38 <h3>Sommaire</h3>
  39
  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>
  46
  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>
  54
  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>
  58
  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>
  64 </div>
  65 <div id="quickview"><h3 class="directives">Directives</h3>
  66 <ul id="toc">
  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>
  70 </ul>
  71 <h3>Sujets</h3>
  72 <ul id="topics">
  73 <li><img alt="" src="../images/down.gif" /> <a href="#AltSyn">Autre syntaxe de définition de
  74 l'intervalle</a></li>
  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>
  77 <div class="section">
  78 <h2><a name="AltSyn" id="AltSyn">Autre syntaxe de définition de
  79 l'intervalle</a></h2>
  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>
  82
  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>] ..."
  86     </pre>
  87
  88
  89     <p>où <var>base</var> peut être :</p>
  90
  91     <ul>
  92       <li><code>access</code></li>
  93
  94       <li><code>now</code> (équivalent à
  95       '<code>access</code>')</li>
  96
  97       <li><code>modification</code></li>
  98     </ul>
  99
 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>
 103
 104     <ul>
 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>
 112     </ul>
 113
 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"
 120     </pre>
 121
 122
 123
 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>
 126
 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"
 130     </pre>
 131
 132
 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
 137     modification.</p>
 138 </div>
 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>
 150 </table>
 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
 163     loin</em>).</p>
 164
 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é
 169     définie.</p>
 170
 171 </div>
 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>&lt;code&gt;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>
 183 </table>
 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
 192     secondes.</p>
 193
 194     <p>Le champ <code><var>&lt;code&gt;</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
 200     de base.</p>
 201
 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>
 212
 213     <div class="example"><h3>Exemple :</h3><pre class="prettyprint lang-config">
 214 # active la génération des en-têtes Expires
 215 ExpiresActive On
 216 # les images GIF expirent au bout d'un mois dans le cache du
 217 # client
 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
 222       </pre>
 223 </div>
 224
 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>
 229
 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>
 233
 234 </div>
 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>&lt;code&gt;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>
 245 </table>
 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>
 252
 253 </div>
 254 </div>
 255 <div class="bottomlang">
 256 <p><span>Langues Disponibles: </span><a href="../en/mod/mod_expires.html" hreflang="en" rel="alternate" title="English">&nbsp;en&nbsp;</a> |
 257 <a href="../fr/mod/mod_expires.html" title="Français">&nbsp;fr&nbsp;</a> |
 258 <a href="../ja/mod/mod_expires.html" hreflang="ja" rel="alternate" title="Japanese">&nbsp;ja&nbsp;</a> |
 259 <a href="../ko/mod/mod_expires.html" hreflang="ko" rel="alternate" title="Korean">&nbsp;ko&nbsp;</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>This section is experimental!</strong><br />Comments placed here should not be expected
 261 to last beyond the testing phase of this system, nor do we in any way guarantee that we'll read them.</div>
 262 <div id="disqus_thread">
 263 </div><script type="text/javascript"><!--//--><![CDATA[//><!--
 264 var lang = 'fr';
 265 var disqus_shortname = 'httpd';
 266 var disqus_identifier = window.location.href.replace(/(current|trunk)/, "2.4").replace(/\/[a-z]{2}\//, "/").replace(window.location.protocol, "http:") + '.' + lang;
 267 if (disqus_identifier.indexOf("httpd.apache.org") != -1) {
 268     (function() {
 269                 var dsq = document.createElement('script'); dsq.type = 'text/javascript'; dsq.async = true;
 270                 dsq.src = window.location.protocol + '//' + disqus_shortname + '.disqus.com/embed.js';
 271             (document.getElementsByTagName('head')[0] || document.getElementsByTagName('body')[0]).appendChild(dsq);
 272         })();
 273 } else {
 274     var text = document.createTextNode("Comments have been disabled for offline viewing.");
 275     document.getElementById('disqus_thread').appendChild(text);
 276 }
 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) {
 281     prettyPrint();
 282 }
 283 //--><!]]></script>
 284 </body></html>