<?xml version="1.0"?>
<!DOCTYPE modulesynopsis SYSTEM "../style/modulesynopsis.dtd">
<?xml-stylesheet type="text/xsl" href="../style/manual.fr.xsl"?>
-<!-- English Revision: 1231607:1234643 (outdated) -->
+<!-- English Revision : 1234876 -->
<!-- French translation : Lucien GENTIS -->
<!-- Reviewed by : Vincent Deffontaines -->
<name>Include</name>
<description>Inclut d'autres fichiers de configuration dans un des
fichiers de configuration du serveur</description>
-<syntax>Include [<var>optional</var>|<var>strict</var>] <var>chemin fichier</var>|<var>chemin
-répertoire|<var>wildcard</var></var></syntax>
+<syntax>Include <var>chemin-fichier</var>|<var>chemin-répertoire</var>|<var>wildcard</var></syntax>
<contextlist><context>server config</context><context>virtual
host</context>
<context>directory</context>
exemple, nous vous recommandons d'utiliser plutôt la syntaxe avec
caractères génériques comme ci-dessous.</p>
- <p>Lorsque la partie <strong>nom de fichier</strong> ou répertoires
- du chemin
- comporte des caractères génériques, et si aucun fichier ou
- répertoire ne correspond, la directive <directive
- module="core">Include</directive> sera <strong>ignorée
- silencieusement</strong>.
- Lorsqu'une partie <strong>répertoires</strong> du chemin comporte
- des caractères génériques, et si aucun
- répertoire ne correspond, la directive <directive
- module="core">Include</directive> <strong>échouera et renverra une
- erreur</strong>
- indiquant que le fichier ou le répertoire n'a pas été trouvé.
- </p>
-
- <p>Pour contrôler plus finement le comportement du serveur
- lorsqu'aucun fichier ou répertoire ne correspond, préfixez le chemin
- avec les modificateurs <var>optional</var> ou <var>strict</var>. Si
- <var>optional</var> est spécifié, tout fichier ou répertoire avec
- caractères génériques qui ne correspond à aucun fichier ou
- répertoire sera ignoré silencieusement. Si <var>strict</var> est
- spécifié, tout fichier ou répertoire avec
- caractères génériques qui ne correspond pas à au moins un fichier
- fera échouer le démarrage du serveur.</p>
-
- <p>Lorsqu'une partie fichier ou répertoire du chemin est
- spécipée sans caractères génériques, et si ce fichier ou
- répertoire n'existe pas, la directive <directive
- module="core">Include</directive> échouera avec un message
- d'erreur indiquant que le fichier ou répertoire n'a pas pu être
- trouvé.</p>
+ <p>La directive <directive module="core">Include</directive>
+ <strong>échouera avec un code d'erreur</strong> si une expression
+ contenant des caractères génériques ne correspond à aucun fichier.
+ Pour ignorer les expressions contenant des caractères génériques ne
+ correspondant à aucun fichier, utilisez la directive <directive
+ module="core">IncludeOptional</directive>.</p>
<p>Le chemin fichier spécifié peut être soit un chemin absolu, soit
un chemin relatif au répertoire défini par la directive <directive
</example>
<p>On peut aussi insérer des caractères génériques dans la partie
- répertoires du chemin. Dans l'exemple suivant, le démarrage du
- serveur échouera si aucun répertoire ne correspond à conf/vhosts/*,
- mais réussira si aucun fichier ne correspond à *.conf :</p>
+ répertoires du chemin. Dans l'exemple suivant, la directive
+ échouera si aucun sous-répertoire de conf/vhosts ne contient au
+ moins un fichier *.conf :</p>
<example>
- Include conf/vhosts/*/vhost.conf<br />
Include conf/vhosts/*/*.conf
</example>
- <p>Dans cet exemple, le démarrage du serveur échouera si
- conf/vhosts/* ne correspond à aucun répertoire, ou si *.conf ne
- correspond à aucun fichier :</p>
+ <p>Par contre, dans l'exemple suivant, la directive sera simplement
+ ignorée si aucun sous-répertoire de conf/vhosts ne contient au
+ moins un fichier *.conf :</p>
<example>
- Include strict conf/vhosts/*/*.conf
+ IncludeOptional conf/vhosts/*/*.conf
</example>
- <p>Dans cet exemple, le démarrage du serveur réussira si
- conf/vhosts/* ne correspond à aucun répertoire, ou si *.conf ne
- correspond à aucun fichier.</p>
+</usage>
- <example>
- Include optional conf/vhosts/*/*.conf
- </example>
+<seealso><directive module="core">IncludeOptional</directive></seealso>
+<seealso><program>apachectl</program></seealso>
+</directivesynopsis>
+
+<directivesynopsis>
+<name>IncludeOptional</name>
+<description>Inclusion de fichiers dans le fichier de configuration</description>
+<syntax>IncludeOptional
+<var>chemin-fichier</var>|<var>chemin-répertoire</var>|<var>wildcard</var></syntax>
+<contextlist><context>server config</context><context>virtual host</context>
+<context>directory</context>
+</contextlist>
+<compatibility>Disponible à partir de la version 2.3.6 du serveur HTTP
+Apache</compatibility>
+
+<usage>
+ <p>Cette directive permet d'inclure des fichiers dans les fichiers
+ de configuration du serveur. Elle fonctionne de manière identique à
+ la directive <directive module="core">Include</directive>, à
+ l'exception du fait que si l'expression avec caractères génériques
+ wilcard ne correspond à aucun fichier ou répertoire, elle sera
+ ignorée silencieusement au lieu de causer une erreur.</p>
</usage>
+<seealso><directive module="core">Include</directive></seealso>
<seealso><program>apachectl</program></seealso>
</directivesynopsis>
projects / apache / commitdiff