1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
232
233
234
235
236
237
238
239
240
241
242
243
244
245
246
247
248
249
250
251
252
253
254
255
256
257
258
259
260
261
262
|
<?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">
<html xmlns="http://www.w3.org/1999/xhtml" lang="fr" xml:lang="fr"><head><!--
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" />
<link href="../style/css/manual-print.css" rel="stylesheet" media="print" type="text/css" />
<link href="../images/favicon.ico" rel="shortcut icon" /></head>
<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.3</p>
<img alt="" src="../images/feather.gif" /></div>
<div class="up"><a href="./"><img title="<-" alt="<-" src="../images/left.gif" /></a></div>
<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.3</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="../fr/mod/mod_expires.html" title="Fran�ais"> fr </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> |
<a href="../zh-cn/mod/mod_expires.html" hreflang="zh-cn" rel="alternate" title="Simplified Chinese"> zh-cn </a></p>
</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#Status">Statut:</a></th><td>Extension</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">
<li><img alt="" src="../images/down.gif" /> <a href="#expiresactive">ExpiresActive</a></li>
<li><img alt="" src="../images/down.gif" /> <a href="#expiresbytype">ExpiresByType</a></li>
<li><img alt="" src="../images/down.gif" /> <a href="#expiresdefault">ExpiresDefault</a></li>
</ul>
<h3>Sujets</h3>
<ul id="topics">
<li><img alt="" src="../images/down.gif" /> <a href="#AltSyn">Autre syntaxe de d�finition de
l'intervalle</a></li>
</ul></div>
<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></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 />
ExpiresByType type/encoding "<base> [plus]
{<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>
ExpiresByType text/html "access plus 1 month 15
days 2 hours"<br />
ExpiresByType image/gif "modification plus 5 hours 3
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="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></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>
<tr><th><a href="directive-dict.html#Override">AllowOverride:</a></th><td>Indexes</td></tr>
<tr><th><a href="directive-dict.html#Status">Statut:</a></th><td>Extension</td></tr>
<tr><th><a href="directive-dict.html#Module">Module:</a></th><td>mod_expires</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="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></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>
<tr><th><a href="directive-dict.html#Override">AllowOverride:</a></th><td>Indexes</td></tr>
<tr><th><a href="directive-dict.html#Status">Statut:</a></th><td>Extension</td></tr>
<tr><th><a href="directive-dict.html#Module">Module:</a></th><td>mod_expires</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
type MIME sp�cifi� (par exemple, <code>text/html</code>). Le second
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 />
ExpiresByType image/gif A2592000<br />
# les documents HTML restent valables une semaine apr�s leur date
# de derni�re modification<br />
ExpiresByType text/html M604800
</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="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></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>
<tr><th><a href="directive-dict.html#Override">AllowOverride:</a></th><td>Indexes</td></tr>
<tr><th><a href="directive-dict.html#Status">Statut:</a></th><td>Extension</td></tr>
<tr><th><a href="directive-dict.html#Module">Module:</a></th><td>mod_expires</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="../fr/mod/mod_expires.html" title="Fran�ais"> fr </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> |
<a href="../zh-cn/mod/mod_expires.html" hreflang="zh-cn" rel="alternate" title="Simplified Chinese"> zh-cn </a></p>
</div><div id="footer">
<p class="apache">Copyright 2011 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>
|
