mirror of
https://github.com/apache/httpd.git
synced 2025-11-14 01:22:37 +03:00
3e7485982e
git-svn-id: https://svn.apache.org/repos/asf/httpd/httpd/trunk@1436575 13f79535-47bb-0310-9956-ffa450edef68
207 lines
8.5 KiB
Plaintext
207 lines
8.5 KiB
Plaintext
<?xml version="1.0"?>
|
|
<!DOCTYPE modulesynopsis SYSTEM "../style/modulesynopsis.dtd">
|
|
<?xml-stylesheet type="text/xsl" href="../style/manual.fr.xsl"?>
|
|
<!-- English Revision: 1436366:1436574 (outdated) -->
|
|
<!-- French translation: Fabien Coelho -->
|
|
|
|
<!--
|
|
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.
|
|
-->
|
|
|
|
<modulesynopsis metafile="mod_macro.xml.meta">
|
|
|
|
<name>mod_macro</name>
|
|
<description>Ce module permet d'utiliser des macros dans les fichiers
|
|
de configuration Apache.</description>
|
|
<status>Base</status>
|
|
<sourcefile>mod_macro.c</sourcefile>
|
|
<identifier>macro_module</identifier>
|
|
|
|
<summary>
|
|
|
|
<p>Ce module permet de définir et d'utiliser des macros dans les fichiers
|
|
de configuration Apache. Ces macros peuvent avoir des paramètres qui sont
|
|
expansés à l'utilisation (les paramètres sont remplacés par la valeur
|
|
passée en argument), et le résultat de la substitution est traité
|
|
normalement.</p>
|
|
</summary>
|
|
|
|
<section id="features"><title>Caractéristiques</title>
|
|
|
|
<p>Définition d'une macro :</p>
|
|
<ul>
|
|
<li> dans une section <Macro> au style homogène à la
|
|
syntaxe des fichiers de configuration Apache.</li>
|
|
<li> l'utilisateur choisit le nom de la macro et de ses paramètres.</li>
|
|
<li> les noms de macro sont insensibles à la casse, comme les directives Apache.</li>
|
|
<li> les noms de paramètres sont par contre sensibles à la casse.</li>
|
|
<li> les paramètres d'une macro doivent avoir des noms distincts.</li>
|
|
<li> il y a une erreur si un paramètre a un nom vide.</li>
|
|
<li> la redéfinition d'une macro génère un avertissement.</li>
|
|
<li> des définitions de macros peuvent être nichées les unes dans les autres...</li>
|
|
<li> les paramètres inutilisés génèrent un avertissement.</li>
|
|
<li> les noms de paramètre en préfixe les uns des autres génèrent un avertissement.</li>
|
|
<li> les noms de paramètre non préfixés par '<code>$%@</code>' génèrent un
|
|
avertissement pour encourager cette bonne pratique.</li>
|
|
<li> les différents préfixes proposés permettent de gérer les interactions
|
|
avec d'autres directives comme <directive module="core">Define</directive>.</li>
|
|
<li> un conseil : il peut être utile d'ajouter des accolades autour du nom d'un
|
|
paramètre, par exemple <code>${foo}</code>, de manière à ce que le
|
|
paramètre puisse être utilisée avec des caractères collés autour,
|
|
par exemple <code>bla${foo}bla</code>.</li>
|
|
<li> génère un avertissement si le contenu de la macro est vide.</li>
|
|
<li> génère un avertissement si le système détecte que les sections à l'intérieur
|
|
d'une macro ne sont pas correctement nichées.</li>
|
|
<li> la portée lexicale des paramètres d'une macro est restreinte au texte
|
|
de la macro elle-même... en particulier elle n'est pas propagée aux inclusions.</li>
|
|
<li> il n'y a pas de contrainte sur le contenu d'une macro.
|
|
<p>Cela signifie que vous pouvez mettre une section perl ou n'importe
|
|
quoi d'autre dans une macro. Il n'y a pas d'autre hypothèse sur la
|
|
structure lexicale et syntaxique de la macro (guillemets, espaces...)
|
|
que d'attendre une séquence de ligne avec éventuellement des
|
|
continuations.</p></li>
|
|
</ul>
|
|
|
|
<p>Utilisation d'une macro:</p>
|
|
<ul>
|
|
<li> le nombre d'argument doit être cohérent avec la définition.</li>
|
|
<li> toutes les occurences des paramètres sont substitués par leur valeur.</li>
|
|
<li> en cas de conflit, le nom le plus long est choisit.</li>
|
|
<li> une récursion dans l'expansion d'une macro est détectée et arrêtée avec une erreur.</li>
|
|
<li> les arguments vides génèrent un avertissement si ils sont utilisés.</li>
|
|
<li> le système génère une description très précise de la localisation des erreurs.</li>
|
|
<li> les valeurs des paramètres préfixés par <code>$</code> et <code>%</code> ne sont pas protégés.</li>
|
|
<li> les valeurs des paramètres préfixés par <code>@</code> sont protégés par des guillemets.</li>
|
|
</ul>
|
|
|
|
<p>Effacement de la définition d'une macro :</p>
|
|
<ul>
|
|
<li> la macro effacée doit avoir été définie auparavant.</li>
|
|
</ul>
|
|
|
|
<highlight language="config">
|
|
<Macro DirGroup $dir $group>
|
|
<Directory $dir>
|
|
require group $group
|
|
</Directory>
|
|
</Macro>
|
|
|
|
Use DirGroup /www/apache/private private
|
|
Use DirGroup /www/apache/server admin
|
|
|
|
UndefMacro DirGroup
|
|
</highlight>
|
|
</section>
|
|
|
|
<!-- Macro -->
|
|
<directivesynopsis type="section">
|
|
<name>Macro</name>
|
|
<description>Définition d'une macro dans un fichier de configuration</description>
|
|
<syntax>
|
|
<Macro <var>nom</var> [<var>par1</var> .. <var>parN</var>]>
|
|
... </Macro></syntax>
|
|
<contextlist>
|
|
<context>server config</context>
|
|
<context>virtual host</context>
|
|
<context>directory</context>
|
|
</contextlist>
|
|
|
|
<usage>
|
|
<p>La diretive <directive>Macro</directive> permet de définir une macro
|
|
dans un fichier de configuration Apache. Le premier argument est le nom
|
|
de la macro, et les arguments suivants sont les noms des paramètres. Il
|
|
est de bon aloi de préfixer les noms des paramètres d'une macro
|
|
avec un caractère parmi '<code>$%@</code>'.
|
|
</p>
|
|
|
|
<highlight language="config">
|
|
<Macro LocalAccessPolicy>
|
|
order deny,allow
|
|
deny from all
|
|
allow from 10.2.16.0/24
|
|
</Macro>
|
|
|
|
<Macro RestrictedAccessPolicy $ipnumbers>
|
|
order deny,allow
|
|
deny from all
|
|
allow from $ipnumbers
|
|
</Macro>
|
|
</highlight>
|
|
</usage>
|
|
</directivesynopsis>
|
|
|
|
<!-- Use -->
|
|
<directivesynopsis>
|
|
<name>Use</name>
|
|
<description>Utilise une macro</description>
|
|
<syntax>Use <var>nom</var> [<var>valeur1</var> ... <var>valeurN</var>]
|
|
</syntax>
|
|
<contextlist>
|
|
<context>server config</context>
|
|
<context>virtual host</context>
|
|
<context>directory</context>
|
|
</contextlist>
|
|
|
|
<usage>
|
|
<p> La directive <directive>Use</directive> permet d'utiliser une macro.
|
|
La macro est expansée. Elle doit avoir le même nombre d'argument que le
|
|
nombre de paramètres précisés dans sa définition. Les valeurs passées en
|
|
argument sont substituées avant l'interprétation du texte de la macro.</p>
|
|
|
|
<highlight language="config">
|
|
Use LocalAccessPolicy
|
|
...
|
|
Use RestrictedAccessPolicy "192.54.172.0/24 192.54.148.0/24"
|
|
</highlight>
|
|
|
|
<p>est équivalent, avec les macros définies au dessus, à :</p>
|
|
|
|
<highlight language="config">
|
|
order deny,allow
|
|
deny from all
|
|
allow from 10.2.16.0/24
|
|
...
|
|
order deny,allow
|
|
deny from all
|
|
allow from 192.54.172.0/24 192.54.148.0/24
|
|
</highlight>
|
|
</usage>
|
|
</directivesynopsis>
|
|
|
|
<!-- UndefMacro -->
|
|
<directivesynopsis>
|
|
<name>undefMacro</name>
|
|
<description>Efface une macro</description>
|
|
|
|
<syntax>UndefMacro <var>nom</var></syntax>
|
|
<contextlist>
|
|
<context>server config</context>
|
|
<context>virtual host</context>
|
|
<context>directory</context>
|
|
</contextlist>
|
|
|
|
<usage>
|
|
<p>La directive <directive>UndefMacro</directive> efface la définition
|
|
d'une macro, qui doit avoir été définie auparavant.</p>
|
|
|
|
<highlight language="config">
|
|
UndefMacro LocalAccessPolicy
|
|
UndefMacro RestrictedAccessPolicy
|
|
</highlight>
|
|
</usage>
|
|
</directivesynopsis>
|
|
</modulesynopsis>
|