| <?xml version="1.0" ?> |
| <!DOCTYPE manualpage SYSTEM "../style/manualpage.dtd"> |
| <?xml-stylesheet type="text/xsl" href="../style/manual.fr.xsl"?> |
| <!-- English Revision : 1544630 --> |
| <!-- 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 du web, et est |
| différente de la représentation de cette même ressource vue du |
| 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> |
| </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/Écrasement</title> |
| |
| <p>Ce terme indique quelle autorisation de surcharge ("override") 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 "Expérimental" 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> |
| |
