You are viewing a plain text version of this content. The canonical link for it is here.
Posted to cvs@httpd.apache.org by gr...@apache.org on 2017/01/26 20:02:26 UTC
svn commit: r1780462 [4/23] - /httpd/httpd/trunk/docs/manual/mod/
Added: httpd/httpd/trunk/docs/manual/mod/mod_include.xml.fr
URL: http://svn.apache.org/viewvc/httpd/httpd/trunk/docs/manual/mod/mod_include.xml.fr?rev=1780462&view=auto
==============================================================================
--- httpd/httpd/trunk/docs/manual/mod/mod_include.xml.fr (added)
+++ httpd/httpd/trunk/docs/manual/mod/mod_include.xml.fr [utf-8] Thu Jan 26 20:02:25 2017
@@ -0,0 +1,1199 @@
+<?xml version="1.0" encoding="UTF-8" ?>
+<!DOCTYPE modulesynopsis SYSTEM "../style/modulesynopsis.dtd">
+<?xml-stylesheet type="text/xsl" href="../style/manual.fr.xsl"?>
+<!-- English Revision: 1741842 -->
+<!-- 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.
+-->
+
+<modulesynopsis metafile="mod_include.xml.meta">
+
+<name>mod_include</name>
+<description>Documents html interpr�t�s par le serveur (Server Side
+Includes ou SSI)</description>
+<status>Base</status>
+<sourcefile>mod_include.c</sourcefile>
+<identifier>include_module</identifier>
+
+<summary>
+ <p>Ce module fournit un filtre qui va traiter les fichiers avant
+ de les envoyer au client. Le traitement est contr�l� via des
+ commentaires SGML sp�cialement format�s, aussi nomm�s
+ <dfn>�l�ments</dfn>. Ces �l�ments permettent l'insertion
+ conditionnelle de texte, l'inclusion d'autres fichiers ou
+ programmes, ainsi que la d�finition et l'affichage de variables
+ d'environnement.</p>
+</summary>
+<seealso><directive module="core">Options</directive></seealso>
+<seealso><directive module="core">AcceptPathInfo</directive></seealso>
+<seealso><a href="../filter.html">Les filtres</a></seealso>
+<seealso><a href="../howto/ssi.html">Tutoriel SSI</a></seealso>
+
+<section id="enabling">
+ <title>Activation des SSI</title>
+
+ <p>Les SSI sont impl�ment�s par le <a
+ href="../filter.html">filtre</a> <code>INCLUDES</code>. Si des
+ documents contenant des directives SSI poss�dent une extension
+ .shtml, les directives suivantes indiqueront � Apache de les
+ interpr�ter et d'assigner le type MIME
+ <code>text/html</code> au document obtenu :</p>
+
+ <highlight language="config">
+AddType text/html .shtml
+AddOutputFilter INCLUDES .shtml
+ </highlight>
+
+ <p>L'option suivante doit �tre d�finie pour les r�pertoires qui
+ contiennent les fichiers shtml (en g�n�ral dans une section
+ <directive module="core" type="section">Directory</directive>, mais
+ cette option peut �galement �tre d�finie dans un fichier
+ <code>.htaccess</code> si <code><directive
+ module="core">AllowOverride</directive> Options</code> a �t� d�fini pour le
+ r�pertoire consid�r�) :</p>
+
+ <highlight language="config">
+ Options +Includes
+ </highlight>
+
+ <p>Pour des raisons de compatibilit� ascendante, le <a
+ href="../handler.html">gestionnaire</a> <code>server-parsed</code>
+ peut aussi activer le filtre INCLUDES. Ainsi, Apache va activer le
+ filtre INCLUDES pour tout document de type MIME
+ <code>text/x-server-parsed-html</code> ou
+ <code>text/x-server-parsed-html3</code> (et le document obtenu aura
+ pour type MIME <code>text/html</code>).</p>
+
+ <p>Pour plus d'informations, voyez notre <a
+ href="../howto/ssi.html">Tutoriel SSI</a>.</p>
+</section> <!-- /enabling -->
+
+<section id="pathinfo">
+ <title>PATH_INFO et SSI</title>
+
+ <p>Les fichiers trait�s dans le cadre des SSI n'acceptent plus par
+ d�faut les requ�tes avec <code>PATH_INFO</code> (les informations
+ relatives au chemin en fin de requ�te). La directive <directive
+ module="core">AcceptPathInfo</directive> permet de configurer le
+ serveur de fa�on � ce qu'il accepte ce genre de requ�te.</p>
+</section> <!-- /pathinfo -->
+
+<section id="elements"><title>El�ments disponibles</title>
+ <p>Le document est interpr�t� comme un document HTML, avec des
+ commandes sp�ciales incluses sous forme de commentaires SGML. La
+ syntaxe d'une commande est la suivante : </p>
+
+ <example>
+ <!--#<var>�l�ment</var> <var>attribut</var>=<var>valeur</var>
+ <var>attribut</var>=<var>valeur</var> ... -->
+ </example>
+
+ <p>Les valeurs sont souvent entour�es de guillemets, mais on peut
+ aussi utiliser des apostrophes (<code>'</code>) ou des apostrophes
+ inverses (<code>`</code>). De nombreuses commandes n'acceptent
+ qu'une seule paire attribut-valeur. Notez que le terminateur de
+ commentaire (<code>--></code>) doit �tre pr�c�d� d'un espace afin
+ d'�tre s�r qu'il ne soit pas consid�r� comme un �l�ment de commande
+ SSI. Notez aussi que le d�limiteur de d�but <code><!--#</code>
+ est <em>un</em> �l�ment de commande et ne doit donc pas contenir
+ d'espace.</p>
+
+ <p>La table suivante contient la liste des �l�ments autoris�s :</p>
+
+ <table border="1">
+ <tr><th>El�ment</th><th>Description</th></tr>
+ <tr><td><code><a href="#element.comment">comment</a></code></td>
+ <td>commentaire SSI</td></tr>
+ <tr><td><code><a href="#element.config">config</a></code></td>
+ <td>configure les formats de sortie</td></tr>
+ <tr><td><code><a href="#element.echo">echo</a></code></td>
+ <td>affiche le contenu de variables</td></tr>
+ <tr><td><code><a href="#element.exec">exec</a></code></td>
+ <td>ex�cute des programmes externes</td></tr>
+ <tr><td><code><a href="#element.fsize">fsize</a></code></td>
+ <td>affiche la taille d'un fichier</td></tr>
+ <tr><td><code><a href="#element.flastmod">flastmod</a></code></td>
+ <td>affiche la date de derni�re modification d'un fichier</td></tr>
+ <tr><td><code><a href="#element.include">include</a></code></td>
+ <td>inclut un fichier</td></tr>
+ <tr><td><code><a href="#element.printenv">printenv</a></code></td>
+ <td>affiche toutes les variables disponibles</td></tr>
+ <tr><td><code><a href="#element.set">set</a></code></td>
+ <td>d�finit la valeur d'une variable</td></tr>
+ </table>
+
+ <p>Les �l�ments SSI peuvent �tre d�finis par d'autres modules que
+ <module>mod_include</module>. � ce titre, l'�l�ment <code><a
+ href="#element.exec">exec</a></code> est fourni par
+ <module>mod_cgi</module>, et ne sera disponible que si ce module est
+ charg�.</p>
+
+ <section id="element.comment"><title>L'�l�ment comment</title>
+ <p>Cette commande n'affiche aucune information. Elle n'a pour but que
+ l'ajout de commentaires dans un fichier et ces commentaires ne sont pas
+ affich�s.</p>
+
+ <p>Cette syntaxe est disponible � partir de la version 2.5 du serveur
+ HTTP Apache.</p>
+
+ <example>
+ <!--#comment Blah Blah Blah -->
+ </example>
+ </section> <!-- /comment -->
+
+ <section id="element.config"><title>L'�l�ment config</title>
+ <p>Cette commande contr�le divers aspects de l'interpr�tation. Les
+ attributs valides sont :</p>
+
+ <dl>
+ <dt><code>echomsg</code> (<em>Versions 2.1 et sup�rieures
+ d'Apache</em>)</dt>
+ <dd><p>La valeur est un message qui sera envoy� au client si
+ l'�l�ment <code><a href="#element.echo">echo</a></code> tente
+ d'afficher le contenu d'une variable non d�finie. Cet attribut
+ l'emporte sur toute directive <directive
+ module="mod_include">SSIUndefinedEcho</directive>.</p>
+
+ <example>
+ <!--#config echomsg="[Valeur non d�finie]" -->
+ </example>
+
+ </dd>
+
+ <dt><code>errmsg</code></dt>
+ <dd><p>La valeur est un message qui sera envoy� au client si une
+ erreur survient lors de l'interpr�tation du document. Cet attribut
+ l'emporte sur toute directive <directive
+ module="mod_include">SSIErrorMsg</directive>.</p>
+
+ <example>
+ <!--#config errmsg="[Zut, quelque chose s'est mal pass�.]" -->
+ </example>
+
+ </dd>
+
+ <dt><code>sizefmt</code></dt>
+ <dd><p>La valeur d�finit l'unit� employ�e lors de l'affichage de la
+ taille d'un fichier. Les valeurs possibles sont <code>bytes</code>
+ pour une taille en octets, ou <code>abbrev</code> pour une taille
+ en Ko ou Mo selon son importance ; par exemple, une taille de 1024
+ octets sera affich�e sous la forme "1K".</p>
+
+ <example>
+ <!--#config sizefmt="abbrev" -->
+ </example>
+
+ </dd>
+
+ <dt><code>timefmt</code></dt>
+ <dd><p>La valeur est une cha�ne que pourra utiliser la fonction de la
+ biblioth�que standard <code>strftime(3)</code> lors de l'affichage
+ des dates.</p>
+
+ <example>
+ <!--#config timefmt=""%R, %B %d, %Y"" -->
+ </example>
+
+ </dd>
+
+ </dl>
+ </section> <!-- /config -->
+
+ <section id="element.echo"><title>L'�l�ment echo</title>
+ <p>Cette commande affiche le contenu d'une des <a
+ href="#includevars">variables include</a> d�finies ci-dessous. Si
+ la variable n'est pas d�finie, le r�sultat est d�termin� par la
+ valeur de la directive <directive module="mod_include"
+ >SSIUndefinedEcho</directive>. Le format d'affichage des dates est
+ d�fini par l'attribut <code>timefmt</code> de la commande
+ config.</p>
+
+ <p>Attributs:</p>
+
+ <dl>
+ <dt><code>var</code></dt>
+ <dd>La valeur est le nom de la variable � afficher.</dd>
+
+ <dt><code>decoding</code></dt>
+ <dd><p>Sp�cifie si Apache doit effectuer un d�codage dans la
+ variable avant son traitement ult�rieur. La valeur par d�faut est
+ <code>none</code>, et dans ce cas, aucun d�codage n'est effectu�.
+ Si la valeur est <code>url</code>, un d�codage de type URL sera
+ effectu� (il s'agit du codage de type %-encoding utilis� dans les
+ URLs des liens, etc...). Si la valeur est <code>urlencoded</code>,
+ c'est un d�codage des �l�ments de type
+ application/x-www-form-urlencode (que l'on trouve dans les cha�nes
+ de param�tres) qui sera effectu�. Si la valeur est
+ <code>base64</code>, un
+ decodage de type base64 sera effectu�, et si elle est
+ <code>entity</code>, c'est un d�codage des entit�s HTML qui sera
+ effectu�. Ce d�codage est effectu� avant tout codage ult�rieur de
+ la variable. Il est possible d'effectuer plusieurs d�codages en
+ sp�cifiant plusieurs valeurs s�par�es par des virgules. Les
+ sp�cifications de d�codages restent valables jusqu'au prochain
+ attribut de d�codage, ou la fin de l'�l�ment.</p>
+
+ <p>Pour �tre pris en compte, l'attribut de <code>d�codage</code>
+ doit <em>pr�c�der</em> l'attribut <code>var</code> correspondant.</p>
+ </dd>
+
+ <dt><code>encoding</code></dt>
+ <dd><p>Sp�cifie la mani�re dont Apache va coder les caract�res
+ sp�ciaux que la variable contient avant leur affichage. S'il est
+ d�fini � <code>none</code>, aucun codage ne sera effectu�. S'il
+ est d�fini � <code>url</code>, un codage de type URL sera effectu�
+ (aussi connu sous le nom de codage avec caract�res % , il convient
+ pour les URLS des liens, etc...). S'il est d�fini �
+ <code>urlencoded</code>, c'est un codage compatible
+ application/x-www-form-urlencoded qui sera effectu� (� utiliser
+ dans les cha�nes de param�tres). S'il est d�fini �
+ <code>base64</code>, c'est un encodage de type base64 qui sera
+ effectu�. Au d�but d'un �l�ment
+ <code>echo</code>, la valeur par d�faut est d�finie �
+ <code>entity</code>, ce qui correspond � un codage de type entit�
+ (codage qui convient pour un �l�ment HTML de type bloc, comme le
+ paragraphe d'un texte). Cette valeur par d�faut peut �tre modifi�e
+ en ajoutant un attribut <code>encoding</code>, qui fera effet
+ jusqu'� la d�finition d'un nouvel attribut <code>encoding</code>
+ ou la fin de l'�l�ment echo.</p>
+
+ <p>Pour produire son effet, l'attribut <code>encoding</code> doit
+ pr�c�der l'attribut <code>var</code> concern�.</p>
+
+ <note type="warning">
+ Afin de pr�venir les attaques de type cross-site scripting, il
+ est recommand� de <em>toujours</em> encoder les donn�es fournies
+ par les utilisateurs.
+ </note>
+
+ <example><title>Example</title>
+ <!--#echo encoding="entity" var="QUERY_STRING" -->
+ </example>
+ </dd>
+ </dl>
+ </section> <!-- /echo -->
+
+ <section id="element.exec"><title>L'�l�ment exec</title>
+ <p>La commande <code>exec</code> ex�cute la commande shell ou le
+ script sp�cifi�. Elle n�cessite le chargement du module
+ <module>mod_cgi</module>. Si <directive
+ module="core">Options</directive> <code>IncludesNOEXEC</code> est
+ d�finie, cette commande est d�sactiv�e. Les attributs disponibles
+ sont :</p>
+
+ <dl>
+ <dt><code>cgi</code></dt>
+ <dd><p>La valeur sp�cifie un chemin URL vers le script CGI (encod�
+ avec caract�res %). Si le chemin ne commence pas par un slash (/),
+ il est consid�r� comme relatif au document courant. Le document
+ r�f�renc� par ce chemin est invoqu� en tant que script CGI, m�me
+ s'il n'est pas cens� �tre reconnu comme tel par le serveur. Les
+ scripts CGI doivent cependant �tre activ�s dans le r�pertoire qui
+ contient les scripts (via la directive <directive
+ module="mod_alias">ScriptAlias</directive> ou l'<directive
+ module="core">Options</directive> <code>ExecCGI</code>).</p>
+
+ <p>Le <code>PATH_INFO</code> et la cha�ne d'arguments
+ (<code>QUERY_STRING</code>) de la requ�te originale du client sont
+ fournis au script CGI ; ils <em>ne peuvent pas</em> �tre sp�cifi�s
+ dans le chemin de l'URL. Le script disposera des variables include
+ en plus de l'environnement standard <a
+ href="mod_cgi.html">CGI</a>.</p>
+
+ <example><title>Exemple</title>
+ <!--#exec cgi="/cgi-bin/exemple.cgi" -->
+ </example>
+
+ <p>Si, � la place d'un flux de sortie, le script renvoie un
+ en-t�te <code>Location:</code>, ce dernier sera traduit en ancrage
+ HTML.</p>
+
+ <p>L'�l�ment <code><a href="#includevirtual">include
+ virtual</a></code> doit �tre pr�f�r� � <code>exec cgi</code>. En
+ particulier, si vous devez transmettre des arguments
+ suppl�mentaires � un programme CGI en utilisant la cha�ne
+ d'arguments de la requ�te, c'est impossible avec <code>exec
+ cgi</code>, mais vous pouvez y parvenir avec <code>include
+ virtual</code> comme suit :</p>
+
+ <example>
+ <!--#include virtual="/cgi-bin/exemple.cgi?argument=valeur" -->
+ </example>
+ </dd>
+
+ <dt><code>cmd</code></dt>
+ <dd><p>Le serveur va ex�cuter la commande fournie en utilisant
+ <code>/bin/sh</code>. La commande dispose des <a
+ href="#includevars">variables include</a>, en plus du jeu habituel
+ de variables CGI.</p>
+
+ <p>Il est toujours pr�f�rable d'utiliser <code><a
+ href="#includevirtual">#include virtual</a></code> � la place de
+ <code>#exec cgi</code> ou <code>#exec cmd</code>. <code>#include
+ virtual</code> utilise le m�canisme standard des sous-requ�tes
+ d'Apache pour inclure des fichiers ou des scripts. Il a fait
+ l'objet de tests plus approfondis et sa maintenance est mieux
+ suivie.</p>
+
+ <p>De plus, sur certaines plate-formes, comme Win32, et sous unix,
+ si l'on utilise <a href="../suexec.html">suexec</a>, il est
+ impossible de transmettre des arguments � une commande dans une
+ directive <code>exec</code>, � moins d'ins�rer des espaces dans la
+ commande. Ainsi, alors que ce qui suit fonctionnera sous unix avec
+ une configuration sans suexec, l'effet produit ne sera pas celui
+ d�sir� sous Win32, ou dans le cas de l'utilisation de suexec
+ :</p>
+
+ <example>
+ <!--#exec cmd="perl /chemin/vers/script_perl arg1 arg2" -->
+ </example>
+ </dd>
+ </dl>
+ </section> <!-- /exec -->
+
+ <section id="element.fsize"><title>L'�l�ment fsize</title>
+ <p>Cette commande permet d'afficher la taille du fichier sp�cifi�
+ en fonction des sp�cifications de format de <code>sizefmt</code>.
+ Attributs :</p>
+
+ <dl>
+ <dt><code>file</code></dt>
+ <dd>La valeur est le chemin du fichier, relatif au r�pertoire
+ contenant le document en cours d'interpr�tation.
+
+ <example>
+ Ce fichier a une taille de <!--#fsize file="mod_include.html"
+ --> octets.
+ </example>
+
+ La valeur de <code>file</code> ne peut pas faire r�f�rence � un
+ fichier situ� � un niveau sup�rieur de l'arborescence du r�pertoire
+ courant ou en dehors de la racine des documents ; il ne peut donc
+ ni commencer par un slash, ni contenir la s�quence de caract�res
+ <code>../</code>. Si c'est le cas, le message d'erreur <code>The
+ given path was above the root path</code> sera renvoy�.
+ </dd>
+
+ <dt><code>virtual</code></dt>
+ <dd>La valeur est un chemin URL (cod� avec caract�res %). S'il ne
+ commence pas par un slash (/), il est consid�r� comme relatif au
+ document courant. Notez que cette commande n'affiche <em>pas</em>
+ la taille de la sortie d'un programme CGI, mais la taille du
+ programme CGI lui-m�me.</dd>
+ </dl>
+
+ <example>
+ Ce fichier a une taille de <!--#fsize
+ virtual="/docs/mod/mod_include.html" --> octets.
+ </example>
+
+ <p>Notez que dans la plupart des cas, ces deux attributs sont
+ identiques. Cependant, l'attribut <code>file</code> ne respecte
+ pas les aliases URL-space.</p>
+ </section> <!-- /fsize -->
+
+ <section id="element.flastmod"><title>L'�l�ment flastmod</title>
+ <p>Cette commande permet d'afficher la date de derni�re
+ modification du fichier sp�cifi�, en fonction des sp�cifications
+ de format de <code>timefmt</code>. Les attributs sont les m�mes
+ que ceux de la commande <code><a
+ href="#element.fsize">fsize</a></code>.</p>
+ </section> <!-- /flastmod -->
+
+ <section id="element.include"><title>L'�l�ment include</title>
+ <p>Cette commande permet d'ins�rer le texte d'un autre document ou
+ fichier dans le fichier en cours d'interpr�tation. Tout fichier
+ inclus est soumis au contr�le d'acc�s habituel. Si <a
+ href="core.html#options">Options</a> <code>IncludesNOEXEC</code>
+ est d�fini pour le r�pertoire contenant le fichier
+ interpr�t�, seuls les documents poss�dant un
+ <glossary>type MIME</glossary> de type texte
+ (<code>text/plain</code>, <code>text/html</code>, etc...) seront
+ inclus. Les scripts CGI, quant � eux, sont invoqu�s de mani�re
+ habituelle en utilisant l'URL compl�te fournie avec la commande, y
+ compris toute cha�ne d'arguments �ventuelle.</p>
+
+ <p>Un attribut d�finit le chemin du document � inclure, et peut
+ appara�tre plusieurs fois dans l'�l�ment � inclure ; en retour, pour
+ chaque attribut fourni � la commande include, une inclusion est
+ effectu�e. Les attributs disponibles sont :</p>
+
+ <dl>
+ <dt><code>file</code></dt>
+ <dd>La valeur est un chemin relatif au r�pertoire contenant le
+ fichier en cours d'interpr�tation. Elle ne peut ni contenir
+ <code>../</code>, ni �tre un chemin absolu. Ainsi, vous ne pouvez
+ pas inclure de fichiers situ�s en dehors de l'arborescence du
+ site web ou dans un niveau sup�rieur � celui du fichier courant
+ dans cette arborescence. Il est toujours pr�f�rable d'utiliser
+ l'attribut <code>virtual</code>.</dd>
+
+ <dt><code><a id="includevirtual" name="includevirtual"
+ >virtual</a></code></dt>
+ <dd><p>La valeur est un chemin URL (cod� avec caract�res %). L'URL
+ ne peut contenir qu'un chemin et une cha�ne d'arguments
+ �ventuelle, � l'exclusion de tout protocole ou nom d'h�te. S'il ne
+ commence pas par un slash (/), il est consid�r� comme relatif au
+ document courant.</p>
+
+ <p>Une URL est construite � partir de l'attribut, et la sortie que
+ renverrait le serveur si l'URL �tait acc�d�e par le client est
+ incluse dans la sortie interpr�t�e. Les inclusions de fichiers
+ peuvent ainsi �tre imbriqu�es.</p>
+
+ <p>Si l'URL sp�cifi�e correspond � un programme CGI, le programme
+ sera ex�cut�, et son flux de sortie ins�r� � la place de la
+ directive dans le fichier interpr�t�. Vous pouvez ins�rer une
+ cha�ne d'arguments dans une URL correspond � un programme CGI
+ :</p>
+
+ <example>
+ <!--#include virtual="/cgi-bin/exemple.cgi?argument=valeur" -->
+ </example>
+
+ <p><code>include virtual</code> doit �tre pr�f�r� � <code>exec
+ cgi</code> pour inclure le flux de sortie d'un programme CGI dans
+ un document HTML.</p>
+
+ <p>Si la directive <directive
+ module="mod_request">KeptBodySize</directive> est correctement
+ d�finie et valide pour le fichier inclus, les tentatives de
+ requ�tes POST vers le document HTML qui inclut des fichiers seront
+ transmises aux sous-requ�tes en tant que requ�tes POST
+ elles-m�mes. Sans cette directive, toutes les sous-requ�tes sont
+ trait�es en tant que requ�tes GET.</p>
+
+ </dd>
+
+ <dt><code>onerror</code></dt>
+ <dd><p>La valeur est un chemin-URL (cod�-%) qui est affich� si une
+ tentative pr�c�dente d'inclure un fichier ou un attribut virtuel a
+ �chou�. Pour produire son effet, cet attribut doit �tre sp�cifi�
+ apr�s le fichier ou les attributs virtuels concern�s. Si la
+ tentative d'inclure le chemin onerror �choue, ou si onerror n'est
+ pas sp�cifi�, c'est le message d'erreur par d�faut qui sera
+ inclus.</p>
+
+ <example>
+ # Exemple simple<br />
+ <!--#include virtual="/not-exist.html" onerror="/error.html" -->
+ </example>
+
+ <example>
+ # Chemins onerror d�di�s<br />
+ <!--#include virtual="/path-a.html" onerror="/error-a.html" virtual="/path-b.html" onerror="/error-b.html" -->
+ </example>
+
+ </dd>
+ </dl>
+ </section> <!-- /include -->
+
+ <section id="element.printenv"><title>L'�l�ment printenv</title>
+ <p>Cette commande affiche la liste en mode texte de toutes les variables et de
+ leurs valeurs. Les caract�res sp�ciaux sont encod�s <code>entity</code> avant
+ d'�tre affich�s (se reporter � l'�l�ment <code><a
+ href="#element.echo">echo</a></code> pour plus de d�tails). Cette
+ commande ne comporte pas d'attributs.</p>
+
+ <example><title>Exemple</title>
+ <pre>
+ <!--#printenv -->
+ </pre>
+ </example>
+ </section> <!-- /printenv -->
+
+ <section id="element.set"><title>L'�l�ment set</title>
+ <p>Cette commande permet de d�finir la valeur d'une variable. Les
+ attributs sont :</p>
+
+ <dl>
+ <dt><code>var</code></dt>
+ <dd>Le nom de la variable � d�finir.</dd>
+
+ <dt><code>value</code></dt>
+ <dd>La valeur � affecter � la variable.</dd>
+ <dt><code>decoding</code></dt>
+ <dd><p>Sp�cifie si Apache doit effectuer un d�codage dans la
+ variable avant son traitement ult�rieur. La valeur par d�faut est
+ <code>none</code>, et dans ce cas, aucun d�codage n'est effectu�.
+ Si la valeur est <code>url</code>, <code>urlencoded</code>,
+ <code>base64</code> ou
+ <code>entity</code>, c'est un d�codage de type URL,
+ application/x-www-form-urlencoded, base64 ou
+ entit� HTML qui sera respectivement effectu�. Il est possible
+ d'effectuer plusieurs d�codages en
+ sp�cifiant plusieurs valeurs s�par�es par des virgules. Les
+ sp�cifications de d�codages restent valables jusqu'au prochain
+ attribut de d�codage, ou la fin de l'�l�ment. Pour �tre pris en
+ compte, l'attribut de <code>d�codage</code>
+ doit <em>pr�c�der</em> l'attribut <code>var</code> correspondant.</p>
+ </dd>
+
+ <dt><code>encoding</code></dt>
+ <dd><p>Sp�cifie la mani�re dont Apache va encoder les caract�res
+ sp�ciaux que la variable contient avant leur affichage. S'il est
+ d�fini � <code>none</code>, aucun encodage ne sera effectu�. Si la
+ valeur est <code>url</code>, <code>urlencoding</code>,
+ <code>base64</code> ou
+ <code>entity</code>, c'est un encodage de type URL,
+ application/x-www-form-urlencoded, base64 ou
+ entit� HTML qui sera respectivement effectu�. Il est possible de
+ sp�cifier plusieurs types d'encodage en les s�parant par des
+ virgules. La sp�cification du type d'encodage fera effet
+ jusqu'� la d�finition d'un nouvel attribut encoding
+ ou la fin de l'�l�ment. Pour produire son effet, l'attribut <code>encoding</code> doit
+ pr�c�der l'attribut <code>var</code> concern�. Les encodages sont
+ effectu�s apr�s les op�rations de d�codage.</p>
+ </dd>
+
+ </dl>
+
+ <example><title>Exemple</title>
+ <!--#set var="category" value="help" -->
+ </example>
+ </section> <!-- /set -->
+</section> <!-- /basic elements -->
+
+<section id="includevars">
+ <title>Variables include</title>
+
+ <p>� l'instar des variables de l'environnement CGI standard, ces
+ variables sont mises � la disposition de la commande
+ <code>echo</code>, des op�rateurs conditionnels <code>if</code> et
+ <code>elif</code>, et de tout programme invoqu� par le document.</p>
+
+ <dl>
+ <dt><code>DATE_GMT</code></dt>
+ <dd>La date GMT (Greenwich Mean Time) courante.</dd>
+
+ <dt><code>DATE_LOCAL</code></dt>
+ <dd>La date locale courante.</dd>
+
+ <dt><code>DOCUMENT_ARGS</code></dt>
+ <dd>Cette variable contient la cha�ne de param�tres de la requ�te du
+ document SSI actif, ou la cha�ne vide si aucune cha�ne de param�tres de
+ requ�te n'est incluse. Pour les sous-requ�tes invoqu�es par la directive
+ SSI <code>include</code>, <code>QUERY_STRING</code> contiendra la cha�ne
+ de param�tres de la sous-requ�te et <code>DOCUMENT_ARGS</code> la cha�ne
+ de param�tres du document SSI (disponible � partir de la version 2.4.19 du
+ serveur HTTP Apache).</dd>
+
+ <dt><code>DOCUMENT_NAME</code></dt>
+ <dd>Le nom de base du fichier demand� par l'utilisateur (sans son
+ chemin).</dd>
+
+ <dt><code>DOCUMENT_URI</code></dt>
+ <dd>Le chemin URL (caract�res % d�cod�s) du document demand� par
+ l'utilisateur. Notez que dans le cas d'inclusions de fichiers
+ imbriqu�es, il ne s'agit <em>pas</em> de l'URL du document
+ courant. Notez �galement que si l'URL est modifi�e en interne (par
+ exemple via une directive <directive
+ module="mod_alias">alias</directive> ou <directive
+ module="mod_dir">directoryindex</directive>), c'est l'URL modifi�e
+ que contiendra la variable.</dd>
+
+ <dt><code>LAST_MODIFIED</code></dt>
+ <dd>La date de derni�re modification du document demand� par
+ l'utilisateur.</dd>
+
+ <dt><code>QUERY_STRING_UNESCAPED</code></dt>
+ <dd>Si une cha�ne d'arguments est pr�sente dans la requ�te pour le
+ document SSI actif, elle sera affect�e �
+ cette variable, les caract�res %-d�cod�s, et �ventuellement
+ <em>�chapp�s</em> pour qu'ils ne soient pas interpr�t�s par le
+ shell (les caract�res sp�ciaux comme <code>&</code>,etc...
+ sont pr�c�d�s d'anti-slashes). Cette variable n'est pas d�finie si aucune
+ cha�ne d'arguments n'est pr�sente. Utilisez <code>DOCUMENT_ARGS</code> si
+ l'�chappement des caract�res du shell n'est pas souhait�.</dd>
+ </dl>
+</section>
+
+<section id="substitution"><title>Substitution de variable</title>
+
+ <p>Une substitution de variable � l'int�rieur d'une cha�ne entre
+ guillemets s'effectue dans la plupart des situations o� cette
+ derni�re peut raisonablement constituer un argument d'une directive
+ SSI. Sont concern�es les directives <code>config</code>,
+ <code>exec</code>, <code>flastmod</code>, <code>fsize</code>,
+ <code>include</code>, <code>echo</code>, et <code>set</code>. Si la
+ directive <directive
+ module="mod_include">SSILegacyExprParser</directive> est d�finie �
+ <code>on</code>, la substitution s'effectue aussi dans les arguments
+ des op�rateurs conditionnels. Vous pouvez ins�rer
+ un signe dollar en tant que caract�re litt�ral dans une cha�ne en
+ utilisant un anti-slash :</p>
+
+ <example>
+ <!--#set var="cur" value="\$test" -->
+ </example>
+
+ <p>Si une r�f�rence de variable doit �tre substitu�e au beau milieu
+ d'une s�quence de caract�res qui pourrait �tre elle-m�me consid�r�e
+ comme un identifiant valide, l'ambigu�t� peut �tre lev�e en
+ entourant la r�f�rence d'accolades, � la mani�re du shell :</p>
+
+ <example>
+ <!--#set var="Zed" value="${REMOTE_HOST}_${REQUEST_METHOD}" -->
+ </example>
+
+ <p>Dans cet exemple, la variable <code>Zed</code> se verra affecter
+ la valeur "<code>X_Y</code>" si <code>REMOTE_HOST</code> et
+ <code>REQUEST_METHOD</code> contiennent respectivement
+ "<code>X</code>" et "<code>Y</code>".</p>
+
+</section>
+
+<section id="flowctrl">
+ <title>El�ments de contr�le d'inclusion conditionnelle</title>
+
+ <p>Les �l�ments de base du contr�le d'inclusion conditionnelle sont
+ :</p>
+
+ <example>
+ <!--#if expr="<var>test_condition</var>" --><br />
+ <!--#elif expr="<var>test_condition</var>" --><br />
+ <!--#else --><br />
+ <!--#endif -->
+ </example>
+
+ <p>L'�l�ment <code>if</code> fonctionne de la m�me mani�re que
+ la directive if d'un langage de programmation. La condition est
+ �valu�e et si le r�sultat est vrai, le texte qui suit jusqu'au
+ prochain �l�ment <code>elif</code>, <code>else</code> ou
+ <code>endif</code> sera inclus dans le flux de sortie.</p>
+
+ <p>Les �l�ments <code>elif</code> ou <code>else</code> permettent
+ d'ins�rer du texte dans le flux de sortie si
+ <var>test_condition</var> s'est r�v�l� faux. Ces �l�ments sont
+ optionnels.</p>
+
+ <p>L'�l�ment <code>endif</code> termine le bloc de traitement
+ conditionnel <code>if</code> et est obligatoire.</p>
+
+ <p><var>test_condition</var> est une expression bool�enne qui
+ emprunte la syntaxe <a href="../expr.html">ap_expr</a>. La directive
+ <directive module="mod_include">SSILegacyExprParser</directive>
+ permet de modifier cette syntaxe pour la rendre compatible avec
+ Apache HTTPD 2.2.x.</p>
+
+ <p>Le jeu de variables SSI avec l'�l�ment <code>var</code> sont
+ export�es vers l'environnement de la requ�te et sont accessibles via
+ la fonction <code>reqenv</code>. Pour faire simple, le nom de
+ fonction <code>v</code> est aussi disponible dans le module
+ <module>mod_include</module>.</p>
+
+ <p>Dans l'exemple suivant, "depuis le r�seau local" sera affich� si
+ l'adresse IP du client appartient au sous-r�seau 10.0.0.0/8.</p>
+
+ <example>
+ <!--#if expr='-R "10.0.0.0/8"' --><br />
+ <indent>
+ depuis le r�seau local<br />
+ </indent>
+ <!--#else --><br />
+ <indent>
+ depuis ailleurs<br />
+ </indent>
+ <!--#endif -->
+ </example>
+
+ <p>Dans l'exemple suivant, "foo vaut bar" sera affich� si la variable
+ <code>foo</code> contient la valeur "bar".</p>
+
+ <example>
+ <!--#if expr='v("foo") = "bar"' --><br />
+ <indent>
+ foo vaut bar<br />
+ </indent>
+ <!--#endif -->
+ </example>
+
+ <note><title>Documentation de r�f�rence</title>
+ <p>Voir aussi <a href="../expr.html">Les expressions dans le serveur
+ HTTP Apache</a> pour une r�f�rence compl�te et des exemples. Les
+ fonctions <em>restricted</em> ne sont pas disponibles dans
+ <module>mod_include</module>.</p>
+ </note>
+</section>
+
+<section id="legacyexpr">
+ <title>Syntaxe des expressions h�rit�e</title>
+
+ <p>Cette section d�crit la syntaxe de l'�l�ment <code>#if
+ expr</code> dans le cas o� la directive <directive
+ module="mod_include">SSILegacyExprParser</directive> est d�finie �
+ <code>on</code>.</p>
+
+ <dl>
+ <dt><code><var>cha�ne</var></code></dt>
+ <dd>vrai si <var>cha�ne</var> n'est pas vide</dd>
+
+ <dt><code><var>-A string</var></code></dt>
+ <dd><p>vrai si l'URL que contient la cha�ne est accessible du
+ point de vue de la configuration, faux sinon. Il
+ s'av�re utile lorsqu'un lien vers une URL doit �tre cach� aux
+ utilisateurs qui ne sont pas autoris�s � voir cette URL. Notez que
+ le test porte sur l'autorisation d'acc�s � l'URL, et non sur son
+ existence.</p>
+
+ <example><title>Exemple</title>
+ <!--#if expr="-A /prive" --><br />
+ <indent>
+ Cliquez <a href="/prive">ici</a> pour acc�der aux
+ informations priv�es.<br />
+ </indent>
+ <!--#endif -->
+ </example>
+ </dd>
+
+ <dt><code><var>cha�ne1</var> = <var>cha�ne2</var><br />
+ <var>cha�ne1</var> == <var>cha�ne2</var><br />
+ <var>cha�ne1</var> != <var>cha�ne2</var></code></dt>
+
+ <dd><p>Compare <var>cha�ne1</var> � <var>cha�ne2</var>. Si
+ <var>cha�ne2</var> est de la forme
+ <code>/<var>cha�ne2</var>/</code>, elle est trait�e comme une
+ expression rationnelle. Les expressions rationnelles sont
+ impl�ment�es par le moteur <a href="http://www.pcre.org">PCRE</a>
+ et poss�dent la m�me syntaxe que celles de <a
+ href="http://www.perl.com">perl 5</a>. Notez que <code>==</code>
+ n'est qu'un alias pour <code>=</code> et se comporte exactement de
+ la m�me mani�re que ce dernier.</p>
+
+ <p>Si vous faites une comparaison directe (<code>=</code> ou
+ <code>==</code>), vous pouvez extraire des parties de l'expression
+ rationnelle. Les parties extraites sont stock�es dans les
+ variables sp�ciales <code>$1</code> .. <code>$9</code>. L'ensemble
+ de la cha�ne correspondant � l'expression rationnelle est stock�
+ dans la variable sp�ciale <code>$0</code>.</p>
+
+ <example><title>Exemple</title>
+ <!--#if expr="$QUERY_STRING = /^sid=([a-zA-Z0-9]+)/" --><br />
+ <indent>
+ <!--#set var="session" value="$1" --><br />
+ </indent>
+ <!--#endif -->
+ </example>
+ </dd>
+
+ <dt><code><var>cha�ne1</var> < <var>cha�ne2</var><br />
+ <var>cha�ne1</var> <= <var>cha�ne2</var><br />
+ <var>cha�ne1</var> > <var>cha�ne2</var><br />
+ <var>cha�ne1</var> >= <var>cha�ne2</var></code></dt>
+
+ <dd>Compare <var>cha�ne1</var> � <var>cha�ne2</var>. Notez que les
+ cha�nes sont compar�es de mani�re <em>litt�rale</em> (en utilisant
+ <code>strcmp(3)</code>). Ainsi, la cha�ne "100" est inf�rieure �
+ "20".</dd>
+
+ <dt><code>( <var>test_condition</var> )</code></dt>
+ <dd>vrai si <var>test_condition</var> est vrai</dd>
+
+ <dt><code>! <var>test_condition</var></code></dt>
+ <dd>vrai si <var>test_condition</var> est faux</dd>
+
+ <dt><code><var>test_condition1</var> &&
+ <var>test_condition2</var></code></dt>
+ <dd>vrai si <var>test_condition1</var> et
+ <var>test_condition2</var> sont tous les deux vrais</dd>
+
+ <dt><code><var>test_condition1</var> ||
+ <var>test_condition2</var></code></dt>
+ <dd>vrai si au moins un des tests <var>test_condition1</var> ou
+ <var>test_condition2</var> est vrai</dd>
+ </dl>
+
+ <p>"<code>=</code>" et "<code>!=</code>" ont une priorit� sup�rieure
+ � "<code>&&</code>" et "<code>||</code>". "<code>!</code>" a
+ la priorit� la plus haute. Ainsi, les deux directives suivantes sont
+ �quivalentes :</p>
+
+ <example>
+ <!--#if expr="$a = test1 && $b = test2" --><br />
+ <!--#if expr="($a = test1) && ($b = test2)" -->
+ </example>
+
+ <p>Les op�rateurs bool�ens <code>&&</code> et
+ <code>||</code> ont la m�me priorit�. Ainsi, si vous voulez
+ augmenter la priorit� d'un de ces op�rateurs, vous devez utiliser
+ des parenth�ses.</p>
+
+ <p>Tout ce qui n'est pas reconnu comme variable ou op�rateur est
+ trait� comme une cha�ne. Les cha�nes peuvent aussi �tre entour�es
+ d'apostrophes : <code>'cha�ne'</code>. Les cha�nes sans apostrophe
+ ne peuvent pas contenir d'espaces (espaces ou tabulations) car
+ ceux-ci servent � s�parer certains �l�ments comme les variables. Si
+ plusieurs cha�nes se trouvent dans une ligne, elles sont concat�n�es
+ en utilisant des espaces. Ainsi,</p>
+
+ <example>
+ <p><code><var>cha�ne1</var> <var
+ >cha�ne2</var></code> devient <code><var>cha�ne1</var> <var
+ >cha�ne2</var></code><br />
+ <br />
+ et<br />
+ <br />
+ <code>'<var>cha�ne1</var> <var
+ >cha�ne2</var>'</code> devient <code><var
+ >cha�ne1</var> <var>cha�ne2</var></code>.</p>
+ </example>
+
+ <note><title>Optimisation des expressions bool�ennes</title>
+ <p>Si les expressions atteignent une complexit� suffisante pour
+ ralentir les traitements de mani�re significative, vous pouvez
+ essayer de les optimiser en fonction des r�gles d'�valuation :</p>
+ <ul>
+ <li>Les expressions sont �valu�es de la gauche vers la droite</li>
+ <li>Les op�rateurs bool�ens binaires (<code>&&</code> et
+ <code>||</code>) font l'objet d'une �valuation abr�g�e chaque fois
+ que cela est possible. En d'autres termes, et selon la r�gle
+ ci-dessus, <module>mod_include</module> �value tout d'abord la
+ partie gauche de l'expression. Si le r�sultat de l'�valuation de
+ cette partie gauche suffit � d�terminer le r�sultat final,
+ l'�valuation s'arr�te ici. Dans le cas contraire, la partie droite
+ est �valu�e, et le r�sultat final tient compte des r�sultats des
+ �valuations des parties gauche et droite.</li>
+ <li>L'�valuation abr�g�e est d�sactiv�e tant qu'il reste des
+ expressions r�guli�res � traiter. Ces derni�res doivent �tre
+ �valu�es afin de d�finir les variables correspondant aux
+ r�f�rences arri�res (<code>$1</code> .. <code>$9</code>).</li>
+ </ul>
+ <p>Si vous voulez d�terminer la mani�re dont une expression est
+ trait�e, vous pouvez recompiler <module>mod_include</module> en
+ utilisant l'option de compilation <code>-DDEBUG_INCLUDE</code>.
+ Ceci a pour effet d'ins�rer, pour chaque expression interpr�t�e,
+ des informations �tiquet�es, l'arbre d'interpr�tation et la
+ mani�re dont elle est �valu�e au sein du flux de sortie envoy� au
+ client.</p>
+ </note>
+
+ <note><title>Slashes d'�chappement dans les expressions
+ rationnelles</title>
+ <p>Tous les caract�res slashes qui ne sont pas des s�parateurs dans
+ votre expression rationnelle doivent �tre �chapp�s, et ceci sans
+ tenir compte de leur signification du point de vue du moteur
+ d'expressions rationnelles.</p>
+ </note>
+
+ <note><title>Documentation de r�f�rence</title>
+ <p>Voir le document <a href="../expr.html">Les expressions dans le
+ serveur HTTP Apache</a>, pour une r�f�rence compl�te et des exemples.</p>
+ </note>
+
+
+</section>
+
+<directivesynopsis>
+<name>SSIEndTag</name>
+<description>Cha�ne qui termine l'�l�ment include</description>
+<syntax>SSIEndTag <var>tag</var></syntax>
+<default>SSIEndTag "-->"</default>
+<contextlist><context>server config</context><context>virtual host</context>
+</contextlist>
+
+<usage>
+ <p>Cette directive permet de modifier la cha�ne que
+ <module>mod_include</module> interpr�te comme la fin d'un �l�ment
+ include.</p>
+
+ <highlight language="config">
+ SSIEndTag "%>"
+ </highlight>
+
+</usage>
+<seealso><directive module="mod_include">SSIStartTag</directive></seealso>
+</directivesynopsis>
+
+<directivesynopsis>
+<name>SSIUndefinedEcho</name>
+<description>Cha�ne � afficher lorsqu'on tente d'extraire le contenu
+d'une variable non d�finie</description>
+<syntax>SSIUndefinedEcho <var>cha�ne</var></syntax>
+<default>SSIUndefinedEcho "(none)"</default>
+<contextlist><context>server config</context><context>virtual host</context>
+<context>directory</context><context>.htaccess</context></contextlist>
+<override>All</override>
+
+<usage>
+ <p>Cette directive permet de modifier la cha�ne affich�e par
+ <module>mod_include</module> lorsqu'on tente d'extraire le contenu
+ d'une variable non d�finie.</p>
+
+ <highlight language="config">
+ SSIUndefinedEcho "<!-- nondef -->"
+ </highlight>
+</usage>
+</directivesynopsis>
+
+<directivesynopsis>
+<name>SSIErrorMsg</name>
+<description>Message d'erreur affich� lorsqu'une erreur SSI
+survient</description>
+<syntax>SSIErrorMsg <var>message</var></syntax>
+<default>SSIErrorMsg "[an error occurred while processing this
+directive]"</default>
+<contextlist><context>server config</context><context>virtual host</context>
+<context>directory</context><context>.htaccess</context></contextlist>
+<override>All</override>
+
+<usage>
+ <p>La directive <directive>SSIErrorMsg</directive> permet de
+ modifier le message d'erreur affich� lorsqu'une erreur SSI survient.
+ Pour les serveurs en production, il est recommand� de modifier le
+ message d'erreur par d�faut en <code>"<!-- Error
+ -->"</code>, de fa�on � ce que le message ne soit pas
+ pr�sent� � l'utilisateur.</p>
+
+ <p>Cette directive a le m�me effet que l'�l�ment
+ <code><!--#config errmsg=<var>message</var> --></code>.</p>
+
+ <highlight language="config">
+ SSIErrorMsg "<!-- Error -->"
+ </highlight>
+</usage>
+</directivesynopsis>
+
+<directivesynopsis>
+<name>SSIStartTag</name>
+<description>Cha�ne qui marque le d�but d'un �l�ment
+include</description>
+<syntax>SSIStartTag <var>tag</var></syntax>
+<default>SSIStartTag "<!--#"</default>
+<contextlist><context>server config</context><context>virtual host</context>
+</contextlist>
+
+<usage>
+ <p>Cette directive permet de modifier la cha�ne que
+ <module>mod_include</module> interpr�te comme le d�but d'un �l�ment
+ include.</p>
+
+ <p>Cette option peut vous �tre utile si vous avez deux serveurs qui
+ interpr�tent un fichier avec des commandes diff�rentes (et
+ �ventuellement � des moments diff�rents).</p>
+
+ <highlight language="config">
+SSIStartTag "<%"
+SSIEndTag "%>"
+ </highlight>
+
+ <p>Avec l'exemple ci-dessus, qui d�finit aussi une directive
+ <directive module="mod_include">SSIEndTag</directive>, vous pourrez
+ inscrire des directives SSI comme dans l'exemple suivant :</p>
+
+ <example><title>Directives SSI avec marques de d�but et de fin
+ personnalis�es</title>
+ <%printenv %>
+ </example>
+</usage>
+<seealso><directive module="mod_include">SSIEndTag</directive></seealso>
+</directivesynopsis>
+
+<directivesynopsis>
+<name>SSITimeFormat</name>
+<description>Configuration du format d'affichage des dates</description>
+<syntax>SSITimeFormat <var>cha�ne de formatage</var></syntax>
+<default>SSITimeFormat "%A, %d-%b-%Y %H:%M:%S %Z"</default>
+<contextlist>
+<context>server config</context><context>virtual host</context>
+<context>directory</context><context>.htaccess</context></contextlist>
+<override>All</override>
+
+<usage>
+<p>Cette directive permet de modifier le format d'affichage des
+variables d'environnement <code>DATE</code>. La <var>cha�ne de
+formatage</var> est identique � celle de la fonction
+<code>strftime(3)</code> de la biblioth�que C standard.</p>
+
+ <p>Cette directive a le m�me effet que l'�l�ment
+ <code><!--#config timefmt=<var>cha�ne de formatage</var>
+ --></code>.</p>
+
+ <highlight language="config">
+ SSITimeFormat "%R, %B %d, %Y"
+ </highlight>
+
+ <p>Avec l'exemple ci-dessus, les dates seront affich�es dans le
+ style "22:26, June 14, 2002".</p>
+</usage>
+</directivesynopsis>
+
+<directivesynopsis>
+<name>SSIETag</name>
+<description>D�finit si des en-t�tes ETags sont g�n�r�s par le serveur.</description>
+<syntax>SSIETag on|off</syntax>
+<default>SSIETag off</default>
+<contextlist><context>directory</context><context>.htaccess</context></contextlist>
+
+<usage>
+ <p>Dans le cas g�n�ral, un fichier filtr� par
+ <module>mod_include</module> peut contenir des �l�ments soit
+ g�n�r�s dynamiquement, soit �ventuellement modifi�s ind�pendemment
+ du fichier original. En cons�quence, il est demand� par d�faut au
+ serveur de ne pas g�n�rer d'en-t�te <code>ETag</code> � la r�ponse
+ en ajoutant <code>no-etag</code> aux informations de requ�te.</p>
+
+ <p>Ce comportement peut �tre modifi� via la directive
+ <directive>SSIETag</directive> qui permet au serveur de g�n�rer un
+ en-t�te <code>ETag</code>. On peut aussi l'utiliser pour la mise
+ en cache de la sortie. Notez qu'un serveur d'arri�re-plan ou un
+ g�n�rateur de contenu dynamique peut lui-m�me g�n�rer un en-t�te
+ <code>ETag</code>, en ignorant l'information <code>no-etag</code>,
+ cet en-t�te <code>ETag</code> �tant transmis par
+ <module>mod_include</module> sans tenir compte de la d�finition de
+ la pr�sente directive. La directive <directive>SSIETag</directive>
+ peut prendre une des valeurs suivantes :</p>
+
+ <dl>
+
+ <dt><code>off</code></dt>
+ <dd><code>no-etag</code> sera ajout� aux informations de
+ requ�te, et il sera demand� au serveur de ne pas g�n�rer
+ d'en-t�te <code>ETag</code>. Lorsqu'un serveur ignore la valeur
+ de <code>no-etag</code> et g�n�re tout de m�me un en-t�te
+ <code>ETag</code>, ce dernier sera respect�.</dd>
+
+ <dt><code>on</code></dt>
+ <dd>Les en-t�tes <code>ETag</code> existants seront respect�s,
+ et ceux g�n�r�s par le serveur seront ajout�s � la r�ponse.</dd>
+
+ </dl>
+
+</usage>
+</directivesynopsis>
+
+<directivesynopsis>
+<name>SSILastModified</name>
+<description>D�finit si des en-t�tes <code>Last-Modified</code> sont
+g�n�r�s par le serveur.</description>
+<syntax>SSILastModified on|off</syntax>
+<default>SSILastModified off</default>
+<contextlist><context>directory</context><context>.htaccess</context></contextlist>
+
+<usage>
+ <p>Dans le cas g�n�ral, un fichier filtr� par
+ <module>mod_include</module> peut contenir des �l�ments soit
+ g�n�r�s dynamiquement, soit �ventuellement modifi�s ind�pendemment
+ du fichier original. En cons�quence, l'en-t�te
+ <code>Last-Modified</code> est supprim� par d�faut de la r�ponse.</p>
+
+ <p>La directive <directive>SSILastModified</directive> permet de
+ modifier ce comportement en faisant en sorte que l'en-t�te
+ <code>Last-Modified</code> soit respect� s'il est d�j� pr�sent, ou
+ d�fini dans le cas contraire. On peut aussi l'utiliser pour la mise
+ en cache de la sortie. La directive
+ <directive>SSILastModified</directive> peut prendre une des
+ valeurs suivantes :</p>
+
+ <dl>
+
+ <dt><code>off</code></dt>
+ <dd>L'en-t�te <code>Last-Modified</code> sera supprim� des
+ r�ponses, � moins que la directive <directive
+ module="mod_include">XBitHack</directive> ne soit d�finie �
+ <code>full</code> comme d�crit plus loin.</dd>
+
+ <dt><code>on</code></dt>
+ <dd>L'en-t�te <code>Last-Modified</code> sera respect� s'il est
+ d�j� pr�sent, et ajout� � la r�ponse si cette derni�re est un
+ fichier et si l'en-t�te est manquant. La directive <directive
+ module="mod_include">SSILastModified</directive> l'emporte sur
+ la directive <directive
+ module="mod_include">XBitHack</directive>.</dd>
+
+ </dl>
+
+</usage>
+</directivesynopsis>
+<directivesynopsis>
+<name>SSILegacyExprParser</name>
+<description>Active le mode de compatibilit� pour les expressions
+conditionnelles.</description>
+<syntax>SSILegacyExprParser on|off</syntax>
+<default>SSILegacyExprParser off</default>
+<contextlist><context>directory</context><context>.htaccess</context></contextlist>
+<compatibility>Disponible � partir de la version 2.3.13.</compatibility>
+
+<usage>
+ <p>Depuis la version 2.3.13, <module>mod_include</module> a adopt�
+ la nouvelle syntaxe <a href="../expr.html">ap_expr</a> pour ses
+ expressions conditionnelles dans les �l�ments de contr�le de flux
+ <code>#if</code>. Cette directive permet de r�activer l'<a
+ href="#legacyexpr">ancienne syntaxe</a> qui est compatible avec les
+ versions 2.2.x et ant�rieures d'Apache HTTPD.
+ </p>
+</usage>
+</directivesynopsis>
+
+<directivesynopsis>
+<name>XBitHack</name>
+<description>Interpr�te les directives SSI dans les fichiers dont le bit
+d'ex�cution est positionn�</description>
+<syntax>XBitHack on|off|full</syntax>
+<default>XBitHack off</default>
+<contextlist><context>server config</context><context>virtual host</context>
+<context>directory</context><context>.htaccess</context></contextlist>
+<override>Options</override>
+
+<usage>
+ <p>La directive <directive>XBitHack</directive> permet de contr�ler
+ l'interpr�tation des documents html standards. Elle n'affecte que
+ les fichiers dont le <glossary>type MIME</glossary> est
+ <code>text/html</code>. <directive>XBitHack</directive> peut prendre
+ les valeurs suivantes :</p>
+
+ <dl>
+ <dt><code>off</code></dt>
+ <dd>Aucun traitement particulier pour les fichiers
+ ex�cutables.</dd>
+
+ <dt><code>on</code></dt>
+ <dd>Tout fichier <code>text/html</code> dont le bit d'ex�cution
+ est positionn� pour le propri�taire sera trait� en tant que
+ document html interpr�t� par le serveur.</dd>
+
+ <dt><code>full</code></dt>
+ <dd>Identique � <code>on</code>, avec test du bit d'ex�cution pour
+ le groupe. Si ce dernier est positionn�, la date de <code>derni�re
+ modification</code> du fichier renvoy� est d�finie � la date de
+ derni�re modification du fichier. Dans le cas contraire, aucune
+ date de derni�re modification n'est renvoy�e. Le positionnement de
+ ce bit permet aux clients et aux mandataires de g�rer la mise en
+ cache du r�sultat de la requ�te.
+
+ <note><title>Note</title>
+ <p>Il est recommand� de n'utiliser l'option full que dans le cas
+ o� vous �tes certain que le bit d'ex�cution du groupe est non
+ positionn� pour les scripts SSI qui pourraient effectuer l'<code
+ >#include</code> d'un programme CGI ou bien produire des sorties
+ diff�rentes � chaque acc�s (ou seraient susceptibles d'�tre
+ modifi�es au cours des requ�tes ult�rieures).</p>
+
+ <p>Lorsqu'elle est d�finie � <code>on</code>, la directive
+ <directive module="mod_include">SSILastModified</directive>
+ l'emporte sur la directive <directive
+ module="mod_include">XBitHack</directive>.</p>
+ </note>
+
+ </dd>
+ </dl>
+
+</usage>
+</directivesynopsis>
+
+</modulesynopsis>
Modified: httpd/httpd/trunk/docs/manual/mod/mod_include.xml.meta
URL: http://svn.apache.org/viewvc/httpd/httpd/trunk/docs/manual/mod/mod_include.xml.meta?rev=1780462&r1=1780461&r2=1780462&view=diff
==============================================================================
--- httpd/httpd/trunk/docs/manual/mod/mod_include.xml.meta (original)
+++ httpd/httpd/trunk/docs/manual/mod/mod_include.xml.meta Thu Jan 26 20:02:25 2017
@@ -8,6 +8,7 @@
<variants>
<variant>en</variant>
+ <variant>fr</variant>
<variant outdated="yes">ja</variant>
</variants>
</metafile>
Modified: httpd/httpd/trunk/docs/manual/mod/mod_isapi.html
URL: http://svn.apache.org/viewvc/httpd/httpd/trunk/docs/manual/mod/mod_isapi.html?rev=1780462&r1=1780461&r2=1780462&view=diff
==============================================================================
--- httpd/httpd/trunk/docs/manual/mod/mod_isapi.html (original)
+++ httpd/httpd/trunk/docs/manual/mod/mod_isapi.html Thu Jan 26 20:02:25 2017
@@ -4,6 +4,10 @@ URI: mod_isapi.html.en
Content-Language: en
Content-type: text/html; charset=ISO-8859-1
+URI: mod_isapi.html.fr
+Content-Language: fr
+Content-type: text/html; charset=ISO-8859-1
+
URI: mod_isapi.html.ko.euc-kr
Content-Language: ko
Content-type: text/html; charset=EUC-KR
Added: httpd/httpd/trunk/docs/manual/mod/mod_isapi.html.fr
URL: http://svn.apache.org/viewvc/httpd/httpd/trunk/docs/manual/mod/mod_isapi.html.fr?rev=1780462&view=auto
==============================================================================
--- httpd/httpd/trunk/docs/manual/mod/mod_isapi.html.fr (added)
+++ httpd/httpd/trunk/docs/manual/mod/mod_isapi.html.fr Thu Jan 26 20:02:25 2017
@@ -0,0 +1,395 @@
+<?xml version="1.0" encoding="ISO-8859-1"?>
+<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Strict//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-strict.dtd">
+<html xmlns="http://www.w3.org/1999/xhtml" lang="fr" xml:lang="fr"><head>
+<meta content="text/html; charset=ISO-8859-1" http-equiv="Content-Type" />
+<!--
+ XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
+ This file is generated from xml source: DO NOT EDIT
+ XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
+ -->
+<title>mod_isapi - Serveur Apache HTTP Version 2.5</title>
+<link href="../style/css/manual.css" rel="stylesheet" media="all" type="text/css" title="Main stylesheet" />
+<link href="../style/css/manual-loose-100pc.css" rel="alternate stylesheet" media="all" type="text/css" title="No Sidebar - Default font size" />
+<link href="../style/css/manual-print.css" rel="stylesheet" media="print" type="text/css" /><link rel="stylesheet" type="text/css" href="../style/css/prettify.css" />
+<script src="../style/scripts/prettify.min.js" type="text/javascript">
+</script>
+
+<link href="../images/favicon.ico" rel="shortcut icon" /></head>
+<body>
+<div id="page-header">
+<p class="menu"><a href="../mod/">Modules</a> | <a href="../mod/quickreference.html">Directives</a> | <a href="http://wiki.apache.org/httpd/FAQ">FAQ</a> | <a href="../glossary.html">Glossaire</a> | <a href="../sitemap.html">Plan du site</a></p>
+<p class="apache">Serveur Apache HTTP Version 2.5</p>
+<img alt="" src="../images/feather.png" /></div>
+<div class="up"><a href="./"><img title="<-" alt="<-" src="../images/left.gif" /></a></div>
+<div id="path">
+<a href="http://www.apache.org/">Apache</a> > <a href="http://httpd.apache.org/">Serveur HTTP</a> > <a href="http://httpd.apache.org/docs/">Documentation</a> > <a href="../">Version 2.5</a> > <a href="./">Modules</a></div>
+<div id="page-content">
+<div id="preamble"><h1>Module Apache mod_isapi</h1>
+<div class="toplang">
+<p><span>Langues Disponibles: </span><a href="../en/mod/mod_isapi.html" hreflang="en" rel="alternate" title="English"> en </a> |
+<a href="../fr/mod/mod_isapi.html" title="Fran�ais"> fr </a> |
+<a href="../ko/mod/mod_isapi.html" hreflang="ko" rel="alternate" title="Korean"> ko </a></p>
+</div>
+<div class="outofdate">Cette traduction peut �tre p�rim�e. V�rifiez la version
+ anglaise pour les changements r�cents.</div>
+<table class="module"><tr><th><a href="module-dict.html#Description">Description:</a></th><td>Extensions ISAPI dans Apache pour Windows</td></tr>
+<tr><th><a href="module-dict.html#Status">Statut:</a></th><td>Base</td></tr>
+<tr><th><a href="module-dict.html#ModuleIdentifier">Identificateur�de�Module:</a></th><td>isapi_module</td></tr>
+<tr><th><a href="module-dict.html#SourceFile">Fichier�Source:</a></th><td>mod_isapi.c</td></tr>
+<tr><th><a href="module-dict.html#Compatibility">Compatibilit�:</a></th><td>Win32 only</td></tr></table>
+<h3>Sommaire</h3>
+
+ <p>Ce module impl�mente l'API des extensions du Serveur Internet. Il
+ permet � Apache pour Windows de servir les extensions du Serveur
+ Internet (par exemple les modules .dll ISAPI), compte tenu des
+ restrictions sp�cifi�es.</p>
+
+ <p>Les modules d'extension ISAPI (fichiers .dll) sont des modules
+ tiers. Leur auteur n'est pas le Groupe Apache, et nous n'assurons
+ donc pas leur support. Veuillez contacter directement l'auteur
+ d'ISAPI si vous rencontrez des probl�mes � l'ex�cution d'une
+ extension ISAPI. <strong>Merci de <em>ne pas</em> soumettre ce genre
+ de probl�me dans les listes d'Apache ou dans les pages de rapports
+ de bogues.</strong></p>
+</div>
+<div id="quickview"><h3>Sujets</h3>
+<ul id="topics">
+<li><img alt="" src="../images/down.gif" /> <a href="#usage">Utilisation</a></li>
+<li><img alt="" src="../images/down.gif" /> <a href="#notes">Notes additionnelles</a></li>
+<li><img alt="" src="../images/down.gif" /> <a href="#journal">Journal du programmeur</a></li>
+</ul><h3 class="directives">Directives</h3>
+<ul id="toc">
+<li><img alt="" src="../images/down.gif" /> <a href="#isapiappendlogtoerrors">ISAPIAppendLogToErrors</a></li>
+<li><img alt="" src="../images/down.gif" /> <a href="#isapiappendlogtoquery">ISAPIAppendLogToQuery</a></li>
+<li><img alt="" src="../images/down.gif" /> <a href="#isapicachefile">ISAPICacheFile</a></li>
+<li><img alt="" src="../images/down.gif" /> <a href="#isapifakeasync">ISAPIFakeAsync</a></li>
+<li><img alt="" src="../images/down.gif" /> <a href="#isapilognotsupported">ISAPILogNotSupported</a></li>
+<li><img alt="" src="../images/down.gif" /> <a href="#isapireadaheadbuffer">ISAPIReadAheadBuffer</a></li>
+</ul>
+<h3>Traitement des bugs</h3><ul class="seealso"><li><a href="https://www.apache.org/dist/httpd/CHANGES_2.4">Journal des modifications de httpd</a></li><li><a href="https://bz.apache.org/bugzilla/buglist.cgi?bug_status=__open__&list_id=144532&product=Apache%20httpd-2&query_format=specific&order=changeddate%20DESC%2Cpriority%2Cbug_severity&component=mod_isapi">Probl�mes connus</a></li><li><a href="https://bz.apache.org/bugzilla/enter_bug.cgi?product=Apache%20httpd-2&component=mod_isapi">Signaler un bug</a></li></ul><h3>Voir aussi</h3>
+<ul class="seealso">
+<li><a href="#comments_section">Commentaires</a></li></ul></div>
+<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
+<div class="section">
+<h2><a name="usage" id="usage">Utilisation</a></h2>
+
+ <p>Dans le fichier de configuration du serveur, utilisez la
+ directive <code class="directive"><a href="../mod/mod_mime.html#addhandler">AddHandler</a></code> pour
+ associer les fichiers ISAPI au gestionnaire
+ <code>isapi-handler</code> � l'aide de l'extension de leur nom de
+ fichier. Pour faire en sorte que tout fichier .dll soit trait� en
+ tant qu'extension ISAPI, �ditez le fichier httpd.conf et ajoutez les
+ lignes suivantes :</p>
+ <pre class="prettyprint lang-config">AddHandler isapi-handler .dll</pre>
+
+
+ <div class="note">Dans les versions plus anciennes du serveur Apache, le nom du
+ gestionnaire �tait <code>isapi-isa</code> au lieu de
+ <code>isapi-handler</code>. Depuis les versions de d�veloppement 2.3
+ du serveur Apache, <code>isapi-isa</code> n'est plus valide, et vous
+ devrez �ventuellement modifier votre configuration pour utiliser
+ <code>isapi-handler</code> � la place.</div>
+
+ <p>Le serveur Apache ne propose aucun moyen de conserver en m�moire
+ un module charg�. Vous pouvez cependant pr�charger et garder un
+ module sp�cifique en m�moire en utilisant la syntaxe suivante dans
+ votre httpd.conf :</p>
+ <pre class="prettyprint lang-config">ISAPICacheFile c:/WebWork/Scripts/ISAPI/mytest.dll</pre>
+
+
+ <p>Que vous ayez ou non pr�charg� une extension ISAPI, ces derni�res
+ sont toutes soumises au m�mes restrictions et poss�dent les m�mes
+ permissions que les scripts CGI. En d'autres termes, <code class="directive"><a href="../mod/core.html#options">Options</a></code> <code>ExecCGI</code> doit �tre
+ d�fini pour le r�pertoire qui contient le fichier .dll ISAPI.</p>
+
+ <p>Reportez-vous aux <a href="#notes">Notes additionnelles</a> et au
+ <a href="#journal">Journal du programmeur</a> pour plus de d�tails
+ et une clarification � propos du support sp�cifique ISAPI fourni par
+ le module <code class="module"><a href="../mod/mod_isapi.html">mod_isapi</a></code>.</p>
+</div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
+<div class="section">
+<h2><a name="notes" id="notes">Notes additionnelles</a></h2>
+
+ <p>L'impl�mentation ISAPI d'Apache se conforme � toutes les
+ sp�cifications ISAPI 2.0, � l'exception de certaines extensions
+ "sp�cifiques Microsoft" utilisant des entr�es/sorties asynchrones.
+ Le mod�le des entr�es/sorties d'Apache ne permet pas l'�criture et
+ la lecture asynchrone de la mani�re dont ISAPI pourrait le faire. Si
+ une extension tente d'utiliser des fonctionnalit�s non support�es,
+ comme les entr�es/sorties asynchrones, un message est enregistr�
+ dans le journal des erreurs afin d'aider au d�bogage. Comme ces
+ messages peuvent devenir envahissants, la directive
+ <code>ISAPILogNotSupported Off</code> permet de filter ce bruit de
+ fond.</p>
+
+ <p>Si aucune option de configuration particuli�re n'est sp�cifi�e,
+ certains serveurs, comme Microsoft IIS, chargent l'extension ISAPI
+ dans le serveur et la conservent en m�moire jusqu'� ce que
+ l'utilisation de cette derni�re devienne trop �lev�e. Apache, par
+ contre, charge et d�charge r�ellement l'extension ISAPI chaque fois
+ qu'elle est invoqu�e, si la directive <code class="directive"><a href="#isapicachefile">ISAPICacheFile</a></code> n'a pas �t� sp�cifi�e.
+ Ce n'est pas tr�s performant, mais le mod�le de m�moire d'Apache
+ fait que cette m�thode est la plus efficace. De nombreux modules
+ ISAPI pr�sentent des incompatibilit�s subtiles avec le serveur
+ Apache, et le d�chargement de ces modules permet d'assurer la
+ stabilit� du serveur.</p>
+
+ <p>En outre, gardez � l'esprit que si Apache supporte les extensions
+ ISAPI, il <strong>ne supporte pas les filtres ISAPI</strong>. Le
+ support des filtres sera peut-�tre ajout� dans le futur, mais n'a
+ pas encore �t� planifi�.</p>
+</div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
+<div class="section">
+<h2><a name="journal" id="journal">Journal du programmeur</a></h2>
+
+ <p>Si vous �crivez des modules <code class="module"><a href="../mod/mod_isapi.html">mod_isapi</a></code> Apache
+ 2.0, vous devez limiter vos appels �
+ <code>ServerSupportFunction</code> aux directives suivantes :</p>
+
+ <dl>
+ <dt><code>HSE_REQ_SEND_URL_REDIRECT_RESP</code></dt>
+ <dd>Redirige l'utilisateur vers une autre adresse.<br />
+ Il doit s'agir d'une URL pleinement qualifi�e (comme
+ <code>http://serveur/chemin</code>).</dd>
+
+ <dt><code>HSE_REQ_SEND_URL</code></dt>
+ <dd>Redirige l'utilisateur vers une autre adresse.<br />
+ Ce ne doit pas �tre une URL pleinement qualifi�e ; la mention du
+ protocole ou du nom du serveur n'est pas autoris�e (par exemple,
+ utilisez simplement <code>/chemin</code>).<br />
+ La redirection n'est pas assur�e par le navigateur mais par le
+ serveur lui-m�me.<br />
+ <div class="warning"><h3>Avertissement</h3>
+ <p>Dans sa documentation r�cente, Microsoft semble avoir
+ abandonn� la distinction entre les deux fonctions
+ <code>HSE_REQ_SEND_URL</code>. Apache, quant � lui, continue de
+ les traiter comme deux fonctions distinctes avec des contraintes
+ et des comportements sp�cifiques.</p>
+ </div></dd>
+
+ <dt><code>HSE_REQ_SEND_RESPONSE_HEADER</code></dt>
+ <dd>Apache accepte un corps de r�ponse apr�s l'en-t�te s'il se
+ situe apr�s la ligne vide (deux caract�res newline cons�cutifs)
+ dans la cha�ne des arguments d'en-t�tes. Ce corps ne doit pas
+ contenir de caract�res NULL, car l'argument des en-t�tes est
+ lui-m�me termin� par un caract�re NULL.</dd>
+
+ <dt><code>HSE_REQ_DONE_WITH_SESSION</code></dt>
+ <dd>Apache consid�re ceci comme sans objet, car la session est
+ ferm�e lorsque l'extension ISAPI termine son traitement.</dd>
+
+ <dt><code>HSE_REQ_MAP_URL_TO_PATH</code></dt>
+ <dd>Apache va traduire un nom virtuel en nom physique.</dd>
+
+ <dt><code>HSE_APPEND_LOG_PARAMETER</code></dt>
+ <dd>
+ Ce param�tre peut intervenir dans un de ces journaux :
+
+ <ul>
+ <li>dans le composant <code>\"%{isapi-parameter}n\"</code>
+ d'une directive <code class="directive"><a href="../mod/mod_log_config.html#customlog">CustomLog</a></code></li>
+
+ <li>dans le composant <code>%q</code> avec la directive
+ <code class="directive"><a href="#isapiappendlogtoquery">ISAPIAppendLogToQuery</a></code>
+ <code>On</code></li>
+
+ <li>dans le journal des erreurs avec la directive <code class="directive"><a href="#isapiappendlogtoerrors">ISAPIAppendLogToErrors</a></code>
+ <code>On</code></li>
+ </ul>
+
+ <p>La premi�re option, le composant
+ <code>%{isapi-parameter}n</code>, est pr�f�rable et toujours
+ disponible.</p>
+ </dd>
+
+ <dt><code>HSE_REQ_IS_KEEP_CONN</code></dt>
+ <dd>retourne le statut n�goci� Keep-Alive.</dd>
+
+ <dt><code>HSE_REQ_SEND_RESPONSE_HEADER_EX</code></dt>
+ <dd>se comportera comme indiqu� dans le documentation, bien que le
+ drapeau <code>fKeepConn</code> soit ignor�.</dd>
+
+ <dt><code>HSE_REQ_IS_CONNECTED</code></dt>
+ <dd>renverra faux si la requ�te a �t� abandonn�e.</dd>
+ </dl>
+
+ <p>Apache renvoie <code>FALSE</code> pour tout appel non support� �
+ <code>ServerSupportFunction</code>, et <code>GetLastError</code>
+ renverra la valeur <code>ERROR_INVALID_PARAMETER</code>.</p>
+
+ <p><code>ReadClient</code> extrait la partie du corps de la requ�te
+ qui d�passe le tampon initial (d�fini par la directive <code class="directive"><a href="#isapireadaheadbuffer">ISAPIReadAheadBuffer</a></code>). En fonction de
+ la d�finition de la directive
+ <code class="directive">ISAPIReadAheadBuffer</code> (nombre d'octets �
+ mettre dans le tampon avant d'appeler le gestionnaire ISAPI), les
+ requ�tes courtes sont envoy�es en entier � l'extension lorsque
+ celle-ci est invoqu�e. Si la taille de la requ�te est trop
+ importante, l'extension ISAPI doit faire appel �
+ <code>ReadClient</code> pour extraire la totalit� du corps de la
+ requ�te.</p>
+
+ <p><code>WriteClient</code> est support�, mais seulement avec le
+ drapeau <code>HSE_IO_SYNC</code> ou le drapeau "aucune option"
+ (valeur <code>0</code>). Toute autre requ�te
+ <code>WriteClient</code> sera rejet�e avec une valeur de retour
+ <code>FALSE</code>, et <code>GetLastError</code> renverra la valeur
+ <code>ERROR_INVALID_PARAMETER</code></p>
+
+ <p><code>GetServerVariable</code> est support�, bien que les
+ variables �tendues de serveur n'existent pas (comme d�fini par
+ d'autres serveurs). Toutes les variables d'environnement CGI
+ usuelles d'Apache sont disponibles � partir de
+ <code>GetServerVariable</code>, ainsi que les valeurs
+ <code>ALL_HTTP</code> et <code>ALL_RAW</code>.</p>
+
+ <p>Depuis httpd 2.0, <code class="module"><a href="../mod/mod_isapi.html">mod_isapi</a></code> propose des
+ fonctionnalit�s suppl�mentaires introduites dans les versions
+ actualis�es de la sp�cification ISAPI, ainsi qu'une �mulation
+ limit�e des entr�es/sorties asynchrones et la s�mantique
+ <code>TransmitFile</code>. Apache httpd supporte aussi le pr�chargement
+ des .dlls ISAPI � des fins de performances.</p>
+</div>
+<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
+<div class="directive-section"><h2><a name="isapiappendlogtoerrors" id="isapiappendlogtoerrors">Directive</a> <a name="ISAPIAppendLogToErrors" id="ISAPIAppendLogToErrors">ISAPIAppendLogToErrors</a></h2>
+<table class="directive">
+<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Enregistrement des requ�tes
+<code>HSE_APPEND_LOG_PARAMETER</code> de la part des extensions ISAPI
+dans le journal des erreurs</td></tr>
+<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>ISAPIAppendLogToErrors on|off</code></td></tr>
+<tr><th><a href="directive-dict.html#Default">D�faut:</a></th><td><code>ISAPIAppendLogToErrors off</code></td></tr>
+<tr><th><a href="directive-dict.html#Context">Contexte:</a></th><td>configuration du serveur, serveur virtuel, r�pertoire, .htaccess</td></tr>
+<tr><th><a href="directive-dict.html#Override">AllowOverride:</a></th><td>FileInfo</td></tr>
+<tr><th><a href="directive-dict.html#Status">Statut:</a></th><td>Base</td></tr>
+<tr><th><a href="directive-dict.html#Module">Module:</a></th><td>mod_isapi</td></tr>
+</table>
+ <p>Cette directive permet d'enregistrer les requ�tes
+ <code>HSE_APPEND_LOG_PARAMETER</code> de la part des extensions
+ ISAPI dans le journal des erreurs.</p>
+
+</div>
+<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
+<div class="directive-section"><h2><a name="isapiappendlogtoquery" id="isapiappendlogtoquery">Directive</a> <a name="ISAPIAppendLogToQuery" id="ISAPIAppendLogToQuery">ISAPIAppendLogToQuery</a></h2>
+<table class="directive">
+<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Enregistre les requ�tes
+<code>HSE_APPEND_LOG_PARAMETER</code> de la part des extensions ISAPI
+dans la partie arguments de la requ�te</td></tr>
+<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>ISAPIAppendLogToQuery on|off</code></td></tr>
+<tr><th><a href="directive-dict.html#Default">D�faut:</a></th><td><code>ISAPIAppendLogToQuery on</code></td></tr>
+<tr><th><a href="directive-dict.html#Context">Contexte:</a></th><td>configuration du serveur, serveur virtuel, r�pertoire, .htaccess</td></tr>
+<tr><th><a href="directive-dict.html#Override">AllowOverride:</a></th><td>FileInfo</td></tr>
+<tr><th><a href="directive-dict.html#Status">Statut:</a></th><td>Base</td></tr>
+<tr><th><a href="directive-dict.html#Module">Module:</a></th><td>mod_isapi</td></tr>
+</table>
+ <p>Cette directive permet d'enregistrer les requ�tes
+ <code>HSE_APPEND_LOG_PARAMETER</code> de la part des extensions
+ ISAPI dans la partie arguments de la requ�te (ajout� au composant
+ <code>%q</code> de la directive <code class="directive"><a href="../mod/mod_log_config.html#customlog">CustomLog</a></code>).</p>
+
+</div>
+<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
+<div class="directive-section"><h2><a name="isapicachefile" id="isapicachefile">Directive</a> <a name="ISAPICacheFile" id="ISAPICacheFile">ISAPICacheFile</a></h2>
+<table class="directive">
+<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Fichiers .dll ISAPI devant �tre charg�s au
+d�marrage</td></tr>
+<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>ISAPICacheFile <var>chemin-fichier</var>
+[<var>chemin-fichier</var>]
+...</code></td></tr>
+<tr><th><a href="directive-dict.html#Context">Contexte:</a></th><td>configuration du serveur, serveur virtuel</td></tr>
+<tr><th><a href="directive-dict.html#Status">Statut:</a></th><td>Base</td></tr>
+<tr><th><a href="directive-dict.html#Module">Module:</a></th><td>mod_isapi</td></tr>
+</table>
+ <p>Cette directive permet de sp�cifier une liste, s�par�s par des
+ espaces, de noms de fichiers devant �tre charg�s au d�marrage
+ du serveur Apache, et rester en m�moire jusqu'� l'arr�t du serveur.
+ Cette directive peut �tre r�p�t�e pour chaque fichier .dll ISAPI
+ souhait�. Le chemin complet du fichier doit �tre sp�cifi�. Si le
+ chemin n'est pas absolu, il sera consid�r� comme relatif au
+ r�pertoire d�fini par la directive <code class="directive"><a href="../mod/core.html#serverroot">ServerRoot</a></code>.</p>
+
+</div>
+<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
+<div class="directive-section"><h2><a name="isapifakeasync" id="isapifakeasync">Directive</a> <a name="ISAPIFakeAsync" id="ISAPIFakeAsync">ISAPIFakeAsync</a></h2>
+<table class="directive">
+<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Emulation du support des entr�es/sorties asynchrones pour
+les appels ISAPI</td></tr>
+<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>ISAPIFakeAsync on|off</code></td></tr>
+<tr><th><a href="directive-dict.html#Default">D�faut:</a></th><td><code>ISAPIFakeAsync off</code></td></tr>
+<tr><th><a href="directive-dict.html#Context">Contexte:</a></th><td>configuration du serveur, serveur virtuel, r�pertoire, .htaccess</td></tr>
+<tr><th><a href="directive-dict.html#Override">AllowOverride:</a></th><td>FileInfo</td></tr>
+<tr><th><a href="directive-dict.html#Status">Statut:</a></th><td>Base</td></tr>
+<tr><th><a href="directive-dict.html#Module">Module:</a></th><td>mod_isapi</td></tr>
+</table>
+ <p>Lorsquelle est d�finie � "on", cette directive permet d'�muler le
+ support des entr�es/sorties asynchrones pour les appels ISAPI.</p>
+
+</div>
+<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
+<div class="directive-section"><h2><a name="isapilognotsupported" id="isapilognotsupported">Directive</a> <a name="ISAPILogNotSupported" id="ISAPILogNotSupported">ISAPILogNotSupported</a></h2>
+<table class="directive">
+<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Journalisation des demandes de fonctionnalit�s non
+support�es de la part des extensions ISAPI</td></tr>
+<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>ISAPILogNotSupported on|off</code></td></tr>
+<tr><th><a href="directive-dict.html#Default">D�faut:</a></th><td><code>ISAPILogNotSupported off</code></td></tr>
+<tr><th><a href="directive-dict.html#Context">Contexte:</a></th><td>configuration du serveur, serveur virtuel, r�pertoire, .htaccess</td></tr>
+<tr><th><a href="directive-dict.html#Override">AllowOverride:</a></th><td>FileInfo</td></tr>
+<tr><th><a href="directive-dict.html#Status">Statut:</a></th><td>Base</td></tr>
+<tr><th><a href="directive-dict.html#Module">Module:</a></th><td>mod_isapi</td></tr>
+</table>
+ <p>Cette directive permet d'enregistrer dans le journal des erreurs
+ toutes les demandes de fonctionnalit�s non support�es de la part des
+ extensions ISAPI. Ceci peut aider les administrateurs � d�cortiquer
+ certains probl�mes. Lorsqu'elle a �t� d�finie � "on" et si tous les
+ modules ISAPI fonctionnent, elle peut �tre red�finie � "off".</p>
+
+</div>
+<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
+<div class="directive-section"><h2><a name="isapireadaheadbuffer" id="isapireadaheadbuffer">Directive</a> <a name="ISAPIReadAheadBuffer" id="ISAPIReadAheadBuffer">ISAPIReadAheadBuffer</a></h2>
+<table class="directive">
+<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Taille du tampon de lecture anticip�e envoy� aux extensions
+ISAPI</td></tr>
+<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>ISAPIReadAheadBuffer <var>taille</var></code></td></tr>
+<tr><th><a href="directive-dict.html#Default">D�faut:</a></th><td><code>ISAPIReadAheadBuffer 49152</code></td></tr>
+<tr><th><a href="directive-dict.html#Context">Contexte:</a></th><td>configuration du serveur, serveur virtuel, r�pertoire, .htaccess</td></tr>
+<tr><th><a href="directive-dict.html#Override">AllowOverride:</a></th><td>FileInfo</td></tr>
+<tr><th><a href="directive-dict.html#Status">Statut:</a></th><td>Base</td></tr>
+<tr><th><a href="directive-dict.html#Module">Module:</a></th><td>mod_isapi</td></tr>
+</table>
+ <p>Cette directive permet de d�finir la taille maximale du tampon de
+ lecture anticip�e envoy� aux extensions ISAPI lorsqu'elles sont
+ initialement invoqu�es. Toute donn�e restante doit �tre extraite en
+ faisant appel � <code>ReadClient</code> ; certaines extensions ISAPI
+ peuvent ne pas supporter la fonction <code>ReadClient</code>.
+ Pour plus de d�tails, veuillez vous adresser � l'auteur de
+ l'extension ISAPI.</p>
+
+</div>
+</div>
+<div class="bottomlang">
+<p><span>Langues Disponibles: </span><a href="../en/mod/mod_isapi.html" hreflang="en" rel="alternate" title="English"> en </a> |
+<a href="../fr/mod/mod_isapi.html" title="Fran�ais"> fr </a> |
+<a href="../ko/mod/mod_isapi.html" hreflang="ko" rel="alternate" title="Korean"> ko </a></p>
+</div><div class="top"><a href="#page-header"><img src="../images/up.gif" alt="top" /></a></div><div class="section"><h2><a id="comments_section" name="comments_section">Commentaires</a></h2><div class="warning"><strong>Notice:</strong><br />This is not a Q&A section. Comments placed here should be pointed towards suggestions on improving the documentation or server, and may be removed again by our moderators if they are either implemented or considered invalid/off-topic. Questions on how to manage the Apache HTTP Server should be directed at either our IRC channel, #httpd, on Freenode, or sent to our <a href="http://httpd.apache.org/lists.html">mailing lists</a>.</div>
+<script type="text/javascript"><!--//--><![CDATA[//><!--
+var comments_shortname = 'httpd';
+var comments_identifier = 'http://httpd.apache.org/docs/trunk/mod/mod_isapi.html';
+(function(w, d) {
+ if (w.location.hostname.toLowerCase() == "httpd.apache.org") {
+ d.write('<div id="comments_thread"><\/div>');
+ var s = d.createElement('script');
+ s.type = 'text/javascript';
+ s.async = true;
+ s.src = 'https://comments.apache.org/show_comments.lua?site=' + comments_shortname + '&page=' + comments_identifier;
+ (d.getElementsByTagName('head')[0] || d.getElementsByTagName('body')[0]).appendChild(s);
+ }
+ else {
+ d.write('<div id="comments_thread">Comments are disabled for this page at the moment.<\/div>');
+ }
+})(window, document);
+//--><!]]></script></div><div id="footer">
+<p class="apache">Copyright 2017 The Apache Software Foundation.<br />Autoris� sous <a href="http://www.apache.org/licenses/LICENSE-2.0">Apache License, Version 2.0</a>.</p>
+<p class="menu"><a href="../mod/">Modules</a> | <a href="../mod/quickreference.html">Directives</a> | <a href="http://wiki.apache.org/httpd/FAQ">FAQ</a> | <a href="../glossary.html">Glossaire</a> | <a href="../sitemap.html">Plan du site</a></p></div><script type="text/javascript"><!--//--><![CDATA[//><!--
+if (typeof(prettyPrint) !== 'undefined') {
+ prettyPrint();
+}
+//--><!]]></script>
+</body></html>
\ No newline at end of file