-<?xml version="1.0" ?>
+<?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 : 1544630 -->
<manualpage metafile="directive-dict.xml.meta">
- <title>Termes utilisés pour la description des directives</title>
+ <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
+ <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>
+<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
+ 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
+ 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
+ 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>
+ 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>
+ 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
+ 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>
+ 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
+ <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
+ 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>
+ <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
+ <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>
<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>
+ 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
+ <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
+ 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
+ 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>
+ 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
+ <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
+ 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>
+ pour plus de détails.</dd>
</dl>
</section>
-<section id="Default"><title>Défaut</title>
+<section id="Default"><title>Défaut</title>
- <p>Si la directive possède une valeur par défaut (en d'autres
+ <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
+ 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>
+ 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>
+ <dt>configuration globale</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
+ <dd>Signifie que la directive peut être utilisée dans les fichiers
+ de configuration globale (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
+ 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
+ <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>
+ <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"
+ <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
+ 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
+ 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>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
+ <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
+ OU logique de tous les contextes spécifiés. En d'autres termes, une
+ directive spécifiée comme valide dans "<code>configuration globale,
+ .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>
+<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
+ <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
+ 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>
+ <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>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>
+ 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
+ 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
+ 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>
+ <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>
+ <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>
fournissent la directive.</p>
</section>
-<section id="Compatibility"><title>Compatibilité</title>
+<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
+ 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>
projects / thirdparty / apache / httpd.git / commitdiff
