1 <?xml version="1.0" encoding="ISO-8859-1" ?>
2 <!DOCTYPE manualpage SYSTEM "../style/manualpage.dtd">
3 <?xml-stylesheet type="text/xsl" href="../style/manual.fr.xsl"?>
4 <!-- English Revision : 1544626 -->
5 <!-- French translation : Lucien GENTIS -->
6 <!-- Reviewed by : Vincent Deffontaines -->
9 Licensed to the Apache Software Foundation (ASF) under one or more
10 contributor license agreements. See the NOTICE file distributed with
11 this work for additional information regarding copyright ownership.
12 The ASF licenses this file to You under the Apache License, Version 2.0
13 (the "License"); you may not use this file except in compliance with
14 the License. You may obtain a copy of the License at
16 http://www.apache.org/licenses/LICENSE-2.0
18 Unless required by applicable law or agreed to in writing, software
19 distributed under the License is distributed on an "AS IS" BASIS,
20 WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
21 See the License for the specific language governing permissions and
22 limitations under the License.
25 <manualpage metafile="directive-dict.xml.meta">
27 <title>Termes utilisés pour la description des directives</title>
30 <p>Ce document décrit les termes utilisés pour décrire chaque <a
31 href="directives.html">directive de configuration</a> d'Apache.</p>
33 <seealso><a href="../configuring.html">Fichiers de configuration</a></seealso>
35 <section id="Description"><title>Description</title>
37 <p>Une brève description des fonctions de cette directive.</p>
40 <section id="Syntax"><title>Syntaxe</title>
42 <p>Ce terme introduit le format sous lequel la directive doit
43 apparaître dans le fichier de configuration. Cette syntaxe est très
44 spécifique à la directive et est décrite en détail dans la
45 définition de cette dernière. En général, le nom de la directive est
46 suivi d'un ou plusieurs arguments séparés par des espaces. Si un
47 argument contient un espace, il doit être entouré de guillemets. Les
48 arguments optionnels sont entourés de crochets. Lorsqu'un argument
49 accepte une valeur parmi une liste de valeurs possibles, cette liste
50 est spécifiée en séparant les valeurs par une barre verticale "|".
51 Les textes littéraux sont présentés dans la fonte par défaut, alors
52 que les types d'argument pour lesquels une substitution est
53 nécessaire sont en <em>gras</em>. La syntaxe des directives
54 acceptant un nombre variable d'arguments se termine par "...", ce
55 qui indique que le dernier argument peut être répété.</p>
57 <p>Les directives utilisent un grand nombre de types d'arguments
58 différents. Les plus courants sont définis ci-dessous.</p>
63 <dd>Un Localisateur de Ressource Uniforme (Uniform Resource
64 Locator) complet comportant un protocole, un nom d'hôte et un nom
65 de chemin optionnel comme dans
66 <code>http://www.example.com/chemin/vers/fichier.html</code></dd>
68 <dt><em>chemin-URL</em></dt>
70 <dd>La partie de l'<em>url</em> qui suit le protocole et le nom
71 d'hôte comme dans <code>/chemin/vers/fichier.html</code>. Le
72 <em>chemin-URL</em> représente la ressource vue depuis le web, et est
73 différente de la représentation de cette même ressource vue depuis le
74 système de fichiers.</dd>
76 <dt><em>chemin-fichier</em></dt>
78 <dd>Le chemin d'un fichier dans le système de fichiers local
79 commençant par le répertoire racine comme dans
80 <code>/usr/local/apache/htdocs/chemin/vers/fichier.html</code>.
81 Sauf mention contraire, un <em>chemin-fichier</em> qui ne commence
82 pas par un slash sera considéré comme relatif au répertoire défini
84 href="core.html#serverroot">ServerRoot</a>.</dd>
86 <dt><em>chemin-répertoire</em></dt>
88 <dd>Le chemin d'un répertoire dans le système de fichiers local
89 commençant par le répertoire racine comme dans
90 <code>/usr/local/apache/htdocs/chemin/vers/</code>.</dd>
92 <dt><em>nom-fichier</em></dt>
94 <dd>Le nom d'un fichier sans son chemin comme dans
95 <code>fichier.html</code>.</dd>
97 <dt><em>regex</em></dt>
99 <dd>Une <glossary ref="regex">expression rationnelle</glossary>
100 compatible Perl. La définition de la directive spécifiera à quoi
101 <em>regex</em> sera comparée.</dd>
103 <dt><em>extension</em></dt>
105 <dd>En général, c'est la partie du <em>nom de fichier</em> qui
106 suit le dernier point. Cependant, Apache reconnaît plusieurs
107 extensions de noms de fichiers ; ainsi, si un <em>nom de
109 contient plusieurs points, chacune des parties du nom de fichier
110 séparées par des points et situées après le premier point est une
111 <em>extension</em>. Par exemple, le <em>nom de fichier</em>
112 <code>fichier.html.en</code> comporte deux extensions :
113 <code>.html</code> et <code>.en</code>. Pour les directives
114 Apache, vous pouvez spécifier les <em>extension</em>s avec ou sans
115 le point initial. Enfin, les <em>extension</em>s ne sont pas
116 sensibles à la casse.</dd>
118 <dt><em>MIME-type</em></dt>
120 <dd>Une méthode de description du format d'un fichier consistant
121 en un type de format majeur et un type de format mineur séparés
122 par un slash comme dans <code>text/html</code>.</dd>
124 <dt><em>env-variable</em></dt>
126 <dd>Le nom d'une <a href="../env.html">variable
127 d'environnement</a> définie au cours du processus de configuration
128 d'Apache. Notez qu'elle peut être différente d'une variable
129 d'environnement du système d'exploitation. Voir la <a
130 href="../env.html">documentation sur les variables d'environnement</a>
131 pour plus de détails.</dd>
135 <section id="Default"><title>Défaut</title>
137 <p>Si la directive possède une valeur par défaut (en d'autres
138 termes, si le serveur Web Apache se comporte comme si vous l'aviez
139 définie à une valeur particulière, alors que vous l'avez omise dans
140 votre configuration), elle est spécifiée ici. Si la directive ne
141 possède pas de valeur par défaut, cette section doit spécifier
142 "<em>Aucune</em>". Notez que la valeur par défaut dont il est
143 question n'est pas nécessairement la même que la valeur attribuée à
144 la directive dans le fichier httpd.conf par défaut distribué avec le
148 <section id="Context"><title>Contexte</title>
150 <p>Indique les parties des fichiers de configuration du serveur
151 où cette directive est valide. Il s'agit d'une liste d'une ou
152 plusieurs des valeurs suivantes séparées par des virgules :</p>
155 <dt>configuration du serveur</dt>
157 <dd>Signifie que la directive peut être utilisée dans les fichiers
158 de configuration du serveur (par exemple <code>httpd.conf</code>),
159 mais <strong>pas</strong> à l'intérieur d'un conteneur <directive
160 module="core" type="section">VirtualHost</directive> ou <directive
161 module="core" type="section">Directory</directive>. De même, elle
162 n'est pas valide dans les fichiers <code>.htaccess</code>.</dd>
164 <dt>serveur virtuel</dt>
166 <dd>Signifie que la directive peut apparaître à l'intérieur d'un
167 conteneur <directive module="core"
168 type="section">VirtualHost</directive> dans les fichiers de
169 configuration du serveur.</dd>
171 <dt>répertoire</dt>
173 <dd>Une directive spécifiée comme valide dans ce contexte peut
174 être utilisée à l'intérieur de conteneurs <directive module="core"
175 type="section">Directory</directive>, <directive type="section"
176 module="core">Location</directive>, <directive module="core"
177 type="section">Files</directive>, <directive module="core"
178 type="section">If</directive>, et <directive
179 module="mod_proxy" type="section">Proxy</directive> dans les
180 fichiers de configuration du serveur, en tenant compte des
181 restrictions précisées dans la documentation sur les <a
182 href="../sections.html">Sections de configuration</a>.</dd>
186 <dd>Si une directive est valide dans ce contexte, cela signifie
187 qu'elle peut apparaître à l'intérieur de fichiers de configuration
188 de <em>niveau</em> répertoire <code>.htaccess</code>. Elle sera ou
189 ne sera pas traitée, selon la définition de l'option <a
190 href="#Override">overrides</a> pour le contexte courant.</dd>
193 <p>La directive n'est autorisée <em>que</em> dans le contexte
194 désigné ; si vous essayez de l'utiliser ailleurs, vous générerez une
195 erreur de configuration qui va soit empêcher le serveur de traiter
196 les requêtes correctement dans ce contexte, soit tout simplement
197 empêcher le serveur de fonctionner -- en d'autres termes, le serveur
198 refusera de démarrer.</p>
200 <p>Les lieux de définition valides pour une directive résultent en
202 OU logique de tous les contextes spécifiés. En d'autres termes, une
203 directive spécifiée comme valide dans "<code>configuration du
204 serveur, .htaccess</code>" peut être utilisée dans le fichier
205 <code>httpd.conf</code> et dans les fichiers <code>.htaccess</code>,
206 mais pas dans un conteneur <directive module="core"
207 type="section">Directory</directive> ou <directive module="core"
208 type="section">VirtualHost</directive>.</p>
211 <section id="Override"><title>Surcharge .htaccess</title>
213 <p>Ce terme indique quelle autorisation de surcharge doit être
214 active pour que la directive puisse être traitée lorsqu'elle
215 apparaît dans un fichier <code>.htaccess</code>. Si le <a
216 href="#Context" >context</a> de la directive ne lui permet pas
217 d'apparaître dans un fichier <code>.htaccess</code>, aucun contexte
218 ne sera spécifié.</p>
220 <p>Les autorisations de surcharge sont activées via la directive
221 <directive module="core">AllowOverride</directive>, et possèdent une
222 portée particulière, comme un répertoire et tous ses
223 sous-répertoires, sauf si une autre directive <directive
224 module="core">AllowOverride</directive> apparaît à un niveau
225 inférieur. La documentation pour cette directive spécifie aussi les
226 noms d'autorisations de surcharge disponibles.</p>
229 <section id="Status"><title>Statut</title>
231 <p>Cet attribut indique le degré de rapprochement de la directive du
232 coeur d'Apache ; en d'autres termes, vous pouvez être amené à
233 recompiler le serveur avec un jeu de modules supplémentaires pour
234 pouvoir utiliser la directive, et ainsi accéder à ses
235 fonctionnalités. Les valeurs possible pour cet attribut sont :</p>
240 <dd>Lorsqu'une directive a pour statut "Core", cela signifie
241 qu'elle fait partie du coeur du serveur web Apache, et est de ce
242 fait toujours disponible.</dd>
246 <dd>Une directive dont le statut est "MPM" est fournie par un <a
247 href="../mpm.html">module Multi-Processus</a>. Ce type de
248 directive sera disponible si et seulement si vous utilisez un des
249 MPMs spécifiés dans la ligne <a href="#Module">Module</a> de la
250 définition de la directive.</dd>
254 <dd>Une directive dont le statut est "Base" est fournie par un des
255 modules Apache standards qui sont compilés dans le serveur par
256 défaut, et sont de ce fait toujours disponibles, sauf si vous avez
257 fait en sorte de les supprimer de votre configuration.</dd>
261 <dd>Une directive dont le statut est "Extension" est fournie par
262 un des modules inclus dans le kit du serveur Apache, mais qui ne
263 sont pas compilés dans le serveur par défaut. Pour activer la
264 directive et accéder à ses fonctionnalités, vous devez modifier
265 les fichiers de configuration de la compilation du serveur, et
266 recompiler Apache.</dd>
268 <dt>Expérimental</dt>
270 <dd>Le statut "Experimental" indique que la directive fait partie
271 du kit Apache, mais que vous l'utilisez à vos risques et périls.
272 La directive est documentée à titre d'exhaustivité, et n'est pas
273 obligatoirement supportée. Le module qui fournit la directive peut
274 être compilé par défaut dans le serveur ou non ; consultez le haut
275 de la page qui décrit la directive et son module pour vérifier sa
276 disponibilité.</dd>
280 <section id="Module"><title>Module</title>
282 <p>Il s'agit d'une simple liste des noms des modules sources qui
283 fournissent la directive.</p>
286 <section id="Compatibility"><title>Compatibilité</title>
288 <p>Si la directive ne faisait pas partie de la distribution
289 originale d'Apache version 2, la version dans laquelle elle a été
290 introduite est indiquée ici. Cette section indique aussi si la
291 directive n'est disponible que sur certaines plates-formes.</p>