summaryrefslogtreecommitdiff
path: root/htdocs/manual/mod/directive-dict.html.fr
blob: 940527744538be886c1ad28a1020ae5484403838 (plain)
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&eacute;s pour d&eacute;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&eacute;s pour d&eacute;crire
    les directives Apache</h1>

    <p>Chaque directive de configuration d'Apache est
    d&eacute;crite selon un format de pr&eacute;sentation commun
    ressemblant &agrave; 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&eacute;faut:</strong></a>
      <samp><em>nomDirective
      valeursParD&eacute;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&eacute;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&eacute;:</strong></a>
      <em>notes concernant la compatibilit&eacute;</em></dd>
    </dl>

    <p>Chacun des attributs possibles pour les directives, avec
    toutes leurs valeurs possibles sont d&eacute;crites dans ce
    document.</p>

    <h2>Termes employ&eacute;s pour les directives</h2>

    <ul>
      <li><a href="#Syntax">Syntaxe</a></li>

      <li><a href="#Default">D&eacute;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&eacute;</a></li>
    </ul>
    <hr />

    <h2><a id="Syntax" name="Syntax">Syntaxe</a></h2>

    <p>Indique le format dans laquelle la directive doit &ecirc;tre
    inscrite dans les fichiers de configuration. Cette syntaxe est
    tr&egrave;s sp&eacute;cifique pour chaque directive, et est
    d&eacute;crite en d&eacute;tail dans la d&eacute;finition de la
    directive. G&eacute;n&eacute;ralement, le nom de la directive
    est suivi d'un ou de plusieurs arguments. Les arguments
    optionnels sont entour&eacute;s de crochets Quand un argument
    peut prendre plus d'une valeur possible, les valeurs possibles
    sont s&eacute;par&eacute;es par une barre verticale. Les
    valeurs litt&eacute;rales sont affich&eacute;e avec la fontes
    par d&eacute;faut, tandis qur les type d'arguments pour
    lesquels une substitution doit &ecirc;tre faite sont en
    italique. Les diretrives pouvant avoir un nombre variable
    d'arguments se terminent avec "..." indiquant que le dernier
    argument se r&eacute;p&egrave;te.</p>
    <hr />

    <h2><a id="Default" name="Default">D&eacute;faut</a></h2>

    <p>Si la directive a une valeur par d&eacute;faut
    (<em>c-&agrave;-d.</em>, si elle n'apparait pas du tout dans le
    fichier de configuration, le serveur Apache se comportera comme
    si cette directive avait &eacute;t&eacute; &eacute;crite en
    mentionnant cette valeur), elle est sp&eacute;cifi&eacute;e
    ici. Si aucune valeur n'est d&eacute;finie par d&eacute;faut,
    cette section pr&eacute;cisera "<em>Non
    pr&eacute;cis&eacute;</em>".</p>
    <hr />

    <h2><a id="Context" name="Context">Contexte</a></h2>

    <p>Indique l&agrave; ou l'implantation de la directive dans le
    fichier de configuration est licite. Il est exprim&eacute;
    comme une liste s&eacute;par&eacute;e par des virgules, et
    pouvant contenir les &eacute;l&eacute;ments suivants :</p>

    <dl>
      <dt><strong>configuration serveur</strong></dt>

      <dd>La directive peut &ecirc;tre utilis&eacute;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&eacute;rieures des containers
      <samp>&lt;VirtualHost&gt;</samp> ni &lt;Directory&gt;. Elle
      n'est pas permise dans aucun des fichiers
      <samp>.htaccess</samp>.</dd>

      <dt><strong>h&ocirc;te virtuel</strong></dt>

      <dd>Dans ce contexte, la directive peut appara&icirc;tre dans
      les containers <samp>&lt;VirtualHost&gt;</samp> &eacute;crits
      dans les fichiers de configuration du serveur.</dd>

      <dt><strong>r&eacute;pertoire</strong></dt>

      <dd>La directive peut appara&icirc;tre dans les containers
      <samp>&lt;Directory&gt;</samp> &eacute;crits dans les
      fichiers de configuration du serveur.</dd>

      <dt><strong>.htaccess</strong></dt>

      <dd>La directive peut appara&icirc;tre dans les fichiers
      <samp>.htaccess</samp> situ&eacute; dans chacun des
      r&eacute;pertoires. Elle peut ou ne pas &ecirc;tre
      interpr&eacute;t&eacute;e, suivant la configuration des
      directives <a href="#Override" rel="Help">de
      surcharge</a>.</dd>
    </dl>

    <p>Les directives ne sont autoris&eacute;es <em>que</em> dans
    les contextes cit&eacute;s ; si vous essayez de les
    &eacute;crire ailleurs, vous provoquerez une erreur de
    configuration qui soit conduira le serveur &agrave; ignorer les
    requ&ecirc;tes dans le contexte sp&eacute;cifi&eacute;, soit
    peut emp&ecirc;cher le serveur de fonctionner --
    <em>c-&agrave;-d.</em>, le serveur refusera de
    d&eacute;marrer.</p>

    <p>Les emplacements valides pour les directives sont le
    r&eacute;sultat d'un OU bool&eacute;en de tous les contextes
    cit&eacute;s. En d'autres termes, une directive marqu&eacute;e
    comma &eacute;tant valide dans le contexte "<samp>configuration
    serveur, .htaccess</samp>" peut &ecirc;tre utilis&eacute;e dans
    le fichier <samp>httpd.conf</samp> et dans les fichiers
    <samp>.htaccess</samp>, mais pas dans le container
    &lt;Directory&gt; ni &lt;VirtualHost&gt;.</p>
    <hr />

    <h2><a id="Override" name="Override">Surcharge</a></h2>

    <p>Cet attribut de directive pr&eacute;cise quelle surcharge
    doit &ecirc;tre permise pour que la directive puisse &ecirc;tre
    interpr&eacute;t&eacute;e lorsqu'elle appara&icirc;t dans un
    fichier <samp>.htaccess</samp>. Si le <a href="#Context"
    rel="Help">contexte</a> de directive ne permet pas une
    &eacute;criture dans les fichiers <samp>.htaccess</samp>, cet
    attribut doit mentionner "<em>Non applicable</em>".</p>

    <p>Les surcharges sont g&eacute;r&eacute;es par la directive <a
    href="core.html#allowoverrides"
    rel="Help"><samp>AllowOverrides</samp></a>, et ont une
    port&eacute;e d&eacute;finie, par exemple un r&eacute;pertoire
    donn&eacute; et tous ses descendants, sauf si la configuration
    de surcharge est chang&eacute;e &agrave; un endroit de la
    descendance par une directive <samp>AllowOverrides</samp> d'un
    niveau inf&eacute;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 &agrave; quel module du serveur Apache Web la
    directive est rattach&eacute;e ; en d'autres termes, vous
    devrez peut &ecirc;tre recompiler le serveur en
    pr&eacute;cisant un ensemble plus large de modules pour pouvoir
    b&eacute;n&eacute;ficier de cette fonctionnalit&eacute;. 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&eacute;ment&eacute;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&eacute; ce module &agrave; la compilation.</dd>

      <dt><strong>Extension</strong></dt>

      <dd>La directive est impl&eacute;ment&eacute;e par un module
      faisant partie de l'Apache Server Kit, mais ce module n'est
      pas compil&eacute; par d&eacute;faut. Pour activer cette
      directive, et rendre op&eacute;rationnelle cette
      fonctionnalit&eacute;, vous devrez modifier le fichier de
      configuration de compilation et recompiler Apache.</dd>

      <dt><strong>Exp&eacute;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'&agrave; vos risques et p&eacute;rils. La
      directive est document&eacute; dans un souci
      d'exhaustivit&eacute; mais n'est pas forc&eacute;ment
      support&eacute;e. Le module qui donne acc&egrave;s &agrave;
      cette directive peut &ecirc;tre ou ne pas &ecirc;tre
      compil&eacute; par d&eacute;faut ; reportez vous en
      t&ecirc;te de la page qui d&eacute;crit la directive et le
      module pour toute remarque concernant sa
      disponibilit&eacute;.</dd>
    </dl>
    <hr />

    <h2><a id="Module" name="Module">Module</a></h2>

    <p>Donne simplement le nom du module ou est
    impl&eacute;ment&eacute;e cette fonctionnalit&eacute;.</p>
    <hr />

    <h2><a id="Compatibility"
    name="Compatibility">Compatibilit&eacute;</a></h2>

    <p>Si la directive ne faisait pas partie de la version 1
    d'Apache, le num&eacute;ro indique la version dans laquelle
    elle a &eacute;t&eacute; introduite. Si la directive a le
    m&ecirc;me nom qu'une ancienne directive du serveur HTTPd du
    NCSA, toute diff&eacute;rence de comportement y sera
    mentionn&eacute;e. Dans les autres cas, cette rubrique
    affichera "<em>Pas de remarques sur
    compatiblit&eacute;.</em>"</p>
    <!--#include virtual="footer.html" -->
  </body>
</html>