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
|
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
"http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<!--Traduction anglais 1.4 -->
<html xmlns="http://www.w3.org/1999/xhtml">
<head>
<META NAME="ROBOTS" CONTENT="NOINDEX, NOFOLLOW">
<meta name="generator" content="HTML Tidy, see www.w3.org" />
<meta http-equiv="Content-Type"
content="text/html; charset=iso-8859-1" />
<title>Termes utilisés pour décrire les
directives Apache</title>
</head>
<!-- Background white, links blue (unvisited), navy (visited), red (active) -->
<body bgcolor="#FFFFFF" text="#000000" link="#0000FF"
vlink="#000080" alink="#FF0000">
<!--#include virtual="header.html" -->
<h1 align="CENTER">Termes utilisés pour décrire
les directives Apache</h1>
<p>Chaque directive de configuration d'Apache est
décrite selon un format de présentation commun
ressemblant à ceci :</p>
<dl>
<dd><a href="#Syntax"
rel="Help"><strong>Syntaxe:</strong></a>
<em>nomDirective</em> <em>arguments</em><br />
<a href="#Default"
rel="Help"><strong>Défaut:</strong></a>
<samp><em>nomDirective
valeursParDéfaut</em></samp><br />
<a href="#Context" rel="Help"><strong>Contexte:</strong></a>
<em>listeDeContextes</em><br />
<a href="#Override"
rel="Help"><strong>Surcharge:</strong></a>
<em>DirectivesSurchargées</em><br />
<a href="#Status" rel="Help"><strong>Statut:</strong></a>
<em>statut</em><br />
<a href="#Module" rel="Help"><strong>Module:</strong></a>
<em>nomModule</em><br />
<a href="#Compatibility"
rel="Help"><strong>Compatibilité:</strong></a>
<em>notes concernant la compatibilité</em></dd>
</dl>
<p>Chacun des attributs possibles pour les directives, avec
toutes leurs valeurs possibles sont décrites dans ce
document.</p>
<h2>Termes employés pour les directives</h2>
<ul>
<li><a href="#Syntax">Syntaxe</a></li>
<li><a href="#Default">Défaut</a></li>
<li><a href="#Context">Contexte</a></li>
<li><a href="#Override">Surcharge</a></li>
<li><a href="#Status">Statut</a></li>
<li><a href="#Module">Module</a></li>
<li><a href="#Compatibility">Compatibilité</a></li>
</ul>
<hr />
<h2><a id="Syntax" name="Syntax">Syntaxe</a></h2>
<p>Indique le format dans laquelle la directive doit être
inscrite dans les fichiers de configuration. Cette syntaxe est
très spécifique pour chaque directive, et est
décrite en détail dans la définition de la
directive. Généralement, le nom de la directive
est suivi d'un ou de plusieurs arguments. Les arguments
optionnels sont entourés de crochets Quand un argument
peut prendre plus d'une valeur possible, les valeurs possibles
sont séparées par une barre verticale. Les
valeurs littérales sont affichée avec la fontes
par défaut, tandis qur les type d'arguments pour
lesquels une substitution doit être faite sont en
italique. Les diretrives pouvant avoir un nombre variable
d'arguments se terminent avec "..." indiquant que le dernier
argument se répète.</p>
<hr />
<h2><a id="Default" name="Default">Défaut</a></h2>
<p>Si la directive a une valeur par défaut
(<em>c-à-d.</em>, si elle n'apparait pas du tout dans le
fichier de configuration, le serveur Apache se comportera comme
si cette directive avait été écrite en
mentionnant cette valeur), elle est spécifiée
ici. Si aucune valeur n'est définie par défaut,
cette section précisera "<em>Non
précisé</em>".</p>
<hr />
<h2><a id="Context" name="Context">Contexte</a></h2>
<p>Indique là ou l'implantation de la directive dans le
fichier de configuration est licite. Il est exprimé
comme une liste séparée par des virgules, et
pouvant contenir les éléments suivants :</p>
<dl>
<dt><strong>configuration serveur</strong></dt>
<dd>La directive peut être utilisée dans le
fichier de configuration du serveur (<em>ex.</em>,
<samp>httpd.conf</samp>, <samp>srm.conf</samp>, et
<samp>access.conf</samp>), mais dans <strong>aucune</strong>
des sections intérieures des containers
<samp><VirtualHost></samp> ni <Directory>. Elle
n'est pas permise dans aucun des fichiers
<samp>.htaccess</samp>.</dd>
<dt><strong>hôte virtuel</strong></dt>
<dd>Dans ce contexte, la directive peut apparaître dans
les containers <samp><VirtualHost></samp> écrits
dans les fichiers de configuration du serveur.</dd>
<dt><strong>répertoire</strong></dt>
<dd>La directive peut apparaître dans les containers
<samp><Directory></samp> écrits dans les
fichiers de configuration du serveur.</dd>
<dt><strong>.htaccess</strong></dt>
<dd>La directive peut apparaître dans les fichiers
<samp>.htaccess</samp> situé dans chacun des
répertoires. Elle peut ou ne pas être
interprétée, suivant la configuration des
directives <a href="#Override" rel="Help">de
surcharge</a>.</dd>
</dl>
<p>Les directives ne sont autorisées <em>que</em> dans
les contextes cités ; si vous essayez de les
écrire ailleurs, vous provoquerez une erreur de
configuration qui soit conduira le serveur à ignorer les
requêtes dans le contexte spécifié, soit
peut empêcher le serveur de fonctionner --
<em>c-à-d.</em>, le serveur refusera de
démarrer.</p>
<p>Les emplacements valides pour les directives sont le
résultat d'un OU booléen de tous les contextes
cités. En d'autres termes, une directive marquée
comma étant valide dans le contexte "<samp>configuration
serveur, .htaccess</samp>" peut être utilisée dans
le fichier <samp>httpd.conf</samp> et dans les fichiers
<samp>.htaccess</samp>, mais pas dans le container
<Directory> ni <VirtualHost>.</p>
<hr />
<h2><a id="Override" name="Override">Surcharge</a></h2>
<p>Cet attribut de directive précise quelle surcharge
doit être permise pour que la directive puisse être
interprétée lorsqu'elle apparaît dans un
fichier <samp>.htaccess</samp>. Si le <a href="#Context"
rel="Help">contexte</a> de directive ne permet pas une
écriture dans les fichiers <samp>.htaccess</samp>, cet
attribut doit mentionner "<em>Non applicable</em>".</p>
<p>Les surcharges sont gérées par la directive <a
href="core.html#allowoverrides"
rel="Help"><samp>AllowOverrides</samp></a>, et ont une
portée définie, par exemple un répertoire
donné et tous ses descendants, sauf si la configuration
de surcharge est changée à un endroit de la
descendance par une directive <samp>AllowOverrides</samp> d'un
niveau inférieur. La documentation pour cette directive
liste aussi les noms possibles de surcharges disponibles.</p>
<hr />
<h2><a id="Status" name="Status">Statut</a></h2>
<p>Indique à quel module du serveur Apache Web la
directive est rattachée ; en d'autres termes, vous
devrez peut être recompiler le serveur en
précisant un ensemble plus large de modules pour pouvoir
bénéficier de cette fonctionnalité. Les
valeurs possibles pour cet attribut sont :</p>
<dl>
<dt><strong>Noyau</strong></dt>
<dd>Il s'agit d'une directive du noyau d'Apache et est de ce
fait toujours disponible.</dd>
<dt><strong>Base</strong></dt>
<dd>La directive est implémentée dans un module
d'Apache faisant partie de l'ensemble de compilation de base,
et est normalement disponible sauf si vous avez explicitement
enlevé ce module à la compilation.</dd>
<dt><strong>Extension</strong></dt>
<dd>La directive est implémentée par un module
faisant partie de l'Apache Server Kit, mais ce module n'est
pas compilé par défaut. Pour activer cette
directive, et rendre opérationnelle cette
fonctionnalité, vous devrez modifier le fichier de
configuration de compilation et recompiler Apache.</dd>
<dt><strong>Expérimental</strong></dt>
<dd>Le statut "Experimental" indique que la directive est
disponible dans le Kit Apache, mais que vous ne pouvez
l'utiliser qu'à vos risques et périls. La
directive est documenté dans un souci
d'exhaustivité mais n'est pas forcément
supportée. Le module qui donne accès à
cette directive peut être ou ne pas être
compilé par défaut ; reportez vous en
tête de la page qui décrit la directive et le
module pour toute remarque concernant sa
disponibilité.</dd>
</dl>
<hr />
<h2><a id="Module" name="Module">Module</a></h2>
<p>Donne simplement le nom du module ou est
implémentée cette fonctionnalité.</p>
<hr />
<h2><a id="Compatibility"
name="Compatibility">Compatibilité</a></h2>
<p>Si la directive ne faisait pas partie de la version 1
d'Apache, le numéro indique la version dans laquelle
elle a été introduite. Si la directive a le
même nom qu'une ancienne directive du serveur HTTPd du
NCSA, toute différence de comportement y sera
mentionnée. Dans les autres cas, cette rubrique
affichera "<em>Pas de remarques sur
compatiblité.</em>"</p>
<!--#include virtual="footer.html" -->
</body>
</html>
|