diff options
| author | Vincent Deffontaines <gryzor@apache.org> | 2013-01-20 21:20:49 +0000 |
|---|---|---|
| committer | Vincent Deffontaines <gryzor@apache.org> | 2013-01-20 21:20:49 +0000 |
| commit | 0fb80799fcea5db018c655fe570cff041f59ca5c (patch) | |
| tree | 16be56ebaf36a7f705983e29b5d892253716c916 /docs/manual/mod | |
| parent | e5af30344fe669e9b69dfb2de212797ee6c0a9bb (diff) | |
| download | httpd-0fb80799fcea5db018c655fe570cff041f59ca5c.tar.gz | |
[Documentation] Adding a number of .fr translation files for 2.4 documentation
git-svn-id: https://svn.apache.org/repos/asf/httpd/httpd/branches/2.4.x@1435971 13f79535-47bb-0310-9956-ffa450edef68
Diffstat (limited to 'docs/manual/mod')
75 files changed, 8170 insertions, 4 deletions
diff --git a/docs/manual/mod/directive-dict.html b/docs/manual/mod/directive-dict.html index 07c060972a..0cf1a17bdc 100644 --- a/docs/manual/mod/directive-dict.html +++ b/docs/manual/mod/directive-dict.html @@ -4,6 +4,10 @@ URI: directive-dict.html.en Content-Language: en Content-type: text/html; charset=ISO-8859-1 +URI: directive-dict.html.fr +Content-Language: fr +Content-type: text/html; charset=ISO-8859-1 + URI: directive-dict.html.ja.utf8 Content-Language: ja Content-type: text/html; charset=UTF-8 diff --git a/docs/manual/mod/directive-dict.html.fr b/docs/manual/mod/directive-dict.html.fr new file mode 100644 index 0000000000..02eecf9001 --- /dev/null +++ b/docs/manual/mod/directive-dict.html.fr @@ -0,0 +1,315 @@ +<?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><!-- + XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX + This file is generated from xml source: DO NOT EDIT + XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX + --> +<title>Termes utilisés pour la description des directives - Serveur Apache HTTP</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.js" type="text/javascript"> +</script> + +<link href="../images/favicon.ico" rel="shortcut icon" /></head> +<body id="manual-page"><div id="page-header"> +<p class="menu"><a href="../mod/">Modules</a> | <a href="../mod/directives.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.4</p> +<img alt="" src="../images/feather.gif" /></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.4</a></div><div id="page-content"><div id="preamble"><h1>Termes utilisés pour la description des directives</h1> +<div class="toplang"> +<p><span>Langues Disponibles: </span><a href="../en/mod/directive-dict.html" hreflang="en" rel="alternate" title="English"> en </a> | +<a href="../fr/mod/directive-dict.html" title="Français"> fr </a> | +<a href="../ja/mod/directive-dict.html" hreflang="ja" rel="alternate" title="Japanese"> ja </a> | +<a href="../ko/mod/directive-dict.html" hreflang="ko" rel="alternate" title="Korean"> ko </a> | +<a href="../tr/mod/directive-dict.html" hreflang="tr" rel="alternate" title="Türkçe"> tr </a></p> +</div> + + <p>Ce document décrit les termes utilisés pour décrire chaque <a href="directives.html">directive de configuration</a> d'Apache.</p> +</div> +<div id="quickview"><ul id="toc"><li><img alt="" src="../images/down.gif" /> <a href="#Description">Description</a></li> +<li><img alt="" src="../images/down.gif" /> <a href="#Syntax">Syntaxe</a></li> +<li><img alt="" src="../images/down.gif" /> <a href="#Default">Défaut</a></li> +<li><img alt="" src="../images/down.gif" /> <a href="#Context">Contexte</a></li> +<li><img alt="" src="../images/down.gif" /> <a href="#Override">Surcharge/Écrasement</a></li> +<li><img alt="" src="../images/down.gif" /> <a href="#Status">Statut</a></li> +<li><img alt="" src="../images/down.gif" /> <a href="#Module">Module</a></li> +<li><img alt="" src="../images/down.gif" /> <a href="#Compatibility">Compatibilité</a></li> +</ul><h3>Voir aussi</h3><ul class="seealso"><li><a href="../configuring.html">Fichiers de configuration</a></li></ul><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="Description" id="Description">Description</a></h2> + +<p>Une brève description des fonctions de cette directive.</p> +</div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div> +<div class="section"> +<h2><a name="Syntax" id="Syntax">Syntaxe</a></h2> + + <p>Ce terme introduit le format sous lequel la directive doit + apparaître dans le fichier de configuration. Cette syntaxe est très + spécifique à la directive et est décrite en détail dans la + définition de cette dernière. En général, le nom de la directive est + suivi d'un ou plusieurs arguments séparés par des espaces. Si un + argument contient un espace, il doit être entouré de guillemets. Les + arguments optionnels sont entourés de crochets. Lorsqu'un argument + accepte une valeur parmi une liste de valeurs possibles, cette liste + est spécifiée en séparant les valeurs par une barre verticale "|". + Les textes littéraux sont présentés dans la fonte par défaut, alors + que les types d'argument pour lesquels une substitution est + nécessaire sont en <em>gras</em>. La syntaxe des directives + acceptant un nombre variable d'arguments se terminent par "...", ce + qui indique que le dernier argument peut être répété.</p> + + <p>Les directives utilisent un grand nombre de types d'arguments + différents. Les plus courants sont définis ci-dessous.</p> + + <dl> + <dt><em>URL</em></dt> + + <dd>Un Localisateur de Ressource Uniforme (Uniform Resource + Locator) complet comportant un protocole, un nom d'hôte et un nom + de chemin optionnel comme dans + <code>http://www.example.com/chemin/vers/fichier.html</code></dd> + + <dt><em>chemin-URL</em></dt> + + <dd>La partie de l'<em>url</em> qui suit le protocole et le nom + d'hôte comme dans <code>/chemin/vers/fichier.html</code>. Le + <em>chemin-URL</em> représente la ressource vue du web, et est + différente de la représentation de cette même ressource vue du + système de fichiers.</dd> + + <dt><em>chemin-fichier</em></dt> + + <dd>Le chemin d'un fichier dans le système de fichiers local + commençant par le répertoire racine comme dans + <code>/usr/local/apache/htdocs/chemin/vers/fichier.html</code>. + Sauf mention contraire, un <em>chemin-fichier</em> qui ne commence + pas par un slash sera considéré comme relatif au répertoire défini + par la directive <a href="core.html#serverroot">ServerRoot</a>.</dd> + + <dt><em>chemin-répertoire</em></dt> + + <dd>Le chemin d'un répertoire dans le système de fichiers local + commençant par le répertoire racine comme dans + <code>/usr/local/apache/htdocs/chemin/vers/</code>.</dd> + + <dt><em>nom-fichier</em></dt> + + <dd>Le nom d'un fichier sans son chemin comme dans + <code>fichier.html</code>.</dd> + + <dt><em>regex</em></dt> + + <dd>Une <a class="glossarylink" href="../glossary.html#regex" title="voir glossaire">expression rationnelle</a> + compatible Perl. La définition de la directive spécifiera à quoi + <em>regex</em> sera comparée.</dd> + + <dt><em>extension</em></dt> + + <dd>En général, c'est la partie du <em>nom de fichier</em> qui + suit le dernier point. Cependant, Apache reconnaît plusieurs + extensions de noms de fichiers ; ainsi, si un <em>nom de + fichier</em> + contient plusieurs points, chacune des parties du nom de fichier + séparées par des points et située après le premier point est une + <em>extension</em>. Par exemple, le <em>nom de fichier</em> + <code>fichier.html.en</code> comporte deux extensions : + <code>.html</code> et <code>.en</code>. Pour les directives + Apache, vous pouvez spécifier les <em>extension</em>s avec ou sans + le point initial. Enfin, les <em>extension</em>s ne sont pas + sensibles à la casse.</dd> + + <dt><em>MIME-type</em></dt> + + <dd>Une méthode de description du format d'un fichier consistant + en un type de format majeur et un type de format mineur séparés + par un slash comme dans <code>text/html</code>.</dd> + + <dt><em>env-variable</em></dt> + + <dd>Le nom d'une <a href="../env.html">variable + d'environnement</a> définie au cours du processus de configuration + d'Apache. Notez qu'elle peut être différente d'une variable + d'environnement du système d'exploitation. Voir la <a href="../env.html">documentation sur les variables d'environnement</a> + pour plus de détails.</dd> + </dl> +</div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div> +<div class="section"> +<h2><a name="Default" id="Default">Défaut</a></h2> + + <p>Si la directive possède une valeur par défaut (en d'autres + termes, si le serveur Web Apache se comporte comme si vous l'aviez + définie à une valeur particulière, alors que vous l'avez omise dans + votre configuration), elle est spécifiée ici. Si la directive ne + possède pas de valeur par défaut, cette section doit spécifier + "<em>Aucune</em>". Notez que la valeur par défaut dont il est + question n'est pas nécessairement la même que la valeur attribuée à + la directive dans le fichier httpd.conf par défaut distribué avec le + serveur.</p> +</div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div> +<div class="section"> +<h2><a name="Context" id="Context">Contexte</a></h2> + + <p>Indique les parties des fichiers de configuration du serveur + où cette directive est valide. Il s'agit d'une liste d'une ou + plusieurs des valeurs suivantes séparées par des virgules :</p> + + <dl> + <dt>configuration du serveur</dt> + + <dd>Signifie que la directive peut être utilisée dans les fichiers + de configuration du serveur (par exemple <code>httpd.conf</code>), + mais <strong>pas</strong> à l'intérieur d'un conteneur <code class="directive"><a href="../mod/core.html#virtualhost"><VirtualHost></a></code> ou <code class="directive"><a href="../mod/core.html#directory"><Directory></a></code>. De même, elle + n'est pas valide dans les fichiers <code>.htaccess</code>.</dd> + + <dt>serveur virtuel</dt> + + <dd>Signifie que la directive peut apparaître à l'intérieur d'un + conteneur <code class="directive"><a href="../mod/core.html#virtualhost"><VirtualHost></a></code> dans les fichiers de + configuration du serveur.</dd> + + <dt>répertoire</dt> + + <dd>Une directive spécifiée comme valide dans ce contexte peut + être utilisée à l'intérieur de conteneurs <code class="directive"><a href="../mod/core.html#directory"><Directory></a></code>, <code class="directive"><a href="../mod/core.html#location"><Location></a></code>, <code class="directive"><a href="../mod/core.html#files"><Files></a></code>, et <code class="directive"><a href="../mod/mod_proxy.html#proxy"><Proxy></a></code> dans les + fichiers de configuration du serveur, en tenant compte des + restrictions précisées dans la documentation sur les <a href="../sections.html">Sections de configuration</a>.</dd> + + <dt>.htaccess</dt> + + <dd>Si une directive est valide dans ce contexte, cela signifie + qu'elle peut apparaître à l'intérieur de fichiers de configuration + de <em>niveau</em> répertoire <code>.htaccess</code>. Elle sera ou + ne sera pas traitée, selon la définition de l'option <a href="#Override">overrides</a> pour le contexte courant.</dd> + </dl> + + <p>La directive n'est autorisée <em>que</em> dans le contexte + désigné ; si vous essayez de l'utiliser ailleurs, vous générerez une + erreur de configuration qui va soit empêcher le serveur de traiter + les requêtes correctement dans ce contexte, soit tout simplement + empêcher le serveur de fonctionner -- en d'autres termes, le serveur + refusera de démarrer.</p> + + <p>Les lieux de définition valides pour une directive résultent en + fait d'un + OU logique de tous les contextes spécifiés. En d'autres termes, une + directive spécifiée comme valide dans "<code>configuration du + serveur, .htaccess</code>" peut être utilisée dans le fichier + <code>httpd.conf</code> et dans les fichiers <code>.htaccess</code>, + mais pas dans un conteneur <code class="directive"><a href="../mod/core.html#directory"><Directory></a></code> ou <code class="directive"><a href="../mod/core.html#virtualhost"><VirtualHost></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="Override" id="Override">Surcharge/Écrasement</a></h2> + + <p>Ce terme indique quelle autorisation de surcharge ("override") doit être + active pour que la directive puisse être traitée lorsqu'elle + apparaît dans un fichier <code>.htaccess</code>. Si le <a href="#Context">context</a> de la directive ne lui permet pas + d'apparaître dans un fichier <code>.htaccess</code>, aucun contexte + ne sera spécifié.</p> + + <p>Les autorisations de surcharge sont activées via la directive + <code class="directive"><a href="../mod/core.html#allowoverride">AllowOverride</a></code>, et possèdent une + portée particulière, comme un répertoire et tous ses + sous-répertoires, sauf si une autre directive <code class="directive"><a href="../mod/core.html#allowoverride">AllowOverride</a></code> apparaît à un niveau + inférieur. La documentation pour cette directive spécifie aussi les + noms d'autorisations de surcharge disponibles.</p> +</div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div> +<div class="section"> +<h2><a name="Status" id="Status">Statut</a></h2> + + <p>Cet attribut indique le degré de rapprochement de la directive du + coeur d'Apache ; en d'autres termes, vous pouvez être amené à + recompiler le serveur avec un jeu de modules supplémentaires pour + pouvoir utiliser la directive, et ainsi accéder à ses + fonctionnalités. Les valeurs possible pour cet attribut sont :</p> + + <dl> + <dt>Core</dt> + + <dd>Lorsqu'une directive a pour statut "Core", cela signifie + qu'elle fait partie du coeur du serveur web Apache, et est de ce + fait toujours disponible.</dd> + + <dt>MPM</dt> + + <dd>Une directive dont le statut est "MPM est fournie par un <a href="../mpm.html">module Multi-Processus</a>. Ce type de + directive sera disponible si et seulement si vous utilisez un des + MPMs spécifiés dans la ligne <a href="#Module">Module</a> de la + définition de la directive.</dd> + + <dt>Base</dt> + + <dd>Une directive dont le statut est "Base" est fournie par un des + modules Apache standards qui sont compilés dans le serveur par + défaut, et sont de ce fait toujours disponibles, sauf si vous avez + fait en sorte de les supprimer de votre configuration.</dd> + + <dt>Extension</dt> + + <dd>Une directive dont le statut est "Extension" est fournie par + un des modules inclus dans le kit du serveur Apache, mais qui ne + sont pas compilés dans le serveur par défaut. Pour activer la + directive et accéder à ses fonctionnalités, vous devez modifier + les fichiers de configuration de la compilation du serveur, et + recompiler Apache.</dd> + + <dt>Expérimental</dt> + + <dd>Le statut "Expérimental" indique que la directive fait partie + du kit Apache, mais que vous l'utilisez à vos risques et périls. + La directive est documentée à titre d'exhaustivité, et n'est pas + obligatoirement supportée. Le module qui fournit la directive peut + être compilé par défaut dans le serveur ou non ; consultez le haut + de la page qui décrit la directive et son module pour vérifier sa + disponibilité.</dd> + </dl> +</div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div> +<div class="section"> +<h2><a name="Module" id="Module">Module</a></h2> + + <p>Il s'agit d'une simple liste des noms des modules sources qui + fournissent la directive.</p> +</div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div> +<div class="section"> +<h2><a name="Compatibility" id="Compatibility">Compatibilité</a></h2> + + <p>Si la directive ne faisait pas partie de la distribution + originale d'Apache version 2, la version dans laquelle elle a été + introduite est indiquée ici. Cette section indique aussi si la + directive n'est disponible que sur certaines plates-formes.</p> +</div></div> +<div class="bottomlang"> +<p><span>Langues Disponibles: </span><a href="../en/mod/directive-dict.html" hreflang="en" rel="alternate" title="English"> en </a> | +<a href="../fr/mod/directive-dict.html" title="Français"> fr </a> | +<a href="../ja/mod/directive-dict.html" hreflang="ja" rel="alternate" title="Japanese"> ja </a> | +<a href="../ko/mod/directive-dict.html" hreflang="ko" rel="alternate" title="Korean"> ko </a> | +<a href="../tr/mod/directive-dict.html" hreflang="tr" rel="alternate" title="Türkçe"> tr </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/2.4/mod/directive-dict.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 2013 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/directives.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 diff --git a/docs/manual/mod/directive-dict.xml.fr b/docs/manual/mod/directive-dict.xml.fr new file mode 100644 index 0000000000..ed9937fc30 --- /dev/null +++ b/docs/manual/mod/directive-dict.xml.fr @@ -0,0 +1,294 @@ +<?xml version="1.0" encoding="ISO-8859-1" ?> +<!DOCTYPE manualpage SYSTEM "../style/manualpage.dtd"> +<?xml-stylesheet type="text/xsl" href="../style/manual.fr.xsl"?> +<!-- English Revision : 420990 --> +<!-- 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. +--> + +<manualpage metafile="directive-dict.xml.meta"> + + <title>Termes utilisés pour la description des directives</title> + +<summary> + <p>Ce document décrit les termes utilisés pour décrire chaque <a + href="directives.html">directive de configuration</a> d'Apache.</p> +</summary> +<seealso><a href="../configuring.html">Fichiers de configuration</a></seealso> + +<section id="Description"><title>Description</title> + +<p>Une brève description des fonctions de cette directive.</p> +</section> + +<section id="Syntax"><title>Syntaxe</title> + + <p>Ce terme introduit le format sous lequel la directive doit + apparaître dans le fichier de configuration. Cette syntaxe est très + spécifique à la directive et est décrite en détail dans la + définition de cette dernière. En général, le nom de la directive est + suivi d'un ou plusieurs arguments séparés par des espaces. Si un + argument contient un espace, il doit être entouré de guillemets. Les + arguments optionnels sont entourés de crochets. Lorsqu'un argument + accepte une valeur parmi une liste de valeurs possibles, cette liste + est spécifiée en séparant les valeurs par une barre verticale "|". + Les textes littéraux sont présentés dans la fonte par défaut, alors + que les types d'argument pour lesquels une substitution est + nécessaire sont en <em>gras</em>. La syntaxe des directives + acceptant un nombre variable d'arguments se terminent par "...", ce + qui indique que le dernier argument peut être répété.</p> + + <p>Les directives utilisent un grand nombre de types d'arguments + différents. Les plus courants sont définis ci-dessous.</p> + + <dl> + <dt><em>URL</em></dt> + + <dd>Un Localisateur de Ressource Uniforme (Uniform Resource + Locator) complet comportant un protocole, un nom d'hôte et un nom + de chemin optionnel comme dans + <code>http://www.example.com/chemin/vers/fichier.html</code></dd> + + <dt><em>chemin-URL</em></dt> + + <dd>La partie de l'<em>url</em> qui suit le protocole et le nom + d'hôte comme dans <code>/chemin/vers/fichier.html</code>. Le + <em>chemin-URL</em> représente la ressource vue du web, et est + différente de la représentation de cette même ressource vue du + système de fichiers.</dd> + + <dt><em>chemin-fichier</em></dt> + + <dd>Le chemin d'un fichier dans le système de fichiers local + commençant par le répertoire racine comme dans + <code>/usr/local/apache/htdocs/chemin/vers/fichier.html</code>. + Sauf mention contraire, un <em>chemin-fichier</em> qui ne commence + pas par un slash sera considéré comme relatif au répertoire défini + par la directive <a + href="core.html#serverroot">ServerRoot</a>.</dd> + + <dt><em>chemin-répertoire</em></dt> + + <dd>Le chemin d'un répertoire dans le système de fichiers local + commençant par le répertoire racine comme dans + <code>/usr/local/apache/htdocs/chemin/vers/</code>.</dd> + + <dt><em>nom-fichier</em></dt> + + <dd>Le nom d'un fichier sans son chemin comme dans + <code>fichier.html</code>.</dd> + + <dt><em>regex</em></dt> + + <dd>Une <glossary ref="regex">expression rationnelle</glossary> + compatible Perl. La définition de la directive spécifiera à quoi + <em>regex</em> sera comparée.</dd> + + <dt><em>extension</em></dt> + + <dd>En général, c'est la partie du <em>nom de fichier</em> qui + suit le dernier point. Cependant, Apache reconnaît plusieurs + extensions de noms de fichiers ; ainsi, si un <em>nom de + fichier</em> + contient plusieurs points, chacune des parties du nom de fichier + séparées par des points et située après le premier point est une + <em>extension</em>. Par exemple, le <em>nom de fichier</em> + <code>fichier.html.en</code> comporte deux extensions : + <code>.html</code> et <code>.en</code>. Pour les directives + Apache, vous pouvez spécifier les <em>extension</em>s avec ou sans + le point initial. Enfin, les <em>extension</em>s ne sont pas + sensibles à la casse.</dd> + + <dt><em>MIME-type</em></dt> + + <dd>Une méthode de description du format d'un fichier consistant + en un type de format majeur et un type de format mineur séparés + par un slash comme dans <code>text/html</code>.</dd> + + <dt><em>env-variable</em></dt> + + <dd>Le nom d'une <a href="../env.html">variable + d'environnement</a> définie au cours du processus de configuration + d'Apache. Notez qu'elle peut être différente d'une variable + d'environnement du système d'exploitation. Voir la <a + href="../env.html">documentation sur les variables d'environnement</a> + pour plus de détails.</dd> + </dl> +</section> + +<section id="Default"><title>Défaut</title> + + <p>Si la directive possède une valeur par défaut (en d'autres + termes, si le serveur Web Apache se comporte comme si vous l'aviez + définie à une valeur particulière, alors que vous l'avez omise dans + votre configuration), elle est spécifiée ici. Si la directive ne + possède pas de valeur par défaut, cette section doit spécifier + "<em>Aucune</em>". Notez que la valeur par défaut dont il est + question n'est pas nécessairement la même que la valeur attribuée à + la directive dans le fichier httpd.conf par défaut distribué avec le + serveur.</p> +</section> + +<section id="Context"><title>Contexte</title> + + <p>Indique les parties des fichiers de configuration du serveur + où cette directive est valide. Il s'agit d'une liste d'une ou + plusieurs des valeurs suivantes séparées par des virgules :</p> + + <dl> + <dt>configuration du serveur</dt> + + <dd>Signifie que la directive peut être utilisée dans les fichiers + de configuration du serveur (par exemple <code>httpd.conf</code>), + mais <strong>pas</strong> à l'intérieur d'un conteneur <directive + module="core" type="section">VirtualHost</directive> ou <directive + module="core" type="section">Directory</directive>. De même, elle + n'est pas valide dans les fichiers <code>.htaccess</code>.</dd> + + <dt>serveur virtuel</dt> + + <dd>Signifie que la directive peut apparaître à l'intérieur d'un + conteneur <directive module="core" + type="section">VirtualHost</directive> dans les fichiers de + configuration du serveur.</dd> + + <dt>répertoire</dt> + + <dd>Une directive spécifiée comme valide dans ce contexte peut + être utilisée à l'intérieur de conteneurs <directive module="core" + type="section">Directory</directive>, <directive type="section" + module="core">Location</directive>, <directive module="core" + type="section">Files</directive>, et <directive + module="mod_proxy" type="section">Proxy</directive> dans les + fichiers de configuration du serveur, en tenant compte des + restrictions précisées dans la documentation sur les <a + href="../sections.html">Sections de configuration</a>.</dd> + + <dt>.htaccess</dt> + + <dd>Si une directive est valide dans ce contexte, cela signifie + qu'elle peut apparaître à l'intérieur de fichiers de configuration + de <em>niveau</em> répertoire <code>.htaccess</code>. Elle sera ou + ne sera pas traitée, selon la définition de l'option <a + href="#Override">overrides</a> pour le contexte courant.</dd> + </dl> + + <p>La directive n'est autorisée <em>que</em> dans le contexte + désigné ; si vous essayez de l'utiliser ailleurs, vous générerez une + erreur de configuration qui va soit empêcher le serveur de traiter + les requêtes correctement dans ce contexte, soit tout simplement + empêcher le serveur de fonctionner -- en d'autres termes, le serveur + refusera de démarrer.</p> + + <p>Les lieux de définition valides pour une directive résultent en + fait d'un + OU logique de tous les contextes spécifiés. En d'autres termes, une + directive spécifiée comme valide dans "<code>configuration du + serveur, .htaccess</code>" peut être utilisée dans le fichier + <code>httpd.conf</code> et dans les fichiers <code>.htaccess</code>, + mais pas dans un conteneur <directive module="core" + type="section">Directory</directive> ou <directive module="core" + type="section">VirtualHost</directive>.</p> +</section> + +<section id="Override"><title>Surcharge/Écrasement</title> + + <p>Ce terme indique quelle autorisation de surcharge ("override") doit être + active pour que la directive puisse être traitée lorsqu'elle + apparaît dans un fichier <code>.htaccess</code>. Si le <a + href="#Context" >context</a> de la directive ne lui permet pas + d'apparaître dans un fichier <code>.htaccess</code>, aucun contexte + ne sera spécifié.</p> + + <p>Les autorisations de surcharge sont activées via la directive + <directive module="core">AllowOverride</directive>, et possèdent une + portée particulière, comme un répertoire et tous ses + sous-répertoires, sauf si une autre directive <directive + module="core">AllowOverride</directive> apparaît à un niveau + inférieur. La documentation pour cette directive spécifie aussi les + noms d'autorisations de surcharge disponibles.</p> +</section> + +<section id="Status"><title>Statut</title> + + <p>Cet attribut indique le degré de rapprochement de la directive du + coeur d'Apache ; en d'autres termes, vous pouvez être amené à + recompiler le serveur avec un jeu de modules supplémentaires pour + pouvoir utiliser la directive, et ainsi accéder à ses + fonctionnalités. Les valeurs possible pour cet attribut sont :</p> + + <dl> + <dt>Core</dt> + + <dd>Lorsqu'une directive a pour statut "Core", cela signifie + qu'elle fait partie du coeur du serveur web Apache, et est de ce + fait toujours disponible.</dd> + + <dt>MPM</dt> + + <dd>Une directive dont le statut est "MPM est fournie par un <a + href="../mpm.html">module Multi-Processus</a>. Ce type de + directive sera disponible si et seulement si vous utilisez un des + MPMs spécifiés dans la ligne <a href="#Module">Module</a> de la + définition de la directive.</dd> + + <dt>Base</dt> + + <dd>Une directive dont le statut est "Base" est fournie par un des + modules Apache standards qui sont compilés dans le serveur par + défaut, et sont de ce fait toujours disponibles, sauf si vous avez + fait en sorte de les supprimer de votre configuration.</dd> + + <dt>Extension</dt> + + <dd>Une directive dont le statut est "Extension" est fournie par + un des modules inclus dans le kit du serveur Apache, mais qui ne + sont pas compilés dans le serveur par défaut. Pour activer la + directive et accéder à ses fonctionnalités, vous devez modifier + les fichiers de configuration de la compilation du serveur, et + recompiler Apache.</dd> + + <dt>Expérimental</dt> + + <dd>Le statut "Expérimental" indique que la directive fait partie + du kit Apache, mais que vous l'utilisez à vos risques et périls. + La directive est documentée à titre d'exhaustivité, et n'est pas + obligatoirement supportée. Le module qui fournit la directive peut + être compilé par défaut dans le serveur ou non ; consultez le haut + de la page qui décrit la directive et son module pour vérifier sa + disponibilité.</dd> + </dl> +</section> + +<section id="Module"><title>Module</title> + + <p>Il s'agit d'une simple liste des noms des modules sources qui + fournissent la directive.</p> +</section> + +<section id="Compatibility"><title>Compatibilité</title> + + <p>Si la directive ne faisait pas partie de la distribution + originale d'Apache version 2, la version dans laquelle elle a été + introduite est indiquée ici. Cette section indique aussi si la + directive n'est disponible que sur certaines plates-formes.</p> +</section> + +</manualpage> + diff --git a/docs/manual/mod/directive-dict.xml.meta b/docs/manual/mod/directive-dict.xml.meta index 4f0cb069e8..49ffa15e7f 100644 --- a/docs/manual/mod/directive-dict.xml.meta +++ b/docs/manual/mod/directive-dict.xml.meta @@ -8,6 +8,7 @@ <variants> <variant>en</variant> + <variant>fr</variant> <variant>ja</variant> <variant outdated="yes">ko</variant> <variant>tr</variant> diff --git a/docs/manual/mod/directives.html b/docs/manual/mod/directives.html index 49d6df3315..b87bb7555b 100644 --- a/docs/manual/mod/directives.html +++ b/docs/manual/mod/directives.html @@ -12,6 +12,10 @@ URI: directives.html.es Content-Language: es Content-type: text/html; charset=ISO-8859-1 +URI: directives.html.fr +Content-Language: fr +Content-type: text/html; charset=ISO-8859-1 + URI: directives.html.ja.utf8 Content-Language: ja Content-type: text/html; charset=UTF-8 diff --git a/docs/manual/mod/directives.html.fr b/docs/manual/mod/directives.html.fr new file mode 100644 index 0000000000..765937b30e --- /dev/null +++ b/docs/manual/mod/directives.html.fr @@ -0,0 +1,654 @@ +<?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><!-- + XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX + This file is generated from xml source: DO NOT EDIT + XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX + --> +<title>Index des directives - Serveur Apache HTTP</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.js" type="text/javascript"> +</script> + +<link href="../images/favicon.ico" rel="shortcut icon" /></head> +<body id="directive-index"><div id="page-header"> +<p class="menu"><a href="../mod/">Modules</a> | <a href="../mod/directives.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.4</p> +<img alt="" src="../images/feather.gif" /></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.4</a> > <a href="./">Modules</a></div><div id="preamble"><h1>Index des directives</h1> +<div class="toplang"> +<p><span>Langues Disponibles: </span><a href="../de/mod/directives.html" hreflang="de" rel="alternate" title="Deutsch"> de </a> | +<a href="../en/mod/directives.html" hreflang="en" rel="alternate" title="English"> en </a> | +<a href="../es/mod/directives.html" hreflang="es" rel="alternate" title="Español"> es </a> | +<a href="../fr/mod/directives.html" title="Français"> fr </a> | +<a href="../ja/mod/directives.html" hreflang="ja" rel="alternate" title="Japanese"> ja </a> | +<a href="../ko/mod/directives.html" hreflang="ko" rel="alternate" title="Korean"> ko </a> | +<a href="../tr/mod/directives.html" hreflang="tr" rel="alternate" title="Türkçe"> tr </a> | +<a href="../zh-cn/mod/directives.html" hreflang="zh-cn" rel="alternate" title="Simplified Chinese"> zh-cn </a></p> +</div> + + <p> + Toutes les directives Apache disponibles dans la distribution standard + d'Apache sont référencées ici. Elles sont décrites en utilisant un + format normalisé, et <a href="directive-dict.html" rel="Glossary">un dictionnaire</a> des termes utilisés dans leurs + descriptions est disponible. + </p> + + <p> + Un <a href="quickreference.html">Document de référence rapide des directives</a> + est également disponible. Il donne des détails à propos de chaque directive + sous une forme abrégée. + </p> + +<p class="letters"><a href="#A"> A </a> | <a href="#B"> B </a> | <a href="#C"> C </a> | <a href="#D"> D </a> | <a href="#E"> E </a> | <a href="#F"> F </a> | <a href="#G"> G </a> | <a href="#H"> H </a> | <a href="#I"> I </a> | <a href="#K"> K </a> | <a href="#L"> L </a> | <a href="#M"> M </a> | <a href="#N"> N </a> | <a href="#O"> O </a> | <a href="#P"> P </a> | <a href="#R"> R </a> | <a href="#S"> S </a> | <a href="#T"> T </a> | <a href="#U"> U </a> | <a href="#V"> V </a> | <a href="#W"> W </a> | <a href="#X"> X </a></p> +</div> +<div id="directive-list"><ul> +<li><a href="core.html#acceptfilter" id="A" name="A">AcceptFilter</a></li> +<li><a href="core.html#acceptpathinfo">AcceptPathInfo</a></li> +<li><a href="core.html#accessfilename">AccessFileName</a></li> +<li><a href="mod_actions.html#action">Action</a></li> +<li><a href="mod_autoindex.html#addalt">AddAlt</a></li> +<li><a href="mod_autoindex.html#addaltbyencoding">AddAltByEncoding</a></li> +<li><a href="mod_autoindex.html#addaltbytype">AddAltByType</a></li> +<li><a href="mod_mime.html#addcharset">AddCharset</a></li> +<li><a href="core.html#adddefaultcharset">AddDefaultCharset</a></li> +<li><a href="mod_autoindex.html#adddescription">AddDescription</a></li> +<li><a href="mod_mime.html#addencoding">AddEncoding</a></li> +<li><a href="mod_mime.html#addhandler">AddHandler</a></li> +<li><a href="mod_autoindex.html#addicon">AddIcon</a></li> +<li><a href="mod_autoindex.html#addiconbyencoding">AddIconByEncoding</a></li> +<li><a href="mod_autoindex.html#addiconbytype">AddIconByType</a></li> +<li><a href="mod_mime.html#addinputfilter">AddInputFilter</a></li> +<li><a href="mod_mime.html#addlanguage">AddLanguage</a></li> +<li><a href="mod_info.html#addmoduleinfo">AddModuleInfo</a></li> +<li><a href="mod_mime.html#addoutputfilter">AddOutputFilter</a></li> +<li><a href="mod_filter.html#addoutputfilterbytype">AddOutputFilterByType</a></li> +<li><a href="mod_mime.html#addtype">AddType</a></li> +<li><a href="mod_alias.html#alias">Alias</a></li> +<li><a href="mod_alias.html#aliasmatch">AliasMatch</a></li> +<li><a href="mod_access_compat.html#allow">Allow</a></li> +<li><a href="mod_proxy_connect.html#allowconnect">AllowCONNECT</a></li> +<li><a href="core.html#allowencodedslashes">AllowEncodedSlashes</a></li> +<li><a href="mod_allowmethods.html#allowmethods">AllowMethods</a></li> +<li><a href="core.html#allowoverride">AllowOverride</a></li> +<li><a href="core.html#allowoverridelist">AllowOverrideList</a></li> +<li><a href="mod_authn_anon.html#anonymous">Anonymous</a></li> +<li><a href="mod_authn_anon.html#anonymous_logemail">Anonymous_LogEmail</a></li> +<li><a href="mod_authn_anon.html#anonymous_mustgiveemail">Anonymous_MustGiveEmail</a></li> +<li><a href="mod_authn_anon.html#anonymous_nouserid">Anonymous_NoUserID</a></li> +<li><a href="mod_authn_anon.html#anonymous_verifyemail">Anonymous_VerifyEmail</a></li> +<li><a href="event.html#asyncrequestworkerfactor">AsyncRequestWorkerFactor</a></li> +<li><a href="mod_auth_basic.html#authbasicauthoritative">AuthBasicAuthoritative</a></li> +<li><a href="mod_auth_basic.html#authbasicprovider">AuthBasicProvider</a></li> +<li><a href="mod_authn_dbd.html#authdbduserpwquery">AuthDBDUserPWQuery</a></li> +<li><a href="mod_authn_dbd.html#authdbduserrealmquery">AuthDBDUserRealmQuery</a></li> +<li><a href="mod_authz_dbm.html#authdbmgroupfile">AuthDBMGroupFile</a></li> +<li><a href="mod_authn_dbm.html#authdbmtype">AuthDBMType</a></li> +<li><a href="mod_authn_dbm.html#authdbmuserfile">AuthDBMUserFile</a></li> +<li><a href="mod_auth_digest.html#authdigestalgorithm">AuthDigestAlgorithm</a></li> +<li><a href="mod_auth_digest.html#authdigestdomain">AuthDigestDomain</a></li> +<li><a href="mod_auth_digest.html#authdigestnoncelifetime">AuthDigestNonceLifetime</a></li> +<li><a href="mod_auth_digest.html#authdigestprovider">AuthDigestProvider</a></li> +<li><a href="mod_auth_digest.html#authdigestqop">AuthDigestQop</a></li> +<li><a href="mod_auth_digest.html#authdigestshmemsize">AuthDigestShmemSize</a></li> +<li><a href="mod_auth_form.html#authformauthoritative">AuthFormAuthoritative</a></li> +<li><a href="mod_auth_form.html#authformbody">AuthFormBody</a></li> +<li><a href="mod_auth_form.html#authformdisablenostore">AuthFormDisableNoStore</a></li> +<li><a href="mod_auth_form.html#authformfakebasicauth">AuthFormFakeBasicAuth</a></li> +<li><a href="mod_auth_form.html#authformlocation">AuthFormLocation</a></li> +<li><a href="mod_auth_form.html#authformloginrequiredlocation">AuthFormLoginRequiredLocation</a></li> +<li><a href="mod_auth_form.html#authformloginsuccesslocation">AuthFormLoginSuccessLocation</a></li> +<li><a href="mod_auth_form.html#authformlogoutlocation">AuthFormLogoutLocation</a></li> +<li><a href="mod_auth_form.html#authformmethod">AuthFormMethod</a></li> +<li><a href="mod_auth_form.html#authformmimetype">AuthFormMimetype</a></li> +<li><a href="mod_auth_form.html#authformpassword">AuthFormPassword</a></li> +<li><a href="mod_auth_form.html#authformprovider">AuthFormProvider</a></li> +<li><a href="mod_auth_form.html#authformsitepassphrase">AuthFormSitePassphrase</a></li> +<li><a href="mod_auth_form.html#authformsize">AuthFormSize</a></li> +<li><a href="mod_auth_form.html#authformusername">AuthFormUsername</a></li> +<li><a href="mod_authz_groupfile.html#authgroupfile">AuthGroupFile</a></li> +<li><a href="mod_authnz_ldap.html#authldapauthorizeprefix">AuthLDAPAuthorizePrefix</a></li> +<li><a href="mod_authnz_ldap.html#authldapbindauthoritative">AuthLDAPBindAuthoritative</a></li> +<li><a href="mod_authnz_ldap.html#authldapbinddn">AuthLDAPBindDN</a></li> +<li><a href="mod_authnz_ldap.html#authldapbindpassword">AuthLDAPBindPassword</a></li> +<li><a href="mod_authnz_ldap.html#authldapcharsetconfig">AuthLDAPCharsetConfig</a></li> +<li><a href="mod_authnz_ldap.html#authldapcompareasuser">AuthLDAPCompareAsUser</a></li> +<li><a href="mod_authnz_ldap.html#authldapcomparednonserver">AuthLDAPCompareDNOnServer</a></li> +<li><a href="mod_authnz_ldap.html#authldapdereferencealiases">AuthLDAPDereferenceAliases</a></li> +<li><a href="mod_authnz_ldap.html#authldapgroupattribute">AuthLDAPGroupAttribute</a></li> +<li><a href="mod_authnz_ldap.html#authldapgroupattributeisdn">AuthLDAPGroupAttributeIsDN</a></li> +<li><a href="mod_authnz_ldap.html#authldapinitialbindasuser">AuthLDAPInitialBindAsUser</a></li> +<li><a href="mod_authnz_ldap.html#authldapinitialbindpattern">AuthLDAPInitialBindPattern</a></li> +<li><a href="mod_authnz_ldap.html#authldapmaxsubgroupdepth">AuthLDAPMaxSubGroupDepth</a></li> +<li><a href="mod_authnz_ldap.html#authldapremoteuserattribute">AuthLDAPRemoteUserAttribute</a></li> +<li><a href="mod_authnz_ldap.html#authldapremoteuserisdn">AuthLDAPRemoteUserIsDN</a></li> +<li><a href="mod_authnz_ldap.html#authldapsearchasuser">AuthLDAPSearchAsUser</a></li> +<li><a href="mod_authnz_ldap.html#authldapsubgroupattribute">AuthLDAPSubGroupAttribute</a></li> +<li><a href="mod_authnz_ldap.html#authldapsubgroupclass">AuthLDAPSubGroupClass</a></li> +<li><a href="mod_authnz_ldap.html#authldapurl">AuthLDAPUrl</a></li> +<li><a href="mod_authz_core.html#authmerging">AuthMerging</a></li> +<li><a href="mod_authn_core.html#authname">AuthName</a></li> +<li><a href="mod_authn_socache.html#authncachecontext">AuthnCacheContext</a></li> +<li><a href="mod_authn_socache.html#authncacheenable">AuthnCacheEnable</a></li> +<li><a href="mod_authn_socache.html#authncacheprovidefor">AuthnCacheProvideFor</a></li> +<li><a href="mod_authn_socache.html#authncachesocache">AuthnCacheSOCache</a></li> +<li><a href="mod_authn_socache.html#authncachetimeout">AuthnCacheTimeout</a></li> +<li><a href="mod_authn_core.html#authnprovideralias"><AuthnProviderAlias></a></li> +<li><a href="mod_authn_core.html#authtype">AuthType</a></li> +<li><a href="mod_authn_file.html#authuserfile">AuthUserFile</a></li> +<li><a href="mod_authz_dbd.html#authzdbdlogintoreferer">AuthzDBDLoginToReferer</a></li> +<li><a href="mod_authz_dbd.html#authzdbdquery">AuthzDBDQuery</a></li> +<li><a href="mod_authz_dbd.html#authzdbdredirectquery">AuthzDBDRedirectQuery</a></li> +<li><a href="mod_authz_dbm.html#authzdbmtype">AuthzDBMType</a></li> +<li><a href="mod_authz_core.html#authzprovideralias"><AuthzProviderAlias></a></li> +<li><a href="mod_authz_core.html#authzsendforbiddenonfailure">AuthzSendForbiddenOnFailure</a></li> +<li><a href="mod_proxy.html#balancergrowth" id="B" name="B">BalancerGrowth</a></li> +<li><a href="mod_proxy.html#balancermember">BalancerMember</a></li> +<li><a href="mod_setenvif.html#browsermatch">BrowserMatch</a></li> +<li><a href="mod_setenvif.html#browsermatchnocase">BrowserMatchNoCase</a></li> +<li><a href="mod_log_config.html#bufferedlogs">BufferedLogs</a></li> +<li><a href="mod_buffer.html#buffersize">BufferSize</a></li> +<li><a href="mod_cache.html#cachedefaultexpire" id="C" name="C">CacheDefaultExpire</a></li> +<li><a href="mod_cache.html#cachedetailheader">CacheDetailHeader</a></li> +<li><a href="mod_cache_disk.html#cachedirlength">CacheDirLength</a></li> +<li><a href="mod_cache_disk.html#cachedirlevels">CacheDirLevels</a></li> +<li><a href="mod_cache.html#cachedisable">CacheDisable</a></li> +<li><a href="mod_cache.html#cacheenable">CacheEnable</a></li> +<li><a href="mod_file_cache.html#cachefile">CacheFile</a></li> +<li><a href="mod_cache.html#cacheheader">CacheHeader</a></li> +<li><a href="mod_cache.html#cacheignorecachecontrol">CacheIgnoreCacheControl</a></li> +<li><a href="mod_cache.html#cacheignoreheaders">CacheIgnoreHeaders</a></li> +<li><a href="mod_cache.html#cacheignorenolastmod">CacheIgnoreNoLastMod</a></li> +<li><a href="mod_cache.html#cacheignorequerystring">CacheIgnoreQueryString</a></li> +<li><a href="mod_cache.html#cacheignoreurlsessionidentifiers">CacheIgnoreURLSessionIdentifiers</a></li> +<li><a href="mod_cache.html#cachekeybaseurl">CacheKeyBaseURL</a></li> +<li><a href="mod_cache.html#cachelastmodifiedfactor">CacheLastModifiedFactor</a></li> +<li><a href="mod_cache.html#cachelock">CacheLock</a></li> +<li><a href="mod_cache.html#cachelockmaxage">CacheLockMaxAge</a></li> +<li><a href="mod_cache.html#cachelockpath">CacheLockPath</a></li> +<li><a href="mod_cache.html#cachemaxexpire">CacheMaxExpire</a></li> +<li><a href="mod_cache_disk.html#cachemaxfilesize">CacheMaxFileSize</a></li> +<li><a href="mod_cache.html#cacheminexpire">CacheMinExpire</a></li> +<li><a href="mod_cache_disk.html#cacheminfilesize">CacheMinFileSize</a></li> +<li><a href="mod_negotiation.html#cachenegotiateddocs">CacheNegotiatedDocs</a></li> +<li><a href="mod_cache.html#cachequickhandler">CacheQuickHandler</a></li> +<li><a href="mod_cache_disk.html#cachereadsize">CacheReadSize</a></li> +<li><a href="mod_cache_disk.html#cachereadtime">CacheReadTime</a></li> +<li><a href="mod_cache_disk.html#cacheroot">CacheRoot</a></li> +<li><a href="mod_cache.html#cachestaleonerror">CacheStaleOnError</a></li> +<li><a href="mod_cache.html#cachestoreexpired">CacheStoreExpired</a></li> +<li><a href="mod_cache.html#cachestorenostore">CacheStoreNoStore</a></li> +<li><a href="mod_cache.html#cachestoreprivate">CacheStorePrivate</a></li> +<li><a href="core.html#cgimapextension">CGIMapExtension</a></li> +<li><a href="mod_charset_lite.html#charsetdefault">CharsetDefault</a></li> +<li><a href="mod_charset_lite.html#charsetoptions">CharsetOptions</a></li> +<li><a href="mod_charset_lite.html#charsetsourceenc">CharsetSourceEnc</a></li> +<li><a href="mod_speling.html#checkcaseonly">CheckCaseOnly</a></li> +<li><a href="mod_speling.html#checkspelling">CheckSpelling</a></li> +<li><a href="mod_unixd.html#chrootdir">ChrootDir</a></li> +<li><a href="core.html#contentdigest">ContentDigest</a></li> +<li><a href="mod_usertrack.html#cookiedomain">CookieDomain</a></li> +<li><a href="mod_usertrack.html#cookieexpires">CookieExpires</a></li> +<li><a href="mod_usertrack.html#cookiename">CookieName</a></li> +<li><a href="mod_usertrack.html#cookiestyle">CookieStyle</a></li> +<li><a href="mod_usertrack.html#cookietracking">CookieTracking</a></li> +<li><a href="mpm_common.html#coredumpdirectory">CoreDumpDirectory</a></li> +<li><a href="mod_log_config.html#customlog">CustomLog</a></li> +<li><a href="mod_dav.html#dav" id="D" name="D">Dav</a></li> +<li><a href="mod_dav.html#davdepthinfinity">DavDepthInfinity</a></li> +<li><a href="mod_dav_lock.html#davgenericlockdb">DavGenericLockDB</a></li> +<li><a href="mod_dav_fs.html#davlockdb">DavLockDB</a></li> +<li><a href="mod_dav.html#davmintimeout">DavMinTimeout</a></li> +<li><a href="mod_dbd.html#dbdexptime">DBDExptime</a></li> +<li><a href="mod_dbd.html#dbdinitsql">DBDInitSQL</a></li> +<li><a href="mod_dbd.html#dbdkeep">DBDKeep</a></li> +<li><a href="mod_dbd.html#dbdmax">DBDMax</a></li> +<li><a href="mod_dbd.html#dbdmin">DBDMin</a></li> +<li><a href="mod_dbd.html#dbdparams">DBDParams</a></li> +<li><a href="mod_dbd.html#dbdpersist">DBDPersist</a></li> +<li><a href="mod_dbd.html#dbdpreparesql">DBDPrepareSQL</a></li> +<li><a href="mod_dbd.html#dbdriver">DBDriver</a></li> +<li><a href="mod_autoindex.html#defaulticon">DefaultIcon</a></li> +<li><a href="mod_mime.html#defaultlanguage">DefaultLanguage</a></li> +<li><a href="core.html#defaultruntimedir">DefaultRuntimeDir</a></li> +<li><a href="core.html#defaulttype">DefaultType</a></li> +<li><a href="core.html#define">Define</a></li> +<li><a href="mod_deflate.html#deflatebuffersize">DeflateBufferSize</a></li> +<li><a href="mod_deflate.html#deflatecompressionlevel">DeflateCompressionLevel</a></li> +<li><a href="mod_deflate.html#deflatefilternote">DeflateFilterNote</a></li> +<li><a href="mod_deflate.html#deflatememlevel">DeflateMemLevel</a></li> +<li><a href="mod_deflate.html#deflatewindowsize">DeflateWindowSize</a></li> +<li><a href="mod_access_compat.html#deny">Deny</a></li> +<li><a href="core.html#directory"><Directory></a></li> +<li><a href="mod_dir.html#directoryindex">DirectoryIndex</a></li> +<li><a href="mod_dir.html#directoryindexredirect">DirectoryIndexRedirect</a></li> +<li><a href="core.html#directorymatch"><DirectoryMatch></a></li> +<li><a href="mod_dir.html#directoryslash">DirectorySlash</a></li> +<li><a href="core.html#documentroot">DocumentRoot</a></li> +<li><a href="mod_privileges.html#dtraceprivileges">DTracePrivileges</a></li> +<li><a href="mod_dumpio.html#dumpioinput">DumpIOInput</a></li> +<li><a href="mod_dumpio.html#dumpiooutput">DumpIOOutput</a></li> +<li><a href="core.html#else" id="E" name="E"><Else></a></li> +<li><a href="core.html#elseif"><ElseIf></a></li> +<li><a href="mpm_common.html#enableexceptionhook">EnableExceptionHook</a></li> +<li><a href="core.html#enablemmap">EnableMMAP</a></li> +<li><a href="core.html#enablesendfile">EnableSendfile</a></li> +<li><a href="core.html#error">Error</a></li> +<li><a href="core.html#errordocument">ErrorDocument</a></li> +<li><a href="core.html#errorlog">ErrorLog</a></li> +<li><a href="core.html#errorlogformat">ErrorLogFormat</a></li> +<li><a href="mod_example.html#example">Example</a></li> +<li><a href="mod_expires.html#expiresactive">ExpiresActive</a></li> +<li><a href="mod_expires.html#expiresbytype">ExpiresByType</a></li> +<li><a href="mod_expires.html#expiresdefault">ExpiresDefault</a></li> +<li><a href="core.html#extendedstatus">ExtendedStatus</a></li> +<li><a href="mod_ext_filter.html#extfilterdefine">ExtFilterDefine</a></li> +<li><a href="mod_ext_filter.html#extfilteroptions">ExtFilterOptions</a></li> +<li><a href="mod_dir.html#fallbackresource" id="F" name="F">FallbackResource</a></li> +<li><a href="core.html#fileetag">FileETag</a></li> +<li><a href="core.html#files"><Files></a></li> +<li><a href="core.html#filesmatch"><FilesMatch></a></li> +<li><a href="mod_filter.html#filterchain">FilterChain</a></li> +<li><a href="mod_filter.html#filterdeclare">FilterDeclare</a></li> +<li><a href="mod_filter.html#filterprotocol">FilterProtocol</a></li> +<li><a href="mod_filter.html#filterprovider">FilterProvider</a></li> +<li><a href="mod_filter.html#filtertrace">FilterTrace</a></li> +<li><a href="mod_negotiation.html#forcelanguagepriority">ForceLanguagePriority</a></li> +<li><a href="core.html#forcetype">ForceType</a></li> +<li><a href="mod_log_forensic.html#forensiclog">ForensicLog</a></li> +<li><a href="core.html#gprofdir" id="G" name="G">GprofDir</a></li> +<li><a href="mpm_common.html#gracefulshutdowntimeout">GracefulShutdownTimeout</a></li> +<li><a href="mod_unixd.html#group">Group</a></li> +<li><a href="mod_headers.html#header" id="H" name="H">Header</a></li> +<li><a href="mod_autoindex.html#headername">HeaderName</a></li> +<li><a href="mod_heartbeat.html#heartbeataddress">HeartbeatAddress</a></li> +<li><a href="mod_heartmonitor.html#heartbeatlisten">HeartbeatListen</a></li> +<li><a href="mod_heartmonitor.html#heartbeatmaxservers">HeartbeatMaxServers</a></li> +<li><a href="mod_heartmonitor.html#heartbeatstorage">HeartbeatStorage</a></li> +<li><a href="mod_lbmethod_heartbeat.html#heartbeatstorage">HeartbeatStorage</a></li> +<li><a href="core.html#hostnamelookups">HostnameLookups</a></li> +<li><a href="mod_ident.html#identitycheck" id="I" name="I">IdentityCheck</a></li> +<li><a href="mod_ident.html#identitychecktimeout">IdentityCheckTimeout</a></li> +<li><a href="core.html#if"><If></a></li> +<li><a href="core.html#ifdefine"><IfDefine></a></li> +<li><a href="core.html#ifmodule"><IfModule></a></li> +<li><a href="mod_version.html#ifversion"><IfVersion></a></li> +<li><a href="mod_imagemap.html#imapbase">ImapBase</a></li> +<li><a href="mod_imagemap.html#imapdefault">ImapDefault</a></li> +<li><a href="mod_imagemap.html#imapmenu">ImapMenu</a></li> +<li><a href="core.html#include">Include</a></li> +<li><a href="core.html#includeoptional">IncludeOptional</a></li> +<li><a href="mod_autoindex.html#indexheadinsert">IndexHeadInsert</a></li> +<li><a href="mod_autoindex.html#indexignore">IndexIgnore</a></li> +<li><a href="mod_autoindex.html#indexignorereset">IndexIgnoreReset</a></li> +<li><a href="mod_autoindex.html#indexoptions">IndexOptions</a></li> +<li><a href="mod_autoindex.html#indexorderdefault">IndexOrderDefault</a></li> +<li><a href="mod_autoindex.html#indexstylesheet">IndexStyleSheet</a></li> +<li><a href="mod_sed.html#inputsed">InputSed</a></li> +<li><a href="mod_isapi.html#isapiappendlogtoerrors">ISAPIAppendLogToErrors</a></li> +<li><a href="mod_isapi.html#isapiappendlogtoquery">ISAPIAppendLogToQuery</a></li> +<li><a href="mod_isapi.html#isapicachefile">ISAPICacheFile</a></li> +<li><a href="mod_isapi.html#isapifakeasync">ISAPIFakeAsync</a></li> +<li><a href="mod_isapi.html#isapilognotsupported">ISAPILogNotSupported</a></li> +<li><a href="mod_isapi.html#isapireadaheadbuffer">ISAPIReadAheadBuffer</a></li> +<li><a href="core.html#keepalive" id="K" name="K">KeepAlive</a></li> +<li><a href="core.html#keepalivetimeout">KeepAliveTimeout</a></li> +<li><a href="mod_request.html#keptbodysize">KeptBodySize</a></li> +<li><a href="mod_negotiation.html#languagepriority" id="L" name="L">LanguagePriority</a></li> +<li><a href="mod_ldap.html#ldapcacheentries">LDAPCacheEntries</a></li> +<li><a href="mod_ldap.html#ldapcachettl">LDAPCacheTTL</a></li> +<li><a href="mod_ldap.html#ldapconnectionpoolttl">LDAPConnectionPoolTTL</a></li> +<li><a href="mod_ldap.html#ldapconnectiontimeout">LDAPConnectionTimeout</a></li> +<li><a href="mod_ldap.html#ldaplibrarydebug">LDAPLibraryDebug</a></li> +<li><a href="mod_ldap.html#ldapopcacheentries">LDAPOpCacheEntries</a></li> +<li><a href="mod_ldap.html#ldapopcachettl">LDAPOpCacheTTL</a></li> +<li><a href="mod_ldap.html#ldapreferralhoplimit">LDAPReferralHopLimit</a></li> +<li><a href="mod_ldap.html#ldapreferrals">LDAPReferrals</a></li> +<li><a href="mod_ldap.html#ldapretries">LDAPRetries</a></li> +<li><a href="mod_ldap.html#ldapretrydelay">LDAPRetryDelay</a></li> +<li><a href="mod_ldap.html#ldapsharedcachefile">LDAPSharedCacheFile</a></li> +<li><a href="mod_ldap.html#ldapsharedcachesize">LDAPSharedCacheSize</a></li> +<li><a href="mod_ldap.html#ldaptimeout">LDAPTimeout</a></li> +<li><a href="mod_ldap.html#ldaptrustedclientcert">LDAPTrustedClientCert</a></li> +<li><a href="mod_ldap.html#ldaptrustedglobalcert">LDAPTrustedGlobalCert</a></li> +<li><a href="mod_ldap.html#ldaptrustedmode">LDAPTrustedMode</a></li> +<li><a href="mod_ldap.html#ldapverifyservercert">LDAPVerifyServerCert</a></li> +<li><a href="core.html#limit"><Limit></a></li> +<li><a href="core.html#limitexcept"><LimitExcept></a></li> +<li><a href="core.html#limitinternalrecursion">LimitInternalRecursion</a></li> +<li><a href="core.html#limitrequestbody">LimitRequestBody</a></li> +<li><a href="core.html#limitrequestfields">LimitRequestFields</a></li> +<li><a href="core.html#limitrequestfieldsize">LimitRequestFieldSize</a></li> +<li><a href="core.html#limitrequestline">LimitRequestLine</a></li> +<li><a href="core.html#limitxmlrequestbody">LimitXMLRequestBody</a></li> +<li><a href="mpm_common.html#listen">Listen</a></li> +<li><a href="mpm_common.html#listenbacklog">ListenBackLog</a></li> +<li><a href="mod_so.html#loadfile">LoadFile</a></li> +<li><a href="mod_so.html#loadmodule">LoadModule</a></li> +<li><a href="core.html#location"><Location></a></li> +<li><a href="core.html#locationmatch"><LocationMatch></a></li> +<li><a href="mod_log_config.html#logformat">LogFormat</a></li> +<li><a href="core.html#loglevel">LogLevel</a></li> +<li><a href="mod_log_debug.html#logmessage">LogMessage</a></li> +<li><a href="mod_lua.html#luaauthzprovider">LuaAuthzProvider</a></li> +<li><a href="mod_lua.html#luahookaccesschecker">LuaHookAccessChecker</a></li> +<li><a href="mod_lua.html#luahookauthchecker">LuaHookAuthChecker</a></li> +<li><a href="mod_lua.html#luahookcheckuserid">LuaHookCheckUserID</a></li> +<li><a href="mod_lua.html#luahookfixups">LuaHookFixups</a></li> +<li><a href="mod_lua.html#luahookinsertfilter">LuaHookInsertFilter</a></li> +<li><a href="mod_lua.html#luahookmaptostorage">LuaHookMapToStorage</a></li> +<li><a href="mod_lua.html#luahooktranslatename">LuaHookTranslateName</a></li> +<li><a href="mod_lua.html#luahooktypechecker">LuaHookTypeChecker</a></li> +<li><a href="mod_lua.html#luainherit">LuaInherit</a></li> +<li><a href="mod_lua.html#luapackagecpath">LuaPackageCPath</a></li> +<li><a href="mod_lua.html#luapackagepath">LuaPackagePath</a></li> +<li><a href="mod_lua.html#luaquickhandler">LuaQuickHandler</a></li> +<li><a href="mod_lua.html#luaroot">LuaRoot</a></li> +<li><a href="mod_lua.html#luascope">LuaScope</a></li> +<li><a href="mpm_common.html#maxconnectionsperchild" id="M" name="M">MaxConnectionsPerChild</a></li> +<li><a href="core.html#maxkeepaliverequests">MaxKeepAliveRequests</a></li> +<li><a href="mpm_common.html#maxmemfree">MaxMemFree</a></li> +<li><a href="core.html#maxrangeoverlaps">MaxRangeOverlaps</a></li> +<li><a href="core.html#maxrangereversals">MaxRangeReversals</a></li> +<li><a href="core.html#maxranges">MaxRanges</a></li> +<li><a href="mpm_common.html#maxrequestworkers">MaxRequestWorkers</a></li> +<li><a href="prefork.html#maxspareservers">MaxSpareServers</a></li> +<li><a href="mpm_common.html#maxsparethreads">MaxSpareThreads</a></li> +<li><a href="mpm_netware.html#maxthreads">MaxThreads</a></li> +<li><a href="mod_cern_meta.html#metadir">MetaDir</a></li> +<li><a href="mod_cern_meta.html#metafiles">MetaFiles</a></li> +<li><a href="mod_cern_meta.html#metasuffix">MetaSuffix</a></li> +<li><a href="mod_mime_magic.html#mimemagicfile">MimeMagicFile</a></li> +<li><a href="prefork.html#minspareservers">MinSpareServers</a></li> +<li><a href="mpm_common.html#minsparethreads">MinSpareThreads</a></li> +<li><a href="mod_file_cache.html#mmapfile">MMapFile</a></li> +<li><a href="mod_dialup.html#modemstandard">ModemStandard</a></li> +<li><a href="mod_mime.html#modmimeusepathinfo">ModMimeUsePathInfo</a></li> +<li><a href="mod_mime.html#multiviewsmatch">MultiviewsMatch</a></li> +<li><a href="core.html#mutex">Mutex</a></li> +<li><a href="core.html#namevirtualhost" id="N" name="N">NameVirtualHost</a></li> +<li><a href="mod_proxy.html#noproxy">NoProxy</a></li> +<li><a href="mod_nw_ssl.html#nwssltrustedcerts">NWSSLTrustedCerts</a></li> +<li><a href="mod_nw_ssl.html#nwsslupgradeable">NWSSLUpgradeable</a></li> +<li><a href="core.html#options" id="O" name="O">Options</a></li> +<li><a href="mod_access_compat.html#order">Order</a></li> +<li><a href="mod_sed.html#outputsed">OutputSed</a></li> +<li><a href="mod_env.html#passenv" id="P" name="P">PassEnv</a></li> +<li><a href="mpm_common.html#pidfile">PidFile</a></li> +<li><a href="mod_privileges.html#privilegesmode">PrivilegesMode</a></li> +<li><a href="core.html#protocol">Protocol</a></li> +<li><a href="mod_echo.html#protocolecho">ProtocolEcho</a></li> +<li><a href="mod_proxy.html#proxy"><Proxy></a></li> +<li><a href="mod_proxy.html#proxyaddheaders">ProxyAddHeaders</a></li> +<li><a href="mod_proxy.html#proxybadheader">ProxyBadHeader</a></li> +<li><a href="mod_proxy.html#proxyblock">ProxyBlock</a></li> +<li><a href="mod_proxy.html#proxydomain">ProxyDomain</a></li> +<li><a href="mod_proxy.html#proxyerroroverride">ProxyErrorOverride</a></li> +<li><a href="mod_proxy_express.html#proxyexpressdbmfile">ProxyExpressDBMFile</a></li> +<li><a href="mod_proxy_express.html#proxyexpressdbmtype">ProxyExpressDBMType</a></li> +<li><a href="mod_proxy_express.html#proxyexpressenable">ProxyExpressEnable</a></li> +<li><a href="mod_proxy_ftp.html#proxyftpdircharset">ProxyFtpDirCharset</a></li> +<li><a href="mod_proxy_ftp.html#proxyftpescapewildcards">ProxyFtpEscapeWildcards</a></li> +<li><a href="mod_proxy_ftp.html#proxyftplistonwildcard">ProxyFtpListOnWildcard</a></li> +<li><a href="mod_proxy_html.html#proxyhtmlbufsize">ProxyHTMLBufSize</a></li> +<li><a href="mod_proxy_html.html#proxyhtmlcharsetout">ProxyHTMLCharsetOut</a></li> +<li><a href="mod_proxy_html.html#proxyhtmldoctype">ProxyHTMLDocType</a></li> +<li><a href="mod_proxy_html.html#proxyhtmlenable">ProxyHTMLEnable</a></li> +<li><a href="mod_proxy_html.html#proxyhtmlevents">ProxyHTMLEvents</a></li> +<li><a href="mod_proxy_html.html#proxyhtmlextended">ProxyHTMLExtended</a></li> +<li><a href="mod_proxy_html.html#proxyhtmlfixups">ProxyHTMLFixups</a></li> +<li><a href="mod_proxy_html.html#proxyhtmlinterp">ProxyHTMLInterp</a></li> +<li><a href="mod_proxy_html.html#proxyhtmllinks">ProxyHTMLLinks</a></li> +<li><a href="mod_proxy_html.html#proxyhtmlmeta">ProxyHTMLMeta</a></li> +<li><a href="mod_proxy_html.html#proxyhtmlstripcomments">ProxyHTMLStripComments</a></li> +<li><a href="mod_proxy_html.html#proxyhtmlurlmap">ProxyHTMLURLMap</a></li> +<li><a href="mod_proxy.html#proxyiobuffersize">ProxyIOBufferSize</a></li> +<li><a href="mod_proxy.html#proxymatch"><ProxyMatch></a></li> +<li><a href="mod_proxy.html#proxymaxforwards">ProxyMaxForwards</a></li> +<li><a href="mod_proxy.html#proxypass">ProxyPass</a></li> +<li><a href="mod_proxy.html#proxypassinterpolateenv">ProxyPassInterpolateEnv</a></li> +<li><a href="mod_proxy.html#proxypassmatch">ProxyPassMatch</a></li> +<li><a href="mod_proxy.html#proxypassreverse">ProxyPassReverse</a></li> +<li><a href="mod_proxy.html#proxypassreversecookiedomain">ProxyPassReverseCookieDomain</a></li> +<li><a href="mod_proxy.html#proxypassreversecookiepath">ProxyPassReverseCookiePath</a></li> +<li><a href="mod_proxy.html#proxypreservehost">ProxyPreserveHost</a></li> +<li><a href="mod_proxy.html#proxyreceivebuffersize">ProxyReceiveBufferSize</a></li> +<li><a href="mod_proxy.html#proxyremote">ProxyRemote</a></li> +<li><a href="mod_proxy.html#proxyremotematch">ProxyRemoteMatch</a></li> +<li><a href="mod_proxy.html#proxyrequests">ProxyRequests</a></li> +<li><a href="mod_proxy_scgi.html#proxyscgiinternalredirect">ProxySCGIInternalRedirect</a></li> +<li><a href="mod_proxy_scgi.html#proxyscgisendfile">ProxySCGISendfile</a></li> +<li><a href="mod_proxy.html#proxyset">ProxySet</a></li> +<li><a href="mod_proxy.html#proxysourceaddress">ProxySourceAddress</a></li> +<li><a href="mod_proxy.html#proxystatus">ProxyStatus</a></li> +<li><a href="mod_proxy.html#proxytimeout">ProxyTimeout</a></li> +<li><a href="mod_proxy.html#proxyvia">ProxyVia</a></li> +<li><a href="mod_autoindex.html#readmename" id="R" name="R">ReadmeName</a></li> +<li><a href="mpm_common.html#receivebuffersize">ReceiveBufferSize</a></li> +<li><a href="mod_alias.html#redirect">Redirect</a></li> +<li><a href="mod_alias.html#redirectmatch">RedirectMatch</a></li> +<li><a href="mod_alias.html#redirectpermanent">RedirectPermanent</a></li> +<li><a href="mod_alias.html#redirecttemp">RedirectTemp</a></li> +<li><a href="mod_reflector.html#reflectorheader">ReflectorHeader</a></li> +<li><a href="mod_remoteip.html#remoteipheader">RemoteIPHeader</a></li> +<li><a href="mod_remoteip.html#remoteipinternalproxy">RemoteIPInternalProxy</a></li> +<li><a href="mod_remoteip.html#remoteipinternalproxylist">RemoteIPInternalProxyList</a></li> +<li><a href="mod_remoteip.html#remoteipproxiesheader">RemoteIPProxiesHeader</a></li> +<li><a href="mod_remoteip.html#remoteiptrustedproxy">RemoteIPTrustedProxy</a></li> +<li><a href="mod_remoteip.html#remoteiptrustedproxylist">RemoteIPTrustedProxyList</a></li> +<li><a href="mod_mime.html#removecharset">RemoveCharset</a></li> +<li><a href="mod_mime.html#removeencoding">RemoveEncoding</a></li> +<li><a href="mod_mime.html#removehandler">RemoveHandler</a></li> +<li><a href="mod_mime.html#removeinputfilter">RemoveInputFilter</a></li> +<li><a href="mod_mime.html#removelanguage">RemoveLanguage</a></li> +<li><a href="mod_mime.html#removeoutputfilter">RemoveOutputFilter</a></li> +<li><a href="mod_mime.html#removetype">RemoveType</a></li> +<li><a href="mod_headers.html#requestheader">RequestHeader</a></li> +<li><a href="mod_reqtimeout.html#requestreadtimeout">RequestReadTimeout</a></li> +<li><a href="mod_authz_core.html#require">Require</a></li> +<li><a href="mod_authz_core.html#requireall"><RequireAll></a></li> +<li><a href="mod_authz_core.html#requireany"><RequireAny></a></li> +<li><a href="mod_authz_core.html#requirenone"><RequireNone></a></li> +<li><a href="mod_rewrite.html#rewritebase">RewriteBase</a></li> +<li><a href="mod_rewrite.html#rewritecond">RewriteCond</a></li> +<li><a href="mod_rewrite.html#rewriteengine">RewriteEngine</a></li> +<li><a href="mod_rewrite.html#rewritemap">RewriteMap</a></li> +<li><a href="mod_rewrite.html#rewriteoptions">RewriteOptions</a></li> +<li><a href="mod_rewrite.html#rewriterule">RewriteRule</a></li> +<li><a href="core.html#rlimitcpu">RLimitCPU</a></li> +<li><a href="core.html#rlimitmem">RLimitMEM</a></li> +<li><a href="core.html#rlimitnproc">RLimitNPROC</a></li> +<li><a href="mod_access_compat.html#satisfy" id="S" name="S">Satisfy</a></li> +<li><a href="mpm_common.html#scoreboardfile">ScoreBoardFile</a></li> +<li><a href="mod_actions.html#script">Script</a></li> +<li><a href="mod_alias.html#scriptalias">ScriptAlias</a></li> +<li><a href="mod_alias.html#scriptaliasmatch">ScriptAliasMatch</a></li> +<li><a href="core.html#scriptinterpretersource">ScriptInterpreterSource</a></li> +<li><a href="mod_cgi.html#scriptlog">ScriptLog</a></li> +<li><a href="mod_cgi.html#scriptlogbuffer">ScriptLogBuffer</a></li> +<li><a href="mod_cgi.html#scriptloglength">ScriptLogLength</a></li> +<li><a href="mod_cgid.html#scriptsock">ScriptSock</a></li> +<li><a href="mod_nw_ssl.html#securelisten">SecureListen</a></li> +<li><a href="core.html#seerequesttail">SeeRequestTail</a></li> +<li><a href="mpm_common.html#sendbuffersize">SendBufferSize</a></li> +<li><a href="core.html#serveradmin">ServerAdmin</a></li> +<li><a href="core.html#serveralias">ServerAlias</a></li> +<li><a href="mpm_common.html#serverlimit">ServerLimit</a></li> +<li><a href="core.html#servername">ServerName</a></li> +<li><a href="core.html#serverpath">ServerPath</a></li> +<li><a href="core.html#serverroot">ServerRoot</a></li> +<li><a href="core.html#serversignature">ServerSignature</a></li> +<li><a href="core.html#servertokens">ServerTokens</a></li> +<li><a href="mod_session.html#session">Session</a></li> +<li><a href="mod_session_cookie.html#sessioncookiename">SessionCookieName</a></li> +<li><a href="mod_session_cookie.html#sessioncookiename2">SessionCookieName2</a></li> +<li><a href="mod_session_cookie.html#sessioncookieremove">SessionCookieRemove</a></li> +<li><a href="mod_session_crypto.html#sessioncryptocipher">SessionCryptoCipher</a></li> +<li><a href="mod_session_crypto.html#sessioncryptodriver">SessionCryptoDriver</a></li> +<li><a href="mod_session_crypto.html#sessioncryptopassphrase">SessionCryptoPassphrase</a></li> +<li><a href="mod_session_crypto.html#sessioncryptopassphrasefile">SessionCryptoPassphraseFile</a></li> +<li><a href="mod_session_dbd.html#sessiondbdcookiename">SessionDBDCookieName</a></li> +<li><a href="mod_session_dbd.html#sessiondbdcookiename2">SessionDBDCookieName2</a></li> +<li><a href="mod_session_dbd.html#sessiondbdcookieremove">SessionDBDCookieRemove</a></li> +<li><a href="mod_session_dbd.html#sessiondbddeletelabel">SessionDBDDeleteLabel</a></li> +<li><a href="mod_session_dbd.html#sessiondbdinsertlabel">SessionDBDInsertLabel</a></li> +<li><a href="mod_session_dbd.html#sessiondbdperuser">SessionDBDPerUser</a></li> +<li><a href="mod_session_dbd.html#sessiondbdselectlabel">SessionDBDSelectLabel</a></li> +<li><a href="mod_session_dbd.html#sessiondbdupdatelabel">SessionDBDUpdateLabel</a></li> +<li><a href="mod_session.html#sessionenv">SessionEnv</a></li> +<li><a href="mod_session.html#sessionexclude">SessionExclude</a></li> +<li><a href="mod_session.html#sessionheader">SessionHeader</a></li> +<li><a href="mod_session.html#sessioninclude">SessionInclude</a></li> +<li><a href="mod_session.html#sessionmaxage">SessionMaxAge</a></li> +<li><a href="mod_env.html#setenv">SetEnv</a></li> +<li><a href="mod_setenvif.html#setenvif">SetEnvIf</a></li> +<li><a href="mod_setenvif.html#setenvifexpr">SetEnvIfExpr</a></li> +<li><a href="mod_setenvif.html#setenvifnocase">SetEnvIfNoCase</a></li> +<li><a href="core.html#sethandler">SetHandler</a></li> +<li><a href="core.html#setinputfilter">SetInputFilter</a></li> +<li><a href="core.html#setoutputfilter">SetOutputFilter</a></li> +<li><a href="mod_include.html#ssiendtag">SSIEndTag</a></li> +<li><a href="mod_include.html#ssierrormsg">SSIErrorMsg</a></li> +<li><a href="mod_include.html#ssietag">SSIETag</a></li> +<li><a href="mod_include.html#ssilastmodified">SSILastModified</a></li> +<li><a href="mod_include.html#ssilegacyexprparser">SSILegacyExprParser</a></li> +<li><a href="mod_include.html#ssistarttag">SSIStartTag</a></li> +<li><a href="mod_include.html#ssitimeformat">SSITimeFormat</a></li> +<li><a href="mod_include.html#ssiundefinedecho">SSIUndefinedEcho</a></li> +<li><a href="mod_ssl.html#sslcacertificatefile">SSLCACertificateFile</a></li> +<li><a href="mod_ssl.html#sslcacertificatepath">SSLCACertificatePath</a></li> +<li><a href="mod_ssl.html#sslcadnrequestfile">SSLCADNRequestFile</a></li> +<li><a href="mod_ssl.html#sslcadnrequestpath">SSLCADNRequestPath</a></li> +<li><a href="mod_ssl.html#sslcarevocationcheck">SSLCARevocationCheck</a></li> +<li><a href="mod_ssl.html#sslcarevocationfile">SSLCARevocationFile</a></li> +<li><a href="mod_ssl.html#sslcarevocationpath">SSLCARevocationPath</a></li> +<li><a href="mod_ssl.html#sslcertificatechainfile">SSLCertificateChainFile</a></li> +<li><a href="mod_ssl.html#sslcertificatefile">SSLCertificateFile</a></li> +<li><a href="mod_ssl.html#sslcertificatekeyfile">SSLCertificateKeyFile</a></li> +<li><a href="mod_ssl.html#sslciphersuite">SSLCipherSuite</a></li> +<li><a href="mod_ssl.html#sslcompression">SSLCompression</a></li> +<li><a href="mod_ssl.html#sslcryptodevice">SSLCryptoDevice</a></li> +<li><a href="mod_ssl.html#sslengine">SSLEngine</a></li> +<li><a href="mod_ssl.html#sslfips">SSLFIPS</a></li> +<li><a href="mod_ssl.html#sslhonorcipherorder">SSLHonorCipherOrder</a></li> +<li><a href="mod_ssl.html#sslinsecurerenegotiation">SSLInsecureRenegotiation</a></li> +<li><a href="mod_ssl.html#sslocspdefaultresponder">SSLOCSPDefaultResponder</a></li> +<li><a href="mod_ssl.html#sslocspenable">SSLOCSPEnable</a></li> +<li><a href="mod_ssl.html#sslocspoverrideresponder">SSLOCSPOverrideResponder</a></li> +<li><a href="mod_ssl.html#sslocsprespondertimeout">SSLOCSPResponderTimeout</a></li> +<li><a href="mod_ssl.html#sslocspresponsemaxage">SSLOCSPResponseMaxAge</a></li> +<li><a href="mod_ssl.html#sslocspresponsetimeskew">SSLOCSPResponseTimeSkew</a></li> +<li><a href="mod_ssl.html#ssloptions">SSLOptions</a></li> +<li><a href="mod_ssl.html#sslpassphrasedialog">SSLPassPhraseDialog</a></li> +<li><a href="mod_ssl.html#sslprotocol">SSLProtocol</a></li> +<li><a href="mod_ssl.html#sslproxycacertificatefile">SSLProxyCACertificateFile</a></li> +<li><a href="mod_ssl.html#sslproxycacertificatepath">SSLProxyCACertificatePath</a></li> +<li><a href="mod_ssl.html#sslproxycarevocationcheck">SSLProxyCARevocationCheck</a></li> +<li><a href="mod_ssl.html#sslproxycarevocationfile">SSLProxyCARevocationFile</a></li> +<li><a href="mod_ssl.html#sslproxycarevocationpath">SSLProxyCARevocationPath</a></li> +<li><a href="mod_ssl.html#sslproxycheckpeercn">SSLProxyCheckPeerCN</a></li> +<li><a href="mod_ssl.html#sslproxycheckpeerexpire">SSLProxyCheckPeerExpire</a></li> +<li><a href="mod_ssl.html#sslproxyciphersuite">SSLProxyCipherSuite</a></li> +<li><a href="mod_ssl.html#sslproxyengine">SSLProxyEngine</a></li> +<li><a href="mod_ssl.html#sslproxymachinecertificatechainfile">SSLProxyMachineCertificateChainFile</a></li> +<li><a href="mod_ssl.html#sslproxymachinecertificatefile">SSLProxyMachineCertificateFile</a></li> +<li><a href="mod_ssl.html#sslproxymachinecertificatepath">SSLProxyMachineCertificatePath</a></li> +<li><a href="mod_ssl.html#sslproxyprotocol">SSLProxyProtocol</a></li> +<li><a href="mod_ssl.html#sslproxyverify">SSLProxyVerify</a></li> +<li><a href="mod_ssl.html#sslproxyverifydepth">SSLProxyVerifyDepth</a></li> +<li><a href="mod_ssl.html#sslrandomseed">SSLRandomSeed</a></li> +<li><a href="mod_ssl.html#sslrenegbuffersize">SSLRenegBufferSize</a></li> +<li><a href="mod_ssl.html#sslrequire">SSLRequire</a></li> +<li><a href="mod_ssl.html#sslrequiressl">SSLRequireSSL</a></li> +<li><a href="mod_ssl.html#sslsessioncache">SSLSessionCache</a></li> +<li><a href="mod_ssl.html#sslsessioncachetimeout">SSLSessionCacheTimeout</a></li> +<li><a href="mod_ssl.html#sslsessionticketkeyfile">SSLSessionTicketKeyFile</a></li> +<li><a href="mod_ssl.html#sslsrpunknownuserseed">SSLSRPUnknownUserSeed</a></li> +<li><a href="mod_ssl.html#sslsrpverifierfile">SSLSRPVerifierFile</a></li> +<li><a href="mod_ssl.html#sslstaplingcache">SSLStaplingCache</a></li> +<li><a href="mod_ssl.html#sslstaplingerrorcachetimeout">SSLStaplingErrorCacheTimeout</a></li> +<li><a href="mod_ssl.html#sslstaplingfaketrylater">SSLStaplingFakeTryLater</a></li> +<li><a href="mod_ssl.html#sslstaplingforceurl">SSLStaplingForceURL</a></li> +<li><a href="mod_ssl.html#sslstaplingrespondertimeout">SSLStaplingResponderTimeout</a></li> +<li><a href="mod_ssl.html#sslstaplingresponsemaxage">SSLStaplingResponseMaxAge</a></li> +<li><a href="mod_ssl.html#sslstaplingresponsetimeskew">SSLStaplingResponseTimeSkew</a></li> +<li><a href="mod_ssl.html#sslstaplingreturnrespondererrors">SSLStaplingReturnResponderErrors</a></li> +<li><a href="mod_ssl.html#sslstaplingstandardcachetimeout">SSLStaplingStandardCacheTimeout</a></li> +<li><a href="mod_ssl.html#sslstrictsnivhostcheck">SSLStrictSNIVHostCheck</a></li> +<li><a href="mod_ssl.html#sslusername">SSLUserName</a></li> +<li><a href="mod_ssl.html#sslusestapling">SSLUseStapling</a></li> +<li><a href="mod_ssl.html#sslverifyclient">SSLVerifyClient</a></li> +<li><a href="mod_ssl.html#sslverifydepth">SSLVerifyDepth</a></li> +<li><a href="mpm_common.html#startservers">StartServers</a></li> +<li><a href="mpm_common.html#startthreads">StartThreads</a></li> +<li><a href="mod_substitute.html#substitute">Substitute</a></li> +<li><a href="mod_unixd.html#suexec">Suexec</a></li> +<li><a href="mod_suexec.html#suexecusergroup">SuexecUserGroup</a></li> +<li><a href="mpm_common.html#threadlimit" id="T" name="T">ThreadLimit</a></li> +<li><a href="mpm_common.html#threadsperchild">ThreadsPerChild</a></li> +<li><a href="mpm_common.html#threadstacksize">ThreadStackSize</a></li> +<li><a href="core.html#timeout">TimeOut</a></li> +<li><a href="core.html#traceenable">TraceEnable</a></li> +<li><a href="mod_log_config.html#transferlog">TransferLog</a></li> +<li><a href="mod_mime.html#typesconfig">TypesConfig</a></li> +<li><a href="core.html#undefine" id="U" name="U">UnDefine</a></li> +<li><a href="mod_env.html#unsetenv">UnsetEnv</a></li> +<li><a href="core.html#usecanonicalname">UseCanonicalName</a></li> +<li><a href="core.html#usecanonicalphysicalport">UseCanonicalPhysicalPort</a></li> +<li><a href="mod_unixd.html#user">User</a></li> +<li><a href="mod_userdir.html#userdir">UserDir</a></li> +<li><a href="mod_privileges.html#vhostcgimode" id="V" name="V">VHostCGIMode</a></li> +<li><a href="mod_privileges.html#vhostcgiprivs">VHostCGIPrivs</a></li> +<li><a href="mod_privileges.html#vhostgroup">VHostGroup</a></li> +<li><a href="mod_privileges.html#vhostprivs">VHostPrivs</a></li> +<li><a href="mod_privileges.html#vhostsecure">VHostSecure</a></li> +<li><a href="mod_privileges.html#vhostuser">VHostUser</a></li> +<li><a href="mod_vhost_alias.html#virtualdocumentroot">VirtualDocumentRoot</a></li> +<li><a href="mod_vhost_alias.html#virtualdocumentrootip">VirtualDocumentRootIP</a></li> +<li><a href="core.html#virtualhost"><VirtualHost></a></li> +<li><a href="mod_vhost_alias.html#virtualscriptalias">VirtualScriptAlias</a></li> +<li><a href="mod_vhost_alias.html#virtualscriptaliasip">VirtualScriptAliasIP</a></li> +<li><a href="mod_watchdog.html#watchdoginterval" id="W" name="W">WatchdogInterval</a></li> +<li><a href="mod_include.html#xbithack" id="X" name="X">XBitHack</a></li> +<li><a href="mod_xml2enc.html#xml2encalias">xml2EncAlias</a></li> +<li><a href="mod_xml2enc.html#xml2encdefault">xml2EncDefault</a></li> +<li><a href="mod_xml2enc.html#xml2startparse">xml2StartParse</a></li> +</ul></div> +<div class="bottomlang"> +<p><span>Langues Disponibles: </span><a href="../de/mod/directives.html" hreflang="de" rel="alternate" title="Deutsch"> de </a> | +<a href="../en/mod/directives.html" hreflang="en" rel="alternate" title="English"> en </a> | +<a href="../es/mod/directives.html" hreflang="es" rel="alternate" title="Español"> es </a> | +<a href="../fr/mod/directives.html" title="Français"> fr </a> | +<a href="../ja/mod/directives.html" hreflang="ja" rel="alternate" title="Japanese"> ja </a> | +<a href="../ko/mod/directives.html" hreflang="ko" rel="alternate" title="Korean"> ko </a> | +<a href="../tr/mod/directives.html" hreflang="tr" rel="alternate" title="Türkçe"> tr </a> | +<a href="../zh-cn/mod/directives.html" hreflang="zh-cn" rel="alternate" title="Simplified Chinese"> zh-cn </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/2.4/mod/directives.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 2013 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/directives.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 diff --git a/docs/manual/mod/directives.xml.fr b/docs/manual/mod/directives.xml.fr new file mode 100644 index 0000000000..a09e49f23c --- /dev/null +++ b/docs/manual/mod/directives.xml.fr @@ -0,0 +1,43 @@ +<?xml version="1.0"?> +<!DOCTYPE directiveindex SYSTEM "../style/modulesynopsis.dtd"> +<?xml-stylesheet type="text/xsl" href="../style/manual.fr.xsl"?> +<!-- LastChangedRevision English document : 420990 --> +<!-- 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. +--> + +<directiveindex metafile="directives.xml.meta"> + <title>Index des directives</title> + <summary> + <p> + Toutes les directives Apache disponibles dans la distribution standard + d'Apache sont référencées ici. Elles sont décrites en utilisant un + format normalisé, et <a href="directive-dict.html" + rel="Glossary">un dictionnaire</a> des termes utilisés dans leurs + descriptions est disponible. + </p> + + <p> + Un <a href="quickreference.html" + >Document de référence rapide des directives</a> + est également disponible. Il donne des détails à propos de chaque directive + sous une forme abrégée. + </p> + </summary> +</directiveindex> diff --git a/docs/manual/mod/directives.xml.meta b/docs/manual/mod/directives.xml.meta index bd7a7b7679..7f569d9530 100644 --- a/docs/manual/mod/directives.xml.meta +++ b/docs/manual/mod/directives.xml.meta @@ -10,6 +10,7 @@ <variant>de</variant> <variant>en</variant> <variant>es</variant> + <variant>fr</variant> <variant>ja</variant> <variant>ko</variant> <variant>tr</variant> diff --git a/docs/manual/mod/mod_authz_core.html b/docs/manual/mod/mod_authz_core.html index 67d6786291..8d3da5b111 100644 --- a/docs/manual/mod/mod_authz_core.html +++ b/docs/manual/mod/mod_authz_core.html @@ -3,3 +3,7 @@ URI: mod_authz_core.html.en Content-Language: en Content-type: text/html; charset=ISO-8859-1 + +URI: mod_authz_core.html.fr +Content-Language: fr +Content-type: text/html; charset=ISO-8859-1 diff --git a/docs/manual/mod/mod_authz_core.html.en b/docs/manual/mod/mod_authz_core.html.en index a3f07b66a3..3cb249dccf 100644 --- a/docs/manual/mod/mod_authz_core.html.en +++ b/docs/manual/mod/mod_authz_core.html.en @@ -24,7 +24,8 @@ <div id="page-content"> <div id="preamble"><h1>Apache Module mod_authz_core</h1> <div class="toplang"> -<p><span>Available Languages: </span><a href="../en/mod/mod_authz_core.html" title="English"> en </a></p> +<p><span>Available Languages: </span><a href="../en/mod/mod_authz_core.html" title="English"> en </a> | +<a href="../fr/mod/mod_authz_core.html" hreflang="fr" rel="alternate" title="Français"> fr </a></p> </div> <table class="module"><tr><th><a href="module-dict.html#Description">Description:</a></th><td>Core Authorization</td></tr> <tr><th><a href="module-dict.html#Status">Status:</a></th><td>Base</td></tr> @@ -637,7 +638,8 @@ must succeed for the enclosing directive to not fail.</td></tr> </div> </div> <div class="bottomlang"> -<p><span>Available Languages: </span><a href="../en/mod/mod_authz_core.html" title="English"> en </a></p> +<p><span>Available Languages: </span><a href="../en/mod/mod_authz_core.html" title="English"> en </a> | +<a href="../fr/mod/mod_authz_core.html" hreflang="fr" rel="alternate" title="Français"> fr </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">Comments</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'; diff --git a/docs/manual/mod/mod_authz_core.html.fr b/docs/manual/mod/mod_authz_core.html.fr new file mode 100644 index 0000000000..e1650fbffb --- /dev/null +++ b/docs/manual/mod/mod_authz_core.html.fr @@ -0,0 +1,675 @@ +<?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><!-- + XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX + This file is generated from xml source: DO NOT EDIT + XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX + --> +<title>mod_authz_core - Serveur Apache HTTP</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.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/directives.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.4</p> +<img alt="" src="../images/feather.gif" /></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.4</a> > <a href="./">Modules</a></div> +<div id="page-content"> +<div id="preamble"><h1>Module Apache mod_authz_core</h1> +<div class="toplang"> +<p><span>Langues Disponibles: </span><a href="../en/mod/mod_authz_core.html" hreflang="en" rel="alternate" title="English"> en </a> | +<a href="../fr/mod/mod_authz_core.html" title="Français"> fr </a></p> +</div> +<table class="module"><tr><th><a href="module-dict.html#Description">Description:</a></th><td>Autorisation basique</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>authz_core_module</td></tr> +<tr><th><a href="module-dict.html#SourceFile">Fichier Source:</a></th><td>mod_authz_core.c</td></tr> +<tr><th><a href="module-dict.html#Compatibility">Compatibilité:</a></th><td>Disponible depuis la version 2.3 +d'Apache HTTPD</td></tr></table> +<h3>Sommaire</h3> + + <p>Ce module fournit des fonctionnalités d'autorisation basiques + permettant d'accorder ou refuser l'accès à certaines zones du site + web aux utilisateurs authentifiés. <code class="module"><a href="../mod/mod_authz_core.html">mod_authz_core</a></code> + donne la possibilité d'enregistrer divers fournisseurs + d'autorisation. Il est en général utilisé avec un module fournisseur + d'authentification comme <code class="module"><a href="../mod/mod_authn_file.html">mod_authn_file</a></code>, et un + module d'autorisation comme <code class="module"><a href="../mod/mod_authz_user.html">mod_authz_user</a></code>. Il + permet aussi l'application d'une logique élaborée au déroulement du + processus d'autorisation.</p> +</div> +<div id="quickview"><h3 class="directives">Directives</h3> +<ul id="toc"> +<li><img alt="" src="../images/down.gif" /> <a href="#authmerging">AuthMerging</a></li> +<li><img alt="" src="../images/down.gif" /> <a href="#authzprovideralias"><AuthzProviderAlias></a></li> +<li><img alt="" src="../images/down.gif" /> <a href="#authzsendforbiddenonfailure">AuthzSendForbiddenOnFailure</a></li> +<li><img alt="" src="../images/down.gif" /> <a href="#require">Require</a></li> +<li><img alt="" src="../images/down.gif" /> <a href="#requireall"><RequireAll></a></li> +<li><img alt="" src="../images/down.gif" /> <a href="#requireany"><RequireAny></a></li> +<li><img alt="" src="../images/down.gif" /> <a href="#requirenone"><RequireNone></a></li> +</ul> +<h3>Sujets</h3> +<ul id="topics"> +<li><img alt="" src="../images/down.gif" /> <a href="#authzalias">Création des alias du fournisseur +d'autorisation</a></li> +<li><img alt="" src="../images/down.gif" /> <a href="#logic">Conteneurs d'autorisation</a></li> +<li><img alt="" src="../images/down.gif" /> <a href="#requiredirectives">Les directives Require</a></li> +</ul><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="authzalias" id="authzalias">Création des alias du fournisseur +d'autorisation</a></h2> + + <p>Il est possible de créer des fournisseurs d'autorisation étendus + dans le fichier de configuration et de leur assigner un nom d'alias. + On peut ensuite utiliser ces fournisseurs aliasés dans une + directive <code class="directive"><a href="#require">Require</a></code> de + la même manière qu'on le ferait pour des fournisseurs d'autorisation + de base. En plus de la possibilité de créer et d'aliaser un + fournisseur étendu, le même fournisseur d'autorisation étendu peut + être utilisé pour contrôler l'accès à plusieurs localisations. + </p> + + <h3><a name="example" id="example">Exemple</a></h3> + <p>Dans l'exemple suivant, on crée deux alias de fournisseur + d'autorisation ldap différents basés sur le fournisseur + d'autorisation ldap-group. Il est ainsi possible pour un seul + répertoire de vérifier l'appartenance à un groupe au niveau de + plusieurs serveurs ldap : + </p> + + <pre class="prettyprint lang-config"> +<AuthzProviderAlias ldap-group ldap-group-alias1 cn=my-group,o=ctx> + AuthLDAPBindDN cn=monutilisateur,o=ctx + AuthLDAPBindPassword monmotdepasse + AuthLDAPURL ldap://serveur.ldap/o=ctx +</AuthzProviderAlias> + +<AuthzProviderAlias ldap-group ldap-group-alias2 cn=my-other-group,o=dev> + AuthLDAPBindDN cn=monautreutilisateur,o=dev + AuthLDAPBindPassword monsecondmotdepasse + AuthLDAPURL ldap://autre.serveur.ldap/o=dev?cn +</AuthzProviderAlias> + +Alias /secure /webpages/secure +<Directory /webpages/secure> + Require all granted + + AuthBasicProvider file + + AuthType Basic + AuthName LDAP_Protected_Place + + #Implicitement, c'est l'un OU l'autre + Require ldap-group-alias1 + Require ldap-group-alias2 +</Directory> + </pre> + + + +</div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div> +<div class="section"> +<h2><a name="logic" id="logic">Conteneurs d'autorisation</a></h2> + + <p>Les directives de conteneur d'autorisation <code class="directive"><a href="#requireall"><RequireAll></a></code>, + <code class="directive"><a href="#requireany"><RequireAny></a></code> et <code class="directive"><a href="#requirenone"><RequireNone></a></code> + peuvent être combinées entre elles et avec la directive <code class="directive"><a href="#require">Require</a></code> pour élaborer une + logique d'autorisation complexe.</p> + + <p>L'exemple ci-dessous illustre la logique d'autorisation suivante. + Pour pouvoir accéder à la ressource, l'utilisateur doit être + l'utilisateur <code>superadmin</code>, ou appartenir aux deux + groupes LDAP <code>admins</code> et <code>Administrateurs</code> et + soit appartenir au groupe <code>ventes</code> ou avoir + <code>ventes</code> comme valeur de l'attribut LDAP + <code>dept</code>. De plus, pour pouvoir accéder à la ressource, + l'utilisateur ne doit appartenir ni au groupe <code>temps</code>, ni + au groupe LDAP <code>Employes temporaires</code>.</p> + + <pre class="prettyprint lang-config"> +<Directory /www/mydocs> + <RequireAll> + <RequireAny> + Require user superadmin + <RequireAll> + Require group admins + Require ldap-group cn=Administrators,o=Airius + <RequireAny> + Require group ventes + Require ldap-attribute dept="ventes" + </RequireAny> + </RequireAll> + </RequireAny> + <RequireNone> + Require group temps + Require ldap-group cn=Employes Temporaires,o=Airius + </RequireNone> + </RequireAll> +</Directory> + </pre> + +</div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div> +<div class="section"> +<h2><a name="requiredirectives" id="requiredirectives">Les directives Require</a></h2> + + <p>Le module <code class="module"><a href="../mod/mod_authz_core.html">mod_authz_core</a></code> met à disposition des + fournisseurs d'autorisation génériques utilisables avec la directive + <code class="directive"><a href="#require">Require</a></code>.</p> + + <h3><a name="reqenv" id="reqenv">Require env</a></h3> + + <p>Le fournisseur <code>env</code> permet de contrôler l'accès au + serveur en fonction de l'existence d'une <a href="../env.html">variable d'environnement</a>. Lorsque <code>Require + env <var>env-variable</var></code> est spécifié, la requête se voit + autoriser l'accès si la variable d'environnement + <var>env-variable</var> existe. Le serveur permet de définir + facilement des variables d'environnement en fonction des + caractéristiques de la requête du client via les directives fournies + par le module <code class="module"><a href="../mod/mod_setenvif.html">mod_setenvif</a></code>. Cette directive Require + env permet donc de contrôler l'accès en fonction des + valeurs des en-têtes de la requête HTTP tels que + <code>User-Agent</code> (type de navigateur), <code>Referer</code>, + entre autres.</p> + + <pre class="prettyprint lang-config"> +SetEnvIf User-Agent ^KnockKnock/2\.0 let_me_in +<Directory /docroot> + Require env let_me_in +</Directory> + </pre> + + + <p>Avec cet exemple, les navigateurs dont la chaîne user-agent + commence par <code>KnockKnock/2.0</code> se verront autoriser + l'accès, alors que tous les autres seront rejetés.</p> + + + + <h3><a name="reqall" id="reqall">Require all</a></h3> + + <p>Le fournisseur <code>all</code> reproduit la fonctionnalité + précédemment fournie par les directives 'Allow from all' et 'Deny + from all'. Il accepte un argument dont les deux valeurs possibles + sont : 'granted' ou 'denied'. Les exemples suivants autorisent ou + interdisent l'accès à toutes les requêtes.</p> + + <pre class="prettyprint lang-config"> + Require all granted + </pre> + + + <pre class="prettyprint lang-config"> + Require all denied + </pre> + + + + + <h3><a name="reqmethod" id="reqmethod">Require method</a></h3> + + <p>Le fournisseur <code>method</code> permet d'utiliser la méthode + HTTP dans le processus d'autorisation. Les méthodes GET et HEAD sont + ici considérées comme équivalentes. La méthode TRACE n'est pas + supportée par ce fournisseur ; utilisez à la place la directive + <code class="directive"><a href="../mod/core.html#traceenable">TraceEnable</a></code>.</p> + + <p>Dans l'exemple suivant, seules les méthodes GET, HEAD, POST, et + OPTIONS sont autorisées :</p> + + <pre class="prettyprint lang-config"> + Require method GET POST OPTIONS + </pre> + + + <p>Dans l'exemple suivant, les méthodes GET, HEAD, POST, et OPTIONS + sont autorisées sans authentification, alors que toutes les autres + méthodes nécessitent un utilisateur valide :</p> + + <pre class="prettyprint lang-config"> +<RequireAny> + Require method GET POST OPTIONS + Require valid-user +</RequireAny> + </pre> + + + + <h3><a name="reqexpr" id="reqexpr">Require expr</a></h3> + + <p>Le fournisseur <code>expr</code> permet d'accorder l'autorisation + d'accès en fonction d'expressions arbitraires.</p> + + <pre class="prettyprint lang-config"> + Require expr %{TIME_HOUR} -ge 9 && %{TIME_HOUR} -le 17 + </pre> + + + <p>La syntaxe de l'expression est décrite dans la documentation de <a href="../expr.html">ap_expr</a>.</p> + + <p>Normalement, l'expression est évaluée avant l'authentification. + Cependant, si l'expression renvoie false et se réfère à la variable + <code>%{REMOTE_USER}</code>, le processus d'authentification sera + engagé et l'expression réévaluée.</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="AuthMerging" id="AuthMerging">AuthMerging</a> <a name="authmerging" id="authmerging">Directive</a></h2> +<table class="directive"> +<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Définit la manière dont chaque logique d'autorisation des +sections de configuration se combine avec celles des sections de +configuration précédentes.</td></tr> +<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>AuthMerging Off | And | Or</code></td></tr> +<tr><th><a href="directive-dict.html#Default">Défaut:</a></th><td><code>AuthMerging Off</code></td></tr> +<tr><th><a href="directive-dict.html#Context">Contexte:</a></th><td>répertoire, .htaccess</td></tr> +<tr><th><a href="directive-dict.html#Override">AllowOverride:</a></th><td>AuthConfig</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_authz_core</td></tr> +</table> + <p>Lorsque l'autorisation est activée, elle est normalement héritée + par chaque <a href="../sections.html#merging">section de + configuration</a> suivante, à moins qu'un jeu de directives + d'autorisations différent ne soit spécifié. Il s'agit du + comportement par défaut, qui correspond à la définition explicite + <code>AuthMerging Off</code>.</p> + + <p>Dans certaines situations cependant, il peut être souhaitable de + combiner la logique d'autorisation d'une section de configuration + avec celle de la section précédente lorsque les sections de + configuration se combinent entre elles. Dans ce cas, deux options + sont disponibles, <code>And</code> et <code>Or</code>.</p> + + <p>Lorsqu'une section de configuration contient <code>AuthMerging + And</code> ou <code>AuthMerging Or</code>, sa logique d'autorisation + se combine avec celle de la section de configuration qui la précède + (selon l'ordre général des sections de configuration), et qui + contient aussi une logique d'autorisation, comme si les deux + sections étaient concaténées respectivement dans une directive + <code class="directive"><a href="#requireall"><RequireAll></a></code> ou <code class="directive"><a href="#requireany"><RequireAny></a></code>.</p> + + <div class="note">La définition de la directive + <code class="directive">AuthMerging</code> ne concerne que la section de + configuration dans laquelle elle apparaît. Dans l'exemple suivant, + seuls les utilisateurs appartenant au groupe <code>alpha</code> sont + autorisés à accéder à <code>/www/docs</code>. Les utilisateurs + appartenant au groupe <code>alpha</code> ou au groupe + <code>beta</code> sont autorisés à accéder à + <code>/www/docs/ab</code>. Cependant, la définition implicite à + <code>Off</code> de la directive <code class="directive">AuthMerging</code> + s'applique à la section de configuration <code class="directive"><a href="../mod/core.html#directory"><Directory></a></code> concernant le répertoire + <code>/www/docs/ab/gamma</code>, ce qui implique que les directives + d'autorisation de cette section l'emportent sur celles des sections + précédentes. Par voie de conséquence, seuls les utilisateurs + appartenant au groupe <code>gamma</code> sont autorisés à accéder à + <code>/www/docs/ab/gamma</code>.</div> + + <pre class="prettyprint lang-config"> +<Directory /www/docs> + AuthType Basic + AuthName Documents + AuthBasicProvider file + AuthUserFile /usr/local/apache/passwd/passwords + Require group alpha +</Directory> + +<Directory /www/docs/ab> + AuthMerging Or + Require group beta +</Directory> + +<Directory /www/docs/ab/gamma> + Require group gamma +</Directory> + </pre> + + +</div> +<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div> +<div class="directive-section"><h2><a name="AuthzProviderAlias" id="AuthzProviderAlias"><AuthzProviderAlias></a> <a name="authzprovideralias" id="authzprovideralias">Directive</a></h2> +<table class="directive"> +<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Regroupe des directives représentant une extension d'un +fournisseur d'autorisation de base qui pourra être référencée à l'aide +de l'alias spécifié</td></tr> +<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code><AuthzProviderAlias <var>fournisseur-de-base Alias +Paramètres-Require</var>> +... </AuthzProviderAlias> +</code></td></tr> +<tr><th><a href="directive-dict.html#Context">Contexte:</a></th><td>configuration du serveur</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_authz_core</td></tr> +</table> + <p>Les balises <code class="directive"><AuthzProviderAlias></code> et + <code></AuthzProviderAlias></code> permettent de regrouper des + directives d'autorisation auxquelles on pourra faire référence à + l'aide de l'alias spécifié dans une directive <code class="directive"><a href="#require">Require</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="AuthzSendForbiddenOnFailure" id="AuthzSendForbiddenOnFailure">AuthzSendForbiddenOnFailure</a> <a name="authzsendforbiddenonfailure" id="authzsendforbiddenonfailure">Directive</a></h2> +<table class="directive"> +<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Envoie '403 FORBIDDEN' au lieu de '401 UNAUTHORIZED' si +l'authentification réussit et si l'autorisation a été refusée. +</td></tr> +<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>AuthzSendForbiddenOnFailure On|Off</code></td></tr> +<tr><th><a href="directive-dict.html#Default">Défaut:</a></th><td><code>AuthzSendForbiddenOnFailure Off</code></td></tr> +<tr><th><a href="directive-dict.html#Context">Contexte:</a></th><td>répertoire, .htaccess</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_authz_core</td></tr> +<tr><th><a href="directive-dict.html#Compatibility">Compatibilité:</a></th><td>Disponible depuis la version 2.3.11 d'Apache HTTPD</td></tr> +</table> + <p>Par défaut, si l'authentification réussit, alors que + l'autorisation est refusée, Apache HTTPD renvoie un code de réponse + HTTP '401 UNAUTHORIZED'. En général, les navigateurs proposent alors + une nouvelle fois à l'utilisateur la boîte de dialogue de saisie du + mot de passe, ce qui n'est pas toujours souhaitable. La directive + <code class="directive">AuthzSendForbiddenOnFailure</code> permet de changer + le code de réponse en '403 FORBIDDEN'.</p> + + <div class="warning"><h3>Avertissement de sécurité</h3> + <p>La modification de la réponse en cas de refus d'autorisation + diminue la sécurité du mot de passe, car elle indique à un éventuel + attaquant que le mot de passe qu'il a saisi était correct.</p> + </div> + +</div> +<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div> +<div class="directive-section"><h2><a name="Require" id="Require">Require</a> <a name="require" id="require">Directive</a></h2> +<table class="directive"> +<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Vérifie si un utilisateur authentifié a une +autorisation d'accès accordée par un fournisseur +d'autorisation.</td></tr> +<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>Require [not] <var>nom-entité</var> [<var>nom-entité</var>] +...</code></td></tr> +<tr><th><a href="directive-dict.html#Context">Contexte:</a></th><td>répertoire, .htaccess</td></tr> +<tr><th><a href="directive-dict.html#Override">AllowOverride:</a></th><td>AuthConfig</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_authz_core</td></tr> +</table> + <p>Cette directive permet de vérifier si un utilisateur authentifié + a l'autorisation d'accès accordée pour un certain fournisseur + d'autorisation et en tenant compte de certaines restrictions. + <code class="module"><a href="../mod/mod_authz_core.html">mod_authz_core</a></code> met à disposition les fournisseurs + d'autorisation génériques suivants :</p> + + <dl> + <dt><code>Require all granted</code></dt> + <dd>L'accès est autorisé sans restriction.</dd> + + <dt><code>Require all denied</code></dt> + <dd>L'accès est systématiquement refusé.</dd> + + <dt><code>Require env <var>env-var</var> [<var>env-var</var>] + ...</code></dt> + <dd>L'accès n'est autorisé que si l'une au moins des variables + d'environnement spécifiées est définie.</dd> + + <dt><code>Require method <var>http-method</var> [<var>http-method</var>] + ...</code></dt> + <dd>L'accès n'est autorisé que pour les méthodes HTTP spécifiées.</dd> + + <dt><code>Require expr <var>expression</var> </code></dt> + <dd>L'accès est autorisé si <var>expression</var> est évalué à + vrai.</dd> + </dl> + + <p>Voici quelques exemples de syntaxes autorisées par + <code class="module"><a href="../mod/mod_authz_user.html">mod_authz_user</a></code>, <code class="module"><a href="../mod/mod_authz_host.html">mod_authz_host</a></code> et + <code class="module"><a href="../mod/mod_authz_groupfile.html">mod_authz_groupfile</a></code> :</p> + + <dl> + <dt><code>Require user <var>identifiant utilisateur</var> + [<var>identifiant utilisateur</var>] + ...</code></dt> + <dd>Seuls les utilisateurs spécifiés auront accès à la + ressource.</dd> + + <dt><code>Require group <var>nom groupe</var> [<var>nom + groupe</var>] + ...</code></dt> + <dd>Seuls les utilisateurs appartenant aux groupes spécifiés + auront accès à la ressource.</dd> + + <dt><code>Require valid-user</code></dt> + <dd>Tous les utilisateurs valides auront accès à la + ressource.</dd> + + <dt><code>Require ip 10 172.20 192.168.2</code></dt> + <dd>Les clients dont les adresses IP font partie des tranches + spécifiées auront accès à la ressource.</dd> + </dl> + + <p>D'autres modules d'autorisation comme + <code class="module"><a href="../mod/mod_authnz_ldap.html">mod_authnz_ldap</a></code>, <code class="module"><a href="../mod/mod_authz_dbm.html">mod_authz_dbm</a></code>, + <code class="module"><a href="../mod/mod_authz_dbd.html">mod_authz_dbd</a></code>, + <code class="module"><a href="../mod/mod_authz_owner.html">mod_authz_owner</a></code> et <code class="module"><a href="../mod/mod_ssl.html">mod_ssl</a></code> + implémentent des options de la directive Require.</p> + + <p>Pour qu'une configuration d'authentification et d'autorisation + fonctionne correctement, la directive <code class="directive">Require</code> + doit être accompagnée dans la plupart des cas de directives <code class="directive"><a href="../mod/mod_authn_core.html#authname">AuthName</a></code>, <code class="directive"><a href="../mod/mod_authn_core.html#authtype">AuthType</a></code> et <code class="directive"><a href="../mod/mod_auth_basic.html#authbasicprovider">AuthBasicProvider</a></code> ou <code class="directive"><a href="../mod/mod_auth_digest.html#authdigestprovider">AuthDigestProvider</a></code>, ainsi que + de directives telles que <code class="directive"><a href="../mod/mod_authn_file.html#authuserfile">AuthUserFile</a></code> et <code class="directive"><a href="../mod/mod_authz_groupfile.html#authgroupfile">AuthGroupFile</a></code> (pour la + définition des utilisateurs et des groupes). Exemple :</p> + + <pre class="prettyprint lang-config"> +AuthType Basic +AuthName "Restricted Resource" +AuthBasicProvider file +AuthUserFile /web/users +AuthGroupFile /web/groups +Require group admin + </pre> + + + <p>Les contrôles d'accès appliqués de cette manière sont effectifs + pour <strong>toutes</strong> les méthodes. <strong>C'est en effet + ce que l'on souhaite en général.</strong> Si vous voulez n'appliquer + les contrôles d'accès qu'à certaines méthodes, tout en laissant les + autres méthodes sans protection, placez la directive + <code class="directive">Require</code> dans une section <code class="directive"><a href="../mod/core.html#limit"><Limit></a></code>.</p> + + <p>Le résultat de la directive <code class="directive">Require</code> peut + être inversé en utilisant l'option <code>not</code>. Comme dans le + cas de l'autre directive d'autorisation inversée <code class="directive"><RequireNone></code>, si la directive + <code class="directive">Require</code> est inversée, elle ne peut qu'échouer + ou produire un résultat neutre ; elle ne peut donc alors pas + autoriser une requête de manière indépendante.</p> + + <p>Dans l'exemple suivant, tous les utilisateurs appartenant aux + groupes <code>alpha</code> et <code>beta</code> ont l'autorisation + d'accès, à l'exception de ceux appartenant au groupe + <code>reject</code>.</p> + + <pre class="prettyprint lang-config"> +<Directory /www/docs> + <RequireAll> + Require group alpha beta + Require not group reject + </RequireAll> +</Directory> + </pre> + + + <p>Lorsque plusieurs directives <code class="directive">Require</code> sont + placées dans une même <a href="../sections.html#merging">section de + configuration</a>, et ne se trouvent pas dans une autre directive + d'autorisation comme <code class="directive"><a href="#requireall"><RequireAll></a></code>, elles sont implicitement + contenues dans une directive <code class="directive"><a href="#requireany"><RequireAny></a></code>. Ainsi, la première directive + <code class="directive">Require</code> qui autorise l'accès à un utilisateur + autorise l'accès pour l'ensemble de la requête, et les directives + <code class="directive">Require</code> suivantes sont ignorées.</p> + + <div class="warning"><h3>Avertissement à propos de la sécurité</h3> + <p>Prêtez une attention particulière aux directives d'autorisation + définies + au sein des sections <code class="directive"><a href="../mod/core.html#location">Location</a></code> + qui se chevauchent avec des contenus servis depuis le système de + fichiers. Par défaut, les configurations définies dans ces <a href="../sections.html#merging">sections</a> l'emportent sur les + configurations d'autorisations définies au sein des sections + <code class="directive"><a href="../mod/core.html#directory">Directory</a></code> et <code class="directive"><a href="../mod/core.html#files">Files</a></code>.</p> + <p>La directive <code class="directive"><a href="#authmerging">AuthMerging</a></code> permet de contrôler + la manière selon laquelle les configurations d'autorisations sont + fusionnées au sein des sections précitées.</p> + </div> + +<h3>Voir aussi</h3> +<ul> +<li><a href="../howto/auth.html">Authentification, autorisation et +contrôle d'accès</a></li> +<li><a href="#logic">Conteneurs d'autorisation</a></li> +<li><code class="module"><a href="../mod/mod_authn_core.html">mod_authn_core</a></code></li> +<li><code class="module"><a href="../mod/mod_authz_host.html">mod_authz_host</a></code></li> +</ul> +</div> +<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div> +<div class="directive-section"><h2><a name="RequireAll" id="RequireAll"><RequireAll></a> <a name="requireall" id="requireall">Directive</a></h2> +<table class="directive"> +<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Regroupe plusieurs directives d'autorisation dont aucune ne +doit échouer et dont au moins une doit retourner un résultat positif +pour que la directive globale retourne elle-même un résultat +positif.</td></tr> +<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code><RequireAll> ... </RequireAll></code></td></tr> +<tr><th><a href="directive-dict.html#Context">Contexte:</a></th><td>répertoire, .htaccess</td></tr> +<tr><th><a href="directive-dict.html#Override">AllowOverride:</a></th><td>AuthConfig</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_authz_core</td></tr> +</table> + <p>Les balises <code class="directive"><RequireAll></code> et + <code></RequireAll></code> permettent de regrouper des + directives d'autorisation dont aucune ne doit échouer, et dont au + moins une doit retourner un résultat positif pour que la directive + <code class="directive"><RequireAll></code> retourne elle-même + un résultat positif.</p> + + <p>Si aucune des directives contenues dans la directive <code class="directive"><RequireAll></code> n'échoue, et si au moins une + retourne un résultat positif, alors la directive <code class="directive"><RequireAll></code> retourne elle-même un résultat + positif. Si aucune ne retourne un résultat positif, et si aucune + n'échoue, la directive globale retourne un résultat neutre. Dans + tous les autres cas, elle échoue.</p> + +<h3>Voir aussi</h3> +<ul> +<li><a href="#logic">Conteneurs d'autorisation</a></li> +<li><a href="../howto/auth.html">Authentification, autorisation et +contrôle d'accès</a></li> +</ul> +</div> +<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div> +<div class="directive-section"><h2><a name="RequireAny" id="RequireAny"><RequireAny></a> <a name="requireany" id="requireany">Directive</a></h2> +<table class="directive"> +<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Regroupe des directives d'autorisation dont au moins une +doit retourner un résultat positif pour que la directive globale +retourne elle-même un résultat positif.</td></tr> +<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code><RequireAny> ... </RequireAny></code></td></tr> +<tr><th><a href="directive-dict.html#Context">Contexte:</a></th><td>répertoire, .htaccess</td></tr> +<tr><th><a href="directive-dict.html#Override">AllowOverride:</a></th><td>AuthConfig</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_authz_core</td></tr> +</table> + <p>Les balises <code class="directive"><RequireAny></code> et + <code></RequireAny></code> permettent de regrouper des + directives d'autorisation dont au moins une doit retourner un + résultat positif pour que la directive <code class="directive"><RequireAny></code> retourne elle-même un résultat + positif.</p> + + <p>Si une ou plusieurs directives contenues dans la directive + <code class="directive"><RequireAny></code> retournent un + résultat positif, alors la directive <code class="directive"><RequireAny></code> retourne elle-même un résultat + positif. Si aucune ne retourne un résultat positif et aucune + n'échoue, la directive globale retourne un résultat neutre. Dans + tous les autres cas, elle échoue.</p> + + <div class="note">Comme les directives d'autorisation inversées sont incapables + de retourner un résultat positif, elles ne peuvent pas impacter de + manière significative le résultat d'une directive <code class="directive"><RequireAny></code> (elles pourraient tout au plus + faire échouer la directive dans le cas où elles échoueraient + elles-mêmes, et où + toutes les autres directives retourneraient un résultat neutre). + C'est pourquoi il n'est pas permis d'utiliser les directives + d'autorisation inversées dans une directive <code class="directive"><RequireAny></code>.</div> + +<h3>Voir aussi</h3> +<ul> +<li><a href="#logic">Conteneurs d'autorisation</a></li> +<li><a href="../howto/auth.html">Authentification, autorisation et +contrôle d'accès</a></li> +</ul> +</div> +<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div> +<div class="directive-section"><h2><a name="RequireNone" id="RequireNone"><RequireNone></a> <a name="requirenone" id="requirenone">Directive</a></h2> +<table class="directive"> +<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Regroupe des directives d'autorisation dont aucune ne doit +retourner un résultat positif pour que la directive globale n'échoue +pas.</td></tr> +<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code><RequireNone> ... </RequireNone></code></td></tr> +<tr><th><a href="directive-dict.html#Context">Contexte:</a></th><td>répertoire, .htaccess</td></tr> +<tr><th><a href="directive-dict.html#Override">AllowOverride:</a></th><td>AuthConfig</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_authz_core</td></tr> +</table> + <p>Les balises <code class="directive"><RequireNone></code> et + <code></RequireNone></code> permettent de regrouper des + directives d'autorisation dont aucune ne doit retourner un résultat + positif pour que la directive <code class="directive"><RequireNone></code> n'échoue pas.</p> + + <p>Si une ou plusieurs directives contenues dans la directive + <code class="directive"><RequireNone></code> retournent un + résultat positif, la directive <code class="directive"><RequireNone></code> échouera. Dans tous les + autres cas, cette dernière retournera un résultat neutre. Ainsi, + comme pour la directive d'autorisation inversée <code>Require + not</code>, elle ne peut jamais autoriser une requête de manière + indépendante car elle ne pourra jamais retourner un résultat + positif. Par contre, on peut l'utiliser pour restreindre l'ensemble + des utilisateurs autorisés à accéder à une ressource.</p> + + <div class="note">Comme les directives d'autorisation inversées sont incapables + de retourner un résultat positif, elles ne peuvent pas impacter de + manière significative le résultat d'une directive <code class="directive"><RequireNone></code>. + C'est pourquoi il n'est pas permis d'utiliser les directives + d'autorisation inversées dans une directive <code class="directive"><RequireNone></code>.</div> + +<h3>Voir aussi</h3> +<ul> +<li><a href="#logic">Conteneurs d'autorisation</a></li> +<li><a href="../howto/auth.html">Authentification, autorisation et +contrôle d'accès</a></li> +</ul> +</div> +</div> +<div class="bottomlang"> +<p><span>Langues Disponibles: </span><a href="../en/mod/mod_authz_core.html" hreflang="en" rel="alternate" title="English"> en </a> | +<a href="../fr/mod/mod_authz_core.html" title="Français"> fr </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/2.4/mod/mod_authz_core.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 2013 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/directives.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 diff --git a/docs/manual/mod/mod_authz_core.xml.fr b/docs/manual/mod/mod_authz_core.xml.fr new file mode 100644 index 0000000000..b1f56ed6c2 --- /dev/null +++ b/docs/manual/mod/mod_authz_core.xml.fr @@ -0,0 +1,648 @@ +<?xml version="1.0"?> +<!DOCTYPE modulesynopsis SYSTEM "../style/modulesynopsis.dtd"> +<?xml-stylesheet type="text/xsl" href="../style/manual.fr.xsl"?> +<!-- English Revision : 1434107 --> +<!-- 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_authz_core.xml.meta"> + +<name>mod_authz_core</name> +<description>Autorisation basique</description> +<status>Base</status> +<sourcefile>mod_authz_core.c</sourcefile> +<identifier>authz_core_module</identifier> +<compatibility>Disponible depuis la version 2.3 +d'Apache HTTPD</compatibility> + +<summary> + <p>Ce module fournit des fonctionnalités d'autorisation basiques + permettant d'accorder ou refuser l'accès à certaines zones du site + web aux utilisateurs authentifiés. <module>mod_authz_core</module> + donne la possibilité d'enregistrer divers fournisseurs + d'autorisation. Il est en général utilisé avec un module fournisseur + d'authentification comme <module>mod_authn_file</module>, et un + module d'autorisation comme <module>mod_authz_user</module>. Il + permet aussi l'application d'une logique élaborée au déroulement du + processus d'autorisation.</p> +</summary> + +<section id="authzalias"><title>Création des alias du fournisseur +d'autorisation</title> + + <p>Il est possible de créer des fournisseurs d'autorisation étendus + dans le fichier de configuration et de leur assigner un nom d'alias. + On peut ensuite utiliser ces fournisseurs aliasés dans une + directive <directive module="mod_authz_core">Require</directive> de + la même manière qu'on le ferait pour des fournisseurs d'autorisation + de base. En plus de la possibilité de créer et d'aliaser un + fournisseur étendu, le même fournisseur d'autorisation étendu peut + être utilisé pour contrôler l'accès à plusieurs localisations. + </p> + + <section id="example"><title>Exemple</title> + <p>Dans l'exemple suivant, on crée deux alias de fournisseur + d'autorisation ldap différents basés sur le fournisseur + d'autorisation ldap-group. Il est ainsi possible pour un seul + répertoire de vérifier l'appartenance à un groupe au niveau de + plusieurs serveurs ldap : + </p> + + <highlight language="config"> +<AuthzProviderAlias ldap-group ldap-group-alias1 cn=my-group,o=ctx> + AuthLDAPBindDN cn=monutilisateur,o=ctx + AuthLDAPBindPassword monmotdepasse + AuthLDAPURL ldap://serveur.ldap/o=ctx +</AuthzProviderAlias> + +<AuthzProviderAlias ldap-group ldap-group-alias2 cn=my-other-group,o=dev> + AuthLDAPBindDN cn=monautreutilisateur,o=dev + AuthLDAPBindPassword monsecondmotdepasse + AuthLDAPURL ldap://autre.serveur.ldap/o=dev?cn +</AuthzProviderAlias> + +Alias /secure /webpages/secure +<Directory /webpages/secure> + Require all granted + + AuthBasicProvider file + + AuthType Basic + AuthName LDAP_Protected_Place + + #Implicitement, c'est l'un OU l'autre + Require ldap-group-alias1 + Require ldap-group-alias2 +</Directory> + </highlight> + </section> + +</section> + +<section id="logic"><title>Conteneurs d'autorisation</title> + + <p>Les directives de conteneur d'autorisation <directive + module="mod_authz_core" type="section">RequireAll</directive>, + <directive module="mod_authz_core" + type="section">RequireAny</directive> et <directive + module="mod_authz_core" type="section">RequireNone</directive> + peuvent être combinées entre elles et avec la directive <directive + module="mod_authz_core">Require</directive> pour élaborer une + logique d'autorisation complexe.</p> + + <p>L'exemple ci-dessous illustre la logique d'autorisation suivante. + Pour pouvoir accéder à la ressource, l'utilisateur doit être + l'utilisateur <code>superadmin</code>, ou appartenir aux deux + groupes LDAP <code>admins</code> et <code>Administrateurs</code> et + soit appartenir au groupe <code>ventes</code> ou avoir + <code>ventes</code> comme valeur de l'attribut LDAP + <code>dept</code>. De plus, pour pouvoir accéder à la ressource, + l'utilisateur ne doit appartenir ni au groupe <code>temps</code>, ni + au groupe LDAP <code>Employes temporaires</code>.</p> + + <highlight language="config"> +<Directory /www/mydocs> + <RequireAll> + <RequireAny> + Require user superadmin + <RequireAll> + Require group admins + Require ldap-group cn=Administrators,o=Airius + <RequireAny> + Require group ventes + Require ldap-attribute dept="ventes" + </RequireAny> + </RequireAll> + </RequireAny> + <RequireNone> + Require group temps + Require ldap-group cn=Employes Temporaires,o=Airius + </RequireNone> + </RequireAll> +</Directory> + </highlight> +</section> + +<section id="requiredirectives"><title>Les directives Require</title> + + <p>Le module <module>mod_authz_core</module> met à disposition des + fournisseurs d'autorisation génériques utilisables avec la directive + <directive module="mod_authz_core">Require</directive>.</p> + + <section id="reqenv"><title>Require env</title> + + <p>Le fournisseur <code>env</code> permet de contrôler l'accès au + serveur en fonction de l'existence d'une <a + href="../env.html">variable d'environnement</a>. Lorsque <code>Require + env <var>env-variable</var></code> est spécifié, la requête se voit + autoriser l'accès si la variable d'environnement + <var>env-variable</var> existe. Le serveur permet de définir + facilement des variables d'environnement en fonction des + caractéristiques de la requête du client via les directives fournies + par le module <module>mod_setenvif</module>. Cette directive Require + env permet donc de contrôler l'accès en fonction des + valeurs des en-têtes de la requête HTTP tels que + <code>User-Agent</code> (type de navigateur), <code>Referer</code>, + entre autres.</p> + + <highlight language="config"> +SetEnvIf User-Agent ^KnockKnock/2\.0 let_me_in +<Directory /docroot> + Require env let_me_in +</Directory> + </highlight> + + <p>Avec cet exemple, les navigateurs dont la chaîne user-agent + commence par <code>KnockKnock/2.0</code> se verront autoriser + l'accès, alors que tous les autres seront rejetés.</p> + + </section> + + <section id="reqall"><title>Require all</title> + + <p>Le fournisseur <code>all</code> reproduit la fonctionnalité + précédemment fournie par les directives 'Allow from all' et 'Deny + from all'. Il accepte un argument dont les deux valeurs possibles + sont : 'granted' ou 'denied'. Les exemples suivants autorisent ou + interdisent l'accès à toutes les requêtes.</p> + + <highlight language="config"> + Require all granted + </highlight> + + <highlight language="config"> + Require all denied + </highlight> + + </section> + + <section id="reqmethod"><title>Require method</title> + + <p>Le fournisseur <code>method</code> permet d'utiliser la méthode + HTTP dans le processus d'autorisation. Les méthodes GET et HEAD sont + ici considérées comme équivalentes. La méthode TRACE n'est pas + supportée par ce fournisseur ; utilisez à la place la directive + <directive module="core">TraceEnable</directive>.</p> + + <p>Dans l'exemple suivant, seules les méthodes GET, HEAD, POST, et + OPTIONS sont autorisées :</p> + + <highlight language="config"> + Require method GET POST OPTIONS + </highlight> + + <p>Dans l'exemple suivant, les méthodes GET, HEAD, POST, et OPTIONS + sont autorisées sans authentification, alors que toutes les autres + méthodes nécessitent un utilisateur valide :</p> + + <highlight language="config"> +<RequireAny> + Require method GET POST OPTIONS + Require valid-user +</RequireAny> + </highlight> + + </section> + <section id="reqexpr"><title>Require expr</title> + + <p>Le fournisseur <code>expr</code> permet d'accorder l'autorisation + d'accès en fonction d'expressions arbitraires.</p> + + <highlight language="config"> + Require expr %{TIME_HOUR} -ge 9 && %{TIME_HOUR} -le 17 + </highlight> + + <p>La syntaxe de l'expression est décrite dans la documentation de <a + href="../expr.html">ap_expr</a>.</p> + + <p>Normalement, l'expression est évaluée avant l'authentification. + Cependant, si l'expression renvoie false et se réfère à la variable + <code>%{REMOTE_USER}</code>, le processus d'authentification sera + engagé et l'expression réévaluée.</p> + + </section> + +</section> + +<directivesynopsis> +<name>Require</name> +<description>Vérifie si un utilisateur authentifié a une +autorisation d'accès accordée par un fournisseur +d'autorisation.</description> +<syntax>Require [not] <var>nom-entité</var> [<var>nom-entité</var>] +...</syntax> +<contextlist><context>directory</context><context>.htaccess</context> +</contextlist> +<override>AuthConfig</override> + +<usage> + <p>Cette directive permet de vérifier si un utilisateur authentifié + a l'autorisation d'accès accordée pour un certain fournisseur + d'autorisation et en tenant compte de certaines restrictions. + <module>mod_authz_core</module> met à disposition les fournisseurs + d'autorisation génériques suivants :</p> + + <dl> + <dt><code>Require all granted</code></dt> + <dd>L'accès est autorisé sans restriction.</dd> + + <dt><code>Require all denied</code></dt> + <dd>L'accès est systématiquement refusé.</dd> + + <dt><code>Require env <var>env-var</var> [<var>env-var</var>] + ...</code></dt> + <dd>L'accès n'est autorisé que si l'une au moins des variables + d'environnement spécifiées est définie.</dd> + + <dt><code>Require method <var>http-method</var> [<var>http-method</var>] + ...</code></dt> + <dd>L'accès n'est autorisé que pour les méthodes HTTP spécifiées.</dd> + + <dt><code>Require expr <var>expression</var> </code></dt> + <dd>L'accès est autorisé si <var>expression</var> est évalué à + vrai.</dd> + </dl> + + <p>Voici quelques exemples de syntaxes autorisées par + <module>mod_authz_user</module>, <module>mod_authz_host</module> et + <module>mod_authz_groupfile</module> :</p> + + <dl> + <dt><code>Require user <var>identifiant utilisateur</var> + [<var>identifiant utilisateur</var>] + ...</code></dt> + <dd>Seuls les utilisateurs spécifiés auront accès à la + ressource.</dd> + + <dt><code>Require group <var>nom groupe</var> [<var>nom + groupe</var>] + ...</code></dt> + <dd>Seuls les utilisateurs appartenant aux groupes spécifiés + auront accès à la ressource.</dd> + + <dt><code>Require valid-user</code></dt> + <dd>Tous les utilisateurs valides auront accès à la + ressource.</dd> + + <dt><code>Require ip 10 172.20 192.168.2</code></dt> + <dd>Les clients dont les adresses IP font partie des tranches + spécifiées auront accès à la ressource.</dd> + </dl> + + <p>D'autres modules d'autorisation comme + <module>mod_authnz_ldap</module>, <module>mod_authz_dbm</module>, + <module>mod_authz_dbd</module>, + <module>mod_authz_owner</module> et <module>mod_ssl</module> + implémentent des options de la directive Require.</p> + + <p>Pour qu'une configuration d'authentification et d'autorisation + fonctionne correctement, la directive <directive>Require</directive> + doit être accompagnée dans la plupart des cas de directives <directive + module="mod_authn_core">AuthName</directive>, <directive + module="mod_authn_core">AuthType</directive> et <directive + module="mod_auth_basic">AuthBasicProvider</directive> ou <directive + module="mod_auth_digest">AuthDigestProvider</directive>, ainsi que + de directives telles que <directive + module="mod_authn_file">AuthUserFile</directive> et <directive + module="mod_authz_groupfile">AuthGroupFile</directive> (pour la + définition des utilisateurs et des groupes). Exemple :</p> + + <highlight language="config"> +AuthType Basic +AuthName "Restricted Resource" +AuthBasicProvider file +AuthUserFile /web/users +AuthGroupFile /web/groups +Require group admin + </highlight> + + <p>Les contrôles d'accès appliqués de cette manière sont effectifs + pour <strong>toutes</strong> les méthodes. <strong>C'est en effet + ce que l'on souhaite en général.</strong> Si vous voulez n'appliquer + les contrôles d'accès qu'à certaines méthodes, tout en laissant les + autres méthodes sans protection, placez la directive + <directive>Require</directive> dans une section <directive + module="core" type="section">Limit</directive>.</p> + + <p>Le résultat de la directive <directive>Require</directive> peut + être inversé en utilisant l'option <code>not</code>. Comme dans le + cas de l'autre directive d'autorisation inversée <directive + type="section">RequireNone</directive>, si la directive + <directive>Require</directive> est inversée, elle ne peut qu'échouer + ou produire un résultat neutre ; elle ne peut donc alors pas + autoriser une requête de manière indépendante.</p> + + <p>Dans l'exemple suivant, tous les utilisateurs appartenant aux + groupes <code>alpha</code> et <code>beta</code> ont l'autorisation + d'accès, à l'exception de ceux appartenant au groupe + <code>reject</code>.</p> + + <highlight language="config"> +<Directory /www/docs> + <RequireAll> + Require group alpha beta + Require not group reject + </RequireAll> +</Directory> + </highlight> + + <p>Lorsque plusieurs directives <directive>Require</directive> sont + placées dans une même <a href="../sections.html#merging">section de + configuration</a>, et ne se trouvent pas dans une autre directive + d'autorisation comme <directive module="mod_authz_core" + type="section">RequireAll</directive>, elles sont implicitement + contenues dans une directive <directive module="mod_authz_core" + type="section">RequireAny</directive>. Ainsi, la première directive + <directive>Require</directive> qui autorise l'accès à un utilisateur + autorise l'accès pour l'ensemble de la requête, et les directives + <directive>Require</directive> suivantes sont ignorées.</p> + + <note type="warning"><title>Avertissement à propos de la sécurité</title> + <p>Prêtez une attention particulière aux directives d'autorisation + définies + au sein des sections <directive module="core">Location</directive> + qui se chevauchent avec des contenus servis depuis le système de + fichiers. Par défaut, les configurations définies dans ces <a + href="../sections.html#merging">sections</a> l'emportent sur les + configurations d'autorisations définies au sein des sections + <directive module="core">Directory</directive> et <directive + module="core">Files</directive>.</p> + <p>La directive <directive + module="mod_authz_core">AuthMerging</directive> permet de contrôler + la manière selon laquelle les configurations d'autorisations sont + fusionnées au sein des sections précitées.</p> + </note> +</usage> + + +<seealso><a href="../howto/auth.html">Authentification, autorisation et +contrôle d'accès</a></seealso> +<seealso><a href="#logic">Conteneurs d'autorisation</a></seealso> +<seealso><module>mod_authn_core</module></seealso> +<seealso><module>mod_authz_host</module></seealso> +</directivesynopsis> + +<directivesynopsis type="section"> +<name>RequireAll</name> +<description>Regroupe plusieurs directives d'autorisation dont aucune ne +doit échouer et dont au moins une doit retourner un résultat positif +pour que la directive globale retourne elle-même un résultat +positif.</description> +<syntax><RequireAll> ... </RequireAll></syntax> +<contextlist><context>directory</context><context>.htaccess</context> +</contextlist> +<override>AuthConfig</override> + +<usage> + <p>Les balises <directive type="section">RequireAll</directive> et + <code></RequireAll></code> permettent de regrouper des + directives d'autorisation dont aucune ne doit échouer, et dont au + moins une doit retourner un résultat positif pour que la directive + <directive type="section">RequireAll</directive> retourne elle-même + un résultat positif.</p> + + <p>Si aucune des directives contenues dans la directive <directive + type="section">RequireAll</directive> n'échoue, et si au moins une + retourne un résultat positif, alors la directive <directive + type="section">RequireAll</directive> retourne elle-même un résultat + positif. Si aucune ne retourne un résultat positif, et si aucune + n'échoue, la directive globale retourne un résultat neutre. Dans + tous les autres cas, elle échoue.</p> +</usage> + +<seealso><a href="#logic">Conteneurs d'autorisation</a></seealso> +<seealso><a href="../howto/auth.html">Authentification, autorisation et +contrôle d'accès</a></seealso> + +</directivesynopsis> + +<directivesynopsis type="section"> +<name>RequireAny</name> +<description>Regroupe des directives d'autorisation dont au moins une +doit retourner un résultat positif pour que la directive globale +retourne elle-même un résultat positif.</description> +<syntax><RequireAny> ... </RequireAny></syntax> +<contextlist><context>directory</context><context>.htaccess</context> +</contextlist> +<override>AuthConfig</override> + +<usage> + <p>Les balises <directive type="section">RequireAny</directive> et + <code></RequireAny></code> permettent de regrouper des + directives d'autorisation dont au moins une doit retourner un + résultat positif pour que la directive <directive + type="section">RequireAny</directive> retourne elle-même un résultat + positif.</p> + + <p>Si une ou plusieurs directives contenues dans la directive + <directive type="section">RequireAny</directive> retournent un + résultat positif, alors la directive <directive + type="section">RequireAny</directive> retourne elle-même un résultat + positif. Si aucune ne retourne un résultat positif et aucune + n'échoue, la directive globale retourne un résultat neutre. Dans + tous les autres cas, elle échoue.</p> + + <note>Comme les directives d'autorisation inversées sont incapables + de retourner un résultat positif, elles ne peuvent pas impacter de + manière significative le résultat d'une directive <directive + type="section">RequireAny</directive> (elles pourraient tout au plus + faire échouer la directive dans le cas où elles échoueraient + elles-mêmes, et où + toutes les autres directives retourneraient un résultat neutre). + C'est pourquoi il n'est pas permis d'utiliser les directives + d'autorisation inversées dans une directive <directive + type="section">RequireAny</directive>.</note> +</usage> + +<seealso><a href="#logic">Conteneurs d'autorisation</a></seealso> +<seealso><a href="../howto/auth.html">Authentification, autorisation et +contrôle d'accès</a></seealso> + +</directivesynopsis> + +<directivesynopsis type="section"> +<name>RequireNone</name> +<description>Regroupe des directives d'autorisation dont aucune ne doit +retourner un résultat positif pour que la directive globale n'échoue +pas.</description> +<syntax><RequireNone> ... </RequireNone></syntax> +<contextlist><context>directory</context><context>.htaccess</context> +</contextlist> +<override>AuthConfig</override> + +<usage> + <p>Les balises <directive type="section">RequireNone</directive> et + <code></RequireNone></code> permettent de regrouper des + directives d'autorisation dont aucune ne doit retourner un résultat + positif pour que la directive <directive + type="section">RequireNone</directive> n'échoue pas.</p> + + <p>Si une ou plusieurs directives contenues dans la directive + <directive type="section">RequireNone</directive> retournent un + résultat positif, la directive <directive + type="section">RequireNone</directive> échouera. Dans tous les + autres cas, cette dernière retournera un résultat neutre. Ainsi, + comme pour la directive d'autorisation inversée <code>Require + not</code>, elle ne peut jamais autoriser une requête de manière + indépendante car elle ne pourra jamais retourner un résultat + positif. Par contre, on peut l'utiliser pour restreindre l'ensemble + des utilisateurs autorisés à accéder à une ressource.</p> + + <note>Comme les directives d'autorisation inversées sont incapables + de retourner un résultat positif, elles ne peuvent pas impacter de + manière significative le résultat d'une directive <directive + type="section">RequireNone</directive>. + C'est pourquoi il n'est pas permis d'utiliser les directives + d'autorisation inversées dans une directive <directive + type="section">RequireNone</directive>.</note> +</usage> + +<seealso><a href="#logic">Conteneurs d'autorisation</a></seealso> +<seealso><a href="../howto/auth.html">Authentification, autorisation et +contrôle d'accès</a></seealso> + +</directivesynopsis> + +<directivesynopsis> +<name>AuthMerging</name> +<description>Définit la manière dont chaque logique d'autorisation des +sections de configuration se combine avec celles des sections de +configuration précédentes.</description> +<syntax>AuthMerging Off | And | Or</syntax> +<default>AuthMerging Off</default> +<contextlist><context>directory</context><context>.htaccess</context> +</contextlist> +<override>AuthConfig</override> + +<usage> + <p>Lorsque l'autorisation est activée, elle est normalement héritée + par chaque <a href="../sections.html#merging">section de + configuration</a> suivante, à moins qu'un jeu de directives + d'autorisations différent ne soit spécifié. Il s'agit du + comportement par défaut, qui correspond à la définition explicite + <code>AuthMerging Off</code>.</p> + + <p>Dans certaines situations cependant, il peut être souhaitable de + combiner la logique d'autorisation d'une section de configuration + avec celle de la section précédente lorsque les sections de + configuration se combinent entre elles. Dans ce cas, deux options + sont disponibles, <code>And</code> et <code>Or</code>.</p> + + <p>Lorsqu'une section de configuration contient <code>AuthMerging + And</code> ou <code>AuthMerging Or</code>, sa logique d'autorisation + se combine avec celle de la section de configuration qui la précède + (selon l'ordre général des sections de configuration), et qui + contient aussi une logique d'autorisation, comme si les deux + sections étaient concaténées respectivement dans une directive + <directive module="mod_authz_core" + type="section">RequireAll</directive> ou <directive + module="mod_authz_core" type="section">RequireAny</directive>.</p> + + <note>La définition de la directive + <directive>AuthMerging</directive> ne concerne que la section de + configuration dans laquelle elle apparaît. Dans l'exemple suivant, + seuls les utilisateurs appartenant au groupe <code>alpha</code> sont + autorisés à accéder à <code>/www/docs</code>. Les utilisateurs + appartenant au groupe <code>alpha</code> ou au groupe + <code>beta</code> sont autorisés à accéder à + <code>/www/docs/ab</code>. Cependant, la définition implicite à + <code>Off</code> de la directive <directive>AuthMerging</directive> + s'applique à la section de configuration <directive type="section" + module="core">Directory</directive> concernant le répertoire + <code>/www/docs/ab/gamma</code>, ce qui implique que les directives + d'autorisation de cette section l'emportent sur celles des sections + précédentes. Par voie de conséquence, seuls les utilisateurs + appartenant au groupe <code>gamma</code> sont autorisés à accéder à + <code>/www/docs/ab/gamma</code>.</note> + + <highlight language="config"> +<Directory /www/docs> + AuthType Basic + AuthName Documents + AuthBasicProvider file + AuthUserFile /usr/local/apache/passwd/passwords + Require group alpha +</Directory> + +<Directory /www/docs/ab> + AuthMerging Or + Require group beta +</Directory> + +<Directory /www/docs/ab/gamma> + Require group gamma +</Directory> + </highlight> +</usage> + +</directivesynopsis> + +<directivesynopsis type="section"> +<name>AuthzProviderAlias</name> +<description>Regroupe des directives représentant une extension d'un +fournisseur d'autorisation de base qui pourra être référencée à l'aide +de l'alias spécifié</description> +<syntax><AuthzProviderAlias <var>fournisseur-de-base Alias +Paramètres-Require</var>> +... </AuthzProviderAlias> +</syntax> +<contextlist><context>server config</context> +</contextlist> + +<usage> + <p>Les balises <directive + type="section">AuthzProviderAlias</directive> et + <code></AuthzProviderAlias></code> permettent de regrouper des + directives d'autorisation auxquelles on pourra faire référence à + l'aide de l'alias spécifié dans une directive <directive + module="mod_authz_core">Require</directive>.</p> + +</usage> +</directivesynopsis> + +<directivesynopsis> +<name>AuthzSendForbiddenOnFailure</name> +<description>Envoie '403 FORBIDDEN' au lieu de '401 UNAUTHORIZED' si +l'authentification réussit et si l'autorisation a été refusée. +</description> +<syntax>AuthzSendForbiddenOnFailure On|Off</syntax> +<default>AuthzSendForbiddenOnFailure Off</default> +<contextlist><context>directory</context><context>.htaccess</context> +</contextlist> +<compatibility>Disponible depuis la version 2.3.11 d'Apache HTTPD</compatibility> + +<usage> + <p>Par défaut, si l'authentification réussit, alors que + l'autorisation est refusée, Apache HTTPD renvoie un code de réponse + HTTP '401 UNAUTHORIZED'. En général, les navigateurs proposent alors + une nouvelle fois à l'utilisateur la boîte de dialogue de saisie du + mot de passe, ce qui n'est pas toujours souhaitable. La directive + <directive>AuthzSendForbiddenOnFailure</directive> permet de changer + le code de réponse en '403 FORBIDDEN'.</p> + + <note type="warning"><title>Avertissement de sécurité</title> + <p>La modification de la réponse en cas de refus d'autorisation + diminue la sécurité du mot de passe, car elle indique à un éventuel + attaquant que le mot de passe qu'il a saisi était correct.</p> + </note> +</usage> +</directivesynopsis> + +</modulesynopsis> diff --git a/docs/manual/mod/mod_authz_core.xml.meta b/docs/manual/mod/mod_authz_core.xml.meta index 6f3ad4cf8f..5023ce74e3 100644 --- a/docs/manual/mod/mod_authz_core.xml.meta +++ b/docs/manual/mod/mod_authz_core.xml.meta @@ -8,5 +8,6 @@ <variants> <variant>en</variant> + <variant>fr</variant> </variants> </metafile> diff --git a/docs/manual/mod/mod_cern_meta.html b/docs/manual/mod/mod_cern_meta.html index 658786398e..ce935a92f1 100644 --- a/docs/manual/mod/mod_cern_meta.html +++ b/docs/manual/mod/mod_cern_meta.html @@ -4,6 +4,10 @@ URI: mod_cern_meta.html.en Content-Language: en Content-type: text/html; charset=ISO-8859-1 +URI: mod_cern_meta.html.fr +Content-Language: fr +Content-type: text/html; charset=ISO-8859-1 + URI: mod_cern_meta.html.ko.euc-kr Content-Language: ko Content-type: text/html; charset=EUC-KR diff --git a/docs/manual/mod/mod_cern_meta.html.en b/docs/manual/mod/mod_cern_meta.html.en index 6ad5bb3e8a..1caf116460 100644 --- a/docs/manual/mod/mod_cern_meta.html.en +++ b/docs/manual/mod/mod_cern_meta.html.en @@ -25,6 +25,7 @@ <div id="preamble"><h1>Apache Module mod_cern_meta</h1> <div class="toplang"> <p><span>Available Languages: </span><a href="../en/mod/mod_cern_meta.html" title="English"> en </a> | +<a href="../fr/mod/mod_cern_meta.html" hreflang="fr" rel="alternate" title="Français"> fr </a> | <a href="../ko/mod/mod_cern_meta.html" hreflang="ko" rel="alternate" title="Korean"> ko </a></p> </div> <table class="module"><tr><th><a href="module-dict.html#Description">Description:</a></th><td>CERN httpd metafile semantics</td></tr> @@ -127,6 +128,7 @@ meta information</td></tr> </div> <div class="bottomlang"> <p><span>Available Languages: </span><a href="../en/mod/mod_cern_meta.html" title="English"> en </a> | +<a href="../fr/mod/mod_cern_meta.html" hreflang="fr" rel="alternate" title="Français"> fr </a> | <a href="../ko/mod/mod_cern_meta.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">Comments</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[//><!-- diff --git a/docs/manual/mod/mod_cern_meta.html.fr b/docs/manual/mod/mod_cern_meta.html.fr new file mode 100644 index 0000000000..77a19f75d8 --- /dev/null +++ b/docs/manual/mod/mod_cern_meta.html.fr @@ -0,0 +1,162 @@ +<?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><!-- + XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX + This file is generated from xml source: DO NOT EDIT + XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX + --> +<title>mod_cern_meta - Serveur Apache HTTP</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.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/directives.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.4</p> +<img alt="" src="../images/feather.gif" /></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.4</a> > <a href="./">Modules</a></div> +<div id="page-content"> +<div id="preamble"><h1>Module Apache mod_cern_meta</h1> +<div class="toplang"> +<p><span>Langues Disponibles: </span><a href="../en/mod/mod_cern_meta.html" hreflang="en" rel="alternate" title="English"> en </a> | +<a href="../fr/mod/mod_cern_meta.html" title="Français"> fr </a> | +<a href="../ko/mod/mod_cern_meta.html" hreflang="ko" rel="alternate" title="Korean"> ko </a></p> +</div> +<table class="module"><tr><th><a href="module-dict.html#Description">Description:</a></th><td>La sémantique des métafichiers du serveur httpd du +CERN</td></tr> +<tr><th><a href="module-dict.html#Status">Statut:</a></th><td>Extension</td></tr> +<tr><th><a href="module-dict.html#ModuleIdentifier">Identificateur de Module:</a></th><td>cern_meta_module</td></tr> +<tr><th><a href="module-dict.html#SourceFile">Fichier Source:</a></th><td>mod_cern_meta.c</td></tr></table> +<h3>Sommaire</h3> + + <p>Il s'agit d'une émulation de la sémantique des métafichiers du + serveur httpd du CERN. Les métafichiers consistent en en-têtes HTTP + qui peuvent s'ajouter au jeu d'en-têtes habituels pour chaque + fichier accédé. Ils ressemblent beaucoup aux fichiers .asis + d'Apache, et permettent d'influencer de manière rudimentaire + l'en-tête Expires:, ainsi que d'autres curiosités. Il existe de + nombreuses méthodes pour gérer les métainformations, mais le choix + s'est porté sur celle-ci car il existe déjà un grand nombre + d'utilisateurs du CERN qui peuvent exploiter ce module.</p> + + <p>Pour plus d'information, voir le document sur la <a href="http://www.w3.org/pub/WWW/Daemon/User/Config/General.html#MetaDir">sémantique des métafichiers du CERN</a>.</p> +</div> +<div id="quickview"><h3 class="directives">Directives</h3> +<ul id="toc"> +<li><img alt="" src="../images/down.gif" /> <a href="#metadir">MetaDir</a></li> +<li><img alt="" src="../images/down.gif" /> <a href="#metafiles">MetaFiles</a></li> +<li><img alt="" src="../images/down.gif" /> <a href="#metasuffix">MetaSuffix</a></li> +</ul> +<h3>Voir aussi</h3> +<ul class="seealso"> +<li><code class="module"><a href="../mod/mod_headers.html">mod_headers</a></code></li> +<li><code class="module"><a href="../mod/mod_asis.html">mod_asis</a></code></li> +</ul><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="directive-section"><h2><a name="MetaDir" id="MetaDir">MetaDir</a> <a name="metadir" id="metadir">Directive</a></h2> +<table class="directive"> +<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Le nom du répertoire où trouver les fichiers de +métainformations dans le style du CERN</td></tr> +<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>MetaDir <var>répertoire</var></code></td></tr> +<tr><th><a href="directive-dict.html#Default">Défaut:</a></th><td><code>MetaDir .web</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>Indexes</td></tr> +<tr><th><a href="directive-dict.html#Status">Statut:</a></th><td>Extension</td></tr> +<tr><th><a href="directive-dict.html#Module">Module:</a></th><td>mod_cern_meta</td></tr> +</table> + <p>Spécifie le nom du répertoire dans lequel Apache pourra trouver + les fichiers de métainformations. Ce répertoire est en général un + sous-répertoire 'caché' du répertoire qui contient le fichier à + accéder. Définissez cette directive à "<code>.</code>" pour + rechercher les métafichiers dans le même répertoire que le fichier à + accéder :</p> + + <pre class="prettyprint lang-config">MetaDir .</pre> + + + <p>Ou, pour rechercher dans un sous-répertoire du répertoire + contenant le fichier à accéder :</p> + + <pre class="prettyprint lang-config">MetaDir .meta</pre> + + +</div> +<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div> +<div class="directive-section"><h2><a name="MetaFiles" id="MetaFiles">MetaFiles</a> <a name="metafiles" id="metafiles">Directive</a></h2> +<table class="directive"> +<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Active le traitement des métafichiers du CERN</td></tr> +<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>MetaFiles on|off</code></td></tr> +<tr><th><a href="directive-dict.html#Default">Défaut:</a></th><td><code>MetaFiles 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>Indexes</td></tr> +<tr><th><a href="directive-dict.html#Status">Statut:</a></th><td>Extension</td></tr> +<tr><th><a href="directive-dict.html#Module">Module:</a></th><td>mod_cern_meta</td></tr> +</table> + <p>Active ou désactive le traitement des métafichiers pour certains + répertoires.</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="MetaSuffix" id="MetaSuffix">MetaSuffix</a> <a name="metasuffix" id="metasuffix">Directive</a></h2> +<table class="directive"> +<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Suffixe du fichier contenant les métainformations dans le +style du CERN</td></tr> +<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>MetaSuffix <var>suffixe</var></code></td></tr> +<tr><th><a href="directive-dict.html#Default">Défaut:</a></th><td><code>MetaSuffix .meta</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>Indexes</td></tr> +<tr><th><a href="directive-dict.html#Status">Statut:</a></th><td>Extension</td></tr> +<tr><th><a href="directive-dict.html#Module">Module:</a></th><td>mod_cern_meta</td></tr> +</table> + <p>Spécifie le suffixe du fichier contenant les métainformations. + Par exemple, si on conserve les valeurs par défaut des deux + directives précédentes, une requête pour + <code>DOCUMENT_ROOT/un-rep/index.html</code> provoquera la recherche + du métafichier + <code>DOCUMENT_ROOT/un-rep/.web/index.html.meta</code>, et utilisera + son contenu pour générer les informations quant aux en-têtes MIME + additionnels.</p> + + <div class="example"><h3>Exemple :</h3><pre class="prettyprint lang-config"> + MetaSuffix .meta + </pre> +</div> + +</div> +</div> +<div class="bottomlang"> +<p><span>Langues Disponibles: </span><a href="../en/mod/mod_cern_meta.html" hreflang="en" rel="alternate" title="English"> en </a> | +<a href="../fr/mod/mod_cern_meta.html" title="Français"> fr </a> | +<a href="../ko/mod/mod_cern_meta.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/2.4/mod/mod_cern_meta.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 2013 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/directives.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 diff --git a/docs/manual/mod/mod_cern_meta.xml.fr b/docs/manual/mod/mod_cern_meta.xml.fr new file mode 100644 index 0000000000..7e9770499c --- /dev/null +++ b/docs/manual/mod/mod_cern_meta.xml.fr @@ -0,0 +1,129 @@ +<?xml version="1.0"?> +<!DOCTYPE modulesynopsis SYSTEM "../style/modulesynopsis.dtd"> +<?xml-stylesheet type="text/xsl" href="../style/manual.fr.xsl"?> +<!-- English Revision : 1336591 --> +<!-- 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_cern_meta.xml.meta"> + +<name>mod_cern_meta</name> +<description>La sémantique des métafichiers du serveur httpd du +CERN</description> +<status>Extension</status> +<sourcefile>mod_cern_meta.c</sourcefile> +<identifier>cern_meta_module</identifier> + +<summary> + <p>Il s'agit d'une émulation de la sémantique des métafichiers du + serveur httpd du CERN. Les métafichiers consistent en en-têtes HTTP + qui peuvent s'ajouter au jeu d'en-têtes habituels pour chaque + fichier accédé. Ils ressemblent beaucoup aux fichiers .asis + d'Apache, et permettent d'influencer de manière rudimentaire + l'en-tête Expires:, ainsi que d'autres curiosités. Il existe de + nombreuses méthodes pour gérer les métainformations, mais le choix + s'est porté sur celle-ci car il existe déjà un grand nombre + d'utilisateurs du CERN qui peuvent exploiter ce module.</p> + + <p>Pour plus d'information, voir le document sur la <a + href="http://www.w3.org/pub/WWW/Daemon/User/Config/General.html#MetaDir" + >sémantique des métafichiers du CERN</a>.</p> +</summary> + +<seealso><module>mod_headers</module></seealso> +<seealso><module>mod_asis</module></seealso> + +<directivesynopsis> +<name>MetaFiles</name> +<description>Active le traitement des métafichiers du CERN</description> +<syntax>MetaFiles on|off</syntax> +<default>MetaFiles off</default> +<contextlist><context>server config</context> +<context>virtual host</context> +<context>directory</context> +<context>.htaccess</context></contextlist> +<override>Indexes</override> + +<usage> + <p>Active ou désactive le traitement des métafichiers pour certains + répertoires.</p> +</usage> +</directivesynopsis> + +<directivesynopsis> +<name>MetaDir</name> +<description>Le nom du répertoire où trouver les fichiers de +métainformations dans le style du CERN</description> +<syntax>MetaDir <var>répertoire</var></syntax> +<default>MetaDir .web</default> +<contextlist><context>server config</context> +<context>virtual host</context> +<context>directory</context> +<context>.htaccess</context></contextlist> +<override>Indexes</override> + +<usage> + <p>Spécifie le nom du répertoire dans lequel Apache pourra trouver + les fichiers de métainformations. Ce répertoire est en général un + sous-répertoire 'caché' du répertoire qui contient le fichier à + accéder. Définissez cette directive à "<code>.</code>" pour + rechercher les métafichiers dans le même répertoire que le fichier à + accéder :</p> + + <highlight language="config">MetaDir .</highlight> + + <p>Ou, pour rechercher dans un sous-répertoire du répertoire + contenant le fichier à accéder :</p> + + <highlight language="config">MetaDir .meta</highlight> +</usage> +</directivesynopsis> + +<directivesynopsis> +<name>MetaSuffix</name> +<description>Suffixe du fichier contenant les métainformations dans le +style du CERN</description> +<syntax>MetaSuffix <var>suffixe</var></syntax> +<default>MetaSuffix .meta</default> +<contextlist><context>server config</context> +<context>virtual host</context> +<context>directory</context> +<context>.htaccess</context></contextlist> +<override>Indexes</override> + +<usage> + <p>Spécifie le suffixe du fichier contenant les métainformations. + Par exemple, si on conserve les valeurs par défaut des deux + directives précédentes, une requête pour + <code>DOCUMENT_ROOT/un-rep/index.html</code> provoquera la recherche + du métafichier + <code>DOCUMENT_ROOT/un-rep/.web/index.html.meta</code>, et utilisera + son contenu pour générer les informations quant aux en-têtes MIME + additionnels.</p> + + <example><title>Exemple :</title> + <highlight language="config"> + MetaSuffix .meta + </highlight> + </example> +</usage> +</directivesynopsis> + +</modulesynopsis> diff --git a/docs/manual/mod/mod_cern_meta.xml.meta b/docs/manual/mod/mod_cern_meta.xml.meta index 4488f1cd9f..8a68d26e7d 100644 --- a/docs/manual/mod/mod_cern_meta.xml.meta +++ b/docs/manual/mod/mod_cern_meta.xml.meta @@ -8,6 +8,7 @@ <variants> <variant>en</variant> + <variant>fr</variant> <variant outdated="yes">ko</variant> </variants> </metafile> diff --git a/docs/manual/mod/mod_dav.html b/docs/manual/mod/mod_dav.html index 5cdb02d8ba..02a71d348f 100644 --- a/docs/manual/mod/mod_dav.html +++ b/docs/manual/mod/mod_dav.html @@ -4,6 +4,10 @@ URI: mod_dav.html.en Content-Language: en Content-type: text/html; charset=ISO-8859-1 +URI: mod_dav.html.fr +Content-Language: fr +Content-type: text/html; charset=ISO-8859-1 + URI: mod_dav.html.ja.utf8 Content-Language: ja Content-type: text/html; charset=UTF-8 diff --git a/docs/manual/mod/mod_dav.html.fr b/docs/manual/mod/mod_dav.html.fr new file mode 100644 index 0000000000..7b7489d682 --- /dev/null +++ b/docs/manual/mod/mod_dav.html.fr @@ -0,0 +1,310 @@ +<?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><!-- + XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX + This file is generated from xml source: DO NOT EDIT + XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX + --> +<title>mod_dav - Serveur Apache HTTP</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.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/directives.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.4</p> +<img alt="" src="../images/feather.gif" /></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.4</a> > <a href="./">Modules</a></div> +<div id="page-content"> +<div id="preamble"><h1>Module Apache mod_dav</h1> +<div class="toplang"> +<p><span>Langues Disponibles: </span><a href="../en/mod/mod_dav.html" hreflang="en" rel="alternate" title="English"> en </a> | +<a href="../fr/mod/mod_dav.html" title="Français"> fr </a> | +<a href="../ja/mod/mod_dav.html" hreflang="ja" rel="alternate" title="Japanese"> ja </a> | +<a href="../ko/mod/mod_dav.html" hreflang="ko" rel="alternate" title="Korean"> ko </a></p> +</div> +<table class="module"><tr><th><a href="module-dict.html#Description">Description:</a></th><td>Fonctionnalité de création et gestion de versions de +documents via le web (<a href="http://www.webdav.org/">WebDAV</a>)</td></tr> +<tr><th><a href="module-dict.html#Status">Statut:</a></th><td>Extension</td></tr> +<tr><th><a href="module-dict.html#ModuleIdentifier">Identificateur de Module:</a></th><td>dav_module</td></tr> +<tr><th><a href="module-dict.html#SourceFile">Fichier Source:</a></th><td>mod_dav.c</td></tr></table> +<h3>Sommaire</h3> + + <p>Ce module ajoute à Apache une fonctionnalité <a href="http://www.webdav.org">WebDAV</a> de classes 1 et 2 + ('Web-based Distributed Authoring and Versioning' ou Création et + gestion de versions de documents via le web). Il s'agit d'une + extension du protocole HTTP qui permet de créer, déplacer, copier et + supprimer des ressources ou collections de ressources sur un serveur + web distant.</p> +</div> +<div id="quickview"><h3 class="directives">Directives</h3> +<ul id="toc"> +<li><img alt="" src="../images/down.gif" /> <a href="#dav">Dav</a></li> +<li><img alt="" src="../images/down.gif" /> <a href="#davdepthinfinity">DavDepthInfinity</a></li> +<li><img alt="" src="../images/down.gif" /> <a href="#davmintimeout">DavMinTimeout</a></li> +</ul> +<h3>Sujets</h3> +<ul id="topics"> +<li><img alt="" src="../images/down.gif" /> <a href="#example">Activation de WebDAV</a></li> +<li><img alt="" src="../images/down.gif" /> <a href="#security">Problèmes concernant la sécurité</a></li> +<li><img alt="" src="../images/down.gif" /> <a href="#complex">Configurations complexes</a></li> +</ul><h3>Voir aussi</h3> +<ul class="seealso"> +<li><code class="directive"><a href="../mod/mod_dav_fs.html#davlockdb">DavLockDB</a></code></li> +<li><code class="directive"><a href="../mod/core.html#limitxmlrequestbody">LimitXMLRequestBody</a></code></li> +<li><a href="http://www.webdav.org">Ressources WebDAV</a></li> +</ul><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="example" id="example">Activation de WebDAV</a></h2> + <p>Pour activer le module <code class="module"><a href="../mod/mod_dav.html">mod_dav</a></code>, ajoutez la ligne + suivante à un conteneur de votre fichier <code>httpd.conf</code> + :</p> + + <pre class="prettyprint lang-config">Dav On</pre> + + + <p>Ceci active le fournisseur de système de fichier DAV implémenté par + le module <code class="module"><a href="../mod/mod_dav_fs.html">mod_dav_fs</a></code>. Ce dernier doit donc être + compilé dans le serveur ou chargé au démarrage à l'aide de la + directive <code class="directive"><a href="../mod/mod_so.html#loadmodule">LoadModule</a></code>.</p> + + <p>En outre, vous devez indiquer où se trouve la base de données des + verrous DAV via une directive <code class="directive"><a href="../mod/mod_dav_fs.html#davlockdb">DavLockDB</a></code> dans la section globale de + votre fichier <code>httpd.conf</code> :</p> + + <pre class="prettyprint lang-config"> + DavLockDB /usr/local/apache2/var/DavLock + </pre> + + + <p>Le répertoire contenant le fichier de la base de données des + verrous doit avoir des droits en écriture pour l'utilisateur et le + groupe sous lesquels Apache s'exécute et définis respectivement par + les directives <code class="directive"><a href="../mod/mod_unixd.html#user">User</a></code> et + <code class="directive"><a href="../mod/mod_unixd.html#group">Group</a></code>.</p> + + <p>Si vous souhaitez limiter l'accès aux répertoires où DAV est + activé, vous pouvez ajouter une clause <code class="directive"><a href="../mod/core.html#limit"><Limit></a></code> dans la section <code class="directive"><a href="../mod/core.html#location"><Location></a></code> considérée. Pour + définir la quantité maximale de données en octets qu'un client + DAV peut envoyer par requête, vous devez utiliser la directive + <code class="directive"><a href="../mod/core.html#limitxmlrequestbody">LimitXMLRequestBody</a></code>, car La + directive <code class="directive"><a href="../mod/core.html#limitrequestbody">LimitRequestBody</a></code> + "habituelle" n'a aucune incidence sur les requêtes DAV.</p> + + <div class="example"><h3>Exemple complet</h3><pre class="prettyprint lang-config"> +DavLockDB /usr/local/apache2/var/DavLock + +<Directory /usr/local/apache2/htdocs/foo> + Require all granted + Dav On + + AuthType Basic + AuthName DAV + AuthUserFile user.passwd + + <LimitExcept GET POST OPTIONS> + Require user admin + </LimitExcept> +</Directory> + </pre> +</div> + +</div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div> +<div class="section"> +<h2><a name="security" id="security">Problèmes concernant la sécurité</a></h2> + + <p>Etant donné que les méthodes d'accès DAV permettent à des clients + distants de manipuler des fichiers sur le serveur, vous devez vous + assurer que votre serveur est bien sécurisé avant d'activer + <code class="module"><a href="../mod/mod_dav.html">mod_dav</a></code>.</p> + + <p>Tout répertoire du serveur où DAV est activé doit être protégé + par une procédure d'authentification. L'utilisation de + l'authentification HTTP de base n'est pas recommandée. Vous devez + utiliser au moins l'authentification HTTP à base de condensés + qu'implémente le module <code class="module"><a href="../mod/mod_auth_digest.html">mod_auth_digest</a></code>. + Pratiquement tous les clients WebDAV supportent cette méthode + d'authentification. Vous pouvez aussi utiliser l'authentification de + base sur une connexion où <a href="../ssl/">SSL</a> est activé.</p> + + <p>Pour que <code class="module"><a href="../mod/mod_dav.html">mod_dav</a></code> puisse manipuler des fichiers, + il doit avoir des permissions en écriture sur les répertoires et les + fichiers qui sont sous son contrôle ; en d'autre termes, c'est + l'utilisateur et le groupe sous lesquels Apache s'exécute et définis + par les directives <code class="directive"><a href="../mod/mod_unixd.html#user">User</a></code> et + <code class="directive"><a href="../mod/mod_unixd.html#group">Group</a></code> qui doivent avoir + les droits en écriture sur ces fichiers et répertoires. Les fichiers + nouvellement créés appartiendront aussi à ces utilisateur et groupe. + Par conséquent, il est important de contrôler l'accès à ce compte. + Les répertoires DAV sont considérés comme privés du point de vue + d'Apache, et la modification des fichiers qu'ils contiennent + autrement que par l'intermédiaire d'Apache (par exemple par FTP ou + par des outils du niveau du système de fichiers) ne doit pas être + permise.</p> + + <p><code class="module"><a href="../mod/mod_dav.html">mod_dav</a></code> peut faire l'objet de plusieurs sortes + d'attaques par déni de service. La directive <code class="directive"><a href="../mod/core.html#limitxmlrequestbody">LimitXMLRequestBody</a></code> permet de limiter la + quantité de mémoire consommée pour interpréter des requêtes DAV de + grande taille. En outre, la directive <code class="directive"><a href="#davdepthinfinity">DavDepthInfinity</a></code> permet d'empêcher les + requêtes <code>PROPFIND</code> concernant un répertoire de très + grande taille de consommer de grandes quantités de mémoire. Un autre + type d'attaque par déni de service peut aussi être mené par un + client qui remplit simplement tout l'espace disque disponible avec + des fichiers de très grande taille. Etant donné qu'il n'existe aucun + moyen direct d'éviter ce genre d'attaque dans Apache, vous ne devez + accorder des accès DAV qu'à des utilisateurs de confiance.</p> +</div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div> +<div class="section"> +<h2><a name="complex" id="complex">Configurations complexes</a></h2> + + <p>Les requêtes ayant pour but de manipuler des fichiers dynamiques + (scripts PHP, scripts CGI, etc...) en utilisant + <code class="module"><a href="../mod/mod_dav.html">mod_dav</a></code> sont courantes. Ce traitement n'est pas + évident car une requête + <code>GET</code> va toujours tenter d'exécuter le script, plutôt que + de télécharger son contenu. Pour éviter cet inconvénient, une + méthode possible consiste à faire correspondre deux URLs + différentes au même contenu, l'une d'entre elles servant à lancer le + script, alors que l'autre peut être utilisée pour le télécharger et + le manipuler avec DAV.</p> + +<pre class="prettyprint lang-config"> +Alias /phparea /home/gstein/php_files +Alias /php-source /home/gstein/php_files +<Location /php-source> +DAV On +ForceType text/plain +</Location> +</pre> + + + <p>Avec cette configuration, on peut utiliser + <code>http://example.com/phparea</code> pour afficher le résultat de + l'exécution des scripts PHP, et + <code>http://example.com/php-source</code> pour les manipuler avec + DAV.</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="Dav" id="Dav">Dav</a> <a name="dav" id="dav">Directive</a></h2> +<table class="directive"> +<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Active les méthodes HTTP WebDAV</td></tr> +<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>Dav On|Off|<var>nom fournisseur</var></code></td></tr> +<tr><th><a href="directive-dict.html#Default">Défaut:</a></th><td><code>Dav Off</code></td></tr> +<tr><th><a href="directive-dict.html#Context">Contexte:</a></th><td>répertoire</td></tr> +<tr><th><a href="directive-dict.html#Status">Statut:</a></th><td>Extension</td></tr> +<tr><th><a href="directive-dict.html#Module">Module:</a></th><td>mod_dav</td></tr> +</table> + <p>La directive <code class="directive">Dav</code> permet d'activer les + méthodes HTTP WebDAV pour le conteneur condidéré :</p> + + <pre class="prettyprint lang-config"> +<Location /foo> + Dav On +</Location> + </pre> + + + <p>La valeur <code>On</code> est en fait un alias vers le + fournisseur par défaut <code>filesystem</code> implémenté par le + module <code class="module"><a href="../mod/mod_dav_fs.html">mod_dav_fs</a></code>. Notez que lorsque DAV est activé + pour un conteneur, on <em>ne peut pas</em> le désactiver pour ses + sous-conteneurs. Pour un exemple de configuration complet, + reportez-vous à la <a href="#example">section précédente</a>.</p> + + <div class="warning"> + N'activez pas WebDAV tant que votre serveur n'est pas sécurisé. Si + vous passez outre cette recommandation, tout le monde pourra + enregistrer des fichiers sur votre système. + </div> + +</div> +<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div> +<div class="directive-section"><h2><a name="DavDepthInfinity" id="DavDepthInfinity">DavDepthInfinity</a> <a name="davdepthinfinity" id="davdepthinfinity">Directive</a></h2> +<table class="directive"> +<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Autorise les requêtes PROPFIND avec en-tête Depth: +Infinity</td></tr> +<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>DavDepthInfinity on|off</code></td></tr> +<tr><th><a href="directive-dict.html#Default">Défaut:</a></th><td><code>DavDepthInfinity off</code></td></tr> +<tr><th><a href="directive-dict.html#Context">Contexte:</a></th><td>configuration du serveur, serveur virtuel, répertoire</td></tr> +<tr><th><a href="directive-dict.html#Status">Statut:</a></th><td>Extension</td></tr> +<tr><th><a href="directive-dict.html#Module">Module:</a></th><td>mod_dav</td></tr> +</table> + <p>La directive <code class="directive">DavDepthInfinity</code> permet + d'autoriser le traitement des requêtes <code>PROPFIND</code> + contenant l'en-tête Depth: Infinity. Par défaut, ce type de requête + n'est pas autorisé, car il peut favoriser les attaques de type Déni + de service.</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="DavMinTimeout" id="DavMinTimeout">DavMinTimeout</a> <a name="davmintimeout" id="davmintimeout">Directive</a></h2> +<table class="directive"> +<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Durée minimale pendant laquelle le serveur maintient un +verrou sur une ressource DAV</td></tr> +<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>DavMinTimeout <var>secondes</var></code></td></tr> +<tr><th><a href="directive-dict.html#Default">Défaut:</a></th><td><code>DavMinTimeout 0</code></td></tr> +<tr><th><a href="directive-dict.html#Context">Contexte:</a></th><td>configuration du serveur, serveur virtuel, répertoire</td></tr> +<tr><th><a href="directive-dict.html#Status">Statut:</a></th><td>Extension</td></tr> +<tr><th><a href="directive-dict.html#Module">Module:</a></th><td>mod_dav</td></tr> +</table> + <p>Lorsqu'un client demande le verrouillage d'une ressource DAV, il + peut aussi spécifier une durée au bout de laquelle le verrou sera + automatiquement supprimé par le serveur. Cette valeur ne constitue + qu'une demande, et le serveur peut l'ignorer ou informer le client + qu'il va utiliser une valeur arbitraire.</p> + + <p>La directive <code class="directive">DavMinTimeout</code> permet de + spécifier, en secondes, la durée minimale de verrouillage à renvoyer + au client. Les Répertoires Web de Microsoft présentent une durée par + défaut de 120 secondes ; la directive + <code class="directive">DavMinTimeout</code> permet de définir une valeur + supérieure (par exemple 600 secondes), afin de réduire les risques + de perte du verrou par le client suite à une surcharge du + réseau.</p> + + <div class="example"><h3>Exemple</h3><pre class="prettyprint lang-config"> +<Location /MSWord> + DavMinTimeout 600 +</Location> + </pre> +</div> + +</div> +</div> +<div class="bottomlang"> +<p><span>Langues Disponibles: </span><a href="../en/mod/mod_dav.html" hreflang="en" rel="alternate" title="English"> en </a> | +<a href="../fr/mod/mod_dav.html" title="Français"> fr </a> | +<a href="../ja/mod/mod_dav.html" hreflang="ja" rel="alternate" title="Japanese"> ja </a> | +<a href="../ko/mod/mod_dav.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/2.4/mod/mod_dav.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 2013 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/directives.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 diff --git a/docs/manual/mod/mod_dav.xml.fr b/docs/manual/mod/mod_dav.xml.fr new file mode 100644 index 0000000000..eac1f1a188 --- /dev/null +++ b/docs/manual/mod/mod_dav.xml.fr @@ -0,0 +1,268 @@ +<?xml version="1.0"?> +<!DOCTYPE modulesynopsis SYSTEM "../style/modulesynopsis.dtd"> +<?xml-stylesheet type="text/xsl" href="../style/manual.fr.xsl"?> +<!-- English Revision : 1334011 --> +<!-- 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_dav.xml.meta"> + +<name>mod_dav</name> +<description>Fonctionnalité de création et gestion de versions de +documents via le web (<a +href="http://www.webdav.org/">WebDAV</a>)</description> +<status>Extension</status> +<sourcefile>mod_dav.c</sourcefile> +<identifier>dav_module</identifier> + +<summary> + <p>Ce module ajoute à Apache une fonctionnalité <a + href="http://www.webdav.org">WebDAV</a> de classes 1 et 2 + ('Web-based Distributed Authoring and Versioning' ou Création et + gestion de versions de documents via le web). Il s'agit d'une + extension du protocole HTTP qui permet de créer, déplacer, copier et + supprimer des ressources ou collections de ressources sur un serveur + web distant.</p> +</summary> +<seealso><directive module="mod_dav_fs">DavLockDB</directive></seealso> +<seealso><directive module="core">LimitXMLRequestBody</directive></seealso> +<seealso><a href="http://www.webdav.org">Ressources WebDAV</a></seealso> + +<section id="example"><title>Activation de WebDAV</title> + <p>Pour activer le module <module>mod_dav</module>, ajoutez la ligne + suivante à un conteneur de votre fichier <code>httpd.conf</code> + :</p> + + <highlight language="config">Dav On</highlight> + + <p>Ceci active le fournisseur de système de fichier DAV implémenté par + le module <module>mod_dav_fs</module>. Ce dernier doit donc être + compilé dans le serveur ou chargé au démarrage à l'aide de la + directive <directive module="mod_so">LoadModule</directive>.</p> + + <p>En outre, vous devez indiquer où se trouve la base de données des + verrous DAV via une directive <directive + module="mod_dav_fs">DavLockDB</directive> dans la section globale de + votre fichier <code>httpd.conf</code> :</p> + + <highlight language="config"> + DavLockDB /usr/local/apache2/var/DavLock + </highlight> + + <p>Le répertoire contenant le fichier de la base de données des + verrous doit avoir des droits en écriture pour l'utilisateur et le + groupe sous lesquels Apache s'exécute et définis respectivement par + les directives <directive module="mod_unixd">User</directive> et + <directive module="mod_unixd">Group</directive>.</p> + + <p>Si vous souhaitez limiter l'accès aux répertoires où DAV est + activé, vous pouvez ajouter une clause <directive module="core" + type="section">Limit</directive> dans la section <directive + module="core" type="section">Location</directive> considérée. Pour + définir la quantité maximale de données en octets qu'un client + DAV peut envoyer par requête, vous devez utiliser la directive + <directive module="core">LimitXMLRequestBody</directive>, car La + directive <directive module="core">LimitRequestBody</directive> + "habituelle" n'a aucune incidence sur les requêtes DAV.</p> + + <example><title>Exemple complet</title> + <highlight language="config"> +DavLockDB /usr/local/apache2/var/DavLock + +<Directory /usr/local/apache2/htdocs/foo> + Require all granted + Dav On + + AuthType Basic + AuthName DAV + AuthUserFile user.passwd + + <LimitExcept GET POST OPTIONS> + Require user admin + </LimitExcept> +</Directory> + </highlight> + </example> + +</section> + +<section id="security"><title>Problèmes concernant la sécurité</title> + + <p>Etant donné que les méthodes d'accès DAV permettent à des clients + distants de manipuler des fichiers sur le serveur, vous devez vous + assurer que votre serveur est bien sécurisé avant d'activer + <module>mod_dav</module>.</p> + + <p>Tout répertoire du serveur où DAV est activé doit être protégé + par une procédure d'authentification. L'utilisation de + l'authentification HTTP de base n'est pas recommandée. Vous devez + utiliser au moins l'authentification HTTP à base de condensés + qu'implémente le module <module>mod_auth_digest</module>. + Pratiquement tous les clients WebDAV supportent cette méthode + d'authentification. Vous pouvez aussi utiliser l'authentification de + base sur une connexion où <a href="../ssl/">SSL</a> est activé.</p> + + <p>Pour que <module>mod_dav</module> puisse manipuler des fichiers, + il doit avoir des permissions en écriture sur les répertoires et les + fichiers qui sont sous son contrôle ; en d'autre termes, c'est + l'utilisateur et le groupe sous lesquels Apache s'exécute et définis + par les directives <directive module="mod_unixd">User</directive> et + <directive module="mod_unixd">Group</directive> qui doivent avoir + les droits en écriture sur ces fichiers et répertoires. Les fichiers + nouvellement créés appartiendront aussi à ces utilisateur et groupe. + Par conséquent, il est important de contrôler l'accès à ce compte. + Les répertoires DAV sont considérés comme privés du point de vue + d'Apache, et la modification des fichiers qu'ils contiennent + autrement que par l'intermédiaire d'Apache (par exemple par FTP ou + par des outils du niveau du système de fichiers) ne doit pas être + permise.</p> + + <p><module>mod_dav</module> peut faire l'objet de plusieurs sortes + d'attaques par déni de service. La directive <directive + module="core">LimitXMLRequestBody</directive> permet de limiter la + quantité de mémoire consommée pour interpréter des requêtes DAV de + grande taille. En outre, la directive <directive + module="mod_dav">DavDepthInfinity</directive> permet d'empêcher les + requêtes <code>PROPFIND</code> concernant un répertoire de très + grande taille de consommer de grandes quantités de mémoire. Un autre + type d'attaque par déni de service peut aussi être mené par un + client qui remplit simplement tout l'espace disque disponible avec + des fichiers de très grande taille. Etant donné qu'il n'existe aucun + moyen direct d'éviter ce genre d'attaque dans Apache, vous ne devez + accorder des accès DAV qu'à des utilisateurs de confiance.</p> +</section> + +<section id="complex"><title>Configurations complexes</title> + + <p>Les requêtes ayant pour but de manipuler des fichiers dynamiques + (scripts PHP, scripts CGI, etc...) en utilisant + <module>mod_dav</module> sont courantes. Ce traitement n'est pas + évident car une requête + <code>GET</code> va toujours tenter d'exécuter le script, plutôt que + de télécharger son contenu. Pour éviter cet inconvénient, une + méthode possible consiste à faire correspondre deux URLs + différentes au même contenu, l'une d'entre elles servant à lancer le + script, alors que l'autre peut être utilisée pour le télécharger et + le manipuler avec DAV.</p> + +<highlight language="config"> +Alias /phparea /home/gstein/php_files +Alias /php-source /home/gstein/php_files +<Location /php-source> +DAV On +ForceType text/plain +</Location> +</highlight> + + <p>Avec cette configuration, on peut utiliser + <code>http://example.com/phparea</code> pour afficher le résultat de + l'exécution des scripts PHP, et + <code>http://example.com/php-source</code> pour les manipuler avec + DAV.</p> +</section> + +<directivesynopsis> +<name>Dav</name> +<description>Active les méthodes HTTP WebDAV</description> +<syntax>Dav On|Off|<var>nom fournisseur</var></syntax> +<default>Dav Off</default> +<contextlist><context>directory</context></contextlist> + +<usage> + <p>La directive <directive>Dav</directive> permet d'activer les + méthodes HTTP WebDAV pour le conteneur condidéré :</p> + + <highlight language="config"> +<Location /foo> + Dav On +</Location> + </highlight> + + <p>La valeur <code>On</code> est en fait un alias vers le + fournisseur par défaut <code>filesystem</code> implémenté par le + module <module>mod_dav_fs</module>. Notez que lorsque DAV est activé + pour un conteneur, on <em>ne peut pas</em> le désactiver pour ses + sous-conteneurs. Pour un exemple de configuration complet, + reportez-vous à la <a href="#example">section précédente</a>.</p> + + <note type="warning"> + N'activez pas WebDAV tant que votre serveur n'est pas sécurisé. Si + vous passez outre cette recommandation, tout le monde pourra + enregistrer des fichiers sur votre système. + </note> +</usage> +</directivesynopsis> + +<directivesynopsis> +<name>DavMinTimeout</name> +<description>Durée minimale pendant laquelle le serveur maintient un +verrou sur une ressource DAV</description> +<syntax>DavMinTimeout <var>secondes</var></syntax> +<default>DavMinTimeout 0</default> +<contextlist><context>server config</context><context>virtual host</context> +<context>directory</context></contextlist> + +<usage> + <p>Lorsqu'un client demande le verrouillage d'une ressource DAV, il + peut aussi spécifier une durée au bout de laquelle le verrou sera + automatiquement supprimé par le serveur. Cette valeur ne constitue + qu'une demande, et le serveur peut l'ignorer ou informer le client + qu'il va utiliser une valeur arbitraire.</p> + + <p>La directive <directive>DavMinTimeout</directive> permet de + spécifier, en secondes, la durée minimale de verrouillage à renvoyer + au client. Les Répertoires Web de Microsoft présentent une durée par + défaut de 120 secondes ; la directive + <directive>DavMinTimeout</directive> permet de définir une valeur + supérieure (par exemple 600 secondes), afin de réduire les risques + de perte du verrou par le client suite à une surcharge du + réseau.</p> + + <example><title>Exemple</title> + <highlight language="config"> +<Location /MSWord> + DavMinTimeout 600 +</Location> + </highlight> + </example> +</usage> +</directivesynopsis> + +<directivesynopsis> +<name>DavDepthInfinity</name> +<description>Autorise les requêtes PROPFIND avec en-tête Depth: +Infinity</description> +<syntax>DavDepthInfinity on|off</syntax> +<default>DavDepthInfinity off</default> +<contextlist><context>server config</context><context>virtual host</context> +<context>directory</context></contextlist> + +<usage> + <p>La directive <directive>DavDepthInfinity</directive> permet + d'autoriser le traitement des requêtes <code>PROPFIND</code> + contenant l'en-tête Depth: Infinity. Par défaut, ce type de requête + n'est pas autorisé, car il peut favoriser les attaques de type Déni + de service.</p> +</usage> +</directivesynopsis> + +</modulesynopsis> + + diff --git a/docs/manual/mod/mod_dav.xml.meta b/docs/manual/mod/mod_dav.xml.meta index 63b414b26f..2d094cad4d 100644 --- a/docs/manual/mod/mod_dav.xml.meta +++ b/docs/manual/mod/mod_dav.xml.meta @@ -8,6 +8,7 @@ <variants> <variant>en</variant> + <variant>fr</variant> <variant outdated="yes">ja</variant> <variant outdated="yes">ko</variant> </variants> diff --git a/docs/manual/mod/mod_dav_fs.html b/docs/manual/mod/mod_dav_fs.html index 08525a4027..d071695fa2 100644 --- a/docs/manual/mod/mod_dav_fs.html +++ b/docs/manual/mod/mod_dav_fs.html @@ -4,6 +4,10 @@ URI: mod_dav_fs.html.en Content-Language: en Content-type: text/html; charset=ISO-8859-1 +URI: mod_dav_fs.html.fr +Content-Language: fr +Content-type: text/html; charset=ISO-8859-1 + URI: mod_dav_fs.html.ja.utf8 Content-Language: ja Content-type: text/html; charset=UTF-8 diff --git a/docs/manual/mod/mod_dav_fs.html.fr b/docs/manual/mod/mod_dav_fs.html.fr new file mode 100644 index 0000000000..82d3d13da3 --- /dev/null +++ b/docs/manual/mod/mod_dav_fs.html.fr @@ -0,0 +1,131 @@ +<?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><!-- + XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX + This file is generated from xml source: DO NOT EDIT + XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX + --> +<title>mod_dav_fs - Serveur Apache HTTP</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.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/directives.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.4</p> +<img alt="" src="../images/feather.gif" /></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.4</a> > <a href="./">Modules</a></div> +<div id="page-content"> +<div id="preamble"><h1>Module Apache mod_dav_fs</h1> +<div class="toplang"> +<p><span>Langues Disponibles: </span><a href="../en/mod/mod_dav_fs.html" hreflang="en" rel="alternate" title="English"> en </a> | +<a href="../fr/mod/mod_dav_fs.html" title="Français"> fr </a> | +<a href="../ja/mod/mod_dav_fs.html" hreflang="ja" rel="alternate" title="Japanese"> ja </a> | +<a href="../ko/mod/mod_dav_fs.html" hreflang="ko" rel="alternate" title="Korean"> ko </a></p> +</div> +<table class="module"><tr><th><a href="module-dict.html#Description">Description:</a></th><td>Implémente le fournisseur filesystem pour +<code class="module"><a href="../mod/mod_dav.html">mod_dav</a></code></td></tr> +<tr><th><a href="module-dict.html#Status">Statut:</a></th><td>Extension</td></tr> +<tr><th><a href="module-dict.html#ModuleIdentifier">Identificateur de Module:</a></th><td>dav_fs_module</td></tr> +<tr><th><a href="module-dict.html#SourceFile">Fichier Source:</a></th><td>mod_dav_fs.c</td></tr></table> +<h3>Sommaire</h3> + + <p>L'activation de ce module <em>nécessite</em> l'utilisation de + <code class="module"><a href="../mod/mod_dav.html">mod_dav</a></code>. C'est un module de support pour <code class="module"><a href="../mod/mod_dav.html">mod_dav</a></code> et à ce titre, il permet l'accès à des ressources + situées dans le système de fichiers du serveur. Le nom formel de ce + fournisseur est <code>filesystem</code>. Les fournisseurs supports + de <code class="module"><a href="../mod/mod_dav.html">mod_dav</a></code> sont invoqués via la directive + <code class="directive"><a href="../mod/mod_dav.html#dav">Dav</a></code> :</p> + + <div class="example"><h3>Exemple</h3><pre class="prettyprint lang-config"> + Dav filesystem + </pre> +</div> + + <p>Comme <code>filesystem</code> est le fournisseur par défaut de + <code class="module"><a href="../mod/mod_dav.html">mod_dav</a></code>, vous pouvez vous contenter d'utiliser la + valeur <code>On</code> comme argument de Dav.</p> +</div> +<div id="quickview"><h3 class="directives">Directives</h3> +<ul id="toc"> +<li><img alt="" src="../images/down.gif" /> <a href="#davlockdb">DavLockDB</a></li> +</ul> +<h3>Voir aussi</h3> +<ul class="seealso"> +<li><code class="module"><a href="../mod/mod_dav.html">mod_dav</a></code></li> +</ul><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="directive-section"><h2><a name="DavLockDB" id="DavLockDB">DavLockDB</a> <a name="davlockdb" id="davlockdb">Directive</a></h2> +<table class="directive"> +<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Chemin de la base de données des verrous DAV</td></tr> +<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>DavLockDB <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>Extension</td></tr> +<tr><th><a href="directive-dict.html#Module">Module:</a></th><td>mod_dav_fs</td></tr> +</table> + <p>La directive <code class="directive">DavLockDB</code> permet de spécifier + le chemin complet de la base de données des verrous, sans extension. + 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>. L'implémentation de + <code class="module"><a href="../mod/mod_dav_fs.html">mod_dav_fs</a></code> utilise une base de données SDBM pour + surveiller les verrous utilisateurs.</p> + + + + <div class="example"><h3>Exemple</h3><pre class="prettyprint lang-config"> + DavLockDB var/DavLock + </pre> +</div> + + <p>Les utilisateur et groupe sous lesquels Apache s'exécute et qui + sont respectivement définis par les directives <code class="directive"><a href="../mod/mod_unixd.html#user">User</a></code> et <code class="directive"><a href="../mod/mod_unixd.html#group">Group</a></code> doivent pouvoir écrire dans le + répertoire qui contient le fichier de la base de données des + verrous. Pour des raisons de sécurité, il est recommandé de créer un + répertoire dédié à la base de données des verrous, plutôt que de + modifier les permissions d'un répertoire existant. Dans l'exemple + ci-dessus, Apache va créer des fichiers dans le répertoire + <code>var/</code>, lui-même sous-répertoire du répertoire défini par + la directive <code class="directive"><a href="../mod/core.html#serverroot">ServerRoot</a></code>, avec le nom de base + <code>DavLock</code> suivi d'une extension choisie par le + serveur.</p> + + +</div> +</div> +<div class="bottomlang"> +<p><span>Langues Disponibles: </span><a href="../en/mod/mod_dav_fs.html" hreflang="en" rel="alternate" title="English"> en </a> | +<a href="../fr/mod/mod_dav_fs.html" title="Français"> fr </a> | +<a href="../ja/mod/mod_dav_fs.html" hreflang="ja" rel="alternate" title="Japanese"> ja </a> | +<a href="../ko/mod/mod_dav_fs.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/2.4/mod/mod_dav_fs.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 2013 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/directives.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 diff --git a/docs/manual/mod/mod_dav_fs.xml.fr b/docs/manual/mod/mod_dav_fs.xml.fr new file mode 100644 index 0000000000..d72fc825d0 --- /dev/null +++ b/docs/manual/mod/mod_dav_fs.xml.fr @@ -0,0 +1,101 @@ +<?xml version="1.0"?> +<!DOCTYPE modulesynopsis SYSTEM "../style/modulesynopsis.dtd"> +<?xml-stylesheet type="text/xsl" href="../style/manual.fr.xsl"?> +<!-- English Revision : 1334011 --> +<!-- 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_dav_fs.xml.meta"> + +<name>mod_dav_fs</name> +<description>Implémente le fournisseur filesystem pour +<module>mod_dav</module></description> +<status>Extension</status> +<sourcefile>mod_dav_fs.c</sourcefile> +<identifier>dav_fs_module</identifier> + +<summary> + <p>L'activation de ce module <em>nécessite</em> l'utilisation de + <module>mod_dav</module>. C'est un module de support pour <module + >mod_dav</module> et à ce titre, il permet l'accès à des ressources + situées dans le système de fichiers du serveur. Le nom formel de ce + fournisseur est <code>filesystem</code>. Les fournisseurs supports + de <module>mod_dav</module> sont invoqués via la directive + <directive module="mod_dav">Dav</directive> :</p> + + <example><title>Exemple</title> + <highlight language="config"> + Dav filesystem + </highlight> + </example> + + <p>Comme <code>filesystem</code> est le fournisseur par défaut de + <module>mod_dav</module>, vous pouvez vous contenter d'utiliser la + valeur <code>On</code> comme argument de Dav.</p> +</summary> +<seealso><module>mod_dav</module></seealso> + +<directivesynopsis> +<name>DavLockDB</name> +<description>Chemin de la base de données des verrous DAV</description> +<syntax>DavLockDB <var>chemin fichier</var></syntax> +<contextlist><context>server config</context><context>virtual +host</context> +</contextlist> + +<usage> + <p>La directive <directive>DavLockDB</directive> permet de spécifier + le chemin complet de la base de données des verrous, sans extension. + Si le chemin n'est pas absolu, il sera considéré comme relatif au + répertoire défini par la directive <directive + module="core">ServerRoot</directive>. L'implémentation de + <module>mod_dav_fs</module> utilise une base de données SDBM pour + surveiller les verrous utilisateurs.</p> + + <!-- XXX: someone should add that tool to the support directory... + The utility <code>modules/dav/util/lockview</code> can be used from + the server to display all locks in a lock database.</p> --> + + <example><title>Exemple</title> + <highlight language="config"> + DavLockDB var/DavLock + </highlight> + </example> + + <p>Les utilisateur et groupe sous lesquels Apache s'exécute et qui + sont respectivement définis par les directives <directive + module="mod_unixd">User</directive> et <directive + module="mod_unixd">Group</directive> doivent pouvoir écrire dans le + répertoire qui contient le fichier de la base de données des + verrous. Pour des raisons de sécurité, il est recommandé de créer un + répertoire dédié à la base de données des verrous, plutôt que de + modifier les permissions d'un répertoire existant. Dans l'exemple + ci-dessus, Apache va créer des fichiers dans le répertoire + <code>var/</code>, lui-même sous-répertoire du répertoire défini par + la directive <directive + module="core">ServerRoot</directive>, avec le nom de base + <code>DavLock</code> suivi d'une extension choisie par le + serveur.</p> + +</usage> +</directivesynopsis> + +</modulesynopsis> + diff --git a/docs/manual/mod/mod_dav_fs.xml.meta b/docs/manual/mod/mod_dav_fs.xml.meta index cee81360d3..bea303cc75 100644 --- a/docs/manual/mod/mod_dav_fs.xml.meta +++ b/docs/manual/mod/mod_dav_fs.xml.meta @@ -8,6 +8,7 @@ <variants> <variant>en</variant> + <variant>fr</variant> <variant outdated="yes">ja</variant> <variant outdated="yes">ko</variant> </variants> diff --git a/docs/manual/mod/mod_dav_lock.html b/docs/manual/mod/mod_dav_lock.html index 9c5bb17fd2..81b865ab21 100644 --- a/docs/manual/mod/mod_dav_lock.html +++ b/docs/manual/mod/mod_dav_lock.html @@ -4,6 +4,10 @@ URI: mod_dav_lock.html.en Content-Language: en Content-type: text/html; charset=ISO-8859-1 +URI: mod_dav_lock.html.fr +Content-Language: fr +Content-type: text/html; charset=ISO-8859-1 + URI: mod_dav_lock.html.ja.utf8 Content-Language: ja Content-type: text/html; charset=UTF-8 diff --git a/docs/manual/mod/mod_dav_lock.html.fr b/docs/manual/mod/mod_dav_lock.html.fr new file mode 100644 index 0000000000..7a043aa89b --- /dev/null +++ b/docs/manual/mod/mod_dav_lock.html.fr @@ -0,0 +1,137 @@ +<?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><!-- + XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX + This file is generated from xml source: DO NOT EDIT + XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX + --> +<title>mod_dav_lock - Serveur Apache HTTP</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.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/directives.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.4</p> +<img alt="" src="../images/feather.gif" /></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.4</a> > <a href="./">Modules</a></div> +<div id="page-content"> +<div id="preamble"><h1>Module Apache mod_dav_lock</h1> +<div class="toplang"> +<p><span>Langues Disponibles: </span><a href="../en/mod/mod_dav_lock.html" hreflang="en" rel="alternate" title="English"> en </a> | +<a href="../fr/mod/mod_dav_lock.html" title="Français"> fr </a> | +<a href="../ja/mod/mod_dav_lock.html" hreflang="ja" rel="alternate" title="Japanese"> ja </a></p> +</div> +<table class="module"><tr><th><a href="module-dict.html#Description">Description:</a></th><td>Module de verrouillage générique pour +<code class="module"><a href="../mod/mod_dav.html">mod_dav</a></code></td></tr> +<tr><th><a href="module-dict.html#Status">Statut:</a></th><td>Extension</td></tr> +<tr><th><a href="module-dict.html#ModuleIdentifier">Identificateur de Module:</a></th><td>dav_lock_module</td></tr> +<tr><th><a href="module-dict.html#SourceFile">Fichier Source:</a></th><td>mod_dav_lock.c</td></tr> +<tr><th><a href="module-dict.html#Compatibility">Compatibilité:</a></th><td>Disponible depuis la version 2.1 d'Apache</td></tr></table> +<h3>Sommaire</h3> + + <p>ce module implémente une API de verrouillage générique que tout + fournisseur support de <code class="module"><a href="../mod/mod_dav.html">mod_dav</a></code> peut utiliser. Son + activation nécessite l'utilisation de <code class="module"><a href="../mod/mod_dav.html">mod_dav</a></code>. Mais + sans fournisseur support pour l'utiliser, il n'est d'aucun service + et ne doit pas être chargé dans le serveur. <a href="http://subversion.apache.org/">mod_dav_svn</a>, le module qui + implémente le fournisseur subversion, est un exemple + de module de support qui utilise effectivement + <code class="module"><a href="../mod/mod_dav_lock.html">mod_dav_lock</a></code>.</p> + + <p>Notez que <code class="module"><a href="../mod/mod_dav_fs.html">mod_dav_fs</a></code> n'a <em>pas</em> besoin de + ce module de verrouillage générique, car il utilise sa propre + version plus spécifique.</p> + + <p>Pour que <code class="module"><a href="../mod/mod_dav_lock.html">mod_dav_lock</a></code> puisse fonctionner, il + vous suffit de spécifier le chemin de la base de données des verrous + à l'aide de la directive <code class="directive"><a href="#davgenericlockdb">DavGenericLockDB</a></code> décrite + ci-dessous.</p> + + <div class="note"><h3>Note du développeur</h3> + <p>Pour déterminer le pointeur de la fonction du fournisseur de + verrouillage, vous devez utiliser l'API + <code>ap_lookup_provider</code> avec les arguments + <code>dav-lock</code>, <code>generic</code> et <code>0</code>.</p> + </div> +</div> +<div id="quickview"><h3 class="directives">Directives</h3> +<ul id="toc"> +<li><img alt="" src="../images/down.gif" /> <a href="#davgenericlockdb">DavGenericLockDB</a></li> +</ul> +<h3>Voir aussi</h3> +<ul class="seealso"> +<li><code class="module"><a href="../mod/mod_dav.html">mod_dav</a></code></li> +</ul><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="directive-section"><h2><a name="DavGenericLockDB" id="DavGenericLockDB">DavGenericLockDB</a> <a name="davgenericlockdb" id="davgenericlockdb">Directive</a></h2> +<table class="directive"> +<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Chemin de la base de données des verrous DAV</td></tr> +<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>DavGenericLockDB <var>chemin fichier</var></code></td></tr> +<tr><th><a href="directive-dict.html#Context">Contexte:</a></th><td>configuration du serveur, serveur virtuel, répertoire</td></tr> +<tr><th><a href="directive-dict.html#Status">Statut:</a></th><td>Extension</td></tr> +<tr><th><a href="directive-dict.html#Module">Module:</a></th><td>mod_dav_lock</td></tr> +</table> + <p>La directive <code class="directive">DavLockDB</code> permet de spécifier + le chemin complet de la base de données des verrous, sans extension. + 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>. L'implémentation de + <code class="module"><a href="../mod/mod_dav_lock.html">mod_dav_lock</a></code> utilise une base de données SDBM pour + surveiller les verrous utilisateurs.</p> + + <div class="example"><h3>Exemple</h3><pre class="prettyprint lang-config"> + DavGenericLockDB var/DavLock + </pre> +</div> + + <p>Les utilisateur et groupe sous lesquels Apache s'exécute et qui + sont respectivement définis par les directives <code class="directive"><a href="../mod/mod_unixd.html#user">User</a></code> et <code class="directive"><a href="../mod/mod_unixd.html#group">Group</a></code> doivent pouvoir écrire dans le + répertoire qui contient le fichier de la base de données des + verrous. Pour des raisons de sécurité, il est recommandé de créer un + répertoire dédié à la base de données des verrous, plutôt que de + modifier les permissions d'un répertoire existant. Dans l'exemple + ci-dessus, Apache va créer des fichiers dans le répertoire + <code>var/</code>, lui-même sous-répertoire du répertoire défini par + la directive <code class="directive"><a href="../mod/core.html#serverroot">ServerRoot</a></code>, avec le nom de base + <code>DavLock</code> suivi d'une extension choisie par le + serveur.</p> + + +</div> +</div> +<div class="bottomlang"> +<p><span>Langues Disponibles: </span><a href="../en/mod/mod_dav_lock.html" hreflang="en" rel="alternate" title="English"> en </a> | +<a href="../fr/mod/mod_dav_lock.html" title="Français"> fr </a> | +<a href="../ja/mod/mod_dav_lock.html" hreflang="ja" rel="alternate" title="Japanese"> ja </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/2.4/mod/mod_dav_lock.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 2013 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/directives.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 diff --git a/docs/manual/mod/mod_dav_lock.xml.fr b/docs/manual/mod/mod_dav_lock.xml.fr new file mode 100644 index 0000000000..7c9de7523e --- /dev/null +++ b/docs/manual/mod/mod_dav_lock.xml.fr @@ -0,0 +1,109 @@ +<?xml version="1.0"?> +<!DOCTYPE modulesynopsis SYSTEM "../style/modulesynopsis.dtd"> +<?xml-stylesheet type="text/xsl" href="../style/manual.fr.xsl"?> +<!-- English Revision : 1370909 --> +<!-- 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_dav_lock.xml.meta"> + +<name>mod_dav_lock</name> +<description>Module de verrouillage générique pour +<module>mod_dav</module></description> +<status>Extension</status> +<sourcefile>mod_dav_lock.c</sourcefile> +<identifier>dav_lock_module</identifier> +<compatibility>Disponible depuis la version 2.1 d'Apache</compatibility> + +<summary> + <p>ce module implémente une API de verrouillage générique que tout + fournisseur support de <module>mod_dav</module> peut utiliser. Son + activation nécessite l'utilisation de <module>mod_dav</module>. Mais + sans fournisseur support pour l'utiliser, il n'est d'aucun service + et ne doit pas être chargé dans le serveur. <a + href="http://subversion.apache.org/">mod_dav_svn</a>, le module qui + implémente le fournisseur subversion, est un exemple + de module de support qui utilise effectivement + <module>mod_dav_lock</module>.</p> + + <p>Notez que <module>mod_dav_fs</module> n'a <em>pas</em> besoin de + ce module de verrouillage générique, car il utilise sa propre + version plus spécifique.</p> + + <p>Pour que <module>mod_dav_lock</module> puisse fonctionner, il + vous suffit de spécifier le chemin de la base de données des verrous + à l'aide de la directive <directive + module="mod_dav_lock">DavGenericLockDB</directive> décrite + ci-dessous.</p> + + <note><title>Note du développeur</title> + <p>Pour déterminer le pointeur de la fonction du fournisseur de + verrouillage, vous devez utiliser l'API + <code>ap_lookup_provider</code> avec les arguments + <code>dav-lock</code>, <code>generic</code> et <code>0</code>.</p> + </note> +</summary> +<seealso><module>mod_dav</module></seealso> + +<directivesynopsis> +<name>DavGenericLockDB</name> +<description>Chemin de la base de données des verrous DAV</description> +<syntax>DavGenericLockDB <var>chemin fichier</var></syntax> +<contextlist><context>server config</context><context>virtual +host</context> +<context>directory</context> +</contextlist> + +<usage> + <p>La directive <directive>DavLockDB</directive> permet de spécifier + le chemin complet de la base de données des verrous, sans extension. + Si le chemin n'est pas absolu, il sera considéré comme relatif au + répertoire défini par la directive <directive + module="core">ServerRoot</directive>. L'implémentation de + <module>mod_dav_lock</module> utilise une base de données SDBM pour + surveiller les verrous utilisateurs.</p> + + <example><title>Exemple</title> + <highlight language="config"> + DavGenericLockDB var/DavLock + </highlight> + </example> + + <p>Les utilisateur et groupe sous lesquels Apache s'exécute et qui + sont respectivement définis par les directives <directive + module="mod_unixd">User</directive> et <directive + module="mod_unixd">Group</directive> doivent pouvoir écrire dans le + répertoire qui contient le fichier de la base de données des + verrous. Pour des raisons de sécurité, il est recommandé de créer un + répertoire dédié à la base de données des verrous, plutôt que de + modifier les permissions d'un répertoire existant. Dans l'exemple + ci-dessus, Apache va créer des fichiers dans le répertoire + <code>var/</code>, lui-même sous-répertoire du répertoire défini par + la directive <directive + module="core">ServerRoot</directive>, avec le nom de base + <code>DavLock</code> suivi d'une extension choisie par le + serveur.</p> + +</usage> +</directivesynopsis> + +</modulesynopsis> + diff --git a/docs/manual/mod/mod_dav_lock.xml.meta b/docs/manual/mod/mod_dav_lock.xml.meta index 19a70cc4f2..3c40c2c19b 100644 --- a/docs/manual/mod/mod_dav_lock.xml.meta +++ b/docs/manual/mod/mod_dav_lock.xml.meta @@ -8,6 +8,7 @@ <variants> <variant>en</variant> + <variant>fr</variant> <variant outdated="yes">ja</variant> </variants> </metafile> diff --git a/docs/manual/mod/mod_example.html b/docs/manual/mod/mod_example.html index 6da80488e8..be518f6a68 100644 --- a/docs/manual/mod/mod_example.html +++ b/docs/manual/mod/mod_example.html @@ -4,6 +4,10 @@ URI: mod_example.html.en Content-Language: en Content-type: text/html; charset=ISO-8859-1 +URI: mod_example.html.fr +Content-Language: fr +Content-type: text/html; charset=ISO-8859-1 + URI: mod_example.html.ko.euc-kr Content-Language: ko Content-type: text/html; charset=EUC-KR diff --git a/docs/manual/mod/mod_example.html.fr b/docs/manual/mod/mod_example.html.fr new file mode 100644 index 0000000000..17f0dad1ef --- /dev/null +++ b/docs/manual/mod/mod_example.html.fr @@ -0,0 +1,196 @@ +<?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><!-- + XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX + This file is generated from xml source: DO NOT EDIT + XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX + --> +<title>mod_example - Serveur Apache HTTP</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.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/directives.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.4</p> +<img alt="" src="../images/feather.gif" /></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.4</a> > <a href="./">Modules</a></div> +<div id="page-content"> +<div id="preamble"><h1>Module Apache mod_example</h1> +<div class="toplang"> +<p><span>Langues Disponibles: </span><a href="../en/mod/mod_example.html" hreflang="en" rel="alternate" title="English"> en </a> | +<a href="../fr/mod/mod_example.html" title="Français"> fr </a> | +<a href="../ko/mod/mod_example.html" hreflang="ko" rel="alternate" title="Korean"> ko </a></p> +</div> +<table class="module"><tr><th><a href="module-dict.html#Description">Description:</a></th><td>Illustration de l'API des modules Apache</td></tr> +<tr><th><a href="module-dict.html#Status">Statut:</a></th><td>Expérimental</td></tr> +<tr><th><a href="module-dict.html#ModuleIdentifier">Identificateur de Module:</a></th><td>example_module</td></tr> +<tr><th><a href="module-dict.html#SourceFile">Fichier Source:</a></th><td>mod_example.c</td></tr></table> +<h3>Sommaire</h3> + + <p>Certains fichiers situés dans le répertoire + <code>modules/experimental</code> de l'arborescence de la + distribution d'Apache sont fournis à titre d'exemples pour ceux qui + souhaitent écrire des modules qui utilisent l'API d'Apache.</p> + + <p>Le fichier principal est <code>mod_example.c</code>, qui + constitue une illustration exhaustive des différents mécanismes et + syntaxes d'appels. En aucun cas un module additionnel n'aura à + inclure des routines pour tous les appels - il n'en nécessitera au + contraire qu'un petit nombre !</p> + + <p>Le module example fonctionne réellement. Si vous le chargez dans + votre serveur, activez le gestionnaire "example-handler" dans une + section location, et essayez d'accéder à la zone du site web + correspondante, vous verrez s'afficher certaines sorties que le + module example produit au cours des différents appels.</p> +</div> +<div id="quickview"><h3 class="directives">Directives</h3> +<ul id="toc"> +<li><img alt="" src="../images/down.gif" /> <a href="#example">Example</a></li> +</ul> +<h3>Sujets</h3> +<ul id="topics"> +<li><img alt="" src="../images/down.gif" /> <a href="#compiling">Compilation du module example</a></li> +<li><img alt="" src="../images/down.gif" /> <a href="#using">Utilisation du module +<code>mod_example</code></a></li> +</ul><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="compiling" id="compiling">Compilation du module example</a></h2> + + <p>Pour inclure le module example dans votre serveur, effectuez les + étapes suivantes :</p> + + <ol> + <li>Exécutez <code class="program"><a href="../programs/configure.html">configure</a></code> avec l'option + <code>--enable-example</code>.</li> + + <li>Compilez le serveur (exécutez la commande + "<code>make</code>").</li> + </ol> + + <p>Pour ajouter votre propre module :</p> + + <ol class="up-A"> + <li><code>cp modules/experimental/mod_example.c + modules/nouveau_module/<em>mod_monexemple.c</em></code></li> + + <li>Modifiez le fichier.</li> + + <li>Créez <code>modules/nouveau_module/config.m4</code>. + <ol> + <li>Ajoutez <code>APACHE_MODPATH_INIT(nouveau_module)</code>.</li> + <li>Copiez la ligne APACHE_MODULE contenant "example" depuis + <code>modules/experimental/config.m4</code>.</li> + <li>Remplacez le premier argument "example" par + <em>monexemple</em>.</li> + <li>Remplacez le second argument par une brève description de + votre module. Cette description sera utilisée par la commande + <code>configure --help</code>.</li> + <li>Si la compilation de votre module nécessite des drapeaux + de compilation C, des drapeaux d'édition de liens, ou de + bibliothèques supplémentaires, ajoutez les respectivement à + CFLAGS, LDFLAGS et LIBS. Reportez-vous aux fichiers + <code>config.m4</code> des répertoires des autres modules pour + plus d'exemples.</li> + <li>Ajoutez <code>APACHE_MODPATH_FINISH</code>.</li> + </ol> + </li> + + <li>Créez le fichier + <code>module/nouveau_module/Makefile.in</code>. + Si la compilation de votre module ne nécessite pas d'instructions + particulières, ce fichier ne doit contenir que la ligne + <code>include $(top_srcdir)/build/special.mk</code>.</li> + + <li>Exécutez ./buildconf à la racine du répertoire.</li> + + <li>Compilez le serveur après avoir exécuté la commande configure + avec l'option --enable-monexemple.</li> + + </ol> +</div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div> +<div class="section"> +<h2><a name="using" id="using">Utilisation du module +<code>mod_example</code></a></h2> + + <p>Pour activer le module example, ajoutez à votre fichier + <code>httpd.conf</code> un bloc du style :</p> +<pre class="prettyprint lang-config"> +<Location /example-info> + SetHandler example-handler +</Location> +</pre> + + + <p>Vous pouvez aussi ajouter ce qui suit dans un fichier <a href="core.html#accessfilename"><code>.htaccess</code></a>, puis + accéder au fichier "test.example" à partir du répertoire + correspondant :</p> + +<pre class="prettyprint lang-config"> + AddHandler example-handler .example + </pre> + + + <p>Après avoir rechargé la configuration ou redémarré votre serveur, + vous devriez pouvoir accéder à ce fichier et voir s'afficher ce qui + a été décrit plus haut.</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="Example" id="Example">Example</a> <a name="example" id="example">Directive</a></h2> +<table class="directive"> +<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Directive de démonstration pour illustrer l'API des modules +Apache</td></tr> +<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>Example</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#Status">Statut:</a></th><td>Expérimental</td></tr> +<tr><th><a href="directive-dict.html#Module">Module:</a></th><td>mod_example</td></tr> +</table> + <p>La directive <code class="directive">Example</code> n'a pour fonction que + de définir un drapeau de démonstration que le gestionnaire de + contenu du module example va afficher. Elle ne possède aucun + argument. Si vous naviguez vers une URL à laquelle le gestionnaire + de contenu example s'applique, vous verrez s'afficher les routines + du module, ainsi que l'ordre dans lequel elles ont été appelées pour + servir le document demandé. On peut observer l'effet de cette + directive dans la phrase "<code>Example + directive declared here: YES/NO</code>".</p> + +</div> +</div> +<div class="bottomlang"> +<p><span>Langues Disponibles: </span><a href="../en/mod/mod_example.html" hreflang="en" rel="alternate" title="English"> en </a> | +<a href="../fr/mod/mod_example.html" title="Français"> fr </a> | +<a href="../ko/mod/mod_example.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/2.4/mod/mod_example.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 2013 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/directives.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 diff --git a/docs/manual/mod/mod_example.xml.fr b/docs/manual/mod/mod_example.xml.fr new file mode 100644 index 0000000000..d96bf8c350 --- /dev/null +++ b/docs/manual/mod/mod_example.xml.fr @@ -0,0 +1,154 @@ +<?xml version="1.0"?> +<!DOCTYPE modulesynopsis SYSTEM "../style/modulesynopsis.dtd"> +<?xml-stylesheet type="text/xsl" href="../style/manual.fr.xsl"?> +<!-- English Revision : 1334016 --> +<!-- 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_example.xml.meta"> + +<name>mod_example</name> +<description>Illustration de l'API des modules Apache</description> +<status>Experimental</status> +<sourcefile>mod_example.c</sourcefile> +<identifier>example_module</identifier> + +<summary> + <p>Certains fichiers situés dans le répertoire + <code>modules/experimental</code> de l'arborescence de la + distribution d'Apache sont fournis à titre d'exemples pour ceux qui + souhaitent écrire des modules qui utilisent l'API d'Apache.</p> + + <p>Le fichier principal est <code>mod_example.c</code>, qui + constitue une illustration exhaustive des différents mécanismes et + syntaxes d'appels. En aucun cas un module additionnel n'aura à + inclure des routines pour tous les appels - il n'en nécessitera au + contraire qu'un petit nombre !</p> + + <p>Le module example fonctionne réellement. Si vous le chargez dans + votre serveur, activez le gestionnaire "example-handler" dans une + section location, et essayez d'accéder à la zone du site web + correspondante, vous verrez s'afficher certaines sorties que le + module example produit au cours des différents appels.</p> +</summary> + +<section id="compiling"><title>Compilation du module example</title> + + <p>Pour inclure le module example dans votre serveur, effectuez les + étapes suivantes :</p> + + <ol> + <li>Exécutez <program>configure</program> avec l'option + <code>--enable-example</code>.</li> + + <li>Compilez le serveur (exécutez la commande + "<code>make</code>").</li> + </ol> + + <p>Pour ajouter votre propre module :</p> + + <ol type="A"> + <li><code>cp modules/experimental/mod_example.c + modules/nouveau_module/<em>mod_monexemple.c</em></code></li> + + <li>Modifiez le fichier.</li> + + <li>Créez <code>modules/nouveau_module/config.m4</code>. + <ol> + <li>Ajoutez <code>APACHE_MODPATH_INIT(nouveau_module)</code>.</li> + <li>Copiez la ligne APACHE_MODULE contenant "example" depuis + <code>modules/experimental/config.m4</code>.</li> + <li>Remplacez le premier argument "example" par + <em>monexemple</em>.</li> + <li>Remplacez le second argument par une brève description de + votre module. Cette description sera utilisée par la commande + <code>configure --help</code>.</li> + <li>Si la compilation de votre module nécessite des drapeaux + de compilation C, des drapeaux d'édition de liens, ou de + bibliothèques supplémentaires, ajoutez les respectivement à + CFLAGS, LDFLAGS et LIBS. Reportez-vous aux fichiers + <code>config.m4</code> des répertoires des autres modules pour + plus d'exemples.</li> + <li>Ajoutez <code>APACHE_MODPATH_FINISH</code>.</li> + </ol> + </li> + + <li>Créez le fichier + <code>module/nouveau_module/Makefile.in</code>. + Si la compilation de votre module ne nécessite pas d'instructions + particulières, ce fichier ne doit contenir que la ligne + <code>include $(top_srcdir)/build/special.mk</code>.</li> + + <li>Exécutez ./buildconf à la racine du répertoire.</li> + + <li>Compilez le serveur après avoir exécuté la commande configure + avec l'option --enable-monexemple.</li> + + </ol> +</section> + +<section id="using"><title>Utilisation du module +<code>mod_example</code></title> + + <p>Pour activer le module example, ajoutez à votre fichier + <code>httpd.conf</code> un bloc du style :</p> +<highlight language="config"> +<Location /example-info> + SetHandler example-handler +</Location> +</highlight> + + <p>Vous pouvez aussi ajouter ce qui suit dans un fichier <a + href="core.html#accessfilename"><code>.htaccess</code></a>, puis + accéder au fichier "test.example" à partir du répertoire + correspondant :</p> + +<highlight language="config"> + AddHandler example-handler .example + </highlight> + + <p>Après avoir rechargé la configuration ou redémarré votre serveur, + vous devriez pouvoir accéder à ce fichier et voir s'afficher ce qui + a été décrit plus haut.</p> +</section> + +<directivesynopsis> +<name>Example</name> +<description>Directive de démonstration pour illustrer l'API des modules +Apache</description> +<syntax>Example</syntax> +<contextlist><context>server config</context> +<context>virtual host</context><context>directory</context> +<context>.htaccess</context></contextlist> + +<usage> + <p>La directive <directive>Example</directive> n'a pour fonction que + de définir un drapeau de démonstration que le gestionnaire de + contenu du module example va afficher. Elle ne possède aucun + argument. Si vous naviguez vers une URL à laquelle le gestionnaire + de contenu example s'applique, vous verrez s'afficher les routines + du module, ainsi que l'ordre dans lequel elles ont été appelées pour + servir le document demandé. On peut observer l'effet de cette + directive dans la phrase "<code>Example + directive declared here: YES/NO</code>".</p> +</usage> +</directivesynopsis> + +</modulesynopsis> diff --git a/docs/manual/mod/mod_example.xml.meta b/docs/manual/mod/mod_example.xml.meta index e0bc66bf59..ddb2541c37 100644 --- a/docs/manual/mod/mod_example.xml.meta +++ b/docs/manual/mod/mod_example.xml.meta @@ -8,6 +8,7 @@ <variants> <variant>en</variant> + <variant>fr</variant> <variant outdated="yes">ko</variant> </variants> </metafile> diff --git a/docs/manual/mod/mod_filter.html b/docs/manual/mod/mod_filter.html index 19725c63c6..7d163ef484 100644 --- a/docs/manual/mod/mod_filter.html +++ b/docs/manual/mod/mod_filter.html @@ -3,3 +3,7 @@ URI: mod_filter.html.en Content-Language: en Content-type: text/html; charset=ISO-8859-1 + +URI: mod_filter.html.fr +Content-Language: fr +Content-type: text/html; charset=ISO-8859-1 diff --git a/docs/manual/mod/mod_filter.html.en b/docs/manual/mod/mod_filter.html.en index e75fc7a6b3..56f19e7b1f 100644 --- a/docs/manual/mod/mod_filter.html.en +++ b/docs/manual/mod/mod_filter.html.en @@ -24,7 +24,8 @@ <div id="page-content"> <div id="preamble"><h1>Apache Module mod_filter</h1> <div class="toplang"> -<p><span>Available Languages: </span><a href="../en/mod/mod_filter.html" title="English"> en </a></p> +<p><span>Available Languages: </span><a href="../en/mod/mod_filter.html" title="English"> en </a> | +<a href="../fr/mod/mod_filter.html" hreflang="fr" rel="alternate" title="Français"> fr </a></p> </div> <table class="module"><tr><th><a href="module-dict.html#Description">Description:</a></th><td>Context-sensitive smart filter configuration module</td></tr> <tr><th><a href="module-dict.html#Status">Status:</a></th><td>Base</td></tr> @@ -496,7 +497,8 @@ for a complete reference and examples.</li> </div> </div> <div class="bottomlang"> -<p><span>Available Languages: </span><a href="../en/mod/mod_filter.html" title="English"> en </a></p> +<p><span>Available Languages: </span><a href="../en/mod/mod_filter.html" title="English"> en </a> | +<a href="../fr/mod/mod_filter.html" hreflang="fr" rel="alternate" title="Français"> fr </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">Comments</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'; diff --git a/docs/manual/mod/mod_filter.html.fr b/docs/manual/mod/mod_filter.html.fr new file mode 100644 index 0000000000..914c453678 --- /dev/null +++ b/docs/manual/mod/mod_filter.html.fr @@ -0,0 +1,569 @@ +<?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><!-- + XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX + This file is generated from xml source: DO NOT EDIT + XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX + --> +<title>mod_filter - Serveur Apache HTTP</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.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/directives.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.4</p> +<img alt="" src="../images/feather.gif" /></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.4</a> > <a href="./">Modules</a></div> +<div id="page-content"> +<div id="preamble"><h1>Module Apache mod_filter</h1> +<div class="toplang"> +<p><span>Langues Disponibles: </span><a href="../en/mod/mod_filter.html" hreflang="en" rel="alternate" title="English"> en </a> | +<a href="../fr/mod/mod_filter.html" title="Français"> fr </a></p> +</div> +<table class="module"><tr><th><a href="module-dict.html#Description">Description:</a></th><td>Module de configuration de filtre intelligent sensible au +contexte</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>filter_module</td></tr> +<tr><th><a href="module-dict.html#SourceFile">Fichier Source:</a></th><td>mod_filter.c</td></tr> +<tr><th><a href="module-dict.html#Compatibility">Compatibilité:</a></th><td>Versions 2.1 et supérieures</td></tr></table> +<h3>Sommaire</h3> + + <p>Ce module permet une configuration intelligente et dépendant du + contexte des filtres de contenu en sortie. Par exemple, Apache peut + être configuré pour faire traiter différents types de contenus par + différents filtres, même lorsque le type de contenu n'est pas connu + à l'avance (par exemple dans un serveur mandataire).</p> + + <p>Le fonctionnement de <code class="module"><a href="../mod/mod_filter.html">mod_filter</a></code> consiste à + introduire des branchements dans la chaîne de filtrage. Plutôt que + d'insérer directement des filtres dans la chaîne, on insère un + sélecteur de filtre qui va effectuer un branchement conditionnel + vers un fournisseur de filtre. <code class="module"><a href="../mod/mod_filter.html">mod_filter</a></code> peut + utiliser tout filtre de contenu comme fournisseur ; aucune + modification des modules de filtrage existants n'est nécessaire + (bien qu'il soit tout de même possible de les simplifier).</p> +</div> +<div id="quickview"><h3 class="directives">Directives</h3> +<ul id="toc"> +<li><img alt="" src="../images/down.gif" /> <a href="#addoutputfilterbytype">AddOutputFilterByType</a></li> +<li><img alt="" src="../images/down.gif" /> <a href="#filterchain">FilterChain</a></li> +<li><img alt="" src="../images/down.gif" /> <a href="#filterdeclare">FilterDeclare</a></li> +<li><img alt="" src="../images/down.gif" /> <a href="#filterprotocol">FilterProtocol</a></li> +<li><img alt="" src="../images/down.gif" /> <a href="#filterprovider">FilterProvider</a></li> +<li><img alt="" src="../images/down.gif" /> <a href="#filtertrace">FilterTrace</a></li> +</ul> +<h3>Sujets</h3> +<ul id="topics"> +<li><img alt="" src="../images/down.gif" /> <a href="#smart">Filtrage intelligent</a></li> +<li><img alt="" src="../images/down.gif" /> <a href="#terms">Déclarations de filtres, fournisseurs et +chaînes</a></li> +<li><img alt="" src="../images/down.gif" /> <a href="#config">Configuration de la chaîne de +filtrage</a></li> +<li><img alt="" src="../images/down.gif" /> <a href="#errordocs">Filtrage et statut de la réponse</a></li> +<li><img alt="" src="../images/down.gif" /> <a href="#upgrade">Mise à jour depuis une configuration du +serveur HTTP Apache 2.2</a></li> +<li><img alt="" src="../images/down.gif" /> <a href="#examples">Exemples</a></li> +<li><img alt="" src="../images/down.gif" /> <a href="#protocol">Gestion de protocole</a></li> +</ul><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="smart" id="smart">Filtrage intelligent</a></h2> + <p>Dans le modèle de filtrage traditionnel, les filtres sont insérés + sans condition à l'aide de la directive <code class="directive"><a href="../mod/mod_mime.html#addoutputfilter">AddOutputFilter</a></code> et des directives + apparentées. Chaque filtre doit ensuite déterminer s'il doit + s'exécuter ou non, et les administrateurs du serveur disposent de + peu de souplesse pour faire en sorte que la chaîne soit traitée de + manière dynamique.</p> + + <p><code class="module"><a href="../mod/mod_filter.html">mod_filter</a></code>, à l'opposé, fournit aux + administrateurs du serveur un grand degré de souplesse pour + configurer la chaîne de filtrage. Concrètement, la décision + d'insérer un filtre peut être prise en fonction d'une <a href="../expr.html">expression</a> booléenne complexe. Ceci + généralise le fonctionnement relativement souple de la directive + <code class="directive">AddOutputFilterByType</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="terms" id="terms">Déclarations de filtres, fournisseurs et +chaînes</a></h2> + <p class="figure"> + <img src="../images/mod_filter_old.gif" width="160" height="310" alt="[Cette image illustre le modèle de filtrage traditionnel]" /><br /> + <dfn>Figure 1:</dfn> Le modèle de filtrage traditionnel</p> + + <p>Dans le modèle traditionnel, les filtres en sortie constituent + une simple chaîne s'étendant depuis le générateur de contenu (ou + gestionnaire) jusqu'au client. Ce fonctionnement peut convenir si la + chaîne de filtrage peut être correctement configurée, mais pose + problème lorsque cette chaîne doit être configurée dynamiquement en + fonction de la sortie du gestionnaire.</p> + + <p class="figure"> + <img src="../images/mod_filter_new.gif" width="423" height="331" alt="[Cette image illustre le modèle de fonctionnement de mod_filter]" /><br /> + <dfn>Figure 2:</dfn> Le modèle de fonctionnement de + <code class="module"><a href="../mod/mod_filter.html">mod_filter</a></code></p> + + <p>Le fonctionnement de <code class="module"><a href="../mod/mod_filter.html">mod_filter</a></code> consiste à + introduire des branchements dans la chaîne de filtrage. Plutôt que + d'insérer directement des filtres dans la chaîne, on insère un + sélecteur de filtre qui va effectuer un branchement conditionnel + vers un fournisseur de filtre. <code class="module"><a href="../mod/mod_filter.html">mod_filter</a></code> peut + utiliser tout filtre de contenu comme fournisseur ; aucune + modification des modules de filtrage existants n'est nécessaire + (bien qu'il soit tout de même possible de les simplifier). Il peut y + avoir plusieurs fournisseurs pour un seul filtre, mais un seul + fournisseur sera choisi pour chaque requête.</p> + + <p>Une chaîne de filtrage peut comporter autant d'instances du + sélecteur de filtre que l'on souhaite, chacune d'entre elles pouvant + disposer de plusieurs fournisseurs. Un sélecteur de filtre possédant + un seul fournisseur dont le choix est inconditionnel constitue un + cas particulier : cette situation est équivalente à l'insertion + directe du filtre dans la chaîne.</p> +</div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div> +<div class="section"> +<h2><a name="config" id="config">Configuration de la chaîne de +filtrage</a></h2> + <p>Trois étapes sont nécessaires pour configurer une chaîne de + filtrage avec <code class="module"><a href="../mod/mod_filter.html">mod_filter</a></code>. Voir ci-dessous la + description détaillée des directives.</p> + + <dl> + <dt>Déclaration des filtres</dt> + <dd>La directive <code class="directive"><a href="#filterdeclare">FilterDeclare</a></code> permet de déclarer un + filtre en lui assignant un nom et un type. Elle n'est obligatoire + que si le filtre n'est pas du type par défaut + AP_FTYPE_RESOURCE.</dd> + + <dt>Enregistrement des fournisseurs</dt> + <dd>La directive <code class="directive"><a href="#filterprovider">FilterProvider</a></code> permet d'associer un + fournisseur à un filtre. Le filtre a été éventuellement déclaré à + l'aide de la directive <code class="directive"><a href="#filterdeclare">FilterDeclare</a></code> ; si ce n'est pas le cas, FilterProvider + va le déclarer implicitement avec le type par défaut + AP_FTYPE_RESOURCE. Le fournisseur doit avoir été enregistré à + l'aide de <code>ap_register_output_filter</code> par un module + quelconque. Le dernier argument de la directive <code class="directive"><a href="#filterprovider">FilterProvider</a></code> est une expression : + le fournisseur s'exécutera pour une requête si et seulement si + l'expression est évaluée vraie. L'expression peut évaluer une + requête HTTP ou les en-têtes de la réponse, des variables + d'environnement, ou le gestionnaire utilisé par cette requête. À la + différence des version précédentes, mod_filter supporte désormais + les expressions complexes associant des critères multiples au moyen + d'une logique AND / OR (&& / ||) et de parenthèses. Pour les + détails sur la syntaxe de l'expression, voir la <a href="../expr.html">documentation sur ap_expr</a>.</dd> + + <dt>Configuration de la chaîne de filtrage</dt> + <dd>Les directives ci-dessus permettent d'élaborer les éléments + d'une chaîne de filtrage intelligente, mais pas de les configurer en + vue de leur exécution. La directive <code class="directive"><a href="#filterchain">FilterChain</a></code> élabore une chaîne de filtrage à + partir de filtres intelligents déclarés, permettant avec souplesse + d'insérer des filtres au début ou à la fin de la chaîne, de + supprimer un filtre ou même la chaîne complète.</dd> +</dl> +</div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div> +<div class="section"> +<h2><a name="errordocs" id="errordocs">Filtrage et statut de la réponse</a></h2> + <p>Normalement, mod_filter n'applique les filtres qu'aux réponses + possédant un statut HTTP 200 (OK). Pour pouvoir filtrer des + documents possédant un autre statut, vous devez définir la variable + d'environnement <var>filter-errordocs</var>, les réponses étant + alors filtrées sans se préoccuper de leur statut. Pour définir ce + comportement de manière plus fine, vous pouvez utiliser des + conditions dans la directive + <code class="directive">FilterProvider</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="upgrade" id="upgrade">Mise à jour depuis une configuration du +serveur HTTP Apache 2.2</a></h2> + <p>La directive <code class="directive"><a href="#filterprovider">FilterProvider</a></code> a été modifiée par + rapport à httpd 2.2 : les arguments <var>match</var> et + <var>dispatch</var> ont été remplacés par l'argument unique + <var>expression</var> plus polyvalent. En général, il est possible + de convertir une paire match/dispatch vers les deux côtés d'une + expression, de la manière suivante :</p> + <div class="example"><p><code>"dispatch = 'match'"</code></p></div> + <p>Les en-têtes de requête et de réponse et les variables + d'environnement sont maintenant interprétés selon les syntaxes + respectives <var>%{req:foo}</var>, <var>%{resp:foo}</var> et + <var>%{env:foo}</var>. Les variables <var>%{HANDLER}</var> et + <var>%{CONTENT_TYPE}</var> sont également supportées.</p> + <p>Notez que l'évaluation de l'expression ne supporte plus les + comparaisons de sous-chaînes. Ces dernières peuvent + être remplacées par des comparaisons d'expressions rationnelles.</p> +</div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div> +<div class="section"> +<h2><a name="examples" id="examples">Exemples</a></h2> + <dl> + <dt>Inclusions côté serveur (SSI)</dt> + <dd>Un exemple simple de remplacement de la directive <code class="directive"><a href="../mod/core.html#addoutputfilterbytype">AddOutputFilterByType</a></code> + <pre class="prettyprint lang-config"> +FilterDeclare SSI +FilterProvider SSI INCLUDES "%{CONTENT_TYPE} =~ m|^text/html|" +FilterChain SSI + </pre> + + </dd> + + <dt>Inclusions côté serveur (SSI)</dt> + <dd>Même exemple que ci-dessus, mais envoi vers un gestionnaire + (comportement classique des SSI ; les fichiers .shtml sont + traités). + <pre class="prettyprint lang-config"> +FilterProvider SSI INCLUDES "%{HANDLER} = 'server-parsed'" +FilterChain SSI + </pre> + + </dd> + + <dt>Émulation de mod_gzip avec mod_deflate</dt> + <dd>Insertion du filtre INFLATE seulement si l'en-tête + Accept-Encoding a une valeur autre que "gzip". Ce filtre s'exécute + avec le type ftype CONTENT_SET. + <pre class="prettyprint lang-config"> +FilterDeclare gzip CONTENT_SET +FilterProvider gzip inflate "%{req:Accept-Encoding} !~ /gzip/" +FilterChain gzip + </pre> + + </dd> + + <dt>Diminution de la résolution d'une image</dt> + <dd>Supposons que nous voulions réduire la résolution de toutes les + images web, et que nous disposions de filtres pour les images GIF, + JPEG et PNG. + <pre class="prettyprint lang-config"> +FilterProvider unpack jpeg_unpack "%{CONTENT_TYPE} = 'image/jpeg'" +FilterProvider unpack gif_unpack "%{CONTENT_TYPE} = 'image/gif'" +FilterProvider unpack png_unpack "%{CONTENT_TYPE} = 'image/png'" + +FilterProvider downsample downsample_filter "%{CONTENT_TYPE} = m|^image/(jpeg|gif|png)|" +FilterProtocol downsample "change=yes" + +FilterProvider repack jpeg_pack "%{CONTENT_TYPE} = 'image/jpeg'" +FilterProvider repack gif_pack "%{CONTENT_TYPE} = 'image/gif'" +FilterProvider repack png_pack "%{CONTENT_TYPE} = 'image/png'" +<Location /image-filter> + FilterChain unpack downsample repack +</Location> + </pre> + + </dd> + </dl> +</div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div> +<div class="section"> +<h2><a name="protocol" id="protocol">Gestion de protocole</a></h2> + <p>Historiquement, tout filtre doit s'assurer que toute modification + qu'il effectue est correctement représentée dans les en-têtes de la + réponse HTTP, et qu'il ne s'exécutera pas si cette exécution + résultait en une modification interdite. Ceci impose aux auteurs de + filtres la corvée de réimplémenter certaines fonctionnalités + communes dans chaque filtre :</p> + + <ul> + <li>De nombreux filtres modifient les contenus, et de ce fait + invalident les balises de ces contenus, leur somme de + contrôle, leur condensé (hash) existant, ainsi que leur + taille.</li> + + <li>Les filtres qui nécessitent une réponse entière et non tronquée en + entrée, doivent s'assurer qu'il n'ont pas reçu une réponse à une + requête partielle.</li> + + <li>Les filtres qui modifient la sortie d'un autre filtre doivent + s'assurer qu'ils ne violent pas la directive d'un en-tête + <code>Cache-Control: no-transform</code> éventuel.</li> + + <li>Les filtres peuvent agir sur des réponses de façon à ce qu'elles + ne puissent plus être mises en cache.</li> + </ul> + + <p><code class="module"><a href="../mod/mod_filter.html">mod_filter</a></code> a pour but de gérer de manière + générale ces détails de l'implémentation des filtres, réduisant par + là-même la complexité des modules de filtrage de contenu. Le + travail permettant d'atteindre ce but est cependant toujours en + cours ; la directive <code class="directive"><a href="#filterprotocol">FilterProtocol</a></code> + implémente certaines de ces fonctionnalités à des fins de + compatibilité ascendante avec les modules d'Apache 2.0. Pour les + versions 2.1 et supérieures de httpd, les API + <code>ap_register_output_filter_protocol</code> et + <code>ap_filter_protocol</code> permettent aux modules de filtrage + de définir leurs propres comportements.</p> + + <p>Cependant, <code class="module"><a href="../mod/mod_filter.html">mod_filter</a></code> ne doit pas interférer + avec un filtre qui gère déjà tous les aspects du protocole. Par + défaut (c'est à dire en l'absence de toute directive <code class="directive"><a href="#filterprotocol">FilterProtocol</a></code>), + <code class="module"><a href="../mod/mod_filter.html">mod_filter</a></code> ne modifiera donc pas les en-têtes.</p> + + <p>Au moment où ces lignes sont écrites, cette fonctionnalité a été + très peu testée, car les modules d'usage courant ont été conçus pour + fonctionner avec httpd 2.0. Les modules qui l'utilisent devront donc + l'expérimenter avec précautions.</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="AddOutputFilterByType" id="AddOutputFilterByType">AddOutputFilterByType</a> <a name="addoutputfilterbytype" id="addoutputfilterbytype">Directive</a></h2> +<table class="directive"> +<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>assigne un filtre en sortie pour un type de média +particulier</td></tr> +<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>AddOutputFilterByType <var>filtre</var>[;<var>filtre</var>...] +<var>type de média</var> [<var>type de média</var>] ...</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_filter</td></tr> +<tr><th><a href="directive-dict.html#Compatibility">Compatibilité:</a></th><td>Présentait de sévères limitations avant d'être déplacé dans +<code class="module"><a href="../mod/mod_filter.html">mod_filter</a></code> dans la version 2.3.7</td></tr> +</table> + <p>Cette directive active un <a href="../filter.html">filtre</a> en sortie particulier pour une + requête en fonction du <a class="glossarylink" href="../glossary.html#type de média" title="voir glossaire">type de média</a> de la réponse.</p> + + <p>L'exemple suivant active le filtre <code>DEFLATE</code> qui est + fourni par le module <code class="module"><a href="../mod/mod_deflate.html">mod_deflate</a></code>. Il va compresser + toute sortie dont le type MIME est <code>text/html</code> ou + <code>text/plain</code> avant de l'envoyer au client.</p> + + <pre class="prettyprint lang-config"> + AddOutputFilterByType DEFLATE text/html text/plain + </pre> + + + <p>Si vous voulez assigner plusieurs filtres au contenu, leurs noms + doivent être séparés par des points-virgules. On peut aussi utiliser + une directive <code class="directive">AddOutputFilterByType</code> pour + chacun des filtres à assigner.</p> + + <p>La configuration ci-dessous impose le traitement de toute sortie + de script dont le type MIME est <code>text/html</code> en premier + lieu par le filtre <code>INCLUDES</code>, puis par le filtre + <code>DEFLATE</code>.</p> + + <pre class="prettyprint lang-config"> +<Location /cgi-bin/> + Options Includes + AddOutputFilterByType INCLUDES;DEFLATE text/html +</Location> + </pre> + + + +<h3>Voir aussi</h3> +<ul> +<li><code class="directive"><a href="../mod/mod_mime.html#addoutputfilter">AddOutputFilter</a></code></li> +<li><code class="directive"><a href="../mod/core.html#setoutputfilter">SetOutputFilter</a></code></li> +<li><a href="../filter.html">Les filtres</a></li> +</ul> +</div> +<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div> +<div class="directive-section"><h2><a name="FilterChain" id="FilterChain">FilterChain</a> <a name="filterchain" id="filterchain">Directive</a></h2> +<table class="directive"> +<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Configure la chaîne de filtrage</td></tr> +<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>FilterChain [+=-@!]<var>nom filtre</var> <var>...</var></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>Options</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_filter</td></tr> +</table> + <p>Cette directive permet de configurer une chaîne de filtrage + composée de filtres déclarés. <code class="directive">FilterChain</code> + accepte un nombre illimité d'arguments, chacun d'entre eux étant + précédé d'un caractère de contrôle unique qui détermine l'action à + entreprendre :</p> + + <dl> + <dt><code>+<var>nom filtre</var></code></dt> + <dd>Ajoute<var>nom filtre</var> à la fin de la chaîne de filtrage</dd> + + <dt><code>@<var>nom filtre</var></code></dt> + <dd>Ajoute <var>nom filtre</var> au début de la chaîne de filtrage</dd> + + <dt><code>-<var>nom filtre</var></code></dt> + <dd>Supprime <var>nom filtre</var> de la chaîne de filtrage</dd> + + <dt><code>=<var>nom filtre</var></code></dt> + <dd>Supprime tous les filtres de la chaîne de filtrage existante et + les remplace par <var>nom filtre</var></dd> + + <dt><code>!</code></dt> + <dd>Supprime tous les filtres de la chaîne de filtrage existante</dd> + + <dt><code><var>nom filtre</var></code></dt> + <dd>Équivalent à <code>+<var>nom filtre</var></code></dd> + </dl> + +</div> +<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div> +<div class="directive-section"><h2><a name="FilterDeclare" id="FilterDeclare">FilterDeclare</a> <a name="filterdeclare" id="filterdeclare">Directive</a></h2> +<table class="directive"> +<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Déclare un filtre intelligent</td></tr> +<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>FilterDeclare <var>nom filtre</var> <var>[type]</var></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>Options</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_filter</td></tr> +</table> + <p>Cette directive permet de déclarer un filtre en sortie associé à + un en-tête ou une variable d'environnement qui déterminera les + conditions de son exécution. Le premier argument est le <var>nom du + filtre</var> destiné à être utilisé dans les directives <code class="directive"><a href="#filterprovider">FilterProvider</a></code>, <code class="directive"><a href="#filterchain">FilterChain</a></code> et <code class="directive"><a href="#filterprotocol">FilterProtocol</a></code>.</p> + + <p>Le dernier argument (optionnel) est le type du filtre, et peut + prendre les valeurs de <code>ap_filter_type</code>, à savoir + <code>RESOURCE</code> (valeur par défaut), <code>CONTENT_SET</code>, + <code>PROTOCOL</code>, <code>TRANSCODE</code>, + <code>CONNECTION</code> ou <code>NETWORK</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="FilterProtocol" id="FilterProtocol">FilterProtocol</a> <a name="filterprotocol" id="filterprotocol">Directive</a></h2> +<table class="directive"> +<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Vérifie le respect du protocole HTTP</td></tr> +<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>FilterProtocol <var>nom filtre</var> [<var>nom fournisseur</var>] + <var>drapeaux protocole</var></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>Options</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_filter</td></tr> +</table> + <p>Cette directive permet à <code class="module"><a href="../mod/mod_filter.html">mod_filter</a></code> de s'assurer + qu'un filtre ne s'exécutera pas s'il ne doit pas le faire, et que + les en-têtes de la réponse HTTP sont définis correctement en tenant + compte des effets du filtre.</p> + + <p>Cette directive se présente sous deux formes. Avec trois + arguments, elle s'applique de manière spécifique à un <var>nom + filtre</var> et un <var>nom fournisseur</var> pour ce filtre. Avec + deux arguments, elle s'applique à un <var>nom filtre</var> pour + <em>tout</em> fournisseur qu'il actionne.</p> + + <p><var>drapeaux protocole</var> peut contenir un ou plusieurs + drapeaux parmi les suivants :</p> + + <dl> + <dt><code>change=yes</code></dt> + <dd>Le filtre modifie le contenu, y compris éventuellement sa + taille</dd> + + <dt><code>change=1:1</code></dt> + <dd>>Le filtre modifie le contenu, mais pas sa taille</dd> + + <dt><code>byteranges=no</code></dt> + <dd>Le filtre ne peut pas traiter de réponses à des sous-requêtes et + nécessite des réponses complètes en entrée</dd> + + <dt><code>proxy=no</code></dt> + <dd>Le filtre ne doit pas s'exécuter dans un contexte de mandataire</dd> + + <dt><code>proxy=transform</code></dt> + <dd>Le filtre transforme la réponse de manière incompatible avec + l'en-tête HTTP <code>Cache-Control: no-transform</code></dd> + + <dt><code>cache=no</code></dt> + <dd>Le filtre fait en sorte que la sortie ne puisse pas être mise en + cache (par exemple en introduisant des modifications de contenu + aléatoires)</dd> + </dl> + +</div> +<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div> +<div class="directive-section"><h2><a name="FilterProvider" id="FilterProvider">FilterProvider</a> <a name="filterprovider" id="filterprovider">Directive</a></h2> +<table class="directive"> +<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Enregistre un filtre de contenu</td></tr> +<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>FilterProvider <var>nom filtre</var> <var>nom fournisseur</var> + <var>expression</var></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>Options</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_filter</td></tr> +</table> + <p>Cette directive permet d'associer un <em>fournisseur</em> au + filtre intelligent. Le fournisseur sera invoqué si et seulement si + l'<var>expression</var> est évaluée vraie lorsque le sélecteur de + filtre est appelé pour la première fois.</p> + + <p> + <var>nom fournisseur</var> doit avoir été enregistré au cours du + chargement d'un module à l'aide de + <code>ap_register_output_filter</code>. + </p> + + <p><var>expression</var> est une expression <a href="../expr.html">ap_expr</a>.</p> + + +<h3>Voir aussi</h3> +<ul> +<li><a href="../expr.html">Les expressions dans le serveur HTTP +Apache</a>, pour une référence complète et d'autres exemples.</li> +<li><code class="module"><a href="../mod/mod_include.html">mod_include</a></code></li> +</ul> +</div> +<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div> +<div class="directive-section"><h2><a name="FilterTrace" id="FilterTrace">FilterTrace</a> <a name="filtertrace" id="filtertrace">Directive</a></h2> +<table class="directive"> +<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Obtention d'informations de débogage/diagnostique en +provenance de <code class="module"><a href="../mod/mod_filter.html">mod_filter</a></code></td></tr> +<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>FilterTrace <var>nom filtre</var> <var>niveau</var></code></td></tr> +<tr><th><a href="directive-dict.html#Context">Contexte:</a></th><td>configuration du serveur, serveur virtuel, répertoire</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_filter</td></tr> +</table> + <p>Cette directive permet d'obtenir des informations de débogage en + provenance de <code class="module"><a href="../mod/mod_filter.html">mod_filter</a></code>. Elle est conçue pour + aider à tester et déboguer les fournisseurs (ou modules de filtrage) + ; elle peut aussi apporter une aide à l'utilisation de + <code class="module"><a href="../mod/mod_filter.html">mod_filter</a></code> lui-même.</p> + + <p>La sortie de débogage dépend de la définition d'argument + <var>level</var> :</p> + <dl> + <dt><code>0</code> (valeur par défaut)</dt> + <dd>Aucune information de débogage n'est générée.</dd> + + <dt><code>1</code></dt> + <dd><code class="module"><a href="../mod/mod_filter.html">mod_filter</a></code> va enregistrer les ensembles de + conteneurs de données (buckets and brigades) qui traversent le + filtre dans le journal des erreurs, avant que le fournisseur ne les + traite. Ces informations sont similaires à celles générées par <a href="http://apache.webthing.com/mod_diagnostics/">mod_diagnostics</a>. + </dd> + + <dt><code>2</code> (pas encore implémenté)</dt> + <dd>Ce niveau permettra d'enregistrer l'ensemble des données qui + traversent le filtre dans un fichier temporaire avant de les envoyer + au fournisseur. <strong>Pour un débogage mono-utilisateur + seulement</strong> ; l'enregistrement des données concernant + plusieurs requêtes simultannées ne sera pas supporté.</dd> + </dl> + +</div> +</div> +<div class="bottomlang"> +<p><span>Langues Disponibles: </span><a href="../en/mod/mod_filter.html" hreflang="en" rel="alternate" title="English"> en </a> | +<a href="../fr/mod/mod_filter.html" title="Français"> fr </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/2.4/mod/mod_filter.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 2013 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/directives.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 diff --git a/docs/manual/mod/mod_filter.xml.fr b/docs/manual/mod/mod_filter.xml.fr new file mode 100644 index 0000000000..b09601c7df --- /dev/null +++ b/docs/manual/mod/mod_filter.xml.fr @@ -0,0 +1,528 @@ +<?xml version="1.0"?> +<!DOCTYPE modulesynopsis SYSTEM "../style/modulesynopsis.dtd"> +<?xml-stylesheet type="text/xsl" href="../style/manual.fr.xsl"?> +<!-- English Revision : 1421892 --> +<!-- 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_filter.xml.meta"> + +<name>mod_filter</name> +<description>Module de configuration de filtre intelligent sensible au +contexte</description> +<status>Base</status> +<sourcefile>mod_filter.c</sourcefile> +<identifier>filter_module</identifier> +<compatibility>Versions 2.1 et supérieures</compatibility> + +<summary> + <p>Ce module permet une configuration intelligente et dépendant du + contexte des filtres de contenu en sortie. Par exemple, Apache peut + être configuré pour faire traiter différents types de contenus par + différents filtres, même lorsque le type de contenu n'est pas connu + à l'avance (par exemple dans un serveur mandataire).</p> + + <p>Le fonctionnement de <module>mod_filter</module> consiste à + introduire des branchements dans la chaîne de filtrage. Plutôt que + d'insérer directement des filtres dans la chaîne, on insère un + sélecteur de filtre qui va effectuer un branchement conditionnel + vers un fournisseur de filtre. <module>mod_filter</module> peut + utiliser tout filtre de contenu comme fournisseur ; aucune + modification des modules de filtrage existants n'est nécessaire + (bien qu'il soit tout de même possible de les simplifier).</p> +</summary> + +<section id="smart"><title>Filtrage intelligent</title> + <p>Dans le modèle de filtrage traditionnel, les filtres sont insérés + sans condition à l'aide de la directive <directive + module="mod_mime">AddOutputFilter</directive> et des directives + apparentées. Chaque filtre doit ensuite déterminer s'il doit + s'exécuter ou non, et les administrateurs du serveur disposent de + peu de souplesse pour faire en sorte que la chaîne soit traitée de + manière dynamique.</p> + + <p><module>mod_filter</module>, à l'opposé, fournit aux + administrateurs du serveur un grand degré de souplesse pour + configurer la chaîne de filtrage. Concrètement, la décision + d'insérer un filtre peut être prise en fonction d'une <a + href="../expr.html">expression</a> booléenne complexe. Ceci + généralise le fonctionnement relativement souple de la directive + <directive>AddOutputFilterByType</directive>.</p> +</section> + +<section id="terms"><title>Déclarations de filtres, fournisseurs et +chaînes</title> + <p class="figure"> + <img src="../images/mod_filter_old.gif" width="160" height="310" + alt="[Cette image illustre le modèle de filtrage traditionnel]"/><br /> + <dfn>Figure 1:</dfn> Le modèle de filtrage traditionnel</p> + + <p>Dans le modèle traditionnel, les filtres en sortie constituent + une simple chaîne s'étendant depuis le générateur de contenu (ou + gestionnaire) jusqu'au client. Ce fonctionnement peut convenir si la + chaîne de filtrage peut être correctement configurée, mais pose + problème lorsque cette chaîne doit être configurée dynamiquement en + fonction de la sortie du gestionnaire.</p> + + <p class="figure"> + <img src="../images/mod_filter_new.gif" width="423" height="331" + alt="[Cette image illustre le modèle de fonctionnement de + mod_filter]"/><br /> + <dfn>Figure 2:</dfn> Le modèle de fonctionnement de + <module>mod_filter</module></p> + + <p>Le fonctionnement de <module>mod_filter</module> consiste à + introduire des branchements dans la chaîne de filtrage. Plutôt que + d'insérer directement des filtres dans la chaîne, on insère un + sélecteur de filtre qui va effectuer un branchement conditionnel + vers un fournisseur de filtre. <module>mod_filter</module> peut + utiliser tout filtre de contenu comme fournisseur ; aucune + modification des modules de filtrage existants n'est nécessaire + (bien qu'il soit tout de même possible de les simplifier). Il peut y + avoir plusieurs fournisseurs pour un seul filtre, mais un seul + fournisseur sera choisi pour chaque requête.</p> + + <p>Une chaîne de filtrage peut comporter autant d'instances du + sélecteur de filtre que l'on souhaite, chacune d'entre elles pouvant + disposer de plusieurs fournisseurs. Un sélecteur de filtre possédant + un seul fournisseur dont le choix est inconditionnel constitue un + cas particulier : cette situation est équivalente à l'insertion + directe du filtre dans la chaîne.</p> +</section> + +<section id="config"><title>Configuration de la chaîne de +filtrage</title> + <p>Trois étapes sont nécessaires pour configurer une chaîne de + filtrage avec <module>mod_filter</module>. Voir ci-dessous la + description détaillée des directives.</p> + + <dl> + <dt>Déclaration des filtres</dt> + <dd>La directive <directive + module="mod_filter">FilterDeclare</directive> permet de déclarer un + filtre en lui assignant un nom et un type. Elle n'est obligatoire + que si le filtre n'est pas du type par défaut + AP_FTYPE_RESOURCE.</dd> + + <dt>Enregistrement des fournisseurs</dt> + <dd>La directive <directive + module="mod_filter">FilterProvider</directive> permet d'associer un + fournisseur à un filtre. Le filtre a été éventuellement déclaré à + l'aide de la directive <directive module="mod_filter" + >FilterDeclare</directive> ; si ce n'est pas le cas, FilterProvider + va le déclarer implicitement avec le type par défaut + AP_FTYPE_RESOURCE. Le fournisseur doit avoir été enregistré à + l'aide de <code>ap_register_output_filter</code> par un module + quelconque. Le dernier argument de la directive <directive + module="mod_filter">FilterProvider</directive> est une expression : + le fournisseur s'exécutera pour une requête si et seulement si + l'expression est évaluée vraie. L'expression peut évaluer une + requête HTTP ou les en-têtes de la réponse, des variables + d'environnement, ou le gestionnaire utilisé par cette requête. À la + différence des version précédentes, mod_filter supporte désormais + les expressions complexes associant des critères multiples au moyen + d'une logique AND / OR (&& / ||) et de parenthèses. Pour les + détails sur la syntaxe de l'expression, voir la <a + href="../expr.html">documentation sur ap_expr</a>.</dd> + + <dt>Configuration de la chaîne de filtrage</dt> + <dd>Les directives ci-dessus permettent d'élaborer les éléments + d'une chaîne de filtrage intelligente, mais pas de les configurer en + vue de leur exécution. La directive <directive module="mod_filter" + >FilterChain</directive> élabore une chaîne de filtrage à + partir de filtres intelligents déclarés, permettant avec souplesse + d'insérer des filtres au début ou à la fin de la chaîne, de + supprimer un filtre ou même la chaîne complète.</dd> +</dl> +</section> +<section id="errordocs"><title>Filtrage et statut de la réponse</title> + <p>Normalement, mod_filter n'applique les filtres qu'aux réponses + possédant un statut HTTP 200 (OK). Pour pouvoir filtrer des + documents possédant un autre statut, vous devez définir la variable + d'environnement <var>filter-errordocs</var>, les réponses étant + alors filtrées sans se préoccuper de leur statut. Pour définir ce + comportement de manière plus fine, vous pouvez utiliser des + conditions dans la directive + <directive>FilterProvider</directive>.</p> +</section> +<section id="upgrade"><title>Mise à jour depuis une configuration du +serveur HTTP Apache 2.2</title> + <p>La directive <directive + module="mod_filter">FilterProvider</directive> a été modifiée par + rapport à httpd 2.2 : les arguments <var>match</var> et + <var>dispatch</var> ont été remplacés par l'argument unique + <var>expression</var> plus polyvalent. En général, il est possible + de convertir une paire match/dispatch vers les deux côtés d'une + expression, de la manière suivante :</p> + <example>"dispatch = 'match'"</example> + <p>Les en-têtes de requête et de réponse et les variables + d'environnement sont maintenant interprétés selon les syntaxes + respectives <var>%{req:foo}</var>, <var>%{resp:foo}</var> et + <var>%{env:foo}</var>. Les variables <var>%{HANDLER}</var> et + <var>%{CONTENT_TYPE}</var> sont également supportées.</p> + <p>Notez que l'évaluation de l'expression ne supporte plus les + comparaisons de sous-chaînes. Ces dernières peuvent + être remplacées par des comparaisons d'expressions rationnelles.</p> +</section> + +<section id="examples"><title>Exemples</title> + <dl> + <dt>Inclusions côté serveur (SSI)</dt> + <dd>Un exemple simple de remplacement de la directive <directive + module="core">AddOutputFilterByType</directive> + <highlight language="config"> +FilterDeclare SSI +FilterProvider SSI INCLUDES "%{CONTENT_TYPE} =~ m|^text/html|" +FilterChain SSI + </highlight> + </dd> + + <dt>Inclusions côté serveur (SSI)</dt> + <dd>Même exemple que ci-dessus, mais envoi vers un gestionnaire + (comportement classique des SSI ; les fichiers .shtml sont + traités). + <highlight language="config"> +FilterProvider SSI INCLUDES "%{HANDLER} = 'server-parsed'" +FilterChain SSI + </highlight> + </dd> + + <dt>Émulation de mod_gzip avec mod_deflate</dt> + <dd>Insertion du filtre INFLATE seulement si l'en-tête + Accept-Encoding a une valeur autre que "gzip". Ce filtre s'exécute + avec le type ftype CONTENT_SET. + <highlight language="config"> +FilterDeclare gzip CONTENT_SET +FilterProvider gzip inflate "%{req:Accept-Encoding} !~ /gzip/" +FilterChain gzip + </highlight> + </dd> + + <dt>Diminution de la résolution d'une image</dt> + <dd>Supposons que nous voulions réduire la résolution de toutes les + images web, et que nous disposions de filtres pour les images GIF, + JPEG et PNG. + <highlight language="config"> +FilterProvider unpack jpeg_unpack "%{CONTENT_TYPE} = 'image/jpeg'" +FilterProvider unpack gif_unpack "%{CONTENT_TYPE} = 'image/gif'" +FilterProvider unpack png_unpack "%{CONTENT_TYPE} = 'image/png'" + +FilterProvider downsample downsample_filter "%{CONTENT_TYPE} = m|^image/(jpeg|gif|png)|" +FilterProtocol downsample "change=yes" + +FilterProvider repack jpeg_pack "%{CONTENT_TYPE} = 'image/jpeg'" +FilterProvider repack gif_pack "%{CONTENT_TYPE} = 'image/gif'" +FilterProvider repack png_pack "%{CONTENT_TYPE} = 'image/png'" +<Location /image-filter> + FilterChain unpack downsample repack +</Location> + </highlight> + </dd> + </dl> +</section> + +<section id="protocol"><title>Gestion de protocole</title> + <p>Historiquement, tout filtre doit s'assurer que toute modification + qu'il effectue est correctement représentée dans les en-têtes de la + réponse HTTP, et qu'il ne s'exécutera pas si cette exécution + résultait en une modification interdite. Ceci impose aux auteurs de + filtres la corvée de réimplémenter certaines fonctionnalités + communes dans chaque filtre :</p> + + <ul> + <li>De nombreux filtres modifient les contenus, et de ce fait + invalident les balises de ces contenus, leur somme de + contrôle, leur condensé (hash) existant, ainsi que leur + taille.</li> + + <li>Les filtres qui nécessitent une réponse entière et non tronquée en + entrée, doivent s'assurer qu'il n'ont pas reçu une réponse à une + requête partielle.</li> + + <li>Les filtres qui modifient la sortie d'un autre filtre doivent + s'assurer qu'ils ne violent pas la directive d'un en-tête + <code>Cache-Control: no-transform</code> éventuel.</li> + + <li>Les filtres peuvent agir sur des réponses de façon à ce qu'elles + ne puissent plus être mises en cache.</li> + </ul> + + <p><module>mod_filter</module> a pour but de gérer de manière + générale ces détails de l'implémentation des filtres, réduisant par + là-même la complexité des modules de filtrage de contenu. Le + travail permettant d'atteindre ce but est cependant toujours en + cours ; la directive <directive + module="mod_filter">FilterProtocol</directive> + implémente certaines de ces fonctionnalités à des fins de + compatibilité ascendante avec les modules d'Apache 2.0. Pour les + versions 2.1 et supérieures de httpd, les API + <code>ap_register_output_filter_protocol</code> et + <code>ap_filter_protocol</code> permettent aux modules de filtrage + de définir leurs propres comportements.</p> + + <p>Cependant, <module>mod_filter</module> ne doit pas interférer + avec un filtre qui gère déjà tous les aspects du protocole. Par + défaut (c'est à dire en l'absence de toute directive <directive + module="mod_filter">FilterProtocol</directive>), + <module>mod_filter</module> ne modifiera donc pas les en-têtes.</p> + + <p>Au moment où ces lignes sont écrites, cette fonctionnalité a été + très peu testée, car les modules d'usage courant ont été conçus pour + fonctionner avec httpd 2.0. Les modules qui l'utilisent devront donc + l'expérimenter avec précautions.</p> +</section> + +<directivesynopsis> +<name>AddOutputFilterByType</name> +<description>assigne un filtre en sortie pour un type de média +particulier</description> +<syntax>AddOutputFilterByType <var>filtre</var>[;<var>filtre</var>...] +<var>type de média</var> [<var>type de média</var>] ...</syntax> +<contextlist><context>server config</context> +<context>virtual host</context><context>directory</context> +<context>.htaccess</context></contextlist> +<override>FileInfo</override> +<compatibility>Présentait de sévères limitations avant d'être déplacé dans +<module>mod_filter</module> dans la version 2.3.7</compatibility> + +<usage> + <p>Cette directive active un <a + href="../filter.html">filtre</a> en sortie particulier pour une + requête en fonction du <glossary>type de média</glossary> de la réponse.</p> + + <p>L'exemple suivant active le filtre <code>DEFLATE</code> qui est + fourni par le module <module>mod_deflate</module>. Il va compresser + toute sortie dont le type MIME est <code>text/html</code> ou + <code>text/plain</code> avant de l'envoyer au client.</p> + + <highlight language="config"> + AddOutputFilterByType DEFLATE text/html text/plain + </highlight> + + <p>Si vous voulez assigner plusieurs filtres au contenu, leurs noms + doivent être séparés par des points-virgules. On peut aussi utiliser + une directive <directive>AddOutputFilterByType</directive> pour + chacun des filtres à assigner.</p> + + <p>La configuration ci-dessous impose le traitement de toute sortie + de script dont le type MIME est <code>text/html</code> en premier + lieu par le filtre <code>INCLUDES</code>, puis par le filtre + <code>DEFLATE</code>.</p> + + <highlight language="config"> +<Location /cgi-bin/> + Options Includes + AddOutputFilterByType INCLUDES;DEFLATE text/html +</Location> + </highlight> + +</usage> + +<seealso><directive module="mod_mime">AddOutputFilter</directive></seealso> +<seealso><directive module="core">SetOutputFilter</directive></seealso> +<seealso><a href="../filter.html">Les filtres</a></seealso> +</directivesynopsis> + +<directivesynopsis> +<name>FilterDeclare</name> +<description>Déclare un filtre intelligent</description> +<syntax>FilterDeclare <var>nom filtre</var> <var>[type]</var></syntax> +<contextlist><context>server config</context><context>virtual host</context> +<context>directory</context><context>.htaccess</context></contextlist> +<override>Options</override> + +<usage> + <p>Cette directive permet de déclarer un filtre en sortie associé à + un en-tête ou une variable d'environnement qui déterminera les + conditions de son exécution. Le premier argument est le <var>nom du + filtre</var> destiné à être utilisé dans les directives <directive + module="mod_filter">FilterProvider</directive>, <directive + module="mod_filter">FilterChain</directive> et <directive + module="mod_filter">FilterProtocol</directive>.</p> + + <p>Le dernier argument (optionnel) est le type du filtre, et peut + prendre les valeurs de <code>ap_filter_type</code>, à savoir + <code>RESOURCE</code> (valeur par défaut), <code>CONTENT_SET</code>, + <code>PROTOCOL</code>, <code>TRANSCODE</code>, + <code>CONNECTION</code> ou <code>NETWORK</code>.</p> +</usage> +</directivesynopsis> + +<directivesynopsis> +<name>FilterProvider</name> +<description>Enregistre un filtre de contenu</description> +<syntax>FilterProvider <var>nom filtre</var> <var>nom fournisseur</var> + <var>expression</var></syntax> +<contextlist><context>server config</context><context>virtual host</context> +<context>directory</context><context>.htaccess</context></contextlist> +<override>Options</override> + +<usage> + <p>Cette directive permet d'associer un <em>fournisseur</em> au + filtre intelligent. Le fournisseur sera invoqué si et seulement si + l'<var>expression</var> est évaluée vraie lorsque le sélecteur de + filtre est appelé pour la première fois.</p> + + <p> + <var>nom fournisseur</var> doit avoir été enregistré au cours du + chargement d'un module à l'aide de + <code>ap_register_output_filter</code>. + </p> + + <p><var>expression</var> est une expression <a + href="../expr.html">ap_expr</a>.</p> + +</usage> +<seealso><a href="../expr.html">Les expressions dans le serveur HTTP +Apache</a>, pour une référence complète et d'autres exemples.</seealso> +<seealso><module>mod_include</module></seealso> +</directivesynopsis> + +<directivesynopsis> +<name>FilterChain</name> +<description>Configure la chaîne de filtrage</description> +<syntax>FilterChain [+=-@!]<var>nom filtre</var> <var>...</var></syntax> +<contextlist><context>server config</context><context>virtual host</context> +<context>directory</context><context>.htaccess</context></contextlist> +<override>Options</override> + +<usage> + <p>Cette directive permet de configurer une chaîne de filtrage + composée de filtres déclarés. <directive>FilterChain</directive> + accepte un nombre illimité d'arguments, chacun d'entre eux étant + précédé d'un caractère de contrôle unique qui détermine l'action à + entreprendre :</p> + + <dl> + <dt><code>+<var>nom filtre</var></code></dt> + <dd>Ajoute<var>nom filtre</var> à la fin de la chaîne de filtrage</dd> + + <dt><code>@<var>nom filtre</var></code></dt> + <dd>Ajoute <var>nom filtre</var> au début de la chaîne de filtrage</dd> + + <dt><code>-<var>nom filtre</var></code></dt> + <dd>Supprime <var>nom filtre</var> de la chaîne de filtrage</dd> + + <dt><code>=<var>nom filtre</var></code></dt> + <dd>Supprime tous les filtres de la chaîne de filtrage existante et + les remplace par <var>nom filtre</var></dd> + + <dt><code>!</code></dt> + <dd>Supprime tous les filtres de la chaîne de filtrage existante</dd> + + <dt><code><var>nom filtre</var></code></dt> + <dd>Équivalent à <code>+<var>nom filtre</var></code></dd> + </dl> +</usage> +</directivesynopsis> + +<directivesynopsis> +<name>FilterProtocol</name> +<description>Vérifie le respect du protocole HTTP</description> +<syntax>FilterProtocol <var>nom filtre</var> [<var>nom fournisseur</var>] + <var>drapeaux protocole</var></syntax> +<contextlist><context>server config</context><context>virtual host</context> +<context>directory</context><context>.htaccess</context></contextlist> +<override>Options</override> + +<usage> + <p>Cette directive permet à <module>mod_filter</module> de s'assurer + qu'un filtre ne s'exécutera pas s'il ne doit pas le faire, et que + les en-têtes de la réponse HTTP sont définis correctement en tenant + compte des effets du filtre.</p> + + <p>Cette directive se présente sous deux formes. Avec trois + arguments, elle s'applique de manière spécifique à un <var>nom + filtre</var> et un <var>nom fournisseur</var> pour ce filtre. Avec + deux arguments, elle s'applique à un <var>nom filtre</var> pour + <em>tout</em> fournisseur qu'il actionne.</p> + + <p><var>drapeaux protocole</var> peut contenir un ou plusieurs + drapeaux parmi les suivants :</p> + + <dl> + <dt><code>change=yes</code></dt> + <dd>Le filtre modifie le contenu, y compris éventuellement sa + taille</dd> + + <dt><code>change=1:1</code></dt> + <dd>>Le filtre modifie le contenu, mais pas sa taille</dd> + + <dt><code>byteranges=no</code></dt> + <dd>Le filtre ne peut pas traiter de réponses à des sous-requêtes et + nécessite des réponses complètes en entrée</dd> + + <dt><code>proxy=no</code></dt> + <dd>Le filtre ne doit pas s'exécuter dans un contexte de mandataire</dd> + + <dt><code>proxy=transform</code></dt> + <dd>Le filtre transforme la réponse de manière incompatible avec + l'en-tête HTTP <code>Cache-Control: no-transform</code></dd> + + <dt><code>cache=no</code></dt> + <dd>Le filtre fait en sorte que la sortie ne puisse pas être mise en + cache (par exemple en introduisant des modifications de contenu + aléatoires)</dd> + </dl> +</usage> +</directivesynopsis> + +<directivesynopsis> +<name>FilterTrace</name> +<description>Obtention d'informations de débogage/diagnostique en +provenance de <module>mod_filter</module></description> +<syntax>FilterTrace <var>nom filtre</var> <var>niveau</var></syntax> +<contextlist><context>server config</context><context>virtual host</context> +<context>directory</context></contextlist> + +<usage> + <p>Cette directive permet d'obtenir des informations de débogage en + provenance de <module>mod_filter</module>. Elle est conçue pour + aider à tester et déboguer les fournisseurs (ou modules de filtrage) + ; elle peut aussi apporter une aide à l'utilisation de + <module>mod_filter</module> lui-même.</p> + + <p>La sortie de débogage dépend de la définition d'argument + <var>level</var> :</p> + <dl> + <dt><code>0</code> (valeur par défaut)</dt> + <dd>Aucune information de débogage n'est générée.</dd> + + <dt><code>1</code></dt> + <dd><module>mod_filter</module> va enregistrer les ensembles de + conteneurs de données (buckets and brigades) qui traversent le + filtre dans le journal des erreurs, avant que le fournisseur ne les + traite. Ces informations sont similaires à celles générées par <a + href="http://apache.webthing.com/mod_diagnostics/" + >mod_diagnostics</a>. + </dd> + + <dt><code>2</code> (pas encore implémenté)</dt> + <dd>Ce niveau permettra d'enregistrer l'ensemble des données qui + traversent le filtre dans un fichier temporaire avant de les envoyer + au fournisseur. <strong>Pour un débogage mono-utilisateur + seulement</strong> ; l'enregistrement des données concernant + plusieurs requêtes simultannées ne sera pas supporté.</dd> + </dl> +</usage> +</directivesynopsis> + +</modulesynopsis> + diff --git a/docs/manual/mod/mod_filter.xml.meta b/docs/manual/mod/mod_filter.xml.meta index 661090548b..57da411bff 100644 --- a/docs/manual/mod/mod_filter.xml.meta +++ b/docs/manual/mod/mod_filter.xml.meta @@ -8,5 +8,6 @@ <variants> <variant>en</variant> + <variant>fr</variant> </variants> </metafile> diff --git a/docs/manual/mod/mod_logio.html b/docs/manual/mod/mod_logio.html index 0eb2b07092..370e8030bb 100644 --- a/docs/manual/mod/mod_logio.html +++ b/docs/manual/mod/mod_logio.html @@ -4,6 +4,10 @@ URI: mod_logio.html.en Content-Language: en Content-type: text/html; charset=ISO-8859-1 +URI: mod_logio.html.fr +Content-Language: fr +Content-type: text/html; charset=ISO-8859-1 + URI: mod_logio.html.ja.utf8 Content-Language: ja Content-type: text/html; charset=UTF-8 diff --git a/docs/manual/mod/mod_logio.html.fr b/docs/manual/mod/mod_logio.html.fr new file mode 100644 index 0000000000..4238c3fda9 --- /dev/null +++ b/docs/manual/mod/mod_logio.html.fr @@ -0,0 +1,130 @@ +<?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><!-- + XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX + This file is generated from xml source: DO NOT EDIT + XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX + --> +<title>mod_logio - Serveur Apache HTTP</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.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/directives.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.4</p> +<img alt="" src="../images/feather.gif" /></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.4</a> > <a href="./">Modules</a></div> +<div id="page-content"> +<div id="preamble"><h1>Module Apache mod_logio</h1> +<div class="toplang"> +<p><span>Langues Disponibles: </span><a href="../en/mod/mod_logio.html" hreflang="en" rel="alternate" title="English"> en </a> | +<a href="../fr/mod/mod_logio.html" title="Français"> fr </a> | +<a href="../ja/mod/mod_logio.html" hreflang="ja" rel="alternate" title="Japanese"> ja </a> | +<a href="../ko/mod/mod_logio.html" hreflang="ko" rel="alternate" title="Korean"> ko </a> | +<a href="../tr/mod/mod_logio.html" hreflang="tr" rel="alternate" title="Türkçe"> tr </a></p> +</div> +<table class="module"><tr><th><a href="module-dict.html#Description">Description:</a></th><td>Journalisation des octets en entrée et en sortie pour +chaque requête</td></tr> +<tr><th><a href="module-dict.html#Status">Statut:</a></th><td>Extension</td></tr> +<tr><th><a href="module-dict.html#ModuleIdentifier">Identificateur de Module:</a></th><td>logio_module</td></tr> +<tr><th><a href="module-dict.html#SourceFile">Fichier Source:</a></th><td>mod_logio.c</td></tr></table> +<h3>Sommaire</h3> + + + <p>Ce module permet d'enregistrer le nombre d'octets reçus et + envoyés pour chaque requête. Ce nombre reflète le nombre réel + d'octets transmis sur le réseau, et prend en compte les en-têtes et + corps des requêtes et des réponses. Le décompte est effectué avant + SSL/TLS en entrée et après SSL/TLS en sortie, si bien que le + résultat reflètera toute modification introduite par le + chiffrement.</p> + + <p>Pour fonctionner, ce module requiert le chargement du module + <code class="module"><a href="../mod/mod_log_config.html">mod_log_config</a></code>.</p> + + <div class="note">Lorsqu'on utilise les connexions persistantes avec SSL, le + supplément de trafic induit par la négociation SSL est enregistré + dans le décompte des octets transmis dans le cadre de la première + requête de la connexion. Lors d'une renégociation SSL au niveau d'un + répertoire, le décompte d'octets est associé à la + requête qui a déclenché la renégociation.</div> + +</div> +<div id="quickview"><h3 class="directives">Directives</h3> +<p>Ce module ne fournit aucune directive.</p> +<h3>Sujets</h3> +<ul id="topics"> +<li><img alt="" src="../images/down.gif" /> <a href="#formats">Formats de journaux personnalisés</a></li> +</ul><h3>Voir aussi</h3> +<ul class="seealso"> +<li><code class="module"><a href="../mod/mod_log_config.html">mod_log_config</a></code></li> +<li><a href="../logs.html">Les fichiers journaux +d'Apache</a></li> +</ul><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="formats" id="formats">Formats de journaux personnalisés</a></h2> + + + <p>Ce module introduit deux nouvelles directives de journalisation. + Les caractéristiques de la requête en elle-même sont journalisées en + insérant des directives "<code>%</code>" dans la chaîne de format, + qui seront remplacées comme suit dans le fichier journal :</p> + + <table class="bordered"><tr class="header"><th>Chaîne de Format</th> + <th>Description</th></tr> +<tr><td><code>%...I</code></td> + <td>Octets reçus, en-têtes et corps de requête inclus ; ne peut + pas être nul.</td></tr> +<tr class="odd"><td><code>%...O</code></td> + <td>Octets envoyés, en-têtes inclus ; ne peut + pas être nul.</td></tr> +</table> + + <p>En général, cette fonctionnalité s'utilise comme suit :</p> + + <dl> + <dt>Format de journal d'entrées/sorties combiné :</dt> + <dd><code>"%h %l %u %t \"%r\" %>s %b \"%{Referer}i\" + \"%{User-agent}i\" %I %O"</code></dd> + </dl> +</div> +</div> +<div class="bottomlang"> +<p><span>Langues Disponibles: </span><a href="../en/mod/mod_logio.html" hreflang="en" rel="alternate" title="English"> en </a> | +<a href="../fr/mod/mod_logio.html" title="Français"> fr </a> | +<a href="../ja/mod/mod_logio.html" hreflang="ja" rel="alternate" title="Japanese"> ja </a> | +<a href="../ko/mod/mod_logio.html" hreflang="ko" rel="alternate" title="Korean"> ko </a> | +<a href="../tr/mod/mod_logio.html" hreflang="tr" rel="alternate" title="Türkçe"> tr </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/2.4/mod/mod_logio.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 2013 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/directives.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 diff --git a/docs/manual/mod/mod_logio.xml.fr b/docs/manual/mod/mod_logio.xml.fr new file mode 100644 index 0000000000..d05d6d7099 --- /dev/null +++ b/docs/manual/mod/mod_logio.xml.fr @@ -0,0 +1,90 @@ +<?xml version="1.0"?> +<!DOCTYPE modulesynopsis SYSTEM "../style/modulesynopsis.dtd"> +<?xml-stylesheet type="text/xsl" href="../style/manual.fr.xsl"?> +<!-- English Revision : 630289 --> +<!-- 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_logio.xml.meta"> + +<name>mod_logio</name> +<description>Journalisation des octets en entrée et en sortie pour +chaque requête</description> +<status>Extension</status> +<sourcefile>mod_logio.c</sourcefile> +<identifier>logio_module</identifier> + +<summary> + + <p>Ce module permet d'enregistrer le nombre d'octets reçus et + envoyés pour chaque requête. Ce nombre reflète le nombre réel + d'octets transmis sur le réseau, et prend en compte les en-têtes et + corps des requêtes et des réponses. Le décompte est effectué avant + SSL/TLS en entrée et après SSL/TLS en sortie, si bien que le + résultat reflètera toute modification introduite par le + chiffrement.</p> + + <p>Pour fonctionner, ce module requiert le chargement du module + <module>mod_log_config</module>.</p> + + <note>Lorsqu'on utilise les connexions persistantes avec SSL, le + supplément de trafic induit par la négociation SSL est enregistré + dans le décompte des octets transmis dans le cadre de la première + requête de la connexion. Lors d'une renégociation SSL au niveau d'un + répertoire, le décompte d'octets est associé à la + requête qui a déclenché la renégociation.</note> + +</summary> + +<seealso><module>mod_log_config</module></seealso> +<seealso><a href="../logs.html">Les fichiers journaux +d'Apache</a></seealso> + +<section id="formats"> +<title>Formats de journaux personnalisés</title> + + <p>Ce module introduit deux nouvelles directives de journalisation. + Les caractéristiques de la requête en elle-même sont journalisées en + insérant des directives "<code>%</code>" dans la chaîne de format, + qui seront remplacées comme suit dans le fichier journal :</p> + + <table border="1" style="zebra"> + <tr><th>Chaîne de Format</th> + <th>Description</th></tr> + + <tr><td><code>%...I</code></td> + <td>Octets reçus, en-têtes et corps de requête inclus ; ne peut + pas être nul.</td></tr> + + <tr><td><code>%...O</code></td> + <td>Octets envoyés, en-têtes inclus ; ne peut + pas être nul.</td></tr> + </table> + + <p>En général, cette fonctionnalité s'utilise comme suit :</p> + + <dl> + <dt>Format de journal d'entrées/sorties combiné :</dt> + <dd><code>"%h %l %u %t \"%r\" %>s %b \"%{Referer}i\" + \"%{User-agent}i\" %I %O"</code></dd> + </dl> +</section> + +</modulesynopsis> diff --git a/docs/manual/mod/mod_logio.xml.meta b/docs/manual/mod/mod_logio.xml.meta index ced9e78317..ed5503c132 100644 --- a/docs/manual/mod/mod_logio.xml.meta +++ b/docs/manual/mod/mod_logio.xml.meta @@ -8,6 +8,7 @@ <variants> <variant>en</variant> + <variant>fr</variant> <variant outdated="yes">ja</variant> <variant outdated="yes">ko</variant> <variant>tr</variant> diff --git a/docs/manual/mod/mod_proxy_connect.html b/docs/manual/mod/mod_proxy_connect.html index 05c12719b1..4d4aafaa7c 100644 --- a/docs/manual/mod/mod_proxy_connect.html +++ b/docs/manual/mod/mod_proxy_connect.html @@ -4,6 +4,10 @@ URI: mod_proxy_connect.html.en Content-Language: en Content-type: text/html; charset=ISO-8859-1 +URI: mod_proxy_connect.html.fr +Content-Language: fr +Content-type: text/html; charset=ISO-8859-1 + URI: mod_proxy_connect.html.ja.utf8 Content-Language: ja Content-type: text/html; charset=UTF-8 diff --git a/docs/manual/mod/mod_proxy_connect.html.fr b/docs/manual/mod/mod_proxy_connect.html.fr new file mode 100644 index 0000000000..383a21eb9f --- /dev/null +++ b/docs/manual/mod/mod_proxy_connect.html.fr @@ -0,0 +1,141 @@ +<?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><!-- + XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX + This file is generated from xml source: DO NOT EDIT + XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX + --> +<title>mod_proxy_connect - Serveur Apache HTTP</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.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/directives.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.4</p> +<img alt="" src="../images/feather.gif" /></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.4</a> > <a href="./">Modules</a></div> +<div id="page-content"> +<div id="preamble"><h1>Module Apache mod_proxy_connect</h1> +<div class="toplang"> +<p><span>Langues Disponibles: </span><a href="../en/mod/mod_proxy_connect.html" hreflang="en" rel="alternate" title="English"> en </a> | +<a href="../fr/mod/mod_proxy_connect.html" title="Français"> fr </a> | +<a href="../ja/mod/mod_proxy_connect.html" hreflang="ja" rel="alternate" title="Japanese"> ja </a></p> +</div> +<table class="module"><tr><th><a href="module-dict.html#Description">Description:</a></th><td>Extension de <code class="module"><a href="../mod/mod_proxy.html">mod_proxy</a></code> pour le traitement +des requêtes <code>CONNECT</code></td></tr> +<tr><th><a href="module-dict.html#Status">Statut:</a></th><td>Extension</td></tr> +<tr><th><a href="module-dict.html#ModuleIdentifier">Identificateur de Module:</a></th><td>proxy_connect_module</td></tr> +<tr><th><a href="module-dict.html#SourceFile">Fichier Source:</a></th><td>mod_proxy_connect.c</td></tr></table> +<h3>Sommaire</h3> + + <p>Pour fonctionner, ce module <em>nécessite</em> le chargement de + <code class="module"><a href="../mod/mod_proxy.html">mod_proxy</a></code>. Il fournit le support de la méthode HTTP + <code>CONNECT</code>. Cette méthode est principalement utilisée pour + faire franchir les serveurs mandataires aux requêtes SSL à l'aide + d'un tunnel.</p> + + <p>Ainsi, pour pouvoir traiter les requêtes <code>CONNECT</code>, + <code class="module"><a href="../mod/mod_proxy.html">mod_proxy</a></code> et <code class="module"><a href="../mod/mod_proxy_connect.html">mod_proxy_connect</a></code> + doivent être chargés dans le serveur.</p> + + <p>CONNECT est aussi utilisée lorsque le serveur doit envoyer une + requête HTTPS via un mandataire. Dans ce cas, le serveur se comporte + comme un client CONNECT. Cette fonctionnalité étant fournie par le + module <code class="module"><a href="../mod/mod_proxy.html">mod_proxy</a></code>, le module + <code class="module"><a href="../mod/mod_proxy_connect.html">mod_proxy_connect</a></code> n'est dans ce cas pas nécessaire.</p> + + <div class="warning"><h3>Avertissement</h3> + <p>N'activez pas la fonctionnalité de mandataire avant d'avoir <a href="mod_proxy.html#access">sécurisé votre serveur</a>. Les + serveurs mandataires ouverts sont dangereux non seulement pour + votre réseau, mais aussi pour l'Internet au sens large.</p> + </div> +</div> +<div id="quickview"><h3 class="directives">Directives</h3> +<ul id="toc"> +<li><img alt="" src="../images/down.gif" /> <a href="#allowconnect">AllowCONNECT</a></li> +</ul> +<h3>Sujets</h3> +<ul id="topics"> +<li><img alt="" src="../images/down.gif" /> <a href="#notes">Informations sur les requêtes</a></li> +</ul><h3>Voir aussi</h3> +<ul class="seealso"> +<li><code class="module"><a href="../mod/mod_proxy.html">mod_proxy</a></code></li> +</ul><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="notes" id="notes">Informations sur les requêtes</a></h2> + <p><code class="module"><a href="../mod/mod_proxy_connect.html">mod_proxy_connect</a></code> enregistre les informations + suivantes pour journalisation via le format <code>%{NOMVAR}n</code> + dans les directives <code class="directive"><a href="../mod/mod_log_config.html#logformat">LogFormat</a></code> ou <code class="directive"><a href="../mod/core.html#errorlogformat">ErrorLogFormat</a></code> : + </p> + <dl> + <dt>proxy-source-port</dt> + <dd>Le port local utilisé pour la connexion vers le serveur + d'arrière-plan.</dd> + </dl> +</div> +<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div> +<div class="directive-section"><h2><a name="AllowCONNECT" id="AllowCONNECT">AllowCONNECT</a> <a name="allowconnect" id="allowconnect">Directive</a></h2> +<table class="directive"> +<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Ports autorisés à se <code>CONNECT</code>er à travers le +mandataire</td></tr> +<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>AllowCONNECT <var>port</var>[-<var>port</var>] +[<var>port</var>[-<var>port</var>]] ...</code></td></tr> +<tr><th><a href="directive-dict.html#Default">Défaut:</a></th><td><code>AllowCONNECT 443 563</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>Extension</td></tr> +<tr><th><a href="directive-dict.html#Module">Module:</a></th><td>mod_proxy_connect</td></tr> +<tr><th><a href="directive-dict.html#Compatibility">Compatibilité:</a></th><td>Déplacé depuis <code class="module"><a href="../mod/mod_proxy.html">mod_proxy</a></code> à partir +d'Apache 2.3.5. Plages de ports disponibles depuis Apache 2.3.7.</td></tr> +</table> + <p>La directive <code class="directive">AllowCONNECT</code> permet de + spécifier une liste de numéros ou de plages de ports auxquels la + méthode de mandataire <code>CONNECT</code> pourra se connecter. Les + navigateurs récents utilisent cette méthode dans le cas où une + connexion <code>https</code> est requise et où le tunneling + mandataire sur HTTP est en service.</p> + + <p>Par défaut, seuls les ports par défauts https (<code>443</code>) + et snews (<code>563</code>) sont pris en compte. Vous pouvez + utiliser la directive <code class="directive">AllowCONNECT</code> pour + outrepasser ces valeurs par défaut et n'autoriser les connexions que + vers les ports spécifiés.</p> + +</div> +</div> +<div class="bottomlang"> +<p><span>Langues Disponibles: </span><a href="../en/mod/mod_proxy_connect.html" hreflang="en" rel="alternate" title="English"> en </a> | +<a href="../fr/mod/mod_proxy_connect.html" title="Français"> fr </a> | +<a href="../ja/mod/mod_proxy_connect.html" hreflang="ja" rel="alternate" title="Japanese"> ja </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/2.4/mod/mod_proxy_connect.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 2013 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/directives.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 diff --git a/docs/manual/mod/mod_proxy_connect.xml.fr b/docs/manual/mod/mod_proxy_connect.xml.fr new file mode 100644 index 0000000000..0ac8f3a8e7 --- /dev/null +++ b/docs/manual/mod/mod_proxy_connect.xml.fr @@ -0,0 +1,103 @@ +<?xml version="1.0"?> +<!DOCTYPE modulesynopsis SYSTEM "../style/modulesynopsis.dtd"> +<?xml-stylesheet type="text/xsl" href="../style/manual.fr.xsl"?> +<!-- English Revision : 1154342 --> +<!-- 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_proxy_connect.xml.meta"> + +<name>mod_proxy_connect</name> +<description>Extension de <module>mod_proxy</module> pour le traitement +des requêtes <code>CONNECT</code></description> +<status>Extension</status> +<sourcefile>mod_proxy_connect.c</sourcefile> +<identifier>proxy_connect_module</identifier> + +<summary> + <p>Pour fonctionner, ce module <em>nécessite</em> le chargement de + <module>mod_proxy</module>. Il fournit le support de la méthode HTTP + <code>CONNECT</code>. Cette méthode est principalement utilisée pour + faire franchir les serveurs mandataires aux requêtes SSL à l'aide + d'un tunnel.</p> + + <p>Ainsi, pour pouvoir traiter les requêtes <code>CONNECT</code>, + <module>mod_proxy</module> et <module>mod_proxy_connect</module> + doivent être chargés dans le serveur.</p> + + <p>CONNECT est aussi utilisée lorsque le serveur doit envoyer une + requête HTTPS via un mandataire. Dans ce cas, le serveur se comporte + comme un client CONNECT. Cette fonctionnalité étant fournie par le + module <module>mod_proxy</module>, le module + <module>mod_proxy_connect</module> n'est dans ce cas pas nécessaire.</p> + + <note type="warning"><title>Avertissement</title> + <p>N'activez pas la fonctionnalité de mandataire avant d'avoir <a + href="mod_proxy.html#access">sécurisé votre serveur</a>. Les + serveurs mandataires ouverts sont dangereux non seulement pour + votre réseau, mais aussi pour l'Internet au sens large.</p> + </note> +</summary> +<seealso><module>mod_proxy</module></seealso> + +<section id="notes"><title>Informations sur les requêtes</title> + <p><module>mod_proxy_connect</module> enregistre les informations + suivantes pour journalisation via le format <code>%{NOMVAR}n</code> + dans les directives <directive + module="mod_log_config">LogFormat</directive> ou <directive + module="core">ErrorLogFormat</directive> : + </p> + <dl> + <dt>proxy-source-port</dt> + <dd>Le port local utilisé pour la connexion vers le serveur + d'arrière-plan.</dd> + </dl> +</section> + +<directivesynopsis> +<name>AllowCONNECT</name> +<description>Ports autorisés à se <code>CONNECT</code>er à travers le +mandataire</description> +<syntax>AllowCONNECT <var>port</var>[-<var>port</var>] +[<var>port</var>[-<var>port</var>]] ...</syntax> +<default>AllowCONNECT 443 563</default> +<contextlist><context>server config</context><context>virtual host</context> +</contextlist> +<compatibility>Déplacé depuis <module>mod_proxy</module> à partir +d'Apache 2.3.5. Plages de ports disponibles depuis Apache 2.3.7.</compatibility> + +<usage> + <p>La directive <directive>AllowCONNECT</directive> permet de + spécifier une liste de numéros ou de plages de ports auxquels la + méthode de mandataire <code>CONNECT</code> pourra se connecter. Les + navigateurs récents utilisent cette méthode dans le cas où une + connexion <code>https</code> est requise et où le tunneling + mandataire sur HTTP est en service.</p> + + <p>Par défaut, seuls les ports par défauts https (<code>443</code>) + et snews (<code>563</code>) sont pris en compte. Vous pouvez + utiliser la directive <directive>AllowCONNECT</directive> pour + outrepasser ces valeurs par défaut et n'autoriser les connexions que + vers les ports spécifiés.</p> +</usage> +</directivesynopsis> + + +</modulesynopsis> diff --git a/docs/manual/mod/mod_proxy_connect.xml.meta b/docs/manual/mod/mod_proxy_connect.xml.meta index dcc3b7c1a6..2b58b28de8 100644 --- a/docs/manual/mod/mod_proxy_connect.xml.meta +++ b/docs/manual/mod/mod_proxy_connect.xml.meta @@ -8,6 +8,7 @@ <variants> <variant>en</variant> + <variant>fr</variant> <variant outdated="yes">ja</variant> </variants> </metafile> diff --git a/docs/manual/mod/mod_proxy_express.html b/docs/manual/mod/mod_proxy_express.html index 28ca0cd65a..1afc99c1c7 100644 --- a/docs/manual/mod/mod_proxy_express.html +++ b/docs/manual/mod/mod_proxy_express.html @@ -3,3 +3,7 @@ URI: mod_proxy_express.html.en Content-Language: en Content-type: text/html; charset=ISO-8859-1 + +URI: mod_proxy_express.html.fr +Content-Language: fr +Content-type: text/html; charset=ISO-8859-1 diff --git a/docs/manual/mod/mod_proxy_express.html.fr b/docs/manual/mod/mod_proxy_express.html.fr new file mode 100644 index 0000000000..aa5ccd7063 --- /dev/null +++ b/docs/manual/mod/mod_proxy_express.html.fr @@ -0,0 +1,203 @@ +<?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><!-- + XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX + This file is generated from xml source: DO NOT EDIT + XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX + --> +<title>mod_proxy_express - Serveur Apache HTTP</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.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/directives.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.4</p> +<img alt="" src="../images/feather.gif" /></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.4</a> > <a href="./">Modules</a></div> +<div id="page-content"> +<div id="preamble"><h1>Module Apache mod_proxy_express</h1> +<div class="toplang"> +<p><span>Langues Disponibles: </span><a href="../en/mod/mod_proxy_express.html" hreflang="en" rel="alternate" title="English"> en </a> | +<a href="../fr/mod/mod_proxy_express.html" title="Français"> fr </a></p> +</div> +<table class="module"><tr><th><a href="module-dict.html#Description">Description:</a></th><td>Extension à <code class="module"><a href="../mod/mod_proxy.html">mod_proxy</a></code> pour le fonctionnement en mandataire +dynamique inverse de masse</td></tr> +<tr><th><a href="module-dict.html#Status">Statut:</a></th><td>Extension</td></tr> +<tr><th><a href="module-dict.html#ModuleIdentifier">Identificateur de Module:</a></th><td>proxy_express_module</td></tr> +<tr><th><a href="module-dict.html#SourceFile">Fichier Source:</a></th><td>mod_proxy_express.c</td></tr></table> +<h3>Sommaire</h3> + + <p>Ce module crée dynamiquement en masse des mandataires inverses en + faisant correspondre l'en-tête Host: de la requête HTTP à un nom de + serveur et une URL d'arrière-plan stockés dans un fichier DBM. Il + est ainsi plus aisé d'utiliser un grand nombre de + mandataires inverses sans avoir à modifier la configuration. Il est + loin de posséder autant de fonctionnalités que + <code class="module"><a href="../mod/mod_proxy_balancer.html">mod_proxy_balancer</a></code>, qui propose aussi la croissance + dynamique, mais il est conçu pour gérer un nombre beaucoup plus important + de serveurs d'arrière-plan. Il convient parfaitement pour créer un + commutateur HTTP frontal.</p> + + <p>Pour pouvoir être utilisé, ce module nécessite le chargement de + <code class="module"><a href="../mod/mod_proxy.html">mod_proxy</a></code>.</p> + + <div class="warning"><h3>Avertissement</h3> + <p>N'activez le mandatement que si vous avez <a href="mod_proxy.html#access">sécurisé votre serveur</a>. Les + serveurs mandataires ouverts sont dangereux pour votre réseau, et + dans une plus large mesure pour Internet.</p> + </div> + +<div class="note"><h3>Limitations</h3> + <ul> + <li>Ce module n'est pas conçu pour remplacer les fonctionnalités + dynamiques de <code class="module"><a href="../mod/mod_proxy_balancer.html">mod_proxy_balancer</a></code>. Par contre, il + peut constituer une alternative légère et rapide à + <code class="module"><a href="../mod/mod_rewrite.html">mod_rewrite</a></code> lorsque ce dernier utilise la directive + <code class="directive">RewriteMap</code> et le drapeau <code>[P]</code> + pour le mandatement inverse à partir d'une table de correspondances. + </li> + <li>Il ne supporte pas les mises en correspondance basées sur les + expressions rationnelles ou les modèles. + </li> + <li>Il émule : + <div class="example"><p><code> + ProxyPass / backend.server:port<br /> + ProxyPassReverse / backend.server:port<br /> + </code></p></div> + En d'autres termes, l'URL dans son ensemble est ajoutée à l'URL + d'arrière-plan correspondante, tout ceci dans le but de + proposer un commutateur mandataire inverse simple mais rapide. + </li> + </ul> +</div> + +</div> +<div id="quickview"><h3 class="directives">Directives</h3> +<ul id="toc"> +<li><img alt="" src="../images/down.gif" /> <a href="#proxyexpressdbmfile">ProxyExpressDBMFile</a></li> +<li><img alt="" src="../images/down.gif" /> <a href="#proxyexpressdbmtype">ProxyExpressDBMType</a></li> +<li><img alt="" src="../images/down.gif" /> <a href="#proxyexpressenable">ProxyExpressEnable</a></li> +</ul> +<h3>Voir aussi</h3> +<ul class="seealso"> +<li><code class="module"><a href="../mod/mod_proxy.html">mod_proxy</a></code></li> +</ul><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="directive-section"><h2><a name="ProxyExpressDBMFile" id="ProxyExpressDBMFile">ProxyExpressDBMFile</a> <a name="proxyexpressdbmfile" id="proxyexpressdbmfile">Directive</a></h2> +<table class="directive"> +<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Chemin du fichier DBM.</td></tr> +<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>ProxyExpressDBMFile <chemin></code></td></tr> +<tr><th><a href="directive-dict.html#Default">Défaut:</a></th><td><code>None</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>Extension</td></tr> +<tr><th><a href="directive-dict.html#Module">Module:</a></th><td>mod_proxy_express</td></tr> +<tr><th><a href="directive-dict.html#Compatibility">Compatibilité:</a></th><td>Disponible à partir de la version 2.3.13 d'Apache</td></tr> +</table> + <p>La directive <code class="directive">ProxyExpressDBMFile</code> permet de + définir le chemin du fichier DBM de correspondance Express. Ce fichier + permet de faire correspondre le nom de serveur extrait de l'en-tête + Host: de la requête entrante avec une URL d'arrière-plan.</p> + + <div class="note"><h3>Note</h3> + <p>Ce fichier est élaboré à partir d'un fichier texte à l'aide de + l'utilitaire <code><a href="../programs/httxt2dbm.html">httxt2dbm</a></code>.</p> + + <div class="example"><h3>Fichier de correspondances ProxyExpress</h3><p><code> + ##<br /> + ##express-map.txt:<br /> + ##<br /> + <br /> + www1.example.com http://192.168.211.2:8080<br /> + www2.example.com http://192.168.211.12:8088<br /> + www3.example.com http://192.168.212.10<br /> + </code></p></div> + + <div class="example"><h3>Création du fichier DBM</h3><p><code> + httxt2dbm -i express-map.txt -o emap<br /> + </code></p></div> + + <div class="example"><h3>Configuration</h3><p><code> + ProxyExpressDBMFile emap<br /> + </code></p></div> + </div> + +</div> +<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div> +<div class="directive-section"><h2><a name="ProxyExpressDBMType" id="ProxyExpressDBMType">ProxyExpressDBMType</a> <a name="proxyexpressdbmtype" id="proxyexpressdbmtype">Directive</a></h2> +<table class="directive"> +<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Type de fichier DBM.</td></tr> +<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>ProxyExpressDBMFile <type></code></td></tr> +<tr><th><a href="directive-dict.html#Default">Défaut:</a></th><td><code>"default"</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>Extension</td></tr> +<tr><th><a href="directive-dict.html#Module">Module:</a></th><td>mod_proxy_express</td></tr> +<tr><th><a href="directive-dict.html#Compatibility">Compatibilité:</a></th><td>Disponible à partir de la version 2.3.13 d'Apache</td></tr> +</table> + <p>La directive <code class="directive">ProxyExpressDBMType</code> permet de + définir le type de fichier DBM requis par le module. La valeur par + défaut correspond au type DBM par défaut du fichier créé par + l'utilitaire <code><a href="../programs/httxt2dbm.html">httxt2dbm</a></code>.</p> + <p>Les valeurs possibles sont (mais toutes ne seront pas disponibles à + l'exécution) :</p> +<table class="bordered"><tr class="header"><th>Value</th><th>Description</th></tr> +<tr><td><code>db</code></td><td>Fichiers Berkeley DB</td></tr> +<tr class="odd"><td><code>gdbm</code></td><td>Fichiers GDBM</td></tr> +<tr><td><code>ndbm</code></td><td>Fichiers NDBM</td></tr> +<tr class="odd"><td><code>sdbm</code></td><td>Fichiers SDBM (toujours disponible)</td></tr> +<tr><td><code>default</code></td><td>type DBM par défaut</td></tr> +</table> + + +</div> +<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div> +<div class="directive-section"><h2><a name="ProxyExpressEnable" id="ProxyExpressEnable">ProxyExpressEnable</a> <a name="proxyexpressenable" id="proxyexpressenable">Directive</a></h2> +<table class="directive"> +<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Active la fonctionnalité du module.</td></tr> +<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>ProxyExpressEnable [on|off]</code></td></tr> +<tr><th><a href="directive-dict.html#Default">Défaut:</a></th><td><code>off</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>Extension</td></tr> +<tr><th><a href="directive-dict.html#Module">Module:</a></th><td>mod_proxy_express</td></tr> +<tr><th><a href="directive-dict.html#Compatibility">Compatibilité:</a></th><td>Disponible à partir de la version 2.3.13 d'Apache</td></tr> +</table> + <p>La directive <code class="directive">ProxyExpressEnable</code> permet + d'activer/désactiver le module.</p> + +</div> +</div> +<div class="bottomlang"> +<p><span>Langues Disponibles: </span><a href="../en/mod/mod_proxy_express.html" hreflang="en" rel="alternate" title="English"> en </a> | +<a href="../fr/mod/mod_proxy_express.html" title="Français"> fr </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/2.4/mod/mod_proxy_express.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 2013 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/directives.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 diff --git a/docs/manual/mod/mod_proxy_express.xml.fr b/docs/manual/mod/mod_proxy_express.xml.fr new file mode 100644 index 0000000000..02cd0123b5 --- /dev/null +++ b/docs/manual/mod/mod_proxy_express.xml.fr @@ -0,0 +1,170 @@ +<?xml version="1.0"?> +<!DOCTYPE modulesynopsis SYSTEM "../style/modulesynopsis.dtd"> +<?xml-stylesheet type="text/xsl" href="../style/manual.fr.xsl"?> +<!-- English Revision : 1361949 --> +<!-- 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_proxy_express.xml.meta"> + +<name>mod_proxy_express</name> +<description>Extension à <module>mod_proxy</module> pour le fonctionnement en mandataire +dynamique inverse de masse</description> +<status>Extension</status> +<sourcefile>mod_proxy_express.c</sourcefile> +<identifier>proxy_express_module</identifier> + +<summary> + <p>Ce module crée dynamiquement en masse des mandataires inverses en + faisant correspondre l'en-tête Host: de la requête HTTP à un nom de + serveur et une URL d'arrière-plan stockés dans un fichier DBM. Il + est ainsi plus aisé d'utiliser un grand nombre de + mandataires inverses sans avoir à modifier la configuration. Il est + loin de posséder autant de fonctionnalités que + <module>mod_proxy_balancer</module>, qui propose aussi la croissance + dynamique, mais il est conçu pour gérer un nombre beaucoup plus important + de serveurs d'arrière-plan. Il convient parfaitement pour créer un + commutateur HTTP frontal.</p> + + <p>Pour pouvoir être utilisé, ce module nécessite le chargement de + <module>mod_proxy</module>.</p> + + <note type="warning"><title>Avertissement</title> + <p>N'activez le mandatement que si vous avez <a + href="mod_proxy.html#access">sécurisé votre serveur</a>. Les + serveurs mandataires ouverts sont dangereux pour votre réseau, et + dans une plus large mesure pour Internet.</p> + </note> + +<note><title>Limitations</title> + <ul> + <li>Ce module n'est pas conçu pour remplacer les fonctionnalités + dynamiques de <module>mod_proxy_balancer</module>. Par contre, il + peut constituer une alternative légère et rapide à + <module>mod_rewrite</module> lorsque ce dernier utilise la directive + <directive>RewriteMap</directive> et le drapeau <code>[P]</code> + pour le mandatement inverse à partir d'une table de correspondances. + </li> + <li>Il ne supporte pas les mises en correspondance basées sur les + expressions rationnelles ou les modèles. + </li> + <li>Il émule : + <example> + ProxyPass / backend.server:port<br /> + ProxyPassReverse / backend.server:port<br /> + </example> + En d'autres termes, l'URL dans son ensemble est ajoutée à l'URL + d'arrière-plan correspondante, tout ceci dans le but de + proposer un commutateur mandataire inverse simple mais rapide. + </li> + </ul> +</note> + +</summary> +<seealso><module>mod_proxy</module></seealso> + +<directivesynopsis> +<name>ProxyExpressEnable</name> +<description>Active la fonctionnalité du module.</description> +<syntax>ProxyExpressEnable [on|off]</syntax> +<default>off</default> +<contextlist><context>server config</context><context>virtual host</context> + </contextlist> +<compatibility>Disponible à partir de la version 2.3.13 d'Apache</compatibility> + +<usage> + <p>La directive <directive>ProxyExpressEnable</directive> permet + d'activer/désactiver le module.</p> +</usage> +</directivesynopsis> + +<directivesynopsis> +<name>ProxyExpressDBMFile</name> +<description>Chemin du fichier DBM.</description> +<syntax>ProxyExpressDBMFile <chemin></syntax> +<default>None</default> +<contextlist><context>server config</context><context>virtual host</context> + </contextlist> +<compatibility>Disponible à partir de la version 2.3.13 d'Apache</compatibility> + +<usage> + <p>La directive <directive>ProxyExpressDBMFile</directive> permet de + définir le chemin du fichier DBM de correspondance Express. Ce fichier + permet de faire correspondre le nom de serveur extrait de l'en-tête + Host: de la requête entrante avec une URL d'arrière-plan.</p> + + <note><title>Note</title> + <p>Ce fichier est élaboré à partir d'un fichier texte à l'aide de + l'utilitaire <code><a + href="../programs/httxt2dbm.html">httxt2dbm</a></code>.</p> + + <example><title>Fichier de correspondances ProxyExpress</title> + ##<br /> + ##express-map.txt:<br /> + ##<br /> + <br /> + www1.example.com http://192.168.211.2:8080<br /> + www2.example.com http://192.168.211.12:8088<br /> + www3.example.com http://192.168.212.10<br /> + </example> + + <example><title>Création du fichier DBM</title> + httxt2dbm -i express-map.txt -o emap<br /> + </example> + + <example><title>Configuration</title> + ProxyExpressDBMFile emap<br /> + </example> + </note> +</usage> +</directivesynopsis> + +<directivesynopsis> +<name>ProxyExpressDBMType</name> +<description>Type de fichier DBM.</description> +<syntax>ProxyExpressDBMFile <type></syntax> +<default>"default"</default> +<contextlist><context>server config</context><context>virtual host</context> + </contextlist> +<compatibility>Disponible à partir de la version 2.3.13 d'Apache</compatibility> + +<usage> + <p>La directive <directive>ProxyExpressDBMType</directive> permet de + définir le type de fichier DBM requis par le module. La valeur par + défaut correspond au type DBM par défaut du fichier créé par + l'utilitaire <code><a + href="../programs/httxt2dbm.html">httxt2dbm</a></code>.</p> + <p>Les valeurs possibles sont (mais toutes ne seront pas disponibles à + l'exécution) :</p> +<table border="1" style="zebra"> + <columnspec><column width=".3"/><column width=".7"/></columnspec> + + <tr><th>Value</th><th>Description</th></tr> + <tr><td><code>db</code></td><td>Fichiers Berkeley DB</td></tr> + <tr><td><code>gdbm</code></td><td>Fichiers GDBM</td></tr> + <tr><td><code>ndbm</code></td><td>Fichiers NDBM</td></tr> + <tr><td><code>sdbm</code></td><td>Fichiers SDBM (toujours disponible)</td></tr> + <tr><td><code>default</code></td><td>type DBM par défaut</td></tr> + </table> + +</usage> +</directivesynopsis> + +</modulesynopsis> diff --git a/docs/manual/mod/mod_proxy_express.xml.meta b/docs/manual/mod/mod_proxy_express.xml.meta index a0a06bf7e9..4fda85c3b0 100644 --- a/docs/manual/mod/mod_proxy_express.xml.meta +++ b/docs/manual/mod/mod_proxy_express.xml.meta @@ -8,5 +8,6 @@ <variants> <variant>en</variant> + <variant>fr</variant> </variants> </metafile> diff --git a/docs/manual/mod/mod_proxy_fdpass.html b/docs/manual/mod/mod_proxy_fdpass.html index b660e02764..87478ac85d 100644 --- a/docs/manual/mod/mod_proxy_fdpass.html +++ b/docs/manual/mod/mod_proxy_fdpass.html @@ -3,3 +3,7 @@ URI: mod_proxy_fdpass.html.en Content-Language: en Content-type: text/html; charset=ISO-8859-1 + +URI: mod_proxy_fdpass.html.fr +Content-Language: fr +Content-type: text/html; charset=ISO-8859-1 diff --git a/docs/manual/mod/mod_proxy_fdpass.html.fr b/docs/manual/mod/mod_proxy_fdpass.html.fr new file mode 100644 index 0000000000..42f7c21e10 --- /dev/null +++ b/docs/manual/mod/mod_proxy_fdpass.html.fr @@ -0,0 +1,98 @@ +<?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><!-- + XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX + This file is generated from xml source: DO NOT EDIT + XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX + --> +<title>mod_proxy_fdpass - Serveur Apache HTTP</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.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/directives.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.4</p> +<img alt="" src="../images/feather.gif" /></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.4</a> > <a href="./">Modules</a></div> +<div id="page-content"> +<div id="preamble"><h1>Module Apache mod_proxy_fdpass</h1> +<div class="toplang"> +<p><span>Langues Disponibles: </span><a href="../en/mod/mod_proxy_fdpass.html" hreflang="en" rel="alternate" title="English"> en </a> | +<a href="../fr/mod/mod_proxy_fdpass.html" title="Français"> fr </a></p> +</div> +<table class="module"><tr><th><a href="module-dict.html#Description">Description:</a></th><td>Module fournissant le support des processus externes fdpass +à <code class="module"><a href="../mod/mod_proxy.html">mod_proxy</a></code></td></tr> +<tr><th><a href="module-dict.html#Status">Statut:</a></th><td>Extension</td></tr> +<tr><th><a href="module-dict.html#ModuleIdentifier">Identificateur de Module:</a></th><td>proxy_fdpass_module</td></tr> +<tr><th><a href="module-dict.html#SourceFile">Fichier Source:</a></th><td>mod_proxy_fdpass.c</td></tr> +<tr><th><a href="module-dict.html#Compatibility">Compatibilité:</a></th><td>Disponible pour unix depuis la version 2.3 +d'Apache</td></tr></table> +<h3>Sommaire</h3> + + <p>Pour fonctionner, ce module <em>nécessite</em> le chargement de + <code class="module"><a href="../mod/mod_proxy.html">mod_proxy</a></code>. Il permet le passage de la socket du client + vers un autre processus.</p> + + <p><code>mod_proxy_fdpass</code> utilise la capacité des sockets de + domaine AF_UNIX à <a href="http://www.freebsd.org/cgi/man.cgi?query=recv">transmettre un + descripteur de fichier ouvert</a> afin de permettre à un autre + processus de terminer le traitement de la requête. + </p> + + <p>Le module possède une interface de fournisseur + <code>proxy_fdpass_flusher</code> qui permet éventuellement à un + autre module d'envoyer les en-têtes de la réponse, ou même le début + du corps de la réponse. Le fournisseur par défaut flush désactive la + persistence, et envoie les en-têtes de la réponse, laissant le soin + au processus externe d'envoyer le corps de la réponse.</p> + + <p>À l'heure actuelle, la seule donnée transmise au processus + externe est la socket du client. Pour recevoir une socket client, + appelez recvfrom avec une structure <a href="http://www.kernel.org/doc/man-pages/online/pages/man3/ cmsg.3.html"><code>struct cmsghdr</code></a> allouée. Les versions + futures de ce module pourront transmettre d'autres données que le + socket client. + </p> +</div> +<div id="quickview"><h3 class="directives">Directives</h3> +<p>Ce module ne fournit aucune directive.</p> +<h3>Voir aussi</h3> +<ul class="seealso"> +<li><code class="module"><a href="../mod/mod_proxy.html">mod_proxy</a></code></li> +</ul><ul class="seealso"><li><a href="#comments_section">Commentaires</a></li></ul></div> + +</div> +<div class="bottomlang"> +<p><span>Langues Disponibles: </span><a href="../en/mod/mod_proxy_fdpass.html" hreflang="en" rel="alternate" title="English"> en </a> | +<a href="../fr/mod/mod_proxy_fdpass.html" title="Français"> fr </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/2.4/mod/mod_proxy_fdpass.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 2013 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/directives.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 diff --git a/docs/manual/mod/mod_proxy_fdpass.xml.fr b/docs/manual/mod/mod_proxy_fdpass.xml.fr new file mode 100644 index 0000000000..715ff1f973 --- /dev/null +++ b/docs/manual/mod/mod_proxy_fdpass.xml.fr @@ -0,0 +1,66 @@ +<?xml version="1.0"?> +<!DOCTYPE modulesynopsis SYSTEM "../style/modulesynopsis.dtd"> +<?xml-stylesheet type="text/xsl" href="../style/manual.fr.xsl"?> +<!-- English Revision : 1174747 --> +<!-- 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_proxy_fdpass.xml.meta"> + +<name>mod_proxy_fdpass</name> +<description>Module fournissant le support des processus externes fdpass +à <module>mod_proxy</module></description> +<status>Extension</status> +<sourcefile>mod_proxy_fdpass.c</sourcefile> +<identifier>proxy_fdpass_module</identifier> +<compatibility>Disponible pour unix depuis la version 2.3 +d'Apache</compatibility> + +<summary> + <p>Pour fonctionner, ce module <em>nécessite</em> le chargement de + <module>mod_proxy</module>. Il permet le passage de la socket du client + vers un autre processus.</p> + + <p><code>mod_proxy_fdpass</code> utilise la capacité des sockets de + domaine AF_UNIX à <a + href="http://www.freebsd.org/cgi/man.cgi?query=recv">transmettre un + descripteur de fichier ouvert</a> afin de permettre à un autre + processus de terminer le traitement de la requête. + </p> + + <p>Le module possède une interface de fournisseur + <code>proxy_fdpass_flusher</code> qui permet éventuellement à un + autre module d'envoyer les en-têtes de la réponse, ou même le début + du corps de la réponse. Le fournisseur par défaut flush désactive la + persistence, et envoie les en-têtes de la réponse, laissant le soin + au processus externe d'envoyer le corps de la réponse.</p> + + <p>À l'heure actuelle, la seule donnée transmise au processus + externe est la socket du client. Pour recevoir une socket client, + appelez recvfrom avec une structure <a + href="http://www.kernel.org/doc/man-pages/online/pages/man3/ + cmsg.3.html"><code>struct cmsghdr</code></a> allouée. Les versions + futures de ce module pourront transmettre d'autres données que le + socket client. + </p> +</summary> + +<seealso><module>mod_proxy</module></seealso> +</modulesynopsis> diff --git a/docs/manual/mod/mod_proxy_fdpass.xml.meta b/docs/manual/mod/mod_proxy_fdpass.xml.meta index a88dd48420..a99a7942b5 100644 --- a/docs/manual/mod/mod_proxy_fdpass.xml.meta +++ b/docs/manual/mod/mod_proxy_fdpass.xml.meta @@ -8,5 +8,6 @@ <variants> <variant>en</variant> + <variant>fr</variant> </variants> </metafile> diff --git a/docs/manual/mod/mod_proxy_ftp.html b/docs/manual/mod/mod_proxy_ftp.html index 0cdfe603aa..928eb93ef8 100644 --- a/docs/manual/mod/mod_proxy_ftp.html +++ b/docs/manual/mod/mod_proxy_ftp.html @@ -3,3 +3,7 @@ URI: mod_proxy_ftp.html.en Content-Language: en Content-type: text/html; charset=ISO-8859-1 + +URI: mod_proxy_ftp.html.fr +Content-Language: fr +Content-type: text/html; charset=ISO-8859-1 diff --git a/docs/manual/mod/mod_proxy_ftp.html.fr b/docs/manual/mod/mod_proxy_ftp.html.fr new file mode 100644 index 0000000000..701f4b45ae --- /dev/null +++ b/docs/manual/mod/mod_proxy_ftp.html.fr @@ -0,0 +1,295 @@ +<?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><!-- + XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX + This file is generated from xml source: DO NOT EDIT + XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX + --> +<title>mod_proxy_ftp - Serveur Apache HTTP</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.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/directives.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.4</p> +<img alt="" src="../images/feather.gif" /></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.4</a> > <a href="./">Modules</a></div> +<div id="page-content"> +<div id="preamble"><h1>Module Apache mod_proxy_ftp</h1> +<div class="toplang"> +<p><span>Langues Disponibles: </span><a href="../en/mod/mod_proxy_ftp.html" hreflang="en" rel="alternate" title="English"> en </a> | +<a href="../fr/mod/mod_proxy_ftp.html" title="Français"> fr </a></p> +</div> +<table class="module"><tr><th><a href="module-dict.html#Description">Description:</a></th><td>Module fournissant le support FTP à +<code class="module"><a href="../mod/mod_proxy.html">mod_proxy</a></code></td></tr> +<tr><th><a href="module-dict.html#Status">Statut:</a></th><td>Extension</td></tr> +<tr><th><a href="module-dict.html#ModuleIdentifier">Identificateur de Module:</a></th><td>proxy_ftp_module</td></tr> +<tr><th><a href="module-dict.html#SourceFile">Fichier Source:</a></th><td>mod_proxy_ftp.c</td></tr></table> +<h3>Sommaire</h3> + + <p>Pour pouvoir fonctionner, ce module <em>requiert</em> le + chargement de <code class="module"><a href="../mod/mod_proxy.html">mod_proxy</a></code>. Il fournit le support du + mandatement des sites FTP. Notez que le support FTP est + actuellement limité à la méthode GET.</p> + + <p>Ainsi, pour pouvoir traiter les requêtes FTP mandatées, + <code class="module"><a href="../mod/mod_proxy.html">mod_proxy</a></code>, et <code class="module"><a href="../mod/mod_proxy_ftp.html">mod_proxy_ftp</a></code> + doivent être chargés dans le serveur.</p> + + <div class="warning"><h3>Avertissement</h3> + <p>N'activez pas la fonctionnalité de mandataire avant d'avoir <a href="mod_proxy.html#access">sécurisé votre serveur</a>. Les + serveurs mandataires ouverts sont dangereux non seulement pour + votre réseau, mais aussi pour l'Internet au sens large.</p> + </div> +</div> +<div id="quickview"><h3 class="directives">Directives</h3> +<ul id="toc"> +<li><img alt="" src="../images/down.gif" /> <a href="#proxyftpdircharset">ProxyFtpDirCharset</a></li> +<li><img alt="" src="../images/down.gif" /> <a href="#proxyftpescapewildcards">ProxyFtpEscapeWildcards</a></li> +<li><img alt="" src="../images/down.gif" /> <a href="#proxyftplistonwildcard">ProxyFtpListOnWildcard</a></li> +</ul> +<h3>Sujets</h3> +<ul id="topics"> +<li><img alt="" src="../images/down.gif" /> <a href="#mimetypes">Pourquoi les fichiers du type + <var>xxx</var> ne sont-ils pas téléchargeables par FTP ?</a></li> +<li><img alt="" src="../images/down.gif" /> <a href="#type">Comment puis-je forcer le téléchargement + FTP en mode ASCII du fichier <var>xxx</var> ?</a></li> +<li><img alt="" src="../images/down.gif" /> <a href="#ftpnonget">Comment puis-je effectuer un + chargement FTP ?</a></li> +<li><img alt="" src="../images/down.gif" /> <a href="#percent2fhck">Comment puis-je accéder par FTP à + des fichiers situés en dehors de mon répertoire home ?</a></li> +<li><img alt="" src="../images/down.gif" /> <a href="#ftppass">Comment puis-je dissimuler le mot de + passe FTP apparaissant en clair dans la ligne d'URL de mon + navigateur ?</a></li> +<li><img alt="" src="../images/down.gif" /> <a href="#wildcard">Pourquoi reçois-je un listing de + fichiers alors que j'ai demandé le téléchargement d'un fichier + ?</a></li> +</ul><h3>Voir aussi</h3> +<ul class="seealso"> +<li><code class="module"><a href="../mod/mod_proxy.html">mod_proxy</a></code></li> +</ul><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="mimetypes" id="mimetypes">Pourquoi les fichiers du type + <var>xxx</var> ne sont-ils pas téléchargeables par FTP ?</a></h2> + <p>Ce type particulier de fichier n'est probablement pas défini en + temps que <code>application/octet-stream</code> dans le fichier + de configuration mime.types de votre mandataire. La ligne suivante + peut y remédier :</p> + + <div class="example"><pre>application/octet-stream bin dms lha lzh exe class tgz taz</pre></div> + <p>Vous pouvez aussi définir par défaut tous les types de fichiers + en tant que fichiers binaires :</p> + <div class="example"><pre class="prettyprint lang-config">ForceType application/octet-stream</pre> +</div> + </div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div> +<div class="section"> +<h2><a name="type" id="type">Comment puis-je forcer le téléchargement + FTP en mode ASCII du fichier <var>xxx</var> ?</a></h2> + <p>Dans les rares siruations où vous devez télécharger un fichier + spécifique en utilisant la méthode de transfert FTP + <code>ASCII</code> (alors que le mode transfert par défaut est + <code>binary</code>), vous pouvez modifier le mode de transfert de + <code class="module"><a href="../mod/mod_proxy.html">mod_proxy</a></code> en suffixant la requête avec + <code>;type=a</code> pour forcer un transfert en mode ASCII (les + listings de répertoires FTP sont cependant quant à eux transmis en + mode ASCII).</p> + </div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div> +<div class="section"> +<h2><a name="ftpnonget" id="ftpnonget">Comment puis-je effectuer un + chargement FTP ?</a></h2> + <p>Actuellement, seule la méthode GET est supportée pour FTP dans + mod_proxy. Vous pouvez en revanche utiliser le chargement HTTP (POST + or PUT) via un mandataire Apache.</p> + </div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div> +<div class="section"> +<h2><a name="percent2fhck" id="percent2fhck">Comment puis-je accéder par FTP à + des fichiers situés en dehors de mon répertoire home ?</a></h2> + <p>Un URI FTP est considéré comme relatif au répertoire home de + l'utilisateur connecté. Hélas, vous ne pouvez pas utiliser /../ + pour atteindre des répertoires de niveau supérieur, car les points + sont interprétés par le navigateur et ne sont donc pas vraiment + envoyés au serveur FTP. Pour traiter ce problème, une méthode + nommée <dfn>Squid %2f hack</dfn> a été implémentée dans le + mandataire FTP Apache ; cette solution est aussi utilisée par + d'autres serveurs mandataires courants comme le <a href="http://www.squid-cache.org/">Cache mandataire Squid</a>. En + préfixant par <code>/%2f</code> le chemin de votre requête, vous + pouvez faire en sorte que le mandataire modifie le répertoire FTP + racine en <code>/</code> (au lieu du répertoire home). Par + exemple, pour extraire le fichier <code>/etc/motd</code>, vous + pourriez utiliser l'URL :</p> + + <div class="example"><p><code> + ftp://<var>utilisateur</var>@<var>serveur</var>/%2f/etc/motd + </code></p></div> + </div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div> +<div class="section"> +<h2><a name="ftppass" id="ftppass">Comment puis-je dissimuler le mot de + passe FTP apparaissant en clair dans la ligne d'URL de mon + navigateur ?</a></h2> + <p>Apache utilise différentes stratégies pour effectuer une + connexion à un serveur FTP à l'aide d'un nom d'utilisateur et d'un + mot de passe. En l'absence de nom d'utilisateur et de mot de passe + dans l'URL, Apache tente une connexion anonyme auprès du serveur + FTP comme suit :</p> + + <div class="example"><p><code> + utilisateur : anonymous<br /> + mot de passe : apache_proxy@ + </code></p></div> + + <p>Ceci fonctionne avec tous les serveurs FTP courants configurés + pour accepter les connexions anonymes.</p> + + <p>Pour une connexion personnalisée avec un nom d'utilisateur + spécifique, vous pouvez intégrer ce dernier dans l'URL comme suit + :</p> + + <div class="example"><p><code> + ftp://<var>nom-utilisateur</var>@<var>serveur</var>/mon-fichier + </code></p></div> + + <p>Si le serveur FTP demande un mot de passe pour ce nom + d'utilisateur (ce qu'il est censé faire), Apache va renvoyer au + client une réponse <code>401</code> (Autorisation requise), ce qui + fera afficher au navigateur une boîte de dialogue utilisateur/mot + de passe. Une fois le mot de passe saisi, la connexion est tentée + à nouveau, et si elle réussit, la ressource demandée est + présentée. L'avantage de cette procédure réside dans le fait que + votre navigateur n'affiche pas le mot de passe en clair, ce qu'il + aurait fait si vous aviez utilisé l'URL :</p> + + <div class="example"><p><code> + ftp://<var>nom-utilisateur</var>:<var>mot-de-passe</var> + @<var>serveur</var>/mon-fichier + </code></p></div> + + <div class="note"><h3>Note</h3> + <p>Le mot de passe transmis de cette manière n'est pas chiffré + lorsqu'il est envoyé. Il transite entre votre navigateur et le + serveur mandataire Apache sous la forme d'une chaîne de texte en + clair codée en base64, et entre le mandataire Apache et le + serveur FTP en texte pur. Vous devez par conséquent réfléchir à + deux fois avant d'accéder à votre serveur FTP via HTTP (et d'une + manière générale avant d'accéder à vos fichiers personnels via + FTP !) sur des canaux non sécurisés, car des oreilles + indiscrètes pourraient intercepter votre mot de passe au cours + de son transfert.</p> + </div> + </div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div> +<div class="section"> +<h2><a name="wildcard" id="wildcard">Pourquoi reçois-je un listing de + fichiers alors que j'ai demandé le téléchargement d'un fichier + ?</a></h2> + <p>Apache examine l'URL de la requête afin de permettre la + navigation dans les répertoires d'un serveur FTP ainsi que le + téléchargement de fichiers. Si elle ressemble à un répertoire, ou + contient des caractères génériques ("*?[{~"), alors Apache + considère que c'est un listing qui est demandé, et non un + téléchargement.</p> + <p>Vous pouvez désactiver le traitement spécial des noms contenant + des caractères génériques. Voir à cet effet la directive + <code class="directive">ProxyFtpListOnWildcard</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="ProxyFtpDirCharset" id="ProxyFtpDirCharset">ProxyFtpDirCharset</a> <a name="proxyftpdircharset" id="proxyftpdircharset">Directive</a></h2> +<table class="directive"> +<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Définit le jeu de caractères des listings FTP +mandatés</td></tr> +<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>ProxyFtpDirCharset <var>jeu-caractères</var></code></td></tr> +<tr><th><a href="directive-dict.html#Default">Défaut:</a></th><td><code>ProxyFtpDirCharset ISO-8859-1</code></td></tr> +<tr><th><a href="directive-dict.html#Context">Contexte:</a></th><td>configuration du serveur, serveur virtuel, répertoire</td></tr> +<tr><th><a href="directive-dict.html#Status">Statut:</a></th><td>Extension</td></tr> +<tr><th><a href="directive-dict.html#Module">Module:</a></th><td>mod_proxy_ftp</td></tr> +<tr><th><a href="directive-dict.html#Compatibility">Compatibilité:</a></th><td>Disponible depuis la version 2.2.7 d'Apache. Déplacé +depuis <code class="module"><a href="../mod/mod_proxy.html">mod_proxy</a></code> à partir de la version 2.3.5 d'Apache</td></tr> +</table> + <p>La directive <code class="directive">ProxyFtpDirCharset</code> permet de + définir le jeu de caractères à utiliser pour les listings FTP en + HTML générés par <code class="module"><a href="../mod/mod_proxy_ftp.html">mod_proxy_ftp</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="ProxyFtpEscapeWildcards" id="ProxyFtpEscapeWildcards">ProxyFtpEscapeWildcards</a> <a name="proxyftpescapewildcards" id="proxyftpescapewildcards">Directive</a></h2> +<table class="directive"> +<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Les caractères génériques dans les noms de fichiers +doivent-ils être échappés lorsqu'ils sont envoyés au serveur FTP ?</td></tr> +<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>ProxyFtpEscapeWildcards [on|off]</code></td></tr> +<tr><th><a href="directive-dict.html#Default">Défaut:</a></th><td><code>on</code></td></tr> +<tr><th><a href="directive-dict.html#Context">Contexte:</a></th><td>configuration du serveur, serveur virtuel, répertoire</td></tr> +<tr><th><a href="directive-dict.html#Status">Statut:</a></th><td>Extension</td></tr> +<tr><th><a href="directive-dict.html#Module">Module:</a></th><td>mod_proxy_ftp</td></tr> +<tr><th><a href="directive-dict.html#Compatibility">Compatibilité:</a></th><td>Disponible depuis la version 2.3.3 du serveur HTTP Apache</td></tr> +</table> + <p>La directive <code class="directive">ProxyFtpEscapeWildcards</code> permet + de déterminer si les caractères génériques ("*?[{~") que contiennent + les noms de fichiers demandés doivent être échappés pas un slash + inversé avant d'être envoyés au serveur FTP. Il s'agit du comportement + par défaut ; cependant, de nombreux serveurs FTP n'ont aucune + connaissance de la notion d'échappement, et tentent de servir le + fichier demandé sous sa forme littérale, en incluant les slashes + inversés dans son nom.</p> + <p>Définissez cette directive à "off" pour permettre le + téléchargement de fichiers dont les noms contiennent des caractères + génériques depuis des serveurs FTP qui ne connaissent pas + l'échappement des caractères génériques.</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="ProxyFtpListOnWildcard" id="ProxyFtpListOnWildcard">ProxyFtpListOnWildcard</a> <a name="proxyftplistonwildcard" id="proxyftplistonwildcard">Directive</a></h2> +<table class="directive"> +<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Les caractères génériques dans les noms de fichiers +demandés doivent-ils déclencher l'affichage d'un listing ?</td></tr> +<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>ProxyFtpListOnWildcard [on|off]</code></td></tr> +<tr><th><a href="directive-dict.html#Default">Défaut:</a></th><td><code>on</code></td></tr> +<tr><th><a href="directive-dict.html#Context">Contexte:</a></th><td>configuration du serveur, serveur virtuel, répertoire</td></tr> +<tr><th><a href="directive-dict.html#Status">Statut:</a></th><td>Extension</td></tr> +<tr><th><a href="directive-dict.html#Module">Module:</a></th><td>mod_proxy_ftp</td></tr> +<tr><th><a href="directive-dict.html#Compatibility">Compatibilité:</a></th><td>Disponible depuis la version 2.3.3 du serveur HTTP Apache</td></tr> +</table> + <p>La directive <code class="directive">ProxyFtpListOnWildcard</code> permet + de déterminer si les caractères génériques ("*?[{~") que contiennent + les noms de fichiers demandés provoquent l'affichage d'un listing de + fichiers par <code class="module"><a href="../mod/mod_proxy_ftp.html">mod_proxy_ftp</a></code> au lieu de télécharger un + fichier. Il s'agit de leur comportement par défaut (valeur on). + Définissez cette directive à "off" pour permettre le téléchargement de + fichiers même si leur nom contient des caractères génériques.</p> + +</div> +</div> +<div class="bottomlang"> +<p><span>Langues Disponibles: </span><a href="../en/mod/mod_proxy_ftp.html" hreflang="en" rel="alternate" title="English"> en </a> | +<a href="../fr/mod/mod_proxy_ftp.html" title="Français"> fr </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/2.4/mod/mod_proxy_ftp.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 2013 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/directives.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 diff --git a/docs/manual/mod/mod_proxy_ftp.xml.fr b/docs/manual/mod/mod_proxy_ftp.xml.fr new file mode 100644 index 0000000000..e3c88d5336 --- /dev/null +++ b/docs/manual/mod/mod_proxy_ftp.xml.fr @@ -0,0 +1,245 @@ +<?xml version="1.0"?> +<!DOCTYPE modulesynopsis SYSTEM "../style/modulesynopsis.dtd"> +<?xml-stylesheet type="text/xsl" href="../style/manual.fr.xsl"?> +<!-- English Revision : 1421892 --> +<!-- 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_proxy_ftp.xml.meta"> + +<name>mod_proxy_ftp</name> +<description>Module fournissant le support FTP à +<module>mod_proxy</module></description> +<status>Extension</status> +<sourcefile>mod_proxy_ftp.c</sourcefile> +<identifier>proxy_ftp_module</identifier> + +<summary> + <p>Pour pouvoir fonctionner, ce module <em>requiert</em> le + chargement de <module>mod_proxy</module>. Il fournit le support du + mandatement des sites FTP. Notez que le support FTP est + actuellement limité à la méthode GET.</p> + + <p>Ainsi, pour pouvoir traiter les requêtes FTP mandatées, + <module>mod_proxy</module>, et <module>mod_proxy_ftp</module> + doivent être chargés dans le serveur.</p> + + <note type="warning"><title>Avertissement</title> + <p>N'activez pas la fonctionnalité de mandataire avant d'avoir <a + href="mod_proxy.html#access">sécurisé votre serveur</a>. Les + serveurs mandataires ouverts sont dangereux non seulement pour + votre réseau, mais aussi pour l'Internet au sens large.</p> + </note> +</summary> +<seealso><module>mod_proxy</module></seealso> + + <section id="mimetypes"><title>Pourquoi les fichiers du type + <var>xxx</var> ne sont-ils pas téléchargeables par FTP ?</title> + <p>Ce type particulier de fichier n'est probablement pas défini en + temps que <code>application/octet-stream</code> dans le fichier + de configuration mime.types de votre mandataire. La ligne suivante + peut y remédier :</p> + + <example> +<pre>application/octet-stream bin dms lha lzh exe class tgz taz</pre> + </example> + <p>Vous pouvez aussi définir par défaut tous les types de fichiers + en tant que fichiers binaires :</p> + <example> +<highlight language="config">ForceType application/octet-stream</highlight> + </example> + </section> <!-- /mimetypes --> + + <section id="type"><title>Comment puis-je forcer le téléchargement + FTP en mode ASCII du fichier <var>xxx</var> ?</title> + <p>Dans les rares siruations où vous devez télécharger un fichier + spécifique en utilisant la méthode de transfert FTP + <code>ASCII</code> (alors que le mode transfert par défaut est + <code>binary</code>), vous pouvez modifier le mode de transfert de + <module>mod_proxy</module> en suffixant la requête avec + <code>;type=a</code> pour forcer un transfert en mode ASCII (les + listings de répertoires FTP sont cependant quant à eux transmis en + mode ASCII).</p> + </section> <!-- /type --> + + <section id="ftpnonget"><title>Comment puis-je effectuer un + chargement FTP ?</title> + <p>Actuellement, seule la méthode GET est supportée pour FTP dans + mod_proxy. Vous pouvez en revanche utiliser le chargement HTTP (POST + or PUT) via un mandataire Apache.</p> + </section> + + <section id="percent2fhck"><title>Comment puis-je accéder par FTP à + des fichiers situés en dehors de mon répertoire home ?</title> + <p>Un URI FTP est considéré comme relatif au répertoire home de + l'utilisateur connecté. Hélas, vous ne pouvez pas utiliser /../ + pour atteindre des répertoires de niveau supérieur, car les points + sont interprétés par le navigateur et ne sont donc pas vraiment + envoyés au serveur FTP. Pour traiter ce problème, une méthode + nommée <dfn>Squid %2f hack</dfn> a été implémentée dans le + mandataire FTP Apache ; cette solution est aussi utilisée par + d'autres serveurs mandataires courants comme le <a + href="http://www.squid-cache.org/">Cache mandataire Squid</a>. En + préfixant par <code>/%2f</code> le chemin de votre requête, vous + pouvez faire en sorte que le mandataire modifie le répertoire FTP + racine en <code>/</code> (au lieu du répertoire home). Par + exemple, pour extraire le fichier <code>/etc/motd</code>, vous + pourriez utiliser l'URL :</p> + + <example> + ftp://<var>utilisateur</var>@<var>serveur</var>/%2f/etc/motd + </example> + </section> <!-- /percent2fhck --> + + <section id="ftppass"><title>Comment puis-je dissimuler le mot de + passe FTP apparaissant en clair dans la ligne d'URL de mon + navigateur ?</title> + <p>Apache utilise différentes stratégies pour effectuer une + connexion à un serveur FTP à l'aide d'un nom d'utilisateur et d'un + mot de passe. En l'absence de nom d'utilisateur et de mot de passe + dans l'URL, Apache tente une connexion anonyme auprès du serveur + FTP comme suit :</p> + + <example> + utilisateur : anonymous<br /> + mot de passe : apache_proxy@ + </example> + + <p>Ceci fonctionne avec tous les serveurs FTP courants configurés + pour accepter les connexions anonymes.</p> + + <p>Pour une connexion personnalisée avec un nom d'utilisateur + spécifique, vous pouvez intégrer ce dernier dans l'URL comme suit + :</p> + + <example> + ftp://<var>nom-utilisateur</var>@<var>serveur</var>/mon-fichier + </example> + + <p>Si le serveur FTP demande un mot de passe pour ce nom + d'utilisateur (ce qu'il est censé faire), Apache va renvoyer au + client une réponse <code>401</code> (Autorisation requise), ce qui + fera afficher au navigateur une boîte de dialogue utilisateur/mot + de passe. Une fois le mot de passe saisi, la connexion est tentée + à nouveau, et si elle réussit, la ressource demandée est + présentée. L'avantage de cette procédure réside dans le fait que + votre navigateur n'affiche pas le mot de passe en clair, ce qu'il + aurait fait si vous aviez utilisé l'URL :</p> + + <example> + ftp://<var>nom-utilisateur</var>:<var>mot-de-passe</var> + @<var>serveur</var>/mon-fichier + </example> + + <note><title>Note</title> + <p>Le mot de passe transmis de cette manière n'est pas chiffré + lorsqu'il est envoyé. Il transite entre votre navigateur et le + serveur mandataire Apache sous la forme d'une chaîne de texte en + clair codée en base64, et entre le mandataire Apache et le + serveur FTP en texte pur. Vous devez par conséquent réfléchir à + deux fois avant d'accéder à votre serveur FTP via HTTP (et d'une + manière générale avant d'accéder à vos fichiers personnels via + FTP !) sur des canaux non sécurisés, car des oreilles + indiscrètes pourraient intercepter votre mot de passe au cours + de son transfert.</p> + </note> + </section> <!-- /ftppass --> + + <section id="wildcard"><title>Pourquoi reçois-je un listing de + fichiers alors que j'ai demandé le téléchargement d'un fichier + ?</title> + <p>Apache examine l'URL de la requête afin de permettre la + navigation dans les répertoires d'un serveur FTP ainsi que le + téléchargement de fichiers. Si elle ressemble à un répertoire, ou + contient des caractères génériques ("*?[{~"), alors Apache + considère que c'est un listing qui est demandé, et non un + téléchargement.</p> + <p>Vous pouvez désactiver le traitement spécial des noms contenant + des caractères génériques. Voir à cet effet la directive + <directive>ProxyFtpListOnWildcard</directive>. + </p> + </section> <!-- /wildcard --> + +<directivesynopsis> +<name>ProxyFtpListOnWildcard</name> +<description>Les caractères génériques dans les noms de fichiers +demandés doivent-ils déclencher l'affichage d'un listing ?</description> +<syntax>ProxyFtpListOnWildcard [on|off]</syntax> +<default>on</default> +<contextlist><context>server config</context><context>virtual host</context> + <context>directory</context></contextlist> +<compatibility>Disponible depuis la version 2.3.3 du serveur HTTP Apache</compatibility> + +<usage> + <p>La directive <directive>ProxyFtpListOnWildcard</directive> permet + de déterminer si les caractères génériques ("*?[{~") que contiennent + les noms de fichiers demandés provoquent l'affichage d'un listing de + fichiers par <module>mod_proxy_ftp</module> au lieu de télécharger un + fichier. Il s'agit de leur comportement par défaut (valeur on). + Définissez cette directive à "off" pour permettre le téléchargement de + fichiers même si leur nom contient des caractères génériques.</p> +</usage> +</directivesynopsis> + +<directivesynopsis> +<name>ProxyFtpEscapeWildcards</name> +<description>Les caractères génériques dans les noms de fichiers +doivent-ils être échappés lorsqu'ils sont envoyés au serveur FTP ?</description> +<syntax>ProxyFtpEscapeWildcards [on|off]</syntax> +<default>on</default> +<contextlist><context>server config</context><context>virtual host</context> + <context>directory</context></contextlist> +<compatibility>Disponible depuis la version 2.3.3 du serveur HTTP Apache</compatibility> + +<usage> + <p>La directive <directive>ProxyFtpEscapeWildcards</directive> permet + de déterminer si les caractères génériques ("*?[{~") que contiennent + les noms de fichiers demandés doivent être échappés pas un slash + inversé avant d'être envoyés au serveur FTP. Il s'agit du comportement + par défaut ; cependant, de nombreux serveurs FTP n'ont aucune + connaissance de la notion d'échappement, et tentent de servir le + fichier demandé sous sa forme littérale, en incluant les slashes + inversés dans son nom.</p> + <p>Définissez cette directive à "off" pour permettre le + téléchargement de fichiers dont les noms contiennent des caractères + génériques depuis des serveurs FTP qui ne connaissent pas + l'échappement des caractères génériques.</p> +</usage> +</directivesynopsis> + +<directivesynopsis> +<name>ProxyFtpDirCharset</name> +<description>Définit le jeu de caractères des listings FTP +mandatés</description> +<syntax>ProxyFtpDirCharset <var>jeu-caractères</var></syntax> +<default>ProxyFtpDirCharset ISO-8859-1</default> +<contextlist><context>server config</context><context>virtual host</context> +<context>directory</context></contextlist> +<compatibility>Disponible depuis la version 2.2.7 d'Apache. Déplacé +depuis <module>mod_proxy</module> à partir de la version 2.3.5 d'Apache</compatibility> + +<usage> + <p>La directive <directive>ProxyFtpDirCharset</directive> permet de + définir le jeu de caractères à utiliser pour les listings FTP en + HTML générés par <module>mod_proxy_ftp</module>.</p> +</usage> +</directivesynopsis> + +</modulesynopsis> diff --git a/docs/manual/mod/mod_proxy_ftp.xml.meta b/docs/manual/mod/mod_proxy_ftp.xml.meta index 1a0b188f79..b95c3fd4e3 100644 --- a/docs/manual/mod/mod_proxy_ftp.xml.meta +++ b/docs/manual/mod/mod_proxy_ftp.xml.meta @@ -8,5 +8,6 @@ <variants> <variant>en</variant> + <variant>fr</variant> </variants> </metafile> diff --git a/docs/manual/mod/mod_proxy_scgi.html b/docs/manual/mod/mod_proxy_scgi.html index 590ef84df5..fd75046f0b 100644 --- a/docs/manual/mod/mod_proxy_scgi.html +++ b/docs/manual/mod/mod_proxy_scgi.html @@ -3,3 +3,7 @@ URI: mod_proxy_scgi.html.en Content-Language: en Content-type: text/html; charset=ISO-8859-1 + +URI: mod_proxy_scgi.html.fr +Content-Language: fr +Content-type: text/html; charset=ISO-8859-1 diff --git a/docs/manual/mod/mod_proxy_scgi.html.fr b/docs/manual/mod/mod_proxy_scgi.html.fr new file mode 100644 index 0000000000..ff7fa46413 --- /dev/null +++ b/docs/manual/mod/mod_proxy_scgi.html.fr @@ -0,0 +1,220 @@ +<?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><!-- + XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX + This file is generated from xml source: DO NOT EDIT + XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX + --> +<title>mod_proxy_scgi - Serveur Apache HTTP</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.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/directives.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.4</p> +<img alt="" src="../images/feather.gif" /></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.4</a> > <a href="./">Modules</a></div> +<div id="page-content"> +<div id="preamble"><h1>Module Apache mod_proxy_scgi</h1> +<div class="toplang"> +<p><span>Langues Disponibles: </span><a href="../en/mod/mod_proxy_scgi.html" hreflang="en" rel="alternate" title="English"> en </a> | +<a href="../fr/mod/mod_proxy_scgi.html" title="Français"> fr </a></p> +</div> +<table class="module"><tr><th><a href="module-dict.html#Description">Description:</a></th><td>Module fournissant le support de la passerelle SCGI à +<code class="module"><a href="../mod/mod_proxy.html">mod_proxy</a></code></td></tr> +<tr><th><a href="module-dict.html#Status">Statut:</a></th><td>Extension</td></tr> +<tr><th><a href="module-dict.html#ModuleIdentifier">Identificateur de Module:</a></th><td>proxy_scgi_module</td></tr> +<tr><th><a href="module-dict.html#SourceFile">Fichier Source:</a></th><td>mod_proxy_scgi.c</td></tr> +<tr><th><a href="module-dict.html#Compatibility">Compatibilité:</a></th><td>Disponible depuis la version 2.2.14 d'Apache</td></tr></table> +<h3>Sommaire</h3> + + <p>Pour pouvoir fonctionner, ce module <em>requiert</em> le + chargement de <code class="module"><a href="../mod/mod_proxy.html">mod_proxy</a></code>. Il fournit le support du + <a href="http://python.ca/scgi/protocol.txt">protocole SCGI, version + 1</a>.</p> + + <p>Ainsi, pour être en mesure de traiter le protocole SCGI, + <code class="module"><a href="../mod/mod_proxy.html">mod_proxy</a></code> et <code class="module"><a href="../mod/mod_proxy_scgi.html">mod_proxy_scgi</a></code> + doivent être chargés dans le serveur.</p> + + <div class="warning"><h3>Avertissement</h3> + <p>N'activez pas la fonctionnalité de mandataire avant d'avoir <a href="mod_proxy.html#access">sécurisé votre serveur</a>. Les + serveurs mandataires ouverts sont dangereux non seulement pour + votre réseau, mais aussi pour l'Internet au sens large.</p> + </div> +</div> +<div id="quickview"><h3 class="directives">Directives</h3> +<ul id="toc"> +<li><img alt="" src="../images/down.gif" /> <a href="#proxyscgiinternalredirect">ProxySCGIInternalRedirect</a></li> +<li><img alt="" src="../images/down.gif" /> <a href="#proxyscgisendfile">ProxySCGISendfile</a></li> +</ul> +<h3>Sujets</h3> +<ul id="topics"> +<li><img alt="" src="../images/down.gif" /> <a href="#examples">Exemples</a></li> +<li><img alt="" src="../images/down.gif" /> <a href="#env">Variables d'environnement</a></li> +</ul><h3>Voir aussi</h3> +<ul class="seealso"> +<li><code class="module"><a href="../mod/mod_proxy.html">mod_proxy</a></code></li> +<li><code class="module"><a href="../mod/mod_proxy_balancer.html">mod_proxy_balancer</a></code></li> +</ul><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="examples" id="examples">Exemples</a></h2> + <p>Rappelez-vous, pour que les exemples suivants puissent + fonctionner, vous devez activer <code class="module"><a href="../mod/mod_proxy.html">mod_proxy</a></code> et + <code class="module"><a href="../mod/mod_proxy_scgi.html">mod_proxy_scgi</a></code>.</p> + + <div class="example"><h3>Passerelle simple</h3><pre class="prettyprint lang-config"> + ProxyPass /scgi-bin/ scgi://localhost:4000/ + </pre> +</div> + + <p>La passerelle à répartition de charge nécessite le chargement du + module <code class="module"><a href="../mod/mod_proxy_balancer.html">mod_proxy_balancer</a></code> et d'au moins un module + fournissant un algorithme de répartition de charge, comme + <code class="module"><a href="../mod/mod_lbmethod_byrequests.html">mod_lbmethod_byrequests</a></code> en plus des modules + déjà cités. <code class="module"><a href="../mod/mod_lbmethod_byrequests.html">mod_lbmethod_byrequests</a></code> est le module + par défaut et sera utilisé dans cet exemple de configuration.</p> + + <div class="example"><h3>Passerelle à répartition de charge</h3><pre class="prettyprint lang-config"> +ProxyPass /scgi-bin/ balancer://somecluster/ +<Proxy balancer://somecluster/> + BalancerMember scgi://localhost:4000/ + BalancerMember scgi://localhost:4001/ +</Proxy> + </pre> +</div> +</div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div> +<div class="section"> +<h2><a name="env" id="env">Variables d'environnement</a></h2> + <p>En plus des directives de configuration qui permettent de + contrôler le comportement de <code class="module"><a href="../mod/mod_proxy.html">mod_proxy</a></code>, de + nombreuses <dfn>variables d'environnement</dfn> permettent de + contrôler le fournisseur de protocole SCGI :</p> + <dl> + <dt>proxy-scgi-pathinfo</dt> + <dd>Par défaut, <code class="module"><a href="../mod/mod_proxy_scgi.html">mod_proxy_scgi</a></code> ne créera ni + exportera jamais la variable d'environnement + <var>PATH_INFO</var>. Ceci permet au serveur SCGI d'arrière-plan + de déterminer correctement <var>SCRIPT_NAME</var> et + <var>Script-URI</var>, et de rester en conformité avec la section + 3.3 de la RFC 3875. Si au contraire vous souhaitez que + <code class="module"><a href="../mod/mod_proxy_scgi.html">mod_proxy_scgi</a></code> génère une estimation la plus + précise possible de <var>PATH_INFO</var>, définissez cette + variable d'environnement.</dd> + </dl> +</div> +<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div> +<div class="directive-section"><h2><a name="ProxySCGIInternalRedirect" id="ProxySCGIInternalRedirect">ProxySCGIInternalRedirect</a> <a name="proxyscgiinternalredirect" id="proxyscgiinternalredirect">Directive</a></h2> +<table class="directive"> +<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Active ou désactive les réponses de redirection interne en +provenance du serveur cible.</td></tr> +<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>ProxySCGIInternalRedirect On|Off</code></td></tr> +<tr><th><a href="directive-dict.html#Default">Défaut:</a></th><td><code>ProxySCGIInternalRedirect On</code></td></tr> +<tr><th><a href="directive-dict.html#Context">Contexte:</a></th><td>configuration du serveur, serveur virtuel, répertoire</td></tr> +<tr><th><a href="directive-dict.html#Status">Statut:</a></th><td>Extension</td></tr> +<tr><th><a href="directive-dict.html#Module">Module:</a></th><td>mod_proxy_scgi</td></tr> +</table> + <p>La directive <code class="directive">ProxySCGIInternalRedirect</code> + permet au serveur cible de rediriger en interne la passerelle vers + une URL différente. Cette fonctionnalité trouve son origine dans + <code class="module"><a href="../mod/mod_cgi.html">mod_cgi</a></code> qui redirige la réponse en interne si + l'état de la réponse est <code>OK</code> (<code>200</code>), et si + la réponse contient un en-tête <code>Location</code> dont la valeur + débute par un slash (<code>/</code>). Cette valeur est interprétée + comme une nouvelle URL locale vers laquelle Apache effectue sa + redirection.</p> + + <p>De ce point de vue, <code class="module"><a href="../mod/mod_proxy_scgi.html">mod_proxy_scgi</a></code> fait la même + chose que <code class="module"><a href="../mod/mod_cgi.html">mod_cgi</a></code>, mais vous pouvez en plus + désactiver la fonctionnalité.</p> + + <div class="example"><h3>Exemple</h3><pre class="prettyprint lang-config"> + ProxySCGIInternalRedirect Off + </pre> +</div> + +</div> +<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div> +<div class="directive-section"><h2><a name="ProxySCGISendfile" id="ProxySCGISendfile">ProxySCGISendfile</a> <a name="proxyscgisendfile" id="proxyscgisendfile">Directive</a></h2> +<table class="directive"> +<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Active l'évaluation du pseudo en-tête de réponse +<var>X-Sendfile</var></td></tr> +<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>ProxySCGISendfile On|Off|<var>nom-en-tête</var></code></td></tr> +<tr><th><a href="directive-dict.html#Default">Défaut:</a></th><td><code>ProxySCGISendfile Off</code></td></tr> +<tr><th><a href="directive-dict.html#Context">Contexte:</a></th><td>configuration du serveur, serveur virtuel, répertoire</td></tr> +<tr><th><a href="directive-dict.html#Status">Statut:</a></th><td>Extension</td></tr> +<tr><th><a href="directive-dict.html#Module">Module:</a></th><td>mod_proxy_scgi</td></tr> +</table> + <p>La directive <code class="directive">ProxySCGISendfile</code> permet au + serveur cible SCGI de faire servir les fichiers directement par la + passerelle. Ceci s'avère bénéfique en matière de performances -- + httpd peut alors utiliser <code>sendfile</code> ou d'autres + optimisations, ce qui n'est pas possible si les fichiers passent par + la socket du serveur cible.</p> + <p>L'argument de la directive + <code class="directive">ProxySCGISendfile</code> détermine le comportement + de la passerelle :</p> + <dl> + <dt><code>Off</code></dt> + <dd>Aucun traitement particulier n'est effectué.</dd> + + <dt><code>On</code></dt> + <dd>La passerelle recherche un en-tête dans la réponse du serveur + cible nommé <code>X-Sendfile</code>, et interprète sa valeur comme + le nom du fichier à servir. L'en-tête est ensuite supprimé de la + réponse finale. Cet argument produit le même effet que + <code>ProxySCGISendfile X-Sendfile</code>.</dd> + + <dt>toute autre valeur</dt> + <dd>Identique à <code>On</code>, mais au lieu de rechercher le nom + d'en-tête codé en dur, c'est la valeur de l'argument qui constitue + le nom de l'en-tête à rechercher.</dd> + </dl> + + <div class="example"><h3>Exemple</h3><pre class="prettyprint lang-config"> + # Utilise le nom d'en-tête par défaut (X-Sendfile) + ProxySCGISendfile On + + # Utilise un nom d'en-tête différent + ProxySCGISendfile X-Send-Static + </pre> +</div> + +</div> +</div> +<div class="bottomlang"> +<p><span>Langues Disponibles: </span><a href="../en/mod/mod_proxy_scgi.html" hreflang="en" rel="alternate" title="English"> en </a> | +<a href="../fr/mod/mod_proxy_scgi.html" title="Français"> fr </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/2.4/mod/mod_proxy_scgi.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 2013 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/directives.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 diff --git a/docs/manual/mod/mod_proxy_scgi.xml.fr b/docs/manual/mod/mod_proxy_scgi.xml.fr new file mode 100644 index 0000000000..9549e91056 --- /dev/null +++ b/docs/manual/mod/mod_proxy_scgi.xml.fr @@ -0,0 +1,184 @@ +<?xml version="1.0"?> +<!DOCTYPE modulesynopsis SYSTEM "../style/modulesynopsis.dtd"> +<?xml-stylesheet type="text/xsl" href="../style/manual.fr.xsl"?> +<!-- English Revision : 1334022 --> +<!-- 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_proxy_scgi.xml.meta"> + +<name>mod_proxy_scgi</name> +<description>Module fournissant le support de la passerelle SCGI à +<module>mod_proxy</module></description> +<status>Extension</status> +<sourcefile>mod_proxy_scgi.c</sourcefile> +<identifier>proxy_scgi_module</identifier> +<compatibility>Disponible depuis la version 2.2.14 d'Apache</compatibility> + +<summary> + <p>Pour pouvoir fonctionner, ce module <em>requiert</em> le + chargement de <module>mod_proxy</module>. Il fournit le support du + <a href="http://python.ca/scgi/protocol.txt">protocole SCGI, version + 1</a>.</p> + + <p>Ainsi, pour être en mesure de traiter le protocole SCGI, + <module>mod_proxy</module> et <module>mod_proxy_scgi</module> + doivent être chargés dans le serveur.</p> + + <note type="warning"><title>Avertissement</title> + <p>N'activez pas la fonctionnalité de mandataire avant d'avoir <a + href="mod_proxy.html#access">sécurisé votre serveur</a>. Les + serveurs mandataires ouverts sont dangereux non seulement pour + votre réseau, mais aussi pour l'Internet au sens large.</p> + </note> +</summary> + +<seealso><module>mod_proxy</module></seealso> +<seealso><module>mod_proxy_balancer</module></seealso> + +<section id="examples"><title>Exemples</title> + <p>Rappelez-vous, pour que les exemples suivants puissent + fonctionner, vous devez activer <module>mod_proxy</module> et + <module>mod_proxy_scgi</module>.</p> + + <example><title>Passerelle simple</title> + <highlight language="config"> + ProxyPass /scgi-bin/ scgi://localhost:4000/ + </highlight> + </example> + + <p>La passerelle à répartition de charge nécessite le chargement du + module <module>mod_proxy_balancer</module> et d'au moins un module + fournissant un algorithme de répartition de charge, comme + <module>mod_lbmethod_byrequests</module> en plus des modules + déjà cités. <module>mod_lbmethod_byrequests</module> est le module + par défaut et sera utilisé dans cet exemple de configuration.</p> + + <example><title>Passerelle à répartition de charge</title> + <highlight language="config"> +ProxyPass /scgi-bin/ balancer://somecluster/ +<Proxy balancer://somecluster/> + BalancerMember scgi://localhost:4000/ + BalancerMember scgi://localhost:4001/ +</Proxy> + </highlight> + </example> +</section> + +<section id="env"><title>Variables d'environnement</title> + <p>En plus des directives de configuration qui permettent de + contrôler le comportement de <module>mod_proxy</module>, de + nombreuses <dfn>variables d'environnement</dfn> permettent de + contrôler le fournisseur de protocole SCGI :</p> + <dl> + <dt>proxy-scgi-pathinfo</dt> + <dd>Par défaut, <module>mod_proxy_scgi</module> ne créera ni + exportera jamais la variable d'environnement + <var>PATH_INFO</var>. Ceci permet au serveur SCGI d'arrière-plan + de déterminer correctement <var>SCRIPT_NAME</var> et + <var>Script-URI</var>, et de rester en conformité avec la section + 3.3 de la RFC 3875. Si au contraire vous souhaitez que + <module>mod_proxy_scgi</module> génère une estimation la plus + précise possible de <var>PATH_INFO</var>, définissez cette + variable d'environnement.</dd> + </dl> +</section> + +<directivesynopsis> +<name>ProxySCGISendfile</name> +<description>Active l'évaluation du pseudo en-tête de réponse +<var>X-Sendfile</var></description> +<syntax>ProxySCGISendfile On|Off|<var>nom-en-tête</var></syntax> +<default>ProxySCGISendfile Off</default> +<contextlist><context>server config</context><context>virtual host</context> +<context>directory</context></contextlist> + +<usage> + <p>La directive <directive>ProxySCGISendfile</directive> permet au + serveur cible SCGI de faire servir les fichiers directement par la + passerelle. Ceci s'avère bénéfique en matière de performances -- + httpd peut alors utiliser <code>sendfile</code> ou d'autres + optimisations, ce qui n'est pas possible si les fichiers passent par + la socket du serveur cible.</p> + <p>L'argument de la directive + <directive>ProxySCGISendfile</directive> détermine le comportement + de la passerelle :</p> + <dl> + <dt><code>Off</code></dt> + <dd>Aucun traitement particulier n'est effectué.</dd> + + <dt><code>On</code></dt> + <dd>La passerelle recherche un en-tête dans la réponse du serveur + cible nommé <code>X-Sendfile</code>, et interprète sa valeur comme + le nom du fichier à servir. L'en-tête est ensuite supprimé de la + réponse finale. Cet argument produit le même effet que + <code>ProxySCGISendfile X-Sendfile</code>.</dd> + + <dt>toute autre valeur</dt> + <dd>Identique à <code>On</code>, mais au lieu de rechercher le nom + d'en-tête codé en dur, c'est la valeur de l'argument qui constitue + le nom de l'en-tête à rechercher.</dd> + </dl> + + <example><title>Exemple</title> + <highlight language="config"> + # Utilise le nom d'en-tête par défaut (X-Sendfile) + ProxySCGISendfile On + + # Utilise un nom d'en-tête différent + ProxySCGISendfile X-Send-Static + </highlight> + </example> +</usage> +</directivesynopsis> + +<directivesynopsis> +<name>ProxySCGIInternalRedirect</name> +<description>Active ou désactive les réponses de redirection interne en +provenance du serveur cible.</description> +<syntax>ProxySCGIInternalRedirect On|Off</syntax> +<default>ProxySCGIInternalRedirect On</default> +<contextlist><context>server config</context><context>virtual host</context> +<context>directory</context></contextlist> + +<usage> + <p>La directive <directive>ProxySCGIInternalRedirect</directive> + permet au serveur cible de rediriger en interne la passerelle vers + une URL différente. Cette fonctionnalité trouve son origine dans + <module>mod_cgi</module> qui redirige la réponse en interne si + l'état de la réponse est <code>OK</code> (<code>200</code>), et si + la réponse contient un en-tête <code>Location</code> dont la valeur + débute par un slash (<code>/</code>). Cette valeur est interprétée + comme une nouvelle URL locale vers laquelle Apache effectue sa + redirection.</p> + + <p>De ce point de vue, <module>mod_proxy_scgi</module> fait la même + chose que <module>mod_cgi</module>, mais vous pouvez en plus + désactiver la fonctionnalité.</p> + + <example><title>Exemple</title> + <highlight language="config"> + ProxySCGIInternalRedirect Off + </highlight> + </example> +</usage> +</directivesynopsis> + +</modulesynopsis> diff --git a/docs/manual/mod/mod_proxy_scgi.xml.meta b/docs/manual/mod/mod_proxy_scgi.xml.meta index 143cd4fa7d..a125bc5ade 100644 --- a/docs/manual/mod/mod_proxy_scgi.xml.meta +++ b/docs/manual/mod/mod_proxy_scgi.xml.meta @@ -8,5 +8,6 @@ <variants> <variant>en</variant> + <variant>fr</variant> </variants> </metafile> diff --git a/docs/manual/mod/mod_reflector.html b/docs/manual/mod/mod_reflector.html index 2d220f6714..788294bf23 100644 --- a/docs/manual/mod/mod_reflector.html +++ b/docs/manual/mod/mod_reflector.html @@ -3,3 +3,7 @@ URI: mod_reflector.html.en Content-Language: en Content-type: text/html; charset=ISO-8859-1 + +URI: mod_reflector.html.fr +Content-Language: fr +Content-type: text/html; charset=ISO-8859-1 diff --git a/docs/manual/mod/mod_reflector.html.fr b/docs/manual/mod/mod_reflector.html.fr new file mode 100644 index 0000000000..ca9a8ecb48 --- /dev/null +++ b/docs/manual/mod/mod_reflector.html.fr @@ -0,0 +1,129 @@ +<?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><!-- + XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX + This file is generated from xml source: DO NOT EDIT + XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX + --> +<title>mod_reflector - Serveur Apache HTTP</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.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/directives.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.4</p> +<img alt="" src="../images/feather.gif" /></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.4</a> > <a href="./">Modules</a></div> +<div id="page-content"> +<div id="preamble"><h1>Module Apache mod_reflector</h1> +<div class="toplang"> +<p><span>Langues Disponibles: </span><a href="../en/mod/mod_reflector.html" hreflang="en" rel="alternate" title="English"> en </a> | +<a href="../fr/mod/mod_reflector.html" title="Français"> fr </a></p> +</div> +<table class="module"><tr><th><a href="module-dict.html#Description">Description:</a></th><td>Réfléchit un corps de requête comme réponse via la pile de +filtres en sortie.</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>reflector_module</td></tr> +<tr><th><a href="module-dict.html#SourceFile">Fichier Source:</a></th><td>mod_reflector.c</td></tr> +<tr><th><a href="module-dict.html#Compatibility">Compatibilité:</a></th><td>Versions 2.3 et ultérieures</td></tr></table> +<h3>Sommaire</h3> + + <p>Ce module permet de renvoyer un corps de requête au client, après + l'avoir fait passer par la pile de filtres en sortie. Une chaîne de + filtres configurée de manière appropriée peut être utilisée pour + transformer la requête en réponse. Ce module peut ainsi être utilisé + pour transformer un filtre en sortie en service HTTP.</p> +</div> +<div id="quickview"><h3 class="directives">Directives</h3> +<ul id="toc"> +<li><img alt="" src="../images/down.gif" /> <a href="#reflectorheader">ReflectorHeader</a></li> +</ul> +<h3>Sujets</h3> +<ul id="topics"> +<li><img alt="" src="../images/down.gif" /> <a href="#examples">Exemples</a></li> +</ul><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="examples" id="examples">Exemples</a></h2> + <dl> + <dt>Service de compression</dt> + <dd>Fait passer le corps de la requête par le filtre DEFLATE pour le + compresser. Cette requête nécessite un en-tête Content-Encoding + contenant la valeur "gzip" pour que le filtre renvoie les données + compressées. + <pre class="prettyprint lang-config"> +<Location /compress> + SetHandler reflector + SetOutputFilter DEFLATE +</Location> + </pre> + + </dd> + + <dt>Service d'abaissement de l'échantillonnage d'image</dt> + <dd>Fait passer le corps de la requête par un filtre d'abaissement + de l'échantillonnage d'image, et renvoie le résultat au client. + <pre class="prettyprint lang-config"> +<Location /downsample> + SetHandler reflector + SetOutputFilter DOWNSAMPLE +</Location> + </pre> + + </dd> + </dl> +</div> +<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div> +<div class="directive-section"><h2><a name="ReflectorHeader" id="ReflectorHeader">ReflectorHeader</a> <a name="reflectorheader" id="reflectorheader">Directive</a></h2> +<table class="directive"> +<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Réfléchit un en-tête d'entrée dans les en-têtes de sortie</td></tr> +<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>ReflectorHeader <var>en-tête-entrée</var> <var>[en-tête-sortie]</var></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>Options</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_reflector</td></tr> +</table> + <p>Cette directive permet de contrôler la répercution des en-têtes + de la requête dans la réponse. Le premier argument correspond au nom + de l'en-tête à copier. Si le second argument (optionnel) est + spécifié, il définit le nom sous lequel l'en-tête sera répercuté + dans la réponse ; dans le cas contraire, c'est le nom de l'en-tête + original qui sera utilisé.</p> + +</div> +</div> +<div class="bottomlang"> +<p><span>Langues Disponibles: </span><a href="../en/mod/mod_reflector.html" hreflang="en" rel="alternate" title="English"> en </a> | +<a href="../fr/mod/mod_reflector.html" title="Français"> fr </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/2.4/mod/mod_reflector.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 2013 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/directives.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 diff --git a/docs/manual/mod/mod_reflector.xml.fr b/docs/manual/mod/mod_reflector.xml.fr new file mode 100644 index 0000000000..10e5115ba6 --- /dev/null +++ b/docs/manual/mod/mod_reflector.xml.fr @@ -0,0 +1,89 @@ +<?xml version="1.0"?> +<!DOCTYPE modulesynopsis SYSTEM "../style/modulesynopsis.dtd"> +<?xml-stylesheet type="text/xsl" href="../style/manual.en.xsl"?> +<!-- English Revision : 1334024 --> +<!-- 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_reflector.xml.meta"> + +<name>mod_reflector</name> +<description>Réfléchit un corps de requête comme réponse via la pile de +filtres en sortie.</description> +<status>Base</status> +<sourcefile>mod_reflector.c</sourcefile> +<identifier>reflector_module</identifier> +<compatibility>Versions 2.3 et ultérieures</compatibility> + +<summary> + <p>Ce module permet de renvoyer un corps de requête au client, après + l'avoir fait passer par la pile de filtres en sortie. Une chaîne de + filtres configurée de manière appropriée peut être utilisée pour + transformer la requête en réponse. Ce module peut ainsi être utilisé + pour transformer un filtre en sortie en service HTTP.</p> +</summary> + +<section id="examples"><title>Exemples</title> + <dl> + <dt>Service de compression</dt> + <dd>Fait passer le corps de la requête par le filtre DEFLATE pour le + compresser. Cette requête nécessite un en-tête Content-Encoding + contenant la valeur "gzip" pour que le filtre renvoie les données + compressées. + <highlight language="config"> +<Location /compress> + SetHandler reflector + SetOutputFilter DEFLATE +</Location> + </highlight> + </dd> + + <dt>Service d'abaissement de l'échantillonnage d'image</dt> + <dd>Fait passer le corps de la requête par un filtre d'abaissement + de l'échantillonnage d'image, et renvoie le résultat au client. + <highlight language="config"> +<Location /downsample> + SetHandler reflector + SetOutputFilter DOWNSAMPLE +</Location> + </highlight> + </dd> + </dl> +</section> + +<directivesynopsis> +<name>ReflectorHeader</name> +<description>Réfléchit un en-tête d'entrée dans les en-têtes de sortie</description> +<syntax>ReflectorHeader <var>en-tête-entrée</var> <var>[en-tête-sortie]</var></syntax> +<contextlist><context>server config</context><context>virtual host</context> +<context>directory</context><context>.htaccess</context></contextlist> +<override>Options</override> + +<usage> + <p>Cette directive permet de contrôler la répercution des en-têtes + de la requête dans la réponse. Le premier argument correspond au nom + de l'en-tête à copier. Si le second argument (optionnel) est + spécifié, il définit le nom sous lequel l'en-tête sera répercuté + dans la réponse ; dans le cas contraire, c'est le nom de l'en-tête + original qui sera utilisé.</p> +</usage> +</directivesynopsis> + +</modulesynopsis> diff --git a/docs/manual/mod/mod_reflector.xml.meta b/docs/manual/mod/mod_reflector.xml.meta index d7945b496e..70e22cc937 100644 --- a/docs/manual/mod/mod_reflector.xml.meta +++ b/docs/manual/mod/mod_reflector.xml.meta @@ -8,5 +8,6 @@ <variants> <variant>en</variant> + <variant>fr</variant> </variants> </metafile> diff --git a/docs/manual/mod/mod_speling.html b/docs/manual/mod/mod_speling.html index 7cc8d4ee00..8d138c2f9a 100644 --- a/docs/manual/mod/mod_speling.html +++ b/docs/manual/mod/mod_speling.html @@ -4,6 +4,10 @@ URI: mod_speling.html.en Content-Language: en Content-type: text/html; charset=ISO-8859-1 +URI: mod_speling.html.fr +Content-Language: fr +Content-type: text/html; charset=ISO-8859-1 + URI: mod_speling.html.ja.utf8 Content-Language: ja Content-type: text/html; charset=UTF-8 diff --git a/docs/manual/mod/mod_speling.html.fr b/docs/manual/mod/mod_speling.html.fr new file mode 100644 index 0000000000..7068e3c451 --- /dev/null +++ b/docs/manual/mod/mod_speling.html.fr @@ -0,0 +1,167 @@ +<?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><!-- + XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX + This file is generated from xml source: DO NOT EDIT + XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX + --> +<title>mod_speling - Serveur Apache HTTP</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.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/directives.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.4</p> +<img alt="" src="../images/feather.gif" /></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.4</a> > <a href="./">Modules</a></div> +<div id="page-content"> +<div id="preamble"><h1>Module Apache mod_speling</h1> +<div class="toplang"> +<p><span>Langues Disponibles: </span><a href="../en/mod/mod_speling.html" hreflang="en" rel="alternate" title="English"> en </a> | +<a href="../fr/mod/mod_speling.html" title="Français"> fr </a> | +<a href="../ja/mod/mod_speling.html" hreflang="ja" rel="alternate" title="Japanese"> ja </a> | +<a href="../ko/mod/mod_speling.html" hreflang="ko" rel="alternate" title="Korean"> ko </a></p> +</div> +<table class="module"><tr><th><a href="module-dict.html#Description">Description:</a></th><td>Tente de corriger les erreurs de casse dans les URLs ou les +fautes de frappe mineures.</td></tr> +<tr><th><a href="module-dict.html#Status">Statut:</a></th><td>Extension</td></tr> +<tr><th><a href="module-dict.html#ModuleIdentifier">Identificateur de Module:</a></th><td>speling_module</td></tr> +<tr><th><a href="module-dict.html#SourceFile">Fichier Source:</a></th><td>mod_speling.c</td></tr></table> +<h3>Sommaire</h3> + + + <p>Il arrive que des requêtes pour des documents ne puissent pas + être traitées par le serveur Apache de base à cause d'une erreur + de frappe ou de casse. Ce module permet de traiter ce + problème en essayant de trouver un document correspondant, même + lorsque tous les autres modules y ont renoncé. Sa méthode de travail + consiste à comparer chaque nom de document du répertoire demandé + avec le document de la requête <strong>sans tenir compte de la + casse</strong>, et en acceptant <strong>jusqu'à une erreur</strong> + (insertion, omission, inversion de caractère ou caractère + erroné). Une liste de tous les documents qui correspondent est alors + élaborée en utilisant cette stratégie.</p> + + <p>Si après le parcours du répertoire,</p> + + <ul> + <li>aucun document correspondant n'a été trouvé, Apache procèdera + normalement et renverra une erreur "document non trouvé".</li> + + <li>un seul document correspondant pratiquement à la requête a + été trouvé, celui-ci est renvoyé sous la forme d'une réponse de + redirection.</li> + + <li>plusieurs documents pouvant correspondre ont été trouvés, une + liste des documents est envoyée au client afin que ce dernier + puisse sélectionner le document correct.</li> + </ul> + +</div> +<div id="quickview"><h3 class="directives">Directives</h3> +<ul id="toc"> +<li><img alt="" src="../images/down.gif" /> <a href="#checkcaseonly">CheckCaseOnly</a></li> +<li><img alt="" src="../images/down.gif" /> <a href="#checkspelling">CheckSpelling</a></li> +</ul> +<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="directive-section"><h2><a name="CheckCaseOnly" id="CheckCaseOnly">CheckCaseOnly</a> <a name="checkcaseonly" id="checkcaseonly">Directive</a></h2> +<table class="directive"> +<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Limite l'action du module aux corrections de +majuscules</td></tr> +<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>CheckCaseOnly on|off</code></td></tr> +<tr><th><a href="directive-dict.html#Default">Défaut:</a></th><td><code>CheckCaseOnly 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>Options</td></tr> +<tr><th><a href="directive-dict.html#Status">Statut:</a></th><td>Extension</td></tr> +<tr><th><a href="directive-dict.html#Module">Module:</a></th><td>mod_speling</td></tr> +</table> + <p>Lorsqu'elle est définie à "on", cette directive permet de limiter + l'action du module aux inversions majuscule/minuscule. Les autres + corrections ne sont pas effectuées.</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="CheckSpelling" id="CheckSpelling">CheckSpelling</a> <a name="checkspelling" id="checkspelling">Directive</a></h2> +<table class="directive"> +<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Active le module de correction</td></tr> +<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>CheckSpelling on|off</code></td></tr> +<tr><th><a href="directive-dict.html#Default">Défaut:</a></th><td><code>CheckSpelling 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>Options</td></tr> +<tr><th><a href="directive-dict.html#Status">Statut:</a></th><td>Extension</td></tr> +<tr><th><a href="directive-dict.html#Module">Module:</a></th><td>mod_speling</td></tr> +</table> + <p>Cette directive permet d'activer ou de désactiver le module de + correction. Lorsqu'il est activé, rappelez-vous que :</p> + + <ul> + <li>le parcours du répertoire nécessaire à la correction aura un + impact sur les performances du serveur lorsque de nombreuses + corrections devront être effectuées au même moment.</li> + + <li>l'arborescence ne doit pas contenir de documents + sensibles qui pourraient être considérés par erreur comme + correspondant à la requête.</li> + + <li>le module ne corrige pas les noms d'utilisateur mal + orthographiés (comme dans + <code>http://mon.serveur/~apahce/</code>), mais seulement les noms + de fichiers ou de répertoires.</li> + + <li>les corrections s'appliquent strictement aux fichiers + existants, si bien qu'une requête pour <code><Location + /status></code> pour être traitée de manière incorrecte comme + une requête pour le fichier négocié "<code>/stats.html</code>".</li> + </ul> + + + <p>mod_speling ne doit pas être activé pour des répertoires où <a href="mod_dav.html">DAV</a> l'est aussi, car il va essayer de + "corriger" les noms des ressources nouvellement créées en fonction + des noms de fichiers existants ; par exemple, lors du chargement + d'un nouveau document <code>doc43.html</code>, il est possible qu'il + redirige vers un document existant <code>doc34.html</code>, ce qui + ne correspond pas à ce que l'on souhaite. + </p> + +</div> +</div> +<div class="bottomlang"> +<p><span>Langues Disponibles: </span><a href="../en/mod/mod_speling.html" hreflang="en" rel="alternate" title="English"> en </a> | +<a href="../fr/mod/mod_speling.html" title="Français"> fr </a> | +<a href="../ja/mod/mod_speling.html" hreflang="ja" rel="alternate" title="Japanese"> ja </a> | +<a href="../ko/mod/mod_speling.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/2.4/mod/mod_speling.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 2013 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/directives.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 diff --git a/docs/manual/mod/mod_speling.xml.fr b/docs/manual/mod/mod_speling.xml.fr new file mode 100644 index 0000000000..4425806f49 --- /dev/null +++ b/docs/manual/mod/mod_speling.xml.fr @@ -0,0 +1,139 @@ +<?xml version="1.0"?> +<!DOCTYPE modulesynopsis SYSTEM "../style/modulesynopsis.dtd"> +<?xml-stylesheet type="text/xsl" href="../style/manual.fr.xsl"?> +<!-- English Revision : 1174747 --> +<!-- 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_speling.xml.meta"> + +<name>mod_speling</name> +<description>Tente de corriger les erreurs de casse dans les URLs ou les +fautes de frappe mineures.</description> +<status>Extension</status> +<sourcefile>mod_speling.c</sourcefile> +<identifier>speling_module</identifier> + + + +<summary> + + <p>Il arrive que des requêtes pour des documents ne puissent pas + être traitées par le serveur Apache de base à cause d'une erreur + de frappe ou de casse. Ce module permet de traiter ce + problème en essayant de trouver un document correspondant, même + lorsque tous les autres modules y ont renoncé. Sa méthode de travail + consiste à comparer chaque nom de document du répertoire demandé + avec le document de la requête <strong>sans tenir compte de la + casse</strong>, et en acceptant <strong>jusqu'à une erreur</strong> + (insertion, omission, inversion de caractère ou caractère + erroné). Une liste de tous les documents qui correspondent est alors + élaborée en utilisant cette stratégie.</p> + + <p>Si après le parcours du répertoire,</p> + + <ul> + <li>aucun document correspondant n'a été trouvé, Apache procèdera + normalement et renverra une erreur "document non trouvé".</li> + + <li>un seul document correspondant pratiquement à la requête a + été trouvé, celui-ci est renvoyé sous la forme d'une réponse de + redirection.</li> + + <li>plusieurs documents pouvant correspondre ont été trouvés, une + liste des documents est envoyée au client afin que ce dernier + puisse sélectionner le document correct.</li> + </ul> + +</summary> + + +<directivesynopsis> +<name>CheckSpelling</name> +<description>Active le module de correction</description> +<syntax>CheckSpelling on|off</syntax> +<default>CheckSpelling Off</default> +<contextlist> +<context>server config</context> +<context>virtual host</context> +<context>directory</context> +<context>.htaccess</context> +</contextlist> +<override>Options</override> + +<usage> + <p>Cette directive permet d'activer ou de désactiver le module de + correction. Lorsqu'il est activé, rappelez-vous que :</p> + + <ul> + <li>le parcours du répertoire nécessaire à la correction aura un + impact sur les performances du serveur lorsque de nombreuses + corrections devront être effectuées au même moment.</li> + + <li>l'arborescence ne doit pas contenir de documents + sensibles qui pourraient être considérés par erreur comme + correspondant à la requête.</li> + + <li>le module ne corrige pas les noms d'utilisateur mal + orthographiés (comme dans + <code>http://mon.serveur/~apahce/</code>), mais seulement les noms + de fichiers ou de répertoires.</li> + + <li>les corrections s'appliquent strictement aux fichiers + existants, si bien qu'une requête pour <code><Location + /status></code> pour être traitée de manière incorrecte comme + une requête pour le fichier négocié "<code>/stats.html</code>".</li> + </ul> + + <!-- XXX: is that really true?! -nd --> + <p>mod_speling ne doit pas être activé pour des répertoires où <a + href="mod_dav.html">DAV</a> l'est aussi, car il va essayer de + "corriger" les noms des ressources nouvellement créées en fonction + des noms de fichiers existants ; par exemple, lors du chargement + d'un nouveau document <code>doc43.html</code>, il est possible qu'il + redirige vers un document existant <code>doc34.html</code>, ce qui + ne correspond pas à ce que l'on souhaite. + </p> +</usage> +</directivesynopsis> + +<directivesynopsis> +<name>CheckCaseOnly</name> +<description>Limite l'action du module aux corrections de +majuscules</description> +<syntax>CheckCaseOnly on|off</syntax> +<default>CheckCaseOnly Off</default> +<contextlist> +<context>server config</context> +<context>virtual host</context> +<context>directory</context> +<context>.htaccess</context> +</contextlist> +<override>Options</override> + +<usage> + <p>Lorsqu'elle est définie à "on", cette directive permet de limiter + l'action du module aux inversions majuscule/minuscule. Les autres + corrections ne sont pas effectuées.</p> + +</usage> +</directivesynopsis> + +</modulesynopsis> diff --git a/docs/manual/mod/mod_speling.xml.meta b/docs/manual/mod/mod_speling.xml.meta index 0ccab96858..2b2546b834 100644 --- a/docs/manual/mod/mod_speling.xml.meta +++ b/docs/manual/mod/mod_speling.xml.meta @@ -8,6 +8,7 @@ <variants> <variant>en</variant> + <variant>fr</variant> <variant outdated="yes">ja</variant> <variant outdated="yes">ko</variant> </variants> diff --git a/docs/manual/mod/mpmt_os2.html b/docs/manual/mod/mpmt_os2.html index eb0b883e85..032c4b4f83 100644 --- a/docs/manual/mod/mpmt_os2.html +++ b/docs/manual/mod/mpmt_os2.html @@ -3,3 +3,7 @@ URI: mpmt_os2.html.en Content-Language: en Content-type: text/html; charset=ISO-8859-1 + +URI: mpmt_os2.html.fr +Content-Language: fr +Content-type: text/html; charset=ISO-8859-1 diff --git a/docs/manual/mod/mpmt_os2.html.fr b/docs/manual/mod/mpmt_os2.html.fr new file mode 100644 index 0000000000..47647ca255 --- /dev/null +++ b/docs/manual/mod/mpmt_os2.html.fr @@ -0,0 +1,100 @@ +<?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><!-- + XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX + This file is generated from xml source: DO NOT EDIT + XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX + --> +<title>mpmt_os2 - Serveur Apache HTTP</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.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/directives.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.4</p> +<img alt="" src="../images/feather.gif" /></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.4</a> > <a href="./">Modules</a></div> +<div id="page-content"> +<div id="preamble"><h1>Apache MPM os2</h1> +<div class="toplang"> +<p><span>Langues Disponibles: </span><a href="../en/mod/mpmt_os2.html" hreflang="en" rel="alternate" title="English"> en </a> | +<a href="../fr/mod/mpmt_os2.html" title="Français"> fr </a></p> +</div> +<table class="module"><tr><th><a href="module-dict.html#Description">Description:</a></th><td>MPM hybride multi-processus, multi-thread pour +OS/2</td></tr> +<tr><th><a href="module-dict.html#Status">Statut:</a></th><td>MPM</td></tr> +<tr><th><a href="module-dict.html#ModuleIdentifier">Identificateur de Module:</a></th><td>mpm_mpmt_os2_module</td></tr> +<tr><th><a href="module-dict.html#SourceFile">Fichier Source:</a></th><td>mpmt_os2.c</td></tr></table> +<h3>Sommaire</h3> + + <p>Le serveur se compose d'un processus principal parent, et d'un + petit nombre fixe de processus enfants.</p> + + <p>La tâche du processus parent consiste à gérer les processus + enfants, c'est à dire lancer ces processus de manière à ce + qu'il y en ait toujours un nombre égal à la valeur de la directive + <code class="directive"><a href="../mod/mpm_common.html#startservers">StartServers</a></code> pour traiter + les connexions.</p> + + <p>Chaque processus enfant comporte un jeu de threads esclaves et un + thread maître qui accepte les connexions et les distribue aux + esclaves via une file de travail. Le jeu de threads esclaves est + dynamique et géré par un thread de maintenance de façon à ce que le + nombre de threads inactifs soit maintenu entre <code class="directive"><a href="../mod/mpm_common.html#minsparethreads">MinSpareThreads</a></code> et <code class="directive"><a href="../mod/mpm_common.html#maxsparethreads">MaxSpareThreads</a></code>.</p> +</div> +<div id="quickview"><h3 class="directives">Directives</h3> +<ul id="toc"> +<li><img alt="" src="../images/right.gif" /> <a href="mpm_common.html#group">Group</a></li> +<li><img alt="" src="../images/right.gif" /> <a href="mpm_common.html#listen">Listen</a></li> +<li><img alt="" src="../images/right.gif" /> <a href="mpm_common.html#listenbacklog">ListenBacklog</a></li> +<li><img alt="" src="../images/right.gif" /> <a href="mpm_common.html#maxconnectionsperchild">MaxConnectionsPerChild</a></li> +<li><img alt="" src="../images/right.gif" /> <a href="mpm_common.html#maxsparethreads">MaxSpareThreads</a></li> +<li><img alt="" src="../images/right.gif" /> <a href="mpm_common.html#minsparethreads">MinSpareThreads</a></li> +<li><img alt="" src="../images/right.gif" /> <a href="mpm_common.html#pidfile">PidFile</a></li> +<li><img alt="" src="../images/right.gif" /> <a href="mpm_common.html#receivebuffersize">ReceiveBufferSize</a></li> +<li><img alt="" src="../images/right.gif" /> <a href="mpm_common.html#sendbuffersize">SendBufferSize</a></li> +<li><img alt="" src="../images/right.gif" /> <a href="mpm_common.html#startservers">StartServers</a></li> +<li><img alt="" src="../images/right.gif" /> <a href="mpm_common.html#user">User</a></li> +</ul> +<h3>Voir aussi</h3> +<ul class="seealso"> +<li><a href="../bind.html">Définition des adresses et ports +qu'utilise Apache</a></li> +</ul><ul class="seealso"><li><a href="#comments_section">Commentaires</a></li></ul></div> + +</div> +<div class="bottomlang"> +<p><span>Langues Disponibles: </span><a href="../en/mod/mpmt_os2.html" hreflang="en" rel="alternate" title="English"> en </a> | +<a href="../fr/mod/mpmt_os2.html" title="Français"> fr </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/2.4/mod/mpmt_os2.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 2013 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/directives.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 diff --git a/docs/manual/mod/mpmt_os2.xml.fr b/docs/manual/mod/mpmt_os2.xml.fr new file mode 100644 index 0000000000..6e6b6cb100 --- /dev/null +++ b/docs/manual/mod/mpmt_os2.xml.fr @@ -0,0 +1,78 @@ +<?xml version="1.0"?> +<!DOCTYPE modulesynopsis SYSTEM "../style/modulesynopsis.dtd"> +<?xml-stylesheet type="text/xsl" href="../style/manual.fr.xsl"?> +<!-- English Revision : 1328329 --> +<!-- 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="mpmt_os2.xml.meta"> + +<name>mpmt_os2</name> +<description>MPM hybride multi-processus, multi-thread pour +OS/2</description> +<status>MPM</status> +<sourcefile>mpmt_os2.c</sourcefile> +<identifier>mpm_mpmt_os2_module</identifier> + +<summary> + <p>Le serveur se compose d'un processus principal parent, et d'un + petit nombre fixe de processus enfants.</p> + + <p>La tâche du processus parent consiste à gérer les processus + enfants, c'est à dire lancer ces processus de manière à ce + qu'il y en ait toujours un nombre égal à la valeur de la directive + <directive module="mpm_common">StartServers</directive> pour traiter + les connexions.</p> + + <p>Chaque processus enfant comporte un jeu de threads esclaves et un + thread maître qui accepte les connexions et les distribue aux + esclaves via une file de travail. Le jeu de threads esclaves est + dynamique et géré par un thread de maintenance de façon à ce que le + nombre de threads inactifs soit maintenu entre <directive + module="mpm_common">MinSpareThreads</directive> et <directive + module="mpm_common">MaxSpareThreads</directive>.</p> +</summary> +<seealso><a href="../bind.html">Définition des adresses et ports +qu'utilise Apache</a></seealso> + +<directivesynopsis location="mpm_common"><name>User</name> +</directivesynopsis> +<directivesynopsis location="mpm_common"><name>Group</name> +</directivesynopsis> +<directivesynopsis location="mpm_common"><name>Listen</name> +</directivesynopsis> +<directivesynopsis location="mpm_common"><name>ListenBacklog</name> +</directivesynopsis> +<directivesynopsis location="mpm_common"><name>ReceiveBufferSize</name> +</directivesynopsis> +<directivesynopsis location="mpm_common"><name>SendBufferSize</name> +</directivesynopsis> +<directivesynopsis location="mpm_common"><name>MaxConnectionsPerChild</name> +</directivesynopsis> +<directivesynopsis location="mpm_common"><name>MaxSpareThreads</name> +</directivesynopsis> +<directivesynopsis location="mpm_common"><name>MinSpareThreads</name> +</directivesynopsis> +<directivesynopsis location="mpm_common"><name>PidFile</name> +</directivesynopsis> +<directivesynopsis location="mpm_common"><name>StartServers</name> +</directivesynopsis> + +</modulesynopsis> diff --git a/docs/manual/mod/mpmt_os2.xml.meta b/docs/manual/mod/mpmt_os2.xml.meta index dfe34172d9..f380b827f6 100644 --- a/docs/manual/mod/mpmt_os2.xml.meta +++ b/docs/manual/mod/mpmt_os2.xml.meta @@ -8,5 +8,6 @@ <variants> <variant>en</variant> + <variant>fr</variant> </variants> </metafile> |