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" />
  12 <link href="../images/favicon.ico" rel="shortcut icon" /></head>
  13 <body>
  14 <div id="page-header">
  15 <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>
  16 <p class="apache">Serveur Apache HTTP Version 2.3</p>
  17 <img alt="" src="../images/feather.gif" /></div>
  18 <div class="up"><a href="./"><img title="&lt;-" alt="&lt;-" src="../images/left.gif" /></a></div>
  19 <div id="path">
  20 <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.3</a> &gt; <a href="./">Modules</a></div>
  21 <div id="page-content">
  22 <div id="preamble"><h1>Module Apache mod_expires</h1>
  23 <div class="toplang">
  24 <p><span>Langues Disponibles: </span><a href="../en/mod/mod_expires.html" hreflang="en" rel="alternate" title="English">&nbsp;en&nbsp;</a> |
  25 <a href="../fr/mod/mod_expires.html" title="Français">&nbsp;fr&nbsp;</a> |
  26 <a href="../ja/mod/mod_expires.html" hreflang="ja" rel="alternate" title="Japanese">&nbsp;ja&nbsp;</a> |
  27 <a href="../ko/mod/mod_expires.html" hreflang="ko" rel="alternate" title="Korean">&nbsp;ko&nbsp;</a></p>
  28 </div>
  29 <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
  30 <code>Cache-Control</code> en fonction de critères spécifiés par
  31 l'utilisateur</td></tr>
  32 <tr><th><a href="module-dict.html#Status">Statut:</a></th><td>Extension</td></tr>
  33 <tr><th><a href="module-dict.html#ModuleIdentifier">Identificateur de Module:</a></th><td>expires_module</td></tr>
  34 <tr><th><a href="module-dict.html#SourceFile">Fichier Source:</a></th><td>mod_expires.c</td></tr></table>
  35 <h3>Sommaire</h3>
  36
  37     <p>Ce module permet de contrôler la définition de l'en-tête HTTP
  38     <code>Expires</code> et la directive <code>max-age</code> de
  39     l'en-tête HTTP <code>Cache-Control</code> dans les réponses du
  40     serveur. La date d'expiration peut être définie soit par rapport à
  41     la date de dernière modification du fichier source, soit
  42     par rapport à l'heure d'accès du client.</p>
  43
  44     <p>Ces en-têtes HTTP permettent d'informer le client quant à la
  45     validité et à la persistence du document. S'il est présent dans le
  46     cache, et tant qu'il n'est pas arrivé à expiration, le document sera
  47     servi à partir de ce dernier, plutôt qu'à partir du document source.
  48     Après expiration, la copie du document dans le cache sera considérée
  49     comme "expirée" et donc invalide, et une nouvelle copie devra être
  50     obtenue à partir du document source.</p>
  51
  52     <p>Pour modifier les directives de contrôle du cache autres
  53     que <code>max-age</code> (voir la <a href="http://www.w3.org/Protocols/rfc2616/rfc2616-sec14.html#sec14.9">RFC
  54     2616 section 14.9</a>), vous pouvez utiliser la directive <code class="directive"><a href="../mod/mod_headers.html#header">Header</a></code>.</p>
  55
  56 </div>
  57 <div id="quickview"><h3 class="directives">Directives</h3>
  58 <ul id="toc">
  59 <li><img alt="" src="../images/down.gif" /> <a href="#expiresactive">ExpiresActive</a></li>
  60 <li><img alt="" src="../images/down.gif" /> <a href="#expiresbytype">ExpiresByType</a></li>
  61 <li><img alt="" src="../images/down.gif" /> <a href="#expiresdefault">ExpiresDefault</a></li>
  62 </ul>
  63 <h3>Sujets</h3>
  64 <ul id="topics">
  65 <li><img alt="" src="../images/down.gif" /> <a href="#AltSyn">Autre syntaxe de définition de
  66 l'intervalle</a></li>
  67 </ul></div>
  68 <div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
  69 <div class="section">
  70 <h2><a name="AltSyn" id="AltSyn">Autre syntaxe de définition de
  71 l'intervalle</a></h2>
  72     <p>Pour une syntaxe plus lisible, on peut aussi utiliser les
  73     directives <code class="directive"><a href="#expiresdefault">ExpiresDefault</a></code> et <code class="directive"><a href="#expiresbytype">ExpiresByType</a></code> comme suit :</p>
  74
  75     <div class="example"><p><code>
  76       ExpiresDefault "&lt;base&gt; [plus] {&lt;num&gt;
  77       &lt;type&gt;}*"<br />
  78       ExpiresByType type/encoding "&lt;base&gt; [plus]
  79       {&lt;num&gt; &lt;type&gt;}*"
  80     </code></p></div>
  81
  82     <p>où &lt;base&gt; peut être :</p>
  83
  84     <ul>
  85       <li><code>access</code></li>
  86
  87       <li><code>now</code> (équivalent à
  88       '<code>access</code>')</li>
  89
  90       <li><code>modification</code></li>
  91     </ul>
  92
  93     <p>Le mot-clé <code>plus</code> est optionnel. &lt;num&gt; doit
  94     correspondre à une valeur entière [compatible avec
  95     <code>atoi()</code>], et &lt;type&gt; peut être choisi parmi :</p>
  96
  97     <ul>
  98       <li><code>years</code></li>
  99       <li><code>months</code></li>
 100       <li><code>weeks</code></li>
 101       <li><code>days</code></li>
 102       <li><code>hours</code></li>
 103       <li><code>minutes</code></li>
 104       <li><code>seconds</code></li>
 105     </ul>
 106
 107     <p>Par exemple, pour faire expirer par défaut les documents 1 mois
 108     après leur accès, on peut utiliser une des directives suivantes :</p>
 109     <div class="example"><p><code>
 110       ExpiresDefault "access plus 1 month"<br />
 111       ExpiresDefault "access plus 4 weeks"<br />
 112       ExpiresDefault "access plus 30 days"
 113     </code></p></div>
 114
 115
 116     <p>La date d'expiration peut être définie plus précisément en
 117     ajoutant plusieurs clauses'&lt;num&gt; &lt;type&gt;' :</p>
 118
 119     <div class="example"><p><code>
 120       ExpiresByType text/html "access plus 1 month 15
 121       days 2 hours"<br />
 122       ExpiresByType image/gif "modification plus 5 hours 3
 123       minutes"
 124     </code></p></div>
 125
 126     <p>Notez que si vous utilisez une configuration basée sur la date de
 127     modification, l'en-tête Expires ne sera pas ajouté à un contenu qui
 128     ne provient pas directement d'un fichier sur disque ; et ceci tout
 129     simplement parce que ce type de contenu ne possède pas de date de
 130     modification.</p>
 131 </div>
 132 <div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
 133 <div class="directive-section"><h2><a name="ExpiresActive" id="ExpiresActive">ExpiresActive</a> <a name="expiresactive" id="expiresactive">Directive</a></h2>
 134 <table class="directive">
 135 <tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Active la génération d'en-têtes
 136 <code>Expires</code></td></tr>
 137 <tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>ExpiresActive On|Off</code></td></tr>
 138 <tr><th><a href="directive-dict.html#Default">Défaut:</a></th><td><code>ExpiresActive Off</code></td></tr>
 139 <tr><th><a href="directive-dict.html#Context">Contexte:</a></th><td>configuration du serveur, serveur virtuel, répertoire, .htaccess</td></tr>
 140 <tr><th><a href="directive-dict.html#Override">Annuler:</a></th><td>Indexes</td></tr>
 141 <tr><th><a href="directive-dict.html#Status">Statut:</a></th><td>Extension</td></tr>
 142 <tr><th><a href="directive-dict.html#Module">Module:</a></th><td>mod_expires</td></tr>
 143 </table>
 144     <p>Cette directive permet d'activer ou de désactiver la génération
 145     des en-têtes <code>Expires</code> et <code>Cache-Control</code> pour
 146     les documents concernés ; en d'autres termes, si cette directive se
 147     trouve dans un fichier <code>.htaccess</code>, par exemple, elle ne
 148     s'applique qu'aux documents générés à partir du répertoire
 149     considéré. Si elle est définie à <code>Off</code>, les en-têtes ne
 150     seront générés pour aucun document du domaine considéré (sauf
 151     surcharge de la configuration à un niveau inférieur, comme un
 152     fichier <code>.htaccess</code> qui l'emporterait sur le fichier de
 153     configuration du serveur). Si elle est définie à <code>On</code>,
 154     les en-têtes seront ajoutés aux documents servis en fonction des
 155     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
 156     loin</em>).</p>
 157
 158     <p>Notez que cette directive ne permet pas de garantir qu'un en-tête
 159     <code>Expires</code> ou <code>Cache-Control</code> sera généré. Si
 160     les critères ne sont pas respectés, aucun en-tête ne sera généré, et
 161     la directive produira le même effet que si elle n'avait pas été
 162     définie.</p>
 163
 164 </div>
 165 <div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
 166 <div class="directive-section"><h2><a name="ExpiresByType" id="ExpiresByType">ExpiresByType</a> <a name="expiresbytype" id="expiresbytype">Directive</a></h2>
 167 <table class="directive">
 168 <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>
 169 en fonction du type MIME</td></tr>
 170 <tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>ExpiresByType <var>type MIME</var>
 171 <var>&lt;code&gt;secondes</var></code></td></tr>
 172 <tr><th><a href="directive-dict.html#Context">Contexte:</a></th><td>configuration du serveur, serveur virtuel, répertoire, .htaccess</td></tr>
 173 <tr><th><a href="directive-dict.html#Override">Annuler:</a></th><td>Indexes</td></tr>
 174 <tr><th><a href="directive-dict.html#Status">Statut:</a></th><td>Extension</td></tr>
 175 <tr><th><a href="directive-dict.html#Module">Module:</a></th><td>mod_expires</td></tr>
 176 </table>
 177     <p>Cette directive permet de définir la valeur de l'en-tête
 178     <code>Expires</code> et de la directive <code>max-age</code> de
 179     l'en-tête <code>Cache-Control</code> générés pour les documents du
 180     type MIME spécifié (par exemple, <code>text/html</code>). Le second
 181     argument définit le nombre de secondes qui seront ajoutées à un
 182     temps de base pour calculer la date d'expiration.
 183     <code>Cache-Control: max-age</code> se calcule en soustrayant la
 184     date de la requête de la date d'expiration et s'exprime en
 185     secondes.</p>
 186
 187     <p>Le champ <code><var>&lt;code&gt;</var></code> permet de spécifier
 188     quel temps doit être utilisé comme temps de base; <code>M</code>
 189     signifie que c'est la date
 190     de dernière modification du fichier qui doit être utilisée comme
 191     temps de base, alors que <code>A</code> signifie que c'est le moment
 192     où le client a accédé au document qui doit être utilisé comme temps
 193     de base.</p>
 194
 195     <p>La différence d'effet est subtile. Si on utilise <code>M</code>,
 196     toutes les copies existantes du document dans tous les caches
 197     expireront au même moment, ce qui peut convenir par exemple pour une
 198     notice hebdomadaire qui correspond toujours à la même URL. Si on
 199     utilise <code>A</code>, la date d'expiration sera différente pour
 200     chaque client, ce qui peut convenir pour des fichiers d'images qui
 201     ne changent pas très souvent, et en particulier pour un ensemble de
 202     documents en relation qui se réfèrent tous aux mêmes images (ces
 203     images sont alors accédées de manière répétitive dans un intervalle
 204     de temps assez court).</p>
 205
 206     <div class="example"><h3>Exemple :</h3><p><code>
 207       # active la génération des en-têtes Expires<br />
 208       ExpiresActive On<br />
 209       # les images GIF expirent au bout d'un mois dans le cache du
 210       # client<br />
 211       ExpiresByType image/gif A2592000<br />
 212       # les documents HTML restent valables une semaine après leur date
 213       # de dernière modification<br />
 214       ExpiresByType text/html M604800
 215     </code></p></div>
 216
 217     <p>Notez que cette directive ne produit d'effet que si
 218     <code>ExpiresActive On</code> a été spécifié. Elle l'emporte, mais
 219     <em>seulement</em> pour le type MIME spécifié, sur toute date
 220     d'expiration définie par la directive <code class="directive"><a href="#expiresdefault">ExpiresDefault</a></code>.</p>
 221
 222     <p>Vous pouvez aussi définir le mode de calcul de la date
 223     d'expiration en utilisant une <a href="#AltSyn">syntaxe
 224     alternative</a>, comme décrit plus haut dans ce document.</p>
 225
 226 </div>
 227 <div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
 228 <div class="directive-section"><h2><a name="ExpiresDefault" id="ExpiresDefault">ExpiresDefault</a> <a name="expiresdefault" id="expiresdefault">Directive</a></h2>
 229 <table class="directive">
 230 <tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Mode de calcul par défaut de la date
 231 d'expiration</td></tr>
 232 <tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>ExpiresDefault <var>&lt;code&gt;secondes</var></code></td></tr>
 233 <tr><th><a href="directive-dict.html#Context">Contexte:</a></th><td>configuration du serveur, serveur virtuel, répertoire, .htaccess</td></tr>
 234 <tr><th><a href="directive-dict.html#Override">Annuler:</a></th><td>Indexes</td></tr>
 235 <tr><th><a href="directive-dict.html#Status">Statut:</a></th><td>Extension</td></tr>
 236 <tr><th><a href="directive-dict.html#Module">Module:</a></th><td>mod_expires</td></tr>
 237 </table>
 238     <p>Cette directive permet de définir le mode de calcul par défaut de
 239     la date d'expiration pour tous les documents du domaine considéré.
 240     Elle peut être annulée pour certains types de documents par la
 241     directive <code class="directive"><a href="#expiresbytype">ExpiresByType</a></code>. Voir la description
 242     de cette dernière directive pour plus de détails à propos de la
 243     syntaxe de l'argument, ainsi que la description de la <a href="#AltSyn">syntaxe alternative</a>.</p>
 244
 245 </div>
 246 </div>
 247 <div class="bottomlang">
 248 <p><span>Langues Disponibles: </span><a href="../en/mod/mod_expires.html" hreflang="en" rel="alternate" title="English">&nbsp;en&nbsp;</a> |
 249 <a href="../fr/mod/mod_expires.html" title="Français">&nbsp;fr&nbsp;</a> |
 250 <a href="../ja/mod/mod_expires.html" hreflang="ja" rel="alternate" title="Japanese">&nbsp;ja&nbsp;</a> |
 251 <a href="../ko/mod/mod_expires.html" hreflang="ko" rel="alternate" title="Korean">&nbsp;ko&nbsp;</a></p>
 252 </div><div id="footer">
 253 <p class="apache">Copyright 2010 The Apache Software Foundation.<br />Autorisé sous <a href="http://www.apache.org/licenses/LICENSE-2.0">Apache License, Version 2.0</a>.</p>
 254 <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>
 255 </body></html>