<?xml version="1.0"?>
<!DOCTYPE modulesynopsis SYSTEM "../style/modulesynopsis.dtd">
<?xml-stylesheet type="text/xsl" href="../style/manual.fr.xsl"?>
-<!-- English Revision: 1562488:1669205 (outdated) -->
+<!-- English Revision : 1669205 -->
<!-- French translation : Lucien GENTIS -->
<!-- Reviewed by : Vincent Deffontaines -->
<p>Note : cet exemple avec gzip n'est fourni qu'à titre
d'illustration. Veuillez vous reporter à la documentation de
<module>mod_deflate</module> pour un exemple d'implémentation plus
- réaliste.</p>
+ pratique.</p>
<highlight language="config">
# la directive de mod_ext_filter qui définit le filtre externe
<Location /gzipped>
# directive de base permettant de traiter la sortie avec le
- # filtre gzip
+ # filtre gzip
SetOutputFilter gzip
# la directive de mod_headers permettant d'ajouter le champ
- # d'en-tête "Content-Encoding: gzip"
+ # d'en-tête "Content-Encoding: gzip"
Header set Content-Encoding gzip
</Location>
</highlight>
# passer tous les flux en sortie par la commande cat ; cat ne
# modifie rien ; elle ne fait que compliquer le cheminement des
# flux et consommer des ressources supplémentaires
+ ExtFilterDefine slowdown mode=output cmd=/bin/cat \
ExtFilterDefine slowdown mode=output cmd=/bin/cat \
preservescontentlength
</Location>
</highlight>
+<note>
+<p>Vous pouvez aussi utiliser <module>mod_substitute</module> pour
+effectuer le même traitement sans avoir à invoquer un programme
+externe.</p>
+</note>
+
</section>
<section><title>Tracer un autre filtre</title>
<directivesynopsis>
<name>ExtFilterDefine</name>
<description>Définit un filtre externe</description>
-<syntax>ExtFilterDefine <var>nom filtre</var> <var>paramètres</var></syntax>
+<syntax>ExtFilterDefine <var>nom_filtre</var> <var>paramètres</var></syntax>
<contextlist><context>server config</context></contextlist>
<usage>
- <p>La directive <directive>ExtFilterDefine</directive> permet de
- définir les caractéristiques d'un filtre externe, et en particulier
+ <p>La directive <directive>ExtFilterDefine</directive>
+ définit les caractéristiques d'un filtre externe, et en particulier
le programme à exécuter ainsi que ses arguments.</p>
- <p><var>nom filtre</var> spécifie le nom du filtre en cours de
+ <p><var>nom_filtre</var> spécifie le nom du filtre en cours de
définition. On peut ensuite utiliser ce nom pour référencer le
filtre dans les directives <directive module="core"
>SetOutputFilter</directive>. Il doit être unique parmi les noms de
<dl>
<dt><code>cmd=<var>ligne de commande</var></code></dt>
- <dd>Le mot-clé <code>cmd=</code> permet de spécifier la commande
+ <dd>Le mot-clé <code>cmd=</code> spécifie la commande
externe à exécuter. Si la ligne de commande comporte des
arguments, elle doit être entourée de guillemets (par exemple
<code>cmd="<var>/bin/mypgm</var> <var>arg1</var>
argument contient des antislashes '\', ces derniers doivent être
eux-mêmes échappés par un antislash '\'. Outre les variables
d'environnement CGI standards, les variables DOCUMENT_URI,
- DOCUMENT_PATH_INFO, et QUERY_STRING_UNESCAPED seront aussi
+ DOCUMENT_PATH_INFO, et QUERY_STRING_UNESCAPED seront également
définies pour le programme.</dd>
<dt><code>mode=<var>mode</var></code></dt>
<dt><code>intype=<var>type MIME</var></code></dt>
- <dd>Ce paramètre permet de spécifier le type de médium Internet
+ <dd>Ce paramètre spécifie le type de médium Internet
(c'est à dire le type MIME) des documents qui doivent être
- filtrés. Par défaut, tous les documents sont filtrés. Tous les
+ filtrés. Par défaut, tous les documents sont filtrés. Aucun des
documents possédant un type MIME autre que celui spécifié par
- <code>intype=</code> ne seront pas filtrés.</dd>
+ <code>intype=</code> ne sera filtré.</dd>
<dt><code>outtype=<var>type MIME</var></code></dt>
- <dd>Ce paramètre permet de spécifier le type de médium Internet
+ <dd>Ce paramètre spécifie le type de médium Internet
(c'est à dire le type MIME) des documents filtrés. Il intervient
lorsque les opérations de filtrage comprennent une modification du
type MIME. Par défaut, le type MIME n'est pas modifié.</dd>
<dt><code>ftype=<var>type de filtre</var></code></dt>
- <dd>Ce paramètre permet de spécifier une valeur numérique
+ <dd>Ce paramètre spécifie une valeur numérique
représentant le type de filtre sous lequel le filtre doit être
enregistré. La valeur par défaut, AP_FTYPE_RESOURCE, convient dans
- la plupart des situations. Si le filtre doit opérer dans la chaîne
- de filtrage à un autre point que les filtres de ressources, ce
- paramètre est nécessaire. Voir les définitions de AP_FTYPE_...
+ la plupart des situations. Ce paramètre devient nécessaire dès lors
+ que le filtre doit opérer à un autre point de la chaîne de filtrage
+ que les filtres de ressources.
+ Voir les définitions de AP_FTYPE_...
dans util_filter.h pour trouver une valeur appropriée.</dd>
<dt><code>disableenv=<var>env</var></code></dt>
- <dd>Ce paramètre permet de spécifier le nom d'une variable
+ <dd>Ce paramètre spécifie le nom d'une variable
d'environnement qui, si elle est définie, va désactiver le
filtre.</dd>
<dt><code>enableenv=<var>env</var></code></dt>
- <dd>Ce paramètre permet de spécifier le nom d'une variable
+ <dd>Ce paramètre spécifie le nom d'une variable
d'environnement qui doit être définie pour que le filtre ne soit
pas désactivé.</dd>
</dl>
<contextlist><context>directory</context></contextlist>
<usage>
- <p>La directive <directive>ExtFilterOptions</directive> permet de
- spécifier des options de traitement particulières pour
+ <p>La directive <directive>ExtFilterOptions</directive>
+ spécifie des options de traitement particulières pour
<module>mod_ext_filter</module>. Les arguments <var>option</var>
peuvent contenir :</p>
<dt><code>Onfail=[abort|remove]</code></dt>
<dd>Indique la marche à suivre si le programme de filtrage externe
ne peut pas démarrer. Avec <code>abort</code> (la valeur par
- défaut), la requête sera abandonnée. Avec <code>remove</code>, le
+ défaut), le traitement de la requête sera abandonné. Avec <code>remove</code>, le
filtre est supprimé, et le traitement de la requête se poursuit
sans lui.</dd>
</dl>
<?xml version="1.0"?>
<!DOCTYPE modulesynopsis SYSTEM "../style/modulesynopsis.dtd">
<?xml-stylesheet type="text/xsl" href="../style/manual.fr.xsl"?>
-<!-- English Revision: 1643036:1668874 (outdated) -->
+<!-- English Revision : 1668874 -->
<!-- French translation : Lucien GENTIS -->
<!-- Reviewed by : Vincent Deffontaines -->
cette option permet de le rétablir à partir de la version 2.4.4 du
serveur HTTP Apache.</p>
</dd>
+
+ <dt><code>IgnoreContextInfo</code></dt>
+ <dd>
+
+ <p>Dans les versions 2.4.13 et antérieures, lors d'une
+ substitution relative dans un contexte de répertoire (htaccess),
+ et si la directive <directive
+ module="mod_rewrite">RewriteBase</directive> n'a pas été définie,
+ ce module utilise des informations en provenance d'une extension
+ d'URL et du contexte du système de fichiers pour transformer la
+ sustitution relative en URL. Par exemple, les modules
+ <module>mod_userdir</module> et <module>mod_alias</module>
+ utilisent ces informations de contexte étendu. Cette option
+ désactive le comportement introduit avec la version 2.4.13, et ne
+ doit être utilisée que si toutes les conditions précédentes sont
+ vérifiées, et si la substitution renvoie un résultat inattendu.</p>
+ </dd>
+
</dl>
</usage>
contenant la <directive>RewriteRule</directive>, suffixé par
la substitution relative est aussi valide en tant qu'URL sur
le serveur (ce qui est rare).</li>
+ <li>A partir de la version 2.4.13 du serveur HTTP Apache,
+ cette directive peut être omise lorsque la requête est
+ transformée via une directive <directive
+ module="mod_alias">Alias</directive> ou le module
+ <module>mod_userdir</module>.</li>
</ul>
<p>Dans l'exemple ci-dessous, la directive
<highlight language="config">
DocumentRoot /var/www/example.com
-Alias /myapp /opt/myapp-1.2.3
+AliasMatch ^/myapp /opt/myapp-1.2.3
<Directory /opt/myapp-1.2.3>
RewriteEngine On
RewriteBase /myapp/
RewriteRule ^index\.html$ welcome.html
</Directory>
</highlight>
+
</usage>
</directivesynopsis>
projects / apache / commitdiff