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
263
264
265
266
267
268
269
270
271
272
273
274
275
276
277
278
279
280
281
282
283
284
285
286
287
288
289
290
291
292
293
294
295
296
297
298
299
300
301
302
303
304
305
306
307
308
|
<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE manualpage SYSTEM "../style/manualpage.dtd">
<?xml-stylesheet type="text/xsl" href="../style/manual.fr.xsl"?>
<!-- English Revision: 1799456 -->
<!-- French translation : Lucien GENTIS -->
<!-- Reviewed by : Vincent Deffontaines -->
<!--
Licensed to the Apache Software Foundation (ASF) under one or more
contributor license agreements. See the NOTICE file distributed with
this work for additional information regarding copyright ownership.
The ASF licenses this file to You under the Apache License, Version 2.0
(the "License"); you may not use this file except in compliance with
the License. You may obtain a copy of the License at
http://www.apache.org/licenses/LICENSE-2.0
Unless required by applicable law or agreed to in writing, software
distributed under the License is distributed on an "AS IS" BASIS,
WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
See the License for the specific language governing permissions and
limitations under the License.
-->
<manualpage metafile="directive-dict.xml.meta">
<title>Termes utilisés pour la description des directives</title>
<summary>
<p>Ce document décrit les termes utilisés pour décrire chaque <a
href="directives.html">directive de configuration</a> d'Apache.</p>
</summary>
<seealso><a href="../configuring.html">Fichiers de configuration</a></seealso>
<section id="Description"><title>Description</title>
<p>Une brève description des fonctions de cette directive.</p>
</section>
<section id="Syntax"><title>Syntaxe</title>
<p>Ce terme introduit le format sous lequel la directive doit
apparaître dans le fichier de configuration. Cette syntaxe est très
spécifique à la directive et est décrite en détail dans la
définition de cette dernière. En général, le nom de la directive est
suivi d'un ou plusieurs arguments séparés par des espaces. Si un
argument contient un espace, il doit être entouré de guillemets. Les
arguments optionnels sont entourés de crochets. Lorsqu'un argument
accepte une valeur parmi une liste de valeurs possibles, cette liste
est spécifiée en séparant les valeurs par une barre verticale "|".
Les textes littéraux sont présentés dans la fonte par défaut, alors
que les types d'argument pour lesquels une substitution est
nécessaire sont en <em>gras</em>. La syntaxe des directives
acceptant un nombre variable d'arguments se termine par "...", ce
qui indique que le dernier argument peut être répété.</p>
<p>Les directives utilisent un grand nombre de types d'arguments
différents. Les plus courants sont définis ci-dessous.</p>
<dl>
<dt><em>URL</em></dt>
<dd>Un Localisateur de Ressource Uniforme (Uniform Resource
Locator) complet comportant un protocole, un nom d'hôte et un nom
de chemin optionnel comme dans
<code>http://www.example.com/chemin/vers/fichier.html</code></dd>
<dt><em>chemin-URL</em></dt>
<dd>La partie de l'<em>url</em> qui suit le protocole et le nom
d'hôte comme dans <code>/chemin/vers/fichier.html</code>. Le
<em>chemin-URL</em> représente la ressource vue depuis le web, et est
différente de la représentation de cette même ressource vue depuis le
système de fichiers.</dd>
<dt><em>chemin-fichier</em></dt>
<dd>Le chemin d'un fichier dans le système de fichiers local
commençant par le répertoire racine comme dans
<code>/usr/local/apache/htdocs/chemin/vers/fichier.html</code>.
Sauf mention contraire, un <em>chemin-fichier</em> qui ne commence
pas par un slash sera considéré comme relatif au répertoire défini
par la directive <a
href="core.html#serverroot">ServerRoot</a>.</dd>
<dt><em>chemin-répertoire</em></dt>
<dd>Le chemin d'un répertoire dans le système de fichiers local
commençant par le répertoire racine comme dans
<code>/usr/local/apache/htdocs/chemin/vers/</code>.</dd>
<dt><em>nom-fichier</em></dt>
<dd>Le nom d'un fichier sans son chemin comme dans
<code>fichier.html</code>.</dd>
<dt><em>regex</em></dt>
<dd>Une <glossary ref="regex">expression rationnelle</glossary>
compatible Perl. La définition de la directive spécifiera à quoi
<em>regex</em> sera comparée.</dd>
<dt><em>extension</em></dt>
<dd>En général, c'est la partie du <em>nom de fichier</em> qui
suit le dernier point. Cependant, Apache reconnaît plusieurs
extensions de noms de fichiers ; ainsi, si un <em>nom de
fichier</em>
contient plusieurs points, chacune des parties du nom de fichier
séparées par des points et situées après le premier point est une
<em>extension</em>. Par exemple, le <em>nom de fichier</em>
<code>fichier.html.en</code> comporte deux extensions :
<code>.html</code> et <code>.en</code>. Pour les directives
Apache, vous pouvez spécifier les <em>extension</em>s avec ou sans
le point initial. Enfin, les <em>extension</em>s ne sont pas
sensibles à la casse.</dd>
<dt><em>MIME-type</em></dt>
<dd>Une méthode de description du format d'un fichier consistant
en un type de format majeur et un type de format mineur séparés
par un slash comme dans <code>text/html</code>.</dd>
<dt><em>env-variable</em></dt>
<dd>Le nom d'une <a href="../env.html">variable
d'environnement</a> définie au cours du processus de configuration
d'Apache. Notez qu'elle peut être différente d'une variable
d'environnement du système d'exploitation. Voir la <a
href="../env.html">documentation sur les variables d'environnement</a>
pour plus de détails.</dd>
<dt><em>time-interval</em></dt>
<dd>Un format d'intervalle de temps spécifique à divers paramètres de
timeout. Les formats supportés sont les suivants :
<ul>
<li><em>s</em>: Secondes</li>
<li><em>h</em>: Heures</li>
<li><em>ms</em>: Millisecondes</li>
<li><em>mi[n]</em>: Minutes</li>
</ul>
Par exemple : <code>Timeout 575ms</code>
</dd>
</dl>
</section>
<section id="Default"><title>Défaut</title>
<p>Si la directive possède une valeur par défaut (en d'autres
termes, si le serveur Web Apache se comporte comme si vous l'aviez
définie à une valeur particulière, alors que vous l'avez omise dans
votre configuration), elle est spécifiée ici. Si la directive ne
possède pas de valeur par défaut, cette section doit spécifier
"<em>Aucune</em>". Notez que la valeur par défaut dont il est
question n'est pas nécessairement la même que la valeur attribuée à
la directive dans le fichier httpd.conf par défaut distribué avec le
serveur.</p>
</section>
<section id="Context"><title>Contexte</title>
<p>Indique les parties des fichiers de configuration du serveur
où cette directive est valide. Il s'agit d'une liste d'une ou
plusieurs des valeurs suivantes séparées par des virgules :</p>
<dl>
<dt>configuration du serveur</dt>
<dd>Signifie que la directive peut être utilisée dans les fichiers
de configuration du serveur (par exemple <code>httpd.conf</code>),
mais <strong>pas</strong> à l'intérieur d'un conteneur <directive
module="core" type="section">VirtualHost</directive> ou <directive
module="core" type="section">Directory</directive>. De même, elle
n'est pas valide dans les fichiers <code>.htaccess</code>.</dd>
<dt>serveur virtuel</dt>
<dd>Signifie que la directive peut apparaître à l'intérieur d'un
conteneur <directive module="core"
type="section">VirtualHost</directive> dans les fichiers de
configuration du serveur.</dd>
<dt>répertoire</dt>
<dd>Une directive spécifiée comme valide dans ce contexte peut
être utilisée à l'intérieur de conteneurs <directive module="core"
type="section">Directory</directive>, <directive type="section"
module="core">Location</directive>, <directive module="core"
type="section">Files</directive>, <directive module="core"
type="section">If</directive>, et <directive
module="mod_proxy" type="section">Proxy</directive> dans les
fichiers de configuration du serveur, en tenant compte des
restrictions précisées dans la documentation sur les <a
href="../sections.html">Sections de configuration</a>.</dd>
<dt>.htaccess</dt>
<dd>Si une directive est valide dans ce contexte, cela signifie
qu'elle peut apparaître à l'intérieur de fichiers de configuration
de <em>niveau</em> répertoire <code>.htaccess</code>. Elle sera ou
ne sera pas traitée, selon la définition de l'option <a
href="#Override">overrides</a> pour le contexte courant.</dd>
</dl>
<p>La directive n'est autorisée <em>que</em> dans le contexte
désigné ; si vous essayez de l'utiliser ailleurs, vous générerez une
erreur de configuration qui va soit empêcher le serveur de traiter
les requêtes correctement dans ce contexte, soit tout simplement
empêcher le serveur de fonctionner -- en d'autres termes, le serveur
refusera de démarrer.</p>
<p>Les lieux de définition valides pour une directive résultent en
fait d'un
OU logique de tous les contextes spécifiés. En d'autres termes, une
directive spécifiée comme valide dans "<code>configuration du
serveur, .htaccess</code>" peut être utilisée dans le fichier
<code>httpd.conf</code> et dans les fichiers <code>.htaccess</code>,
mais pas dans un conteneur <directive module="core"
type="section">Directory</directive> ou <directive module="core"
type="section">VirtualHost</directive>.</p>
</section>
<section id="Override"><title>Surcharge .htaccess</title>
<p>Ce terme indique quelle autorisation de surcharge doit être
active pour que la directive puisse être traitée lorsqu'elle
apparaît dans un fichier <code>.htaccess</code>. Si le <a
href="#Context" >context</a> de la directive ne lui permet pas
d'apparaître dans un fichier <code>.htaccess</code>, aucun contexte
ne sera spécifié.</p>
<p>Les autorisations de surcharge sont activées via la directive
<directive module="core">AllowOverride</directive>, et possèdent une
portée particulière, comme un répertoire et tous ses
sous-répertoires, sauf si une autre directive <directive
module="core">AllowOverride</directive> apparaît à un niveau
inférieur. La documentation pour cette directive spécifie aussi les
noms d'autorisations de surcharge disponibles.</p>
</section>
<section id="Status"><title>Statut</title>
<p>Cet attribut indique le degré de rapprochement de la directive du
coeur d'Apache ; en d'autres termes, vous pouvez être amené à
recompiler le serveur avec un jeu de modules supplémentaires pour
pouvoir utiliser la directive, et ainsi accéder à ses
fonctionnalités. Les valeurs possible pour cet attribut sont :</p>
<dl>
<dt>Core</dt>
<dd>Lorsqu'une directive a pour statut "Core", cela signifie
qu'elle fait partie du coeur du serveur web Apache, et est de ce
fait toujours disponible.</dd>
<dt>MPM</dt>
<dd>Une directive dont le statut est "MPM" est fournie par un <a
href="../mpm.html">module Multi-Processus</a>. Ce type de
directive sera disponible si et seulement si vous utilisez un des
MPMs spécifiés dans la ligne <a href="#Module">Module</a> de la
définition de la directive.</dd>
<dt>Base</dt>
<dd>Une directive dont le statut est "Base" est fournie par un des
modules Apache standards qui sont compilés dans le serveur par
défaut, et sont de ce fait toujours disponibles, sauf si vous avez
fait en sorte de les supprimer de votre configuration.</dd>
<dt>Extension</dt>
<dd>Une directive dont le statut est "Extension" est fournie par
un des modules inclus dans le kit du serveur Apache, mais qui ne
sont pas compilés dans le serveur par défaut. Pour activer la
directive et accéder à ses fonctionnalités, vous devez modifier
les fichiers de configuration de la compilation du serveur, et
recompiler Apache.</dd>
<dt>Expérimental</dt>
<dd>Le statut "Experimental" indique que la directive fait partie
du kit Apache, mais que vous l'utilisez à vos risques et périls.
La directive est documentée à titre d'exhaustivité, et n'est pas
obligatoirement supportée. Le module qui fournit la directive peut
être compilé par défaut dans le serveur ou non ; consultez le haut
de la page qui décrit la directive et son module pour vérifier sa
disponibilité.</dd>
</dl>
</section>
<section id="Module"><title>Module</title>
<p>Il s'agit d'une simple liste des noms des modules sources qui
fournissent la directive.</p>
</section>
<section id="Compatibility"><title>Compatibilité</title>
<p>Si la directive ne faisait pas partie de la distribution
originale d'Apache version 2, la version dans laquelle elle a été
introduite est indiquée ici. Cette section indique aussi si la
directive n'est disponible que sur certaines plates-formes.</p>
</section>
</manualpage>
|