diff options
| author | Vincent Deffontaines <gryzor@apache.org> | 2009-10-16 22:49:14 +0000 |
|---|---|---|
| committer | Vincent Deffontaines <gryzor@apache.org> | 2009-10-16 22:49:14 +0000 |
| commit | d1d17558412090794b8d8b784fd4df5f49df7f5c (patch) | |
| tree | b59f838dc8b35598893046360a59cb8e0c4645f3 /docs | |
| parent | fc84ba8cee75449e81b49a76f9509fd12f77ff54 (diff) | |
| download | httpd-d1d17558412090794b8d8b784fd4df5f49df7f5c.tar.gz | |
A handful of new french translations for trunk docs.
git-svn-id: https://svn.apache.org/repos/asf/httpd/httpd/trunk@826124 13f79535-47bb-0310-9956-ffa450edef68
Diffstat (limited to 'docs')
83 files changed, 6194 insertions, 53 deletions
diff --git a/docs/manual/mod/allmodules.xml.fr b/docs/manual/mod/allmodules.xml.fr index 8d1ba5916c..078705ddfb 100644 --- a/docs/manual/mod/allmodules.xml.fr +++ b/docs/manual/mod/allmodules.xml.fr @@ -5,26 +5,26 @@ <modulefile>core.xml.fr</modulefile> <modulefile>mod_access_compat.xml</modulefile> <modulefile>mod_actions.xml</modulefile> - <modulefile>mod_alias.xml</modulefile> + <modulefile>mod_alias.xml.fr</modulefile> <modulefile>mod_asis.xml</modulefile> - <modulefile>mod_auth_basic.xml</modulefile> + <modulefile>mod_auth_basic.xml.fr</modulefile> <modulefile>mod_auth_digest.xml</modulefile> <modulefile>mod_auth_form.xml</modulefile> <modulefile>mod_authn_anon.xml</modulefile> <modulefile>mod_authn_core.xml</modulefile> <modulefile>mod_authn_dbd.xml</modulefile> <modulefile>mod_authn_dbm.xml</modulefile> - <modulefile>mod_authn_file.xml</modulefile> + <modulefile>mod_authn_file.xml.fr</modulefile> <modulefile>mod_authnz_ldap.xml</modulefile> <modulefile>mod_authz_core.xml</modulefile> <modulefile>mod_authz_dbd.xml</modulefile> <modulefile>mod_authz_dbm.xml</modulefile> <modulefile>mod_authz_groupfile.xml</modulefile> - <modulefile>mod_authz_host.xml</modulefile> - <modulefile>mod_authz_owner.xml</modulefile> - <modulefile>mod_authz_user.xml</modulefile> + <modulefile>mod_authz_host.xml.fr</modulefile> + <modulefile>mod_authz_owner.xml.fr</modulefile> + <modulefile>mod_authz_user.xml.fr</modulefile> <modulefile>mod_autoindex.xml.fr</modulefile> - <modulefile>mod_buffer.xml</modulefile> + <modulefile>mod_buffer.xml.fr</modulefile> <modulefile>mod_cache.xml</modulefile> <modulefile>mod_cern_meta.xml</modulefile> <modulefile>mod_cgi.xml</modulefile> @@ -36,10 +36,10 @@ <modulefile>mod_dbd.xml</modulefile> <modulefile>mod_deflate.xml</modulefile> <modulefile>mod_dir.xml.fr</modulefile> - <modulefile>mod_disk_cache.xml</modulefile> + <modulefile>mod_disk_cache.xml.fr</modulefile> <modulefile>mod_dumpio.xml</modulefile> - <modulefile>mod_echo.xml</modulefile> - <modulefile>mod_env.xml</modulefile> + <modulefile>mod_echo.xml.fr</modulefile> + <modulefile>mod_env.xml.fr</modulefile> <modulefile>mod_example.xml</modulefile> <modulefile>mod_expires.xml</modulefile> <modulefile>mod_ext_filter.xml</modulefile> @@ -48,10 +48,10 @@ <modulefile>mod_headers.xml</modulefile> <modulefile>mod_heartbeat.xml</modulefile> <modulefile>mod_heartmonitor.xml</modulefile> - <modulefile>mod_ident.xml</modulefile> + <modulefile>mod_ident.xml.fr</modulefile> <modulefile>mod_imagemap.xml</modulefile> <modulefile>mod_include.xml</modulefile> - <modulefile>mod_info.xml</modulefile> + <modulefile>mod_info.xml.fr</modulefile> <modulefile>mod_isapi.xml</modulefile> <modulefile>mod_lbmethod_bybusyness.xml</modulefile> <modulefile>mod_lbmethod_byrequests.xml</modulefile> @@ -63,7 +63,7 @@ <modulefile>mod_logio.xml</modulefile> <modulefile>mod_mime.xml</modulefile> <modulefile>mod_mime_magic.xml</modulefile> - <modulefile>mod_negotiation.xml</modulefile> + <modulefile>mod_negotiation.xml.fr</modulefile> <modulefile>mod_nw_ssl.xml</modulefile> <modulefile>mod_privileges.xml</modulefile> <modulefile>mod_proxy.xml.fr</modulefile> @@ -75,7 +75,7 @@ <modulefile>mod_proxy_ftp.xml</modulefile> <modulefile>mod_proxy_http.xml.fr</modulefile> <modulefile>mod_proxy_scgi.xml</modulefile> - <modulefile>mod_remoteip.xml</modulefile> + <modulefile>mod_remoteip.xml.fr</modulefile> <modulefile>mod_reqtimeout.xml</modulefile> <modulefile>mod_request.xml</modulefile> <modulefile>mod_rewrite.xml.fr</modulefile> @@ -87,10 +87,10 @@ <modulefile>mod_setenvif.xml</modulefile> <modulefile>mod_slotmem_plain.xml</modulefile> <modulefile>mod_slotmem_shm.xml</modulefile> - <modulefile>mod_so.xml</modulefile> + <modulefile>mod_so.xml.fr</modulefile> <modulefile>mod_speling.xml</modulefile> <modulefile>mod_ssl.xml</modulefile> - <modulefile>mod_status.xml</modulefile> + <modulefile>mod_status.xml.fr</modulefile> <modulefile>mod_substitute.xml</modulefile> <modulefile>mod_suexec.xml</modulefile> <modulefile>mod_unique_id.xml</modulefile> diff --git a/docs/manual/mod/mod_alias.html b/docs/manual/mod/mod_alias.html index 4a13e8aea2..7bf1274e07 100644 --- a/docs/manual/mod/mod_alias.html +++ b/docs/manual/mod/mod_alias.html @@ -4,6 +4,10 @@ URI: mod_alias.html.en Content-Language: en Content-type: text/html; charset=ISO-8859-1 +URI: mod_alias.html.fr +Content-Language: fr +Content-type: text/html; charset=ISO-8859-1 + URI: mod_alias.html.ja.utf8 Content-Language: ja Content-type: text/html; charset=UTF-8 diff --git a/docs/manual/mod/mod_alias.html.en b/docs/manual/mod/mod_alias.html.en index 4913b2ffe0..7ee33b4816 100644 --- a/docs/manual/mod/mod_alias.html.en +++ b/docs/manual/mod/mod_alias.html.en @@ -22,6 +22,7 @@ <div id="preamble"><h1>Apache Module mod_alias</h1> <div class="toplang"> <p><span>Available Languages: </span><a href="../en/mod/mod_alias.html" title="English"> en </a> | +<a href="../fr/mod/mod_alias.html" hreflang="fr" rel="alternate" title="Français"> fr </a> | <a href="../ja/mod/mod_alias.html" hreflang="ja" rel="alternate" title="Japanese"> ja </a> | <a href="../ko/mod/mod_alias.html" hreflang="ko" rel="alternate" title="Korean"> ko </a> | <a href="../tr/mod/mod_alias.html" hreflang="tr" rel="alternate" title="Türkçe"> tr </a></p> @@ -453,6 +454,7 @@ and designates the target as a CGI script</td></tr> </div> <div class="bottomlang"> <p><span>Available Languages: </span><a href="../en/mod/mod_alias.html" title="English"> en </a> | +<a href="../fr/mod/mod_alias.html" hreflang="fr" rel="alternate" title="Français"> fr </a> | <a href="../ja/mod/mod_alias.html" hreflang="ja" rel="alternate" title="Japanese"> ja </a> | <a href="../ko/mod/mod_alias.html" hreflang="ko" rel="alternate" title="Korean"> ko </a> | <a href="../tr/mod/mod_alias.html" hreflang="tr" rel="alternate" title="Türkçe"> tr </a></p> diff --git a/docs/manual/mod/mod_alias.html.fr b/docs/manual/mod/mod_alias.html.fr new file mode 100644 index 0000000000..24eaad322f --- /dev/null +++ b/docs/manual/mod/mod_alias.html.fr @@ -0,0 +1,495 @@ +<?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_alias - 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 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="../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.3</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.3</a> > <a href="./">Modules</a></div> +<div id="page-content"> +<div id="preamble"><h1>Module Apache mod_alias</h1> +<div class="toplang"> +<p><span>Langues Disponibles: </span><a href="../en/mod/mod_alias.html" hreflang="en" rel="alternate" title="English"> en </a> | +<a href="../fr/mod/mod_alias.html" title="Français"> fr </a> | +<a href="../ja/mod/mod_alias.html" hreflang="ja" rel="alternate" title="Japanese"> ja </a> | +<a href="../ko/mod/mod_alias.html" hreflang="ko" rel="alternate" title="Korean"> ko </a> | +<a href="../tr/mod/mod_alias.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>Permet d'atteindre différentes parties du système de +fichiers depuis l'arborescence des documents du site web, ainsi que la +redirection d'URL</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>alias_module</td></tr> +<tr><th><a href="module-dict.html#SourceFile">Fichier Source:</a></th><td>mod_alias.c</td></tr></table> +<h3>Sommaire</h3> + + <p>Les directives fournies par ce module permettent de manipuler et + de contrôler les URLs à l'arrivée des requêtes sur le serveur. Les + directives <code class="directive"><a href="#alias">Alias</a></code> et + <code class="directive"><a href="#scriptalias">ScriptAlias</a></code> permettent de + faire correspondre des URLs avec des chemins du système de fichiers. + Ceci permet de servir des contenus qui ne sont pas situés dans + l'arborescence de <code class="directive"><a href="../mod/core.html#documentroot">DocumentRoot</a></code> comme s'ils y étaient + réellement. La directive <code class="directive"><a href="#scriptalias">ScriptAlias</a></code> a pour effet + supplémentaire de marquer le répertoire cible comme conteneur de + scripts CGI.</p> + + <p>Les directives <code class="directive"><a href="#redirect">Redirect</a></code> + indiquent aux clients qu'ils doivent effectuer une nouvelle requête + avec une URL différente. Elles sont souvent utilisées lorsqu'une + ressource a été déplacée.</p> + + <p><code class="module"><a href="../mod/mod_alias.html">mod_alias</a></code> est conçu pour traiter des tâches + simples de manipulation d'URL. Pour des tâches plus complexes comme + la manipulation des chaînes d'arguments des requêtes, utilisez + plutôt les outils fournis par le module <code class="module"><a href="../mod/mod_rewrite.html">mod_rewrite</a></code></p> + +</div> +<div id="quickview"><h3 class="directives">Directives</h3> +<ul id="toc"> +<li><img alt="" src="../images/down.gif" /> <a href="#alias">Alias</a></li> +<li><img alt="" src="../images/down.gif" /> <a href="#aliasmatch">AliasMatch</a></li> +<li><img alt="" src="../images/down.gif" /> <a href="#redirect">Redirect</a></li> +<li><img alt="" src="../images/down.gif" /> <a href="#redirectmatch">RedirectMatch</a></li> +<li><img alt="" src="../images/down.gif" /> <a href="#redirectpermanent">RedirectPermanent</a></li> +<li><img alt="" src="../images/down.gif" /> <a href="#redirecttemp">RedirectTemp</a></li> +<li><img alt="" src="../images/down.gif" /> <a href="#scriptalias">ScriptAlias</a></li> +<li><img alt="" src="../images/down.gif" /> <a href="#scriptaliasmatch">ScriptAliasMatch</a></li> +</ul> +<h3>Sujets</h3> +<ul id="topics"> +<li><img alt="" src="../images/down.gif" /> <a href="#order">Chronologie du traitement</a></li> +</ul><h3>Voir aussi</h3> +<ul class="seealso"> +<li><code class="module"><a href="../mod/mod_rewrite.html">mod_rewrite</a></code></li> +<li><a href="../urlmapping.html">Mise en correspondance des URLs avec le +système de fichiers</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="order" id="order">Chronologie du traitement</a></h2> + + <p>Les alias et redirections apparaissant dans différents contextes + sont traités comme les autres directives en respectant les <a href="../sections.html#mergin">règles de fusion</a> standards. Par + contre, ils sont traités selon une chronologie particulière + lorsqu'ils apparaissent dans le même contexte (par exemple, dans la + même section <code class="directive"><a href="../mod/core.html#virtualhost"><VirtualHost></a></code>).</p> + + <p>Premièrement, toutes les redirections sont traitées avant les + alias, et ainsi, une requête qui correspond à une directive + <code class="directive"><a href="#redirect">Redirect</a></code> ou <code class="directive"><a href="#redirectmatch">RedirectMatch</a></code> ne se verra jamais + appliquer d'alias. Deuxièmement, les alias et redirections sont + traités selon l'ordre dans lequel ils apparaissent dans le fichier + de configuration, seule la première correspondance étant prise en + compte.</p> + + <p>Ainsi, lorsqu'une ou plusieurs de ces directives s'appliquent au + même sous-répertoire, vous devez classer les chemins du plus précis + au moins précis afin que toutes les directives puissent + éventuellement s'appliquer, comme dans l'exemple suivant :</p> + + <div class="example"><p><code> + Alias /foo/bar /baz<br /> + Alias /foo /gaq + </code></p></div> + + <p>Si l'ordre des directives était inversé, la directive <code class="directive"><a href="#alias">Alias</a></code> ayant pour argument + <code>/foo</code> serait toujours appliquée avant la directive + <code class="directive"><a href="#alias">Alias</a></code> ayant pour argument + <code>/foo/bar</code>, et cette dernière serait toujours + ignoré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="Alias" id="Alias">Alias</a> <a name="alias" id="alias">Directive</a></h2> +<table class="directive"> +<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Met en correspondance des URLs avec des chemins du système +de fichiers</td></tr> +<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>Alias <var>chemin URL</var> +<var>chemin fichier</var>|<var>chemin répertoire</var></code></td></tr> +<tr><th><a href="directive-dict.html#Context">Contexte:</a></th><td>configuration du serveur, serveur virtuel</td></tr> +<tr><th><a href="directive-dict.html#Status">Statut:</a></th><td>Base</td></tr> +<tr><th><a href="directive-dict.html#Module">Module:</a></th><td>mod_alias</td></tr> +</table> + + <p>La directive <code class="directive">Alias</code> permet de stocker des + documents (destinés à être servis) dans des zones du système de + fichiers situées en dehors de l'arborescence du site web <code class="directive"><a href="../mod/core.html#documentroot">DocumentRoot</a></code>. Les URLs dont le chemin + (décodé avec caractères %) commence par <var>chemin URL</var> seront + mises en correspondance avec des fichiers locaux dont le chemin + commence par <var>chemin répertoire</var>. Le <var>chemin URL</var> + est sensible à la casse, même sur les systèmes de fichiers + insensibles à la casse.</p> + + <div class="example"><h3>Exemple :</h3><p><code> + Alias /image /ftp/pub/image + </code></p></div> + + <p>Une requête pour <code>http://myserver/image/foo.gif</code> fera + renvoyer par le serveur le fichier + <code>/ftp/pub/image/foo.gif</code>. Seuls les éléments de chemin + complets sont testés ; ainsi l'alias précédent ne conviendra pas + pour une requête du style <code>http://myserver/imagefoo.gif</code>. + Pour des mises en correspondance plus complexes faisant intervenir + les expressions rationnelles, veuillez vous reporter à la directive + <code class="directive"><a href="#aliasmatch">AliasMatch</a></code>.</p> + + <p>Notez que si vous ajoutez un slash de fin au <var>chemin + URL</var>, vous devrez aussi ajouter un slash de fin au chemin de la + requête. Autrement dit, si vous définissez</p> + + <dl><dd><code>Alias /icons/ /usr/local/apache/icons/</code></dd></dl> + + <p>l'alias précédent ne s'appliquera pas à l'url + <code>/icons</code>.</p> + + <p>Notez qu'il pourra s'avérer nécessaire de définir des sections + <code class="directive"><a href="../mod/core.html#directory"><Directory></a></code> + supplémentaires qui couvriront la <em>destination</em> des alias. + Le traitement des alias intervenant avant le traitement des sections + <code class="directive"><a href="../mod/core.html#directory"><Directory></a></code>, + seules les cibles des alias sont affectées (Notez cependant + que les sections <code class="directive"><a href="../mod/core.html#location"><Location></a></code> sont traitées avant les alias, et + s'appliqueront donc).</p> + + <p>En particulier, si vous créez un alias ayant pour cible un + répertoire situé en dehors de l'arborescence de votre site web + <code class="directive"><a href="../mod/core.html#documentroot">DocumentRoot</a></code>, vous devrez + probablement permettre explicitement l'accès à ce répertoire.</p> + + <div class="example"><h3>Exemple :</h3><p><code> + Alias /image /ftp/pub/image<br /> + <Directory /ftp/pub/image><br /> + <span class="indent"> + Order allow,deny<br /> + Allow from all<br /> + </span> + </Directory> + </code></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="AliasMatch" id="AliasMatch">AliasMatch</a> <a name="aliasmatch" id="aliasmatch">Directive</a></h2> +<table class="directive"> +<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Met en correspondance des URLs avec le système de fichiers +en faisant intervenir les expressions rationnelles</td></tr> +<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>AliasMatch <var>regex</var> +<var>chemin fichier</var>|<var>chemin répertoire</var></code></td></tr> +<tr><th><a href="directive-dict.html#Context">Contexte:</a></th><td>configuration du serveur, serveur virtuel</td></tr> +<tr><th><a href="directive-dict.html#Status">Statut:</a></th><td>Base</td></tr> +<tr><th><a href="directive-dict.html#Module">Module:</a></th><td>mod_alias</td></tr> +</table> + <p>Cette directive est identique à la directive <code class="directive"><a href="#alias">Alias</a></code>, mais fait appel aux <a class="glossarylink" href="../glossary.html#regex" title="voir glossaire">expressions rationnelles</a>, à la place d'une + simple mise en correspondance de préfixe. L'expression rationnelle + fournie est mise en correspondance avec le chemin URL, et si elle + correspond, le serveur va substituer toute partie de chemin + correspondant à l'expression entre parenthèses dans la chaîne + fournie et l'utiliser comme nom de fichier. + Par exemple, pour activer le répertoire <code>/icons</code>, on peut + utiliser :</p> + + <div class="example"><p><code> + AliasMatch ^/icons(.*) /usr/local/apache/icons$1 + </code></p></div> + + <p>On peut aussi construire un alias qui met en correspondance le + chemin URL sans tenir compte de la casse :</p> + + <div class="example"><p><code> + AliasMatch (?i)^/image(.*) /ftp/pub/image$1 + </code></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="Redirect" id="Redirect">Redirect</a> <a name="redirect" id="redirect">Directive</a></h2> +<table class="directive"> +<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Envoie une redirection externe demandant au client +d'effectuer une autre requête avec une URL différente</td></tr> +<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>Redirect [<var>statut</var>] <var>chemin URL</var> +<var>URL</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">Annuler:</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_alias</td></tr> +</table> + <p>La directive Redirect permet de faire correspondre une ancienne + URL à une nouvelle en demandant au client d'aller chercher la ressource à + une autre localisation.</p> + + <p>L'ancien <em>chemin URL</em> est un chemin sensible à la casse + (décodé à l'aide de caractères %) commençant par un slash. Les + chemins relatifs ne sont pas autorisés.</p> + + <p>La nouvelle <em>URL</em> + peut être une URL absolue commençant par un protocole et un nom + d'hôte, mais on peut aussi utiliser un chemin URL commençant par un + slash, auquel cas le protocole et le nom d'hôte du serveur local + seront ajoutés.</p> + + <p>Ensuite, toute requête commençant par <em>chemin URL</em> va + renvoyer une redirection au client vers l'<em>URL</em> cible. Tout + élément de chemin supplémentaire situé en aval du <em>chemin + URL</em> sera ajouté à l'URL cible.</p> + + <div class="example"><h3>Exemple :</h3><p><code> + # Redirige vers une URL sur un serveur différent<br /> + Redirect /service http://foo2.exemple.com/service<br /> + <br /> + # Redirige vers une URL sur le même serveur<br /> + Redirect /one /two + </code></p></div> + + <p>Si le client effectue une requête pour l'URL + <code>http://example.com/service/foo.txt</code>, il lui sera demandé + d'en effectuer une autre pour l'URL + <code>http://foo2.example.com/service/foo.txt</code>. Seuls les + éléments de chemin complets sont testés, si bien que l'exemple + précédent ne s'appliquera pas à l'URL + <code>http://example.com/servicefoo.txt</code>. Pour des mises en + correspondance plus complexes faisant intervenir les expressions + rationnelles, veuillez vous reporter à la directive <code class="directive"><a href="#redirectmatch">RedirectMatch</a></code>.</p> + + + <div class="note"><h3>Note</h3> + <p>Les directives de redirection ont priorité sur les directives + Alias et ScriptAlias, quel que soit leur ordre d'apparition dans le + fichier de configuration.</p></div> + + <p>Si aucun argument <var>statut</var> n'est spécifié, la + redirection sera temporaire (statut HTTP 302). Le client est alors + informé que la ressource a été temporairement déplacée. On peut + utiliser l'argument <var>statut</var> pour renvoyer d'autres codes + de statut HTTP :</p> + + <dl> + <dt>permanent</dt> + + <dd>Renvoie un statut de redirection permanente (301), indiquant + que la ressource a été définitivement déplacée.</dd> + + <dt>temp</dt> + + <dd>Renvoie un statut de redirection temporaire (302). C'est le + comportement par défaut.</dd> + + <dt>seeother</dt> + + <dd>Renvoie un statut "See Other" (303) indiquant que la ressource + a été remplacée par une autre.</dd> + + <dt>gone</dt> + + <dd>Renvoie un statut "Gone" (410) indiquant que la ressource a + été définitivement supprimée. Lorsque ce statut est défini, on ne + doit pas utiliser l'argument <var>URL</var>.</dd> + </dl> + + <p>On peut renvoyer d'autres codes de statut en spécifiant le code + de statut numérique comme valeur de l'argument of <var>statut</var>. + Si le code de statut est compris entre 300 et 399, l'argument + <var>URL</var> doit être présent, sinon il ne doit pas être utilisé. + Notez que le statut doit être connu du code d'Apache (voir la + fonction <code>send_error_response</code> dans + http_protocol.c).</p> + + <div class="example"><h3>Exemple :</h3><p><code> + Redirect permanent /un http://exemple.com/deux<br /> + Redirect 303 /trois http://exemple.com/autre + </code></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="RedirectMatch" id="RedirectMatch">RedirectMatch</a> <a name="redirectmatch" id="redirectmatch">Directive</a></h2> +<table class="directive"> +<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Envoie une redirection externe faisant appel aux +expressions rationnelles pour la mise en correspondance de l'URL +courante</td></tr> +<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>RedirectMatch [<var>statut</var>] <var>regex</var> +<var>URL</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">Annuler:</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_alias</td></tr> +</table> + <p>Cette directive est identique à la directive <code class="directive"><a href="#redirect">Redirect</a></code>, mais fait appel aux + <a class="glossarylink" href="../glossary.html#regex" title="voir glossaire">expressions rationnelles</a>, à la + place d'une simple mise en correspondance de préfixe. L'expression + rationnelle fournie est mise en correspondance avec le chemin URL, + et si elle correspond, le serveur va substituer toute partie de + chemin correspondante entre parenthèses dans la chaîne spécifiée et + l'utiliser comme nom de fichier. Par exemple, pour rediriger tous + les fichiers GIF vers les fichiers JPEG de même nom sur un autre + serveur, on peut utiliser :</p> + + <div class="example"><p><code> + RedirectMatch (.*)\.gif$ http://www.autre-serveur.com$1.jpg + </code></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="RedirectPermanent" id="RedirectPermanent">RedirectPermanent</a> <a name="redirectpermanent" id="redirectpermanent">Directive</a></h2> +<table class="directive"> +<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Envoie une redirection externe permanente demandant au +client d'effectuer une nouvelle requête avec une URL +différente</td></tr> +<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>RedirectPermanent <var>chemin URL</var> <var>URL</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">Annuler:</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_alias</td></tr> +</table> + <p>Cette directive informe le client que la redirection est + permanente (statut 301). Son comportement est exactement le même + que celui de <code>Redirect permanent</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="RedirectTemp" id="RedirectTemp">RedirectTemp</a> <a name="redirecttemp" id="redirecttemp">Directive</a></h2> +<table class="directive"> +<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Envoie une redirection externe temporaire demandant au +client d'effectuer une nouvelle requête avec une URL +différente</td></tr> +<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>RedirectTemp <var>chemin URL</var> <var>URL</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">Annuler:</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_alias</td></tr> +</table> + <p>Cette directive informe le client que la redirection n'est + que temporaire (statut 302). Son comportement est exactement le même + que celui de <code>Redirect temp</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="ScriptAlias" id="ScriptAlias">ScriptAlias</a> <a name="scriptalias" id="scriptalias">Directive</a></h2> +<table class="directive"> +<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Fait correspondre une URL à une zone du système de fichiers +et désigne la cible comme script CGI</td></tr> +<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>ScriptAlias <var>chemin URL</var> +<var>chemin fichier</var>|<var>chemin répertoire</var></code></td></tr> +<tr><th><a href="directive-dict.html#Context">Contexte:</a></th><td>configuration du serveur, serveur virtuel</td></tr> +<tr><th><a href="directive-dict.html#Status">Statut:</a></th><td>Base</td></tr> +<tr><th><a href="directive-dict.html#Module">Module:</a></th><td>mod_alias</td></tr> +</table> + <p>La directive <code class="directive">ScriptAlias</code> présente le même + comportement que la directive <code class="directive"><a href="#alias">Alias</a></code>, mais désigne en plus le + répertoire cible comme conteneur de scripts CGI qui seront traitées + par le gestionnaire cgi-script du module <code class="module"><a href="../mod/mod_cgi.html">mod_cgi</a></code>. + Les URLs dont le chemin URL sensible à la casse (décodé avec + caractères %) commence par <var>chemin URL</var> seront mises en + correspondance avec les scripts dont le chemin commence par le + second argument, qui est un chemin complet dans le système de + fichiers local.</p> + + <div class="example"><h3>Exemple :</h3><p><code> + ScriptAlias /cgi-bin/ /web/cgi-bin/ + </code></p></div> + + <p>Une requête pour <code>http://mon-serveur/cgi-bin/foo</code> + ferait exécuter par le serveur le script + <code>/web/cgi-bin/foo</code>. Cette configuration est sensiblement + équivalente à :</p> + <div class="example"><p><code> + Alias /cgi-bin/ /web/cgi-bin/<br /> + <Location /cgi-bin ><br /> + <span class="indent"> + SetHandler cgi-script<br /> + Options +ExecCGI<br /> + </span> + </Location> + </code></p></div> + + <p>Vous pouvez aussi utiliser <code class="directive">ScriptAlias</code> + avec un script ou gestionnaire de votre cru. Par exemple :</p> + + <div class="example"><p><code> + ScriptAlias /cgi-bin/ /web/cgi-handler.pl + </code></p></div> + + <p>Dans ce scénario, tous les fichiers faisant l'objet d'une requête + dans <code>/cgi-bin/</code> seront traités par le fichier que vous + avez spécifié, ce qui vous permet d'utiliser votre propre + gestionnaire. Vous pouvez l'utiliser comme enveloppe (wrapper) pour + les scripts CGI afin d'ajouter du contenu, ou autre action "maison".</p> + + <div class="warning">Il est préférable d'éviter de placer les + scripts CGI dans l'arborescence de <code class="directive"><a href="../mod/core.html#documentroot">DocumentRoot</a></code> afin d'éviter de révéler + accidentellement leur code source lors d'une modification de + configuration. On y parvient aisément avec + <code class="directive">ScriptAlias</code> en mettant en correspondance une + URL et en désignant la cible comme scripts CGI par la même occasion. + Si vous choisissez de placer vos scripts CGI dans un répertoire + accessible depuis le web, n'utilisez pas + <code class="directive">ScriptAlias</code>. Utilisez plutôt <code class="directive"><a href="../mod/core.html#directory"><Directory></a></code>, <code class="directive"><a href="../mod/core.html#sethandler">SetHandler</a></code>, et <code class="directive"><a href="../mod/core.html#options">Options</a></code> comme dans l'exemple suivant : + <div class="example"><p><code> + <Directory /usr/local/apache2/htdocs/cgi-bin ><br /> + <span class="indent"> + SetHandler cgi-script<br /> + Options ExecCGI<br /> + </span> + </Directory> + </code></p></div> + Ceci est nécessaire car plusieurs <var>chemins URL</var> peuvent + correspondre à la même zone du système de fichiers, court-circuitant + ainsi la directive <code class="directive">ScriptAlias</code> et révélant le + code source des scripts CGI s'ils ne sont pas protégés par une + section <code class="directive"><a href="../mod/core.html#directory">Directory</a></code>.</div> + + +<h3>Voir aussi</h3> +<ul> +<li><a href="../howto/cgi.html">Tutoriel CGI</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="ScriptAliasMatch" id="ScriptAliasMatch">ScriptAliasMatch</a> <a name="scriptaliasmatch" id="scriptaliasmatch">Directive</a></h2> +<table class="directive"> +<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Fait correspondre une URL à une zone du système de fichiers +en faisant appel aux expressions rationnelles et en désignant la cible +comme un script CGI</td></tr> +<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>ScriptAliasMatch <var>regex</var> +<var>chemin fichier</var>|<var>chemin répertoire</var></code></td></tr> +<tr><th><a href="directive-dict.html#Context">Contexte:</a></th><td>configuration du serveur, serveur virtuel</td></tr> +<tr><th><a href="directive-dict.html#Status">Statut:</a></th><td>Base</td></tr> +<tr><th><a href="directive-dict.html#Module">Module:</a></th><td>mod_alias</td></tr> +</table> + <p>Cette directive est équivalente à la directive <code class="directive"><a href="#scriptalias">ScriptAlias</a></code>, mais fait appel aux + <a class="glossarylink" href="../glossary.html#regex" title="voir glossaire">expressions rationnelles</a>, à la + place d'une simple mise en correspondance de préfixe. L'expression + rationnelle fournie est mise en correspondance avec le chemin URL, + et si elle correspond, le serveur va substituer toute partie de + chemin entre parenthèses dans la chaîne spécifiée et l'utiliser + comme nom de fichier. Par exemple, pour activer le répertoire + standard <code>/cgi-bin</code>, on peut utiliser :</p> + + <div class="example"><p><code> + ScriptAliasMatch ^/cgi-bin(.*) /usr/local/apache/cgi-bin$1 + </code></p></div> + +</div> +</div> +<div class="bottomlang"> +<p><span>Langues Disponibles: </span><a href="../en/mod/mod_alias.html" hreflang="en" rel="alternate" title="English"> en </a> | +<a href="../fr/mod/mod_alias.html" title="Français"> fr </a> | +<a href="../ja/mod/mod_alias.html" hreflang="ja" rel="alternate" title="Japanese"> ja </a> | +<a href="../ko/mod/mod_alias.html" hreflang="ko" rel="alternate" title="Korean"> ko </a> | +<a href="../tr/mod/mod_alias.html" hreflang="tr" rel="alternate" title="Türkçe"> tr </a></p> +</div><div id="footer"> +<p class="apache">Copyright 2009 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="../faq/">FAQ</a> | <a href="../glossary.html">Glossaire</a> | <a href="../sitemap.html">Plan du site</a></p></div> +</body></html>
\ No newline at end of file diff --git a/docs/manual/mod/mod_alias.xml.fr b/docs/manual/mod/mod_alias.xml.fr new file mode 100644 index 0000000000..c159b5fde3 --- /dev/null +++ b/docs/manual/mod/mod_alias.xml.fr @@ -0,0 +1,482 @@ +<?xml version="1.0"?> +<!DOCTYPE modulesynopsis SYSTEM "../style/modulesynopsis.dtd"> +<?xml-stylesheet type="text/xsl" href="../style/manual.fr.xsl"?> +<!-- English Revision : 770506 --> +<!-- 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_alias.xml.meta"> + +<name>mod_alias</name> +<description>Permet d'atteindre différentes parties du système de +fichiers depuis l'arborescence des documents du site web, ainsi que la +redirection d'URL</description> +<status>Base</status> +<sourcefile>mod_alias.c</sourcefile> +<identifier>alias_module</identifier> + +<summary> + <p>Les directives fournies par ce module permettent de manipuler et + de contrôler les URLs à l'arrivée des requêtes sur le serveur. Les + directives <directive module="mod_alias">Alias</directive> et + <directive module="mod_alias">ScriptAlias</directive> permettent de + faire correspondre des URLs avec des chemins du système de fichiers. + Ceci permet de servir des contenus qui ne sont pas situés dans + l'arborescence de <directive + module="core">DocumentRoot</directive> comme s'ils y étaient + réellement. La directive <directive + module="mod_alias">ScriptAlias</directive> a pour effet + supplémentaire de marquer le répertoire cible comme conteneur de + scripts CGI.</p> + + <p>Les directives <directive module="mod_alias">Redirect</directive> + indiquent aux clients qu'ils doivent effectuer une nouvelle requête + avec une URL différente. Elles sont souvent utilisées lorsqu'une + ressource a été déplacée.</p> + + <p><module>mod_alias</module> est conçu pour traiter des tâches + simples de manipulation d'URL. Pour des tâches plus complexes comme + la manipulation des chaînes d'arguments des requêtes, utilisez + plutôt les outils fournis par le module <module>mod_rewrite</module></p> + +</summary> + +<seealso><module>mod_rewrite</module></seealso> <seealso><a +href="../urlmapping.html">Mise en correspondance des URLs avec le +système de fichiers</a></seealso> + +<section id="order"><title>Chronologie du traitement</title> + + <p>Les alias et redirections apparaissant dans différents contextes + sont traités comme les autres directives en respectant les <a + href="../sections.html#mergin">règles de fusion</a> standards. Par + contre, ils sont traités selon une chronologie particulière + lorsqu'ils apparaissent dans le même contexte (par exemple, dans la + même section <directive type="section" + module="core">VirtualHost</directive>).</p> + + <p>Premièrement, toutes les redirections sont traitées avant les + alias, et ainsi, une requête qui correspond à une directive + <directive module="mod_alias">Redirect</directive> ou <directive + module="mod_alias">RedirectMatch</directive> ne se verra jamais + appliquer d'alias. Deuxièmement, les alias et redirections sont + traités selon l'ordre dans lequel ils apparaissent dans le fichier + de configuration, seule la première correspondance étant prise en + compte.</p> + + <p>Ainsi, lorsqu'une ou plusieurs de ces directives s'appliquent au + même sous-répertoire, vous devez classer les chemins du plus précis + au moins précis afin que toutes les directives puissent + éventuellement s'appliquer, comme dans l'exemple suivant :</p> + + <example> + Alias /foo/bar /baz<br /> + Alias /foo /gaq + </example> + + <p>Si l'ordre des directives était inversé, la directive <directive + module="mod_alias">Alias</directive> ayant pour argument + <code>/foo</code> serait toujours appliquée avant la directive + <directive module="mod_alias">Alias</directive> ayant pour argument + <code>/foo/bar</code>, et cette dernière serait toujours + ignorée.</p> + +</section> + +<directivesynopsis> +<name>Alias</name> +<description>Met en correspondance des URLs avec des chemins du système +de fichiers</description> +<syntax>Alias <var>chemin URL</var> +<var>chemin fichier</var>|<var>chemin répertoire</var></syntax> +<contextlist><context>server config</context><context>virtual host</context> +</contextlist> + +<usage> + + <p>La directive <directive>Alias</directive> permet de stocker des + documents (destinés à être servis) dans des zones du système de + fichiers situées en dehors de l'arborescence du site web <directive + module="core">DocumentRoot</directive>. Les URLs dont le chemin + (décodé avec caractères %) commence par <var>chemin URL</var> seront + mises en correspondance avec des fichiers locaux dont le chemin + commence par <var>chemin répertoire</var>. Le <var>chemin URL</var> + est sensible à la casse, même sur les systèmes de fichiers + insensibles à la casse.</p> + + <example><title>Exemple :</title> + Alias /image /ftp/pub/image + </example> + + <p>Une requête pour <code>http://myserver/image/foo.gif</code> fera + renvoyer par le serveur le fichier + <code>/ftp/pub/image/foo.gif</code>. Seuls les éléments de chemin + complets sont testés ; ainsi l'alias précédent ne conviendra pas + pour une requête du style <code>http://myserver/imagefoo.gif</code>. + Pour des mises en correspondance plus complexes faisant intervenir + les expressions rationnelles, veuillez vous reporter à la directive + <directive module="mod_alias">AliasMatch</directive>.</p> + + <p>Notez que si vous ajoutez un slash de fin au <var>chemin + URL</var>, vous devrez aussi ajouter un slash de fin au chemin de la + requête. Autrement dit, si vous définissez</p> + + <dl><dd><code>Alias /icons/ /usr/local/apache/icons/</code></dd></dl> + + <p>l'alias précédent ne s'appliquera pas à l'url + <code>/icons</code>.</p> + + <p>Notez qu'il pourra s'avérer nécessaire de définir des sections + <directive type="section" module="core">Directory</directive> + supplémentaires qui couvriront la <em>destination</em> des alias. + Le traitement des alias intervenant avant le traitement des sections + <directive type="section" module="core">Directory</directive>, + seules les cibles des alias sont affectées (Notez cependant + que les sections <directive type="section" + module="core">Location</directive> sont traitées avant les alias, et + s'appliqueront donc).</p> + + <p>En particulier, si vous créez un alias ayant pour cible un + répertoire situé en dehors de l'arborescence de votre site web + <directive module="core">DocumentRoot</directive>, vous devrez + probablement permettre explicitement l'accès à ce répertoire.</p> + + <example><title>Exemple :</title> + Alias /image /ftp/pub/image<br /> + <Directory /ftp/pub/image><br /> + <indent> + Order allow,deny<br /> + Allow from all<br /> + </indent> + </Directory> + </example> + +</usage> +</directivesynopsis> + +<directivesynopsis> +<name>AliasMatch</name> +<description>Met en correspondance des URLs avec le système de fichiers +en faisant intervenir les expressions rationnelles</description> +<syntax>AliasMatch <var>regex</var> +<var>chemin fichier</var>|<var>chemin répertoire</var></syntax> +<contextlist><context>server config</context><context>virtual host</context> +</contextlist> + +<usage> + <p>Cette directive est identique à la directive <directive + module="mod_alias">Alias</directive>, mais fait appel aux <glossary + ref="regex">expressions rationnelles</glossary>, à la place d'une + simple mise en correspondance de préfixe. L'expression rationnelle + fournie est mise en correspondance avec le chemin URL, et si elle + correspond, le serveur va substituer toute partie de chemin + correspondant à l'expression entre parenthèses dans la chaîne + fournie et l'utiliser comme nom de fichier. + Par exemple, pour activer le répertoire <code>/icons</code>, on peut + utiliser :</p> + + <example> + AliasMatch ^/icons(.*) /usr/local/apache/icons$1 + </example> + + <p>On peut aussi construire un alias qui met en correspondance le + chemin URL sans tenir compte de la casse :</p> + + <example> + AliasMatch (?i)^/image(.*) /ftp/pub/image$1 + </example> + +</usage> +</directivesynopsis> + +<directivesynopsis> +<name>Redirect</name> +<description>Envoie une redirection externe demandant au client +d'effectuer une autre requête avec une URL différente</description> +<syntax>Redirect [<var>statut</var>] <var>chemin URL</var> +<var>URL</var></syntax> +<contextlist><context>server config</context><context>virtual host</context> +<context>directory</context><context>.htaccess</context></contextlist> +<override>FileInfo</override> + +<usage> + <p>La directive Redirect permet de faire correspondre une ancienne + URL à une nouvelle en demandant au client d'aller chercher la ressource à + une autre localisation.</p> + + <p>L'ancien <em>chemin URL</em> est un chemin sensible à la casse + (décodé à l'aide de caractères %) commençant par un slash. Les + chemins relatifs ne sont pas autorisés.</p> + + <p>La nouvelle <em>URL</em> + peut être une URL absolue commençant par un protocole et un nom + d'hôte, mais on peut aussi utiliser un chemin URL commençant par un + slash, auquel cas le protocole et le nom d'hôte du serveur local + seront ajoutés.</p> + + <p>Ensuite, toute requête commençant par <em>chemin URL</em> va + renvoyer une redirection au client vers l'<em>URL</em> cible. Tout + élément de chemin supplémentaire situé en aval du <em>chemin + URL</em> sera ajouté à l'URL cible.</p> + + <example><title>Exemple :</title> + # Redirige vers une URL sur un serveur différent<br /> + Redirect /service http://foo2.exemple.com/service<br /> + <br /> + # Redirige vers une URL sur le même serveur<br /> + Redirect /one /two + </example> + + <p>Si le client effectue une requête pour l'URL + <code>http://example.com/service/foo.txt</code>, il lui sera demandé + d'en effectuer une autre pour l'URL + <code>http://foo2.example.com/service/foo.txt</code>. Seuls les + éléments de chemin complets sont testés, si bien que l'exemple + précédent ne s'appliquera pas à l'URL + <code>http://example.com/servicefoo.txt</code>. Pour des mises en + correspondance plus complexes faisant intervenir les expressions + rationnelles, veuillez vous reporter à la directive <directive + module="mod_alias">RedirectMatch</directive>.</p> + + + <note><title>Note</title> + <p>Les directives de redirection ont priorité sur les directives + Alias et ScriptAlias, quel que soit leur ordre d'apparition dans le + fichier de configuration.</p></note> + + <p>Si aucun argument <var>statut</var> n'est spécifié, la + redirection sera temporaire (statut HTTP 302). Le client est alors + informé que la ressource a été temporairement déplacée. On peut + utiliser l'argument <var>statut</var> pour renvoyer d'autres codes + de statut HTTP :</p> + + <dl> + <dt>permanent</dt> + + <dd>Renvoie un statut de redirection permanente (301), indiquant + que la ressource a été définitivement déplacée.</dd> + + <dt>temp</dt> + + <dd>Renvoie un statut de redirection temporaire (302). C'est le + comportement par défaut.</dd> + + <dt>seeother</dt> + + <dd>Renvoie un statut "See Other" (303) indiquant que la ressource + a été remplacée par une autre.</dd> + + <dt>gone</dt> + + <dd>Renvoie un statut "Gone" (410) indiquant que la ressource a + été définitivement supprimée. Lorsque ce statut est défini, on ne + doit pas utiliser l'argument <var>URL</var>.</dd> + </dl> + + <p>On peut renvoyer d'autres codes de statut en spécifiant le code + de statut numérique comme valeur de l'argument of <var>statut</var>. + Si le code de statut est compris entre 300 et 399, l'argument + <var>URL</var> doit être présent, sinon il ne doit pas être utilisé. + Notez que le statut doit être connu du code d'Apache (voir la + fonction <code>send_error_response</code> dans + http_protocol.c).</p> + + <example><title>Exemple :</title> + Redirect permanent /un http://exemple.com/deux<br /> + Redirect 303 /trois http://exemple.com/autre + </example> + +</usage> +</directivesynopsis> + +<directivesynopsis> +<name>RedirectMatch</name> +<description>Envoie une redirection externe faisant appel aux +expressions rationnelles pour la mise en correspondance de l'URL +courante</description> +<syntax>RedirectMatch [<var>statut</var>] <var>regex</var> +<var>URL</var></syntax> +<contextlist><context>server config</context><context>virtual host</context> +<context>directory</context><context>.htaccess</context></contextlist> +<override>FileInfo</override> + +<usage> + <p>Cette directive est identique à la directive <directive + module="mod_alias">Redirect</directive>, mais fait appel aux + <glossary ref="regex">expressions rationnelles</glossary>, à la + place d'une simple mise en correspondance de préfixe. L'expression + rationnelle fournie est mise en correspondance avec le chemin URL, + et si elle correspond, le serveur va substituer toute partie de + chemin correspondante entre parenthèses dans la chaîne spécifiée et + l'utiliser comme nom de fichier. Par exemple, pour rediriger tous + les fichiers GIF vers les fichiers JPEG de même nom sur un autre + serveur, on peut utiliser :</p> + + <example> + RedirectMatch (.*)\.gif$ http://www.autre-serveur.com$1.jpg + </example> +</usage> +</directivesynopsis> + +<directivesynopsis> +<name>RedirectTemp</name> +<description>Envoie une redirection externe temporaire demandant au +client d'effectuer une nouvelle requête avec une URL +différente</description> +<syntax>RedirectTemp <var>chemin URL</var> <var>URL</var></syntax> +<contextlist><context>server config</context><context>virtual host</context> +<context>directory</context><context>.htaccess</context></contextlist> +<override>FileInfo</override> + +<usage> + <p>Cette directive informe le client que la redirection n'est + que temporaire (statut 302). Son comportement est exactement le même + que celui de <code>Redirect temp</code>.</p> +</usage> +</directivesynopsis> + +<directivesynopsis> +<name>RedirectPermanent</name> +<description>Envoie une redirection externe permanente demandant au +client d'effectuer une nouvelle requête avec une URL +différente</description> +<syntax>RedirectPermanent <var>chemin URL</var> <var>URL</var></syntax> +<contextlist><context>server config</context><context>virtual host</context> +<context>directory</context><context>.htaccess</context></contextlist> +<override>FileInfo</override> + +<usage> + <p>Cette directive informe le client que la redirection est + permanente (statut 301). Son comportement est exactement le même + que celui de <code>Redirect permanent</code>.</p> +</usage> +</directivesynopsis> + +<directivesynopsis> +<name>ScriptAlias</name> +<description>Fait correspondre une URL à une zone du système de fichiers +et désigne la cible comme script CGI</description> +<syntax>ScriptAlias <var>chemin URL</var> +<var>chemin fichier</var>|<var>chemin répertoire</var></syntax> +<contextlist><context>server config</context><context>virtual host</context> +</contextlist> + +<usage> + <p>La directive <directive>ScriptAlias</directive> présente le même + comportement que la directive <directive + module="mod_alias">Alias</directive>, mais désigne en plus le + répertoire cible comme conteneur de scripts CGI qui seront traitées + par le gestionnaire cgi-script du module <module>mod_cgi</module>. + Les URLs dont le chemin URL sensible à la casse (décodé avec + caractères %) commence par <var>chemin URL</var> seront mises en + correspondance avec les scripts dont le chemin commence par le + second argument, qui est un chemin complet dans le système de + fichiers local.</p> + + <example><title>Exemple :</title> + ScriptAlias /cgi-bin/ /web/cgi-bin/ + </example> + + <p>Une requête pour <code>http://mon-serveur/cgi-bin/foo</code> + ferait exécuter par le serveur le script + <code>/web/cgi-bin/foo</code>. Cette configuration est sensiblement + équivalente à :</p> + <example> + Alias /cgi-bin/ /web/cgi-bin/<br /> + <Location /cgi-bin ><br /> + <indent> + SetHandler cgi-script<br /> + Options +ExecCGI<br /> + </indent> + </Location> + </example> + + <p>Vous pouvez aussi utiliser <directive>ScriptAlias</directive> + avec un script ou gestionnaire de votre cru. Par exemple :</p> + + <example> + ScriptAlias /cgi-bin/ /web/cgi-handler.pl + </example> + + <p>Dans ce scénario, tous les fichiers faisant l'objet d'une requête + dans <code>/cgi-bin/</code> seront traités par le fichier que vous + avez spécifié, ce qui vous permet d'utiliser votre propre + gestionnaire. Vous pouvez l'utiliser comme enveloppe (wrapper) pour + les scripts CGI afin d'ajouter du contenu, ou autre action "maison".</p> + + <note type="warning">Il est préférable d'éviter de placer les + scripts CGI dans l'arborescence de <directive + module="core">DocumentRoot</directive> afin d'éviter de révéler + accidentellement leur code source lors d'une modification de + configuration. On y parvient aisément avec + <directive>ScriptAlias</directive> en mettant en correspondance une + URL et en désignant la cible comme scripts CGI par la même occasion. + Si vous choisissez de placer vos scripts CGI dans un répertoire + accessible depuis le web, n'utilisez pas + <directive>ScriptAlias</directive>. Utilisez plutôt <directive + module="core" type="section">Directory</directive>, <directive + module="core">SetHandler</directive>, et <directive + module="core">Options</directive> comme dans l'exemple suivant : + <example> + <Directory /usr/local/apache2/htdocs/cgi-bin ><br /> + <indent> + SetHandler cgi-script<br /> + Options ExecCGI<br /> + </indent> + </Directory> + </example> + Ceci est nécessaire car plusieurs <var>chemins URL</var> peuvent + correspondre à la même zone du système de fichiers, court-circuitant + ainsi la directive <directive>ScriptAlias</directive> et révélant le + code source des scripts CGI s'ils ne sont pas protégés par une + section <directive module="core">Directory</directive>.</note> + +</usage> +<seealso><a href="../howto/cgi.html">Tutoriel CGI</a></seealso> +</directivesynopsis> + +<directivesynopsis> +<name>ScriptAliasMatch</name> +<description>Fait correspondre une URL à une zone du système de fichiers +en faisant appel aux expressions rationnelles et en désignant la cible +comme un script CGI</description> +<syntax>ScriptAliasMatch <var>regex</var> +<var>chemin fichier</var>|<var>chemin répertoire</var></syntax> +<contextlist><context>server config</context><context>virtual host</context> +</contextlist> + +<usage> + <p>Cette directive est équivalente à la directive <directive + module="mod_alias">ScriptAlias</directive>, mais fait appel aux + <glossary ref="regex">expressions rationnelles</glossary>, à la + place d'une simple mise en correspondance de préfixe. L'expression + rationnelle fournie est mise en correspondance avec le chemin URL, + et si elle correspond, le serveur va substituer toute partie de + chemin entre parenthèses dans la chaîne spécifiée et l'utiliser + comme nom de fichier. Par exemple, pour activer le répertoire + standard <code>/cgi-bin</code>, on peut utiliser :</p> + + <example> + ScriptAliasMatch ^/cgi-bin(.*) /usr/local/apache/cgi-bin$1 + </example> +</usage> +</directivesynopsis> + +</modulesynopsis> diff --git a/docs/manual/mod/mod_alias.xml.meta b/docs/manual/mod/mod_alias.xml.meta index 9ca883a782..59278b77b2 100644 --- a/docs/manual/mod/mod_alias.xml.meta +++ b/docs/manual/mod/mod_alias.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_auth_basic.html b/docs/manual/mod/mod_auth_basic.html index 1df9fdba6c..a3f5884f6a 100644 --- a/docs/manual/mod/mod_auth_basic.html +++ b/docs/manual/mod/mod_auth_basic.html @@ -4,6 +4,10 @@ URI: mod_auth_basic.html.en Content-Language: en Content-type: text/html; charset=ISO-8859-1 +URI: mod_auth_basic.html.fr +Content-Language: fr +Content-type: text/html; charset=ISO-8859-1 + URI: mod_auth_basic.html.ja.utf8 Content-Language: ja Content-type: text/html; charset=UTF-8 diff --git a/docs/manual/mod/mod_auth_basic.html.en b/docs/manual/mod/mod_auth_basic.html.en index f0cb8f6723..44201ec885 100644 --- a/docs/manual/mod/mod_auth_basic.html.en +++ b/docs/manual/mod/mod_auth_basic.html.en @@ -22,6 +22,7 @@ <div id="preamble"><h1>Apache Module mod_auth_basic</h1> <div class="toplang"> <p><span>Available Languages: </span><a href="../en/mod/mod_auth_basic.html" title="English"> en </a> | +<a href="../fr/mod/mod_auth_basic.html" hreflang="fr" rel="alternate" title="Français"> fr </a> | <a href="../ja/mod/mod_auth_basic.html" hreflang="ja" rel="alternate" title="Japanese"> ja </a> | <a href="../ko/mod/mod_auth_basic.html" hreflang="ko" rel="alternate" title="Korean"> ko </a></p> </div> @@ -124,6 +125,7 @@ lower level modules</td></tr> </div> <div class="bottomlang"> <p><span>Available Languages: </span><a href="../en/mod/mod_auth_basic.html" title="English"> en </a> | +<a href="../fr/mod/mod_auth_basic.html" hreflang="fr" rel="alternate" title="Français"> fr </a> | <a href="../ja/mod/mod_auth_basic.html" hreflang="ja" rel="alternate" title="Japanese"> ja </a> | <a href="../ko/mod/mod_auth_basic.html" hreflang="ko" rel="alternate" title="Korean"> ko </a></p> </div><div id="footer"> diff --git a/docs/manual/mod/mod_auth_basic.html.fr b/docs/manual/mod/mod_auth_basic.html.fr new file mode 100644 index 0000000000..9670d37340 --- /dev/null +++ b/docs/manual/mod/mod_auth_basic.html.fr @@ -0,0 +1,145 @@ +<?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_auth_basic - 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 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="../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.3</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.3</a> > <a href="./">Modules</a></div> +<div id="page-content"> +<div id="preamble"><h1>Module Apache mod_auth_basic</h1> +<div class="toplang"> +<p><span>Langues Disponibles: </span><a href="../en/mod/mod_auth_basic.html" hreflang="en" rel="alternate" title="English"> en </a> | +<a href="../fr/mod/mod_auth_basic.html" title="Français"> fr </a> | +<a href="../ja/mod/mod_auth_basic.html" hreflang="ja" rel="alternate" title="Japanese"> ja </a> | +<a href="../ko/mod/mod_auth_basic.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>Authentification de base</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>auth_basic_module</td></tr> +<tr><th><a href="module-dict.html#SourceFile">Fichier Source:</a></th><td>mod_auth_basic.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 permet d'utiliser l'authentification basique HTTP pour + restreindre l'accès en recherchant les utilisateurs dans les + fournisseurs d'authentification spécifiés. Il est en général + combiné avec au moins un module 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>. L'authentification HTTP à + base de condensé (digest), quant à elle, est fournie par le module + <code class="module"><a href="../mod/mod_auth_digest.html">mod_auth_digest</a></code>. </p> +</div> +<div id="quickview"><h3 class="directives">Directives</h3> +<ul id="toc"> +<li><img alt="" src="../images/down.gif" /> <a href="#authbasicauthoritative">AuthBasicAuthoritative</a></li> +<li><img alt="" src="../images/down.gif" /> <a href="#authbasicprovider">AuthBasicProvider</a></li> +</ul> +<h3>Voir aussi</h3> +<ul class="seealso"> +<li><code class="directive"><a href="../mod/mod_authn_core.html#authname">AuthName</a></code></li> +<li><code class="directive"><a href="../mod/mod_authn_core.html#authtype">AuthType</a></code></li> +<li><code class="directive"><a href="../mod/mod_authz_core.html#require">Require</a></code></li> +<li><code class="directive"><a href="../mod/mod_authz_core.html#match">Match</a></code></li> +<li><a href="../howto/auth.html">Mode d'emploi de +l'authentification</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="AuthBasicAuthoritative" id="AuthBasicAuthoritative">AuthBasicAuthoritative</a> <a name="authbasicauthoritative" id="authbasicauthoritative">Directive</a></h2> +<table class="directive"> +<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Définit si les processus d'autorisation et +d'authentification peuvent être confiés à des modules de plus bas +niveau</td></tr> +<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>AuthBasicAuthoritative On|Off</code></td></tr> +<tr><th><a href="directive-dict.html#Default">Défaut:</a></th><td><code>AuthBasicAuthoritative On</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">Annuler:</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_auth_basic</td></tr> +</table> + <p>Normalement, chaque module d'autorisation énuméré dans la + directive <code class="directive"><a href="#authbasicprovider">AuthBasicProvider</a></code> va tenter de + vérifier l'utilisateur, et si ce dernier n'est trouvé dans aucun des + fournisseurs, l'accès sera refusé. Définir explicitement la + directive <code class="directive">AuthBasicAuthoritative</code> à + <code>Off</code> permet de confier l'autorisation et + l'authentification à d'autres modules non basés sur les fournisseurs + si <strong>aucun identifiant utilisateur</strong> ou aucune + <strong>règle</strong> ne correspondent à l'identifiant utilisateur + spécifié. Ceci ne peut s'avérer nécessaire que lorsque + <code class="module"><a href="../mod/mod_auth_basic.html">mod_auth_basic</a></code> est combiné avec des modules tiers + qui n'ont pas été configurés à l'aide de la directive <code class="directive"><a href="#authbasicprovider">AuthBasicProvider</a></code>. Lorsqu'on + utilise de tels modules, l'ordre dans lequel s'effectue le + traitement est défini dans le code source des modules et n'est pas + configurable.</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="AuthBasicProvider" id="AuthBasicProvider">AuthBasicProvider</a> <a name="authbasicprovider" id="authbasicprovider">Directive</a></h2> +<table class="directive"> +<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Définit le(les) fournisseur(s) d'authentification pour +cette zone du site web</td></tr> +<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>AuthBasicProvider <var>nom fournisseur</var> +[<var>nom fournisseur</var>] ...</code></td></tr> +<tr><th><a href="directive-dict.html#Default">Défaut:</a></th><td><code>AuthBasicProvider file</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">Annuler:</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_auth_basic</td></tr> +</table> + <p>La directive <code class="directive">AuthBasicProvider</code> permet de + définir le fournisseur utilisé pour authentifier les utilisateurs + pour la zone du site web concernée. Le fournisseur par défaut + <code>file</code> est implémenté par le module + <code class="module"><a href="../mod/mod_authn_file.html">mod_authn_file</a></code>. Assurez-vous que le module + implémentant le fournisseur choisi soit bien présent dans le + serveur.</p> + + <div class="example"><h3>Exemple</h3><p><code> + <Location /secure><br /> + <span class="indent"> + AuthType basic<br /> + AuthName "private area"<br /> + AuthBasicProvider dbm<br /> + AuthDBMType SDBM<br /> + AuthDBMUserFile /www/etc/dbmpasswd<br /> + Require valid-user<br /> + </span> + </Location> + </code></p></div> + + <p>Les fournisseurs sont sollicités dans l'ordre jusqu'à ce que l'un + d'entre eux trouve une correspondance pour le nom d'utilisateur de + la requête ; alors, ce dernier fournisseur sera le seul à vérifier + le mot de passe. Un échec dans la vérification du mot de passe + n'entraîne pas le passage du contrôle au fournisseur suivant.</p> + + <p>Les différents fournisseurs disponibles sont implémentés par les + modules <code class="module"><a href="../mod/mod_authn_dbm.html">mod_authn_dbm</a></code>, + <code class="module"><a href="../mod/mod_authn_file.html">mod_authn_file</a></code>, <code class="module"><a href="../mod/mod_authn_dbd.html">mod_authn_dbd</a></code>, et + <code class="module"><a href="../mod/mod_authnz_ldap.html">mod_authnz_ldap</a></code>.</p> + +</div> +</div> +<div class="bottomlang"> +<p><span>Langues Disponibles: </span><a href="../en/mod/mod_auth_basic.html" hreflang="en" rel="alternate" title="English"> en </a> | +<a href="../fr/mod/mod_auth_basic.html" title="Français"> fr </a> | +<a href="../ja/mod/mod_auth_basic.html" hreflang="ja" rel="alternate" title="Japanese"> ja </a> | +<a href="../ko/mod/mod_auth_basic.html" hreflang="ko" rel="alternate" title="Korean"> ko </a></p> +</div><div id="footer"> +<p class="apache">Copyright 2009 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="../faq/">FAQ</a> | <a href="../glossary.html">Glossaire</a> | <a href="../sitemap.html">Plan du site</a></p></div> +</body></html>
\ No newline at end of file diff --git a/docs/manual/mod/mod_auth_basic.xml.fr b/docs/manual/mod/mod_auth_basic.xml.fr new file mode 100644 index 0000000000..5c72085a72 --- /dev/null +++ b/docs/manual/mod/mod_auth_basic.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 : 738841 --> +<!-- 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_auth_basic.xml.meta"> + +<name>mod_auth_basic</name> +<description>Authentification de base</description> +<status>Base</status> +<sourcefile>mod_auth_basic.c</sourcefile> +<identifier>auth_basic_module</identifier> +<compatibility>Disponible depuis la version 2.1 d'Apache</compatibility> + +<summary> + <p>Ce module permet d'utiliser l'authentification basique HTTP pour + restreindre l'accès en recherchant les utilisateurs dans les + fournisseurs d'authentification spécifiés. Il est en général + combiné avec au moins un module d'authentification comme + <module>mod_authn_file</module> et un module d'autorisation comme + <module>mod_authz_user</module>. L'authentification HTTP à + base de condensé (digest), quant à elle, est fournie par le module + <module>mod_auth_digest</module>. </p> +</summary> +<seealso><directive module="mod_authn_core">AuthName</directive></seealso> +<seealso><directive module="mod_authn_core">AuthType</directive></seealso> +<seealso><directive module="mod_authz_core">Require</directive></seealso> +<seealso><directive module="mod_authz_core">Match</directive></seealso> +<seealso><a href="../howto/auth.html">Mode d'emploi de +l'authentification</a></seealso> + +<directivesynopsis> +<name>AuthBasicProvider</name> +<description>Définit le(les) fournisseur(s) d'authentification pour +cette zone du site web</description> +<syntax>AuthBasicProvider <var>nom fournisseur</var> +[<var>nom fournisseur</var>] ...</syntax> +<default>AuthBasicProvider file</default> +<contextlist><context>directory</context><context>.htaccess</context> +</contextlist> +<override>AuthConfig</override> + +<usage> + <p>La directive <directive>AuthBasicProvider</directive> permet de + définir le fournisseur utilisé pour authentifier les utilisateurs + pour la zone du site web concernée. Le fournisseur par défaut + <code>file</code> est implémenté par le module + <module>mod_authn_file</module>. Assurez-vous que le module + implémentant le fournisseur choisi soit bien présent dans le + serveur.</p> + + <example><title>Exemple</title> + <Location /secure><br /> + <indent> + AuthType basic<br /> + AuthName "private area"<br /> + AuthBasicProvider dbm<br /> + AuthDBMType SDBM<br /> + AuthDBMUserFile /www/etc/dbmpasswd<br /> + Require valid-user<br /> + </indent> + </Location> + </example> + + <p>Les fournisseurs sont sollicités dans l'ordre jusqu'à ce que l'un + d'entre eux trouve une correspondance pour le nom d'utilisateur de + la requête ; alors, ce dernier fournisseur sera le seul à vérifier + le mot de passe. Un échec dans la vérification du mot de passe + n'entraîne pas le passage du contrôle au fournisseur suivant.</p> + + <p>Les différents fournisseurs disponibles sont implémentés par les + modules <module>mod_authn_dbm</module>, + <module>mod_authn_file</module>, <module>mod_authn_dbd</module>, et + <module>mod_authnz_ldap</module>.</p> +</usage> +</directivesynopsis> + +<directivesynopsis> +<name>AuthBasicAuthoritative</name> +<description>Définit si les processus d'autorisation et +d'authentification peuvent être confiés à des modules de plus bas +niveau</description> +<syntax>AuthBasicAuthoritative On|Off</syntax> +<default>AuthBasicAuthoritative On</default> +<contextlist><context>directory</context><context>.htaccess</context> +</contextlist> +<override>AuthConfig</override> + +<usage> + <p>Normalement, chaque module d'autorisation énuméré dans la + directive <directive + module="mod_auth_basic">AuthBasicProvider</directive> va tenter de + vérifier l'utilisateur, et si ce dernier n'est trouvé dans aucun des + fournisseurs, l'accès sera refusé. Définir explicitement la + directive <directive>AuthBasicAuthoritative</directive> à + <code>Off</code> permet de confier l'autorisation et + l'authentification à d'autres modules non basés sur les fournisseurs + si <strong>aucun identifiant utilisateur</strong> ou aucune + <strong>règle</strong> ne correspondent à l'identifiant utilisateur + spécifié. Ceci ne peut s'avérer nécessaire que lorsque + <module>mod_auth_basic</module> est combiné avec des modules tiers + qui n'ont pas été configurés à l'aide de la directive <directive + module="mod_auth_basic">AuthBasicProvider</directive>. Lorsqu'on + utilise de tels modules, l'ordre dans lequel s'effectue le + traitement est défini dans le code source des modules et n'est pas + configurable.</p> +</usage> +</directivesynopsis> + +</modulesynopsis> diff --git a/docs/manual/mod/mod_auth_basic.xml.meta b/docs/manual/mod/mod_auth_basic.xml.meta index b6db2c4c4d..1c0c396040 100644 --- a/docs/manual/mod/mod_auth_basic.xml.meta +++ b/docs/manual/mod/mod_auth_basic.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_authn_file.html b/docs/manual/mod/mod_authn_file.html index 1f67fc3f4d..c718bed0b8 100644 --- a/docs/manual/mod/mod_authn_file.html +++ b/docs/manual/mod/mod_authn_file.html @@ -4,6 +4,10 @@ URI: mod_authn_file.html.en Content-Language: en Content-type: text/html; charset=ISO-8859-1 +URI: mod_authn_file.html.fr +Content-Language: fr +Content-type: text/html; charset=ISO-8859-1 + URI: mod_authn_file.html.ja.utf8 Content-Language: ja Content-type: text/html; charset=UTF-8 diff --git a/docs/manual/mod/mod_authn_file.html.en b/docs/manual/mod/mod_authn_file.html.en index e8dfcebae7..ea8887d1bf 100644 --- a/docs/manual/mod/mod_authn_file.html.en +++ b/docs/manual/mod/mod_authn_file.html.en @@ -22,6 +22,7 @@ <div id="preamble"><h1>Apache Module mod_authn_file</h1> <div class="toplang"> <p><span>Available Languages: </span><a href="../en/mod/mod_authn_file.html" title="English"> en </a> | +<a href="../fr/mod/mod_authn_file.html" hreflang="fr" rel="alternate" title="Français"> fr </a> | <a href="../ja/mod/mod_authn_file.html" hreflang="ja" rel="alternate" title="Japanese"> ja </a> | <a href="../ko/mod/mod_authn_file.html" hreflang="ko" rel="alternate" title="Korean"> ko </a></p> </div> @@ -124,6 +125,7 @@ passwords for authentication</td></tr> </div> <div class="bottomlang"> <p><span>Available Languages: </span><a href="../en/mod/mod_authn_file.html" title="English"> en </a> | +<a href="../fr/mod/mod_authn_file.html" hreflang="fr" rel="alternate" title="Français"> fr </a> | <a href="../ja/mod/mod_authn_file.html" hreflang="ja" rel="alternate" title="Japanese"> ja </a> | <a href="../ko/mod/mod_authn_file.html" hreflang="ko" rel="alternate" title="Korean"> ko </a></p> </div><div id="footer"> diff --git a/docs/manual/mod/mod_authn_file.html.fr b/docs/manual/mod/mod_authn_file.html.fr new file mode 100644 index 0000000000..416b8cb4e6 --- /dev/null +++ b/docs/manual/mod/mod_authn_file.html.fr @@ -0,0 +1,139 @@ +<?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_authn_file - 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 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="../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.3</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.3</a> > <a href="./">Modules</a></div> +<div id="page-content"> +<div id="preamble"><h1>Module Apache mod_authn_file</h1> +<div class="toplang"> +<p><span>Langues Disponibles: </span><a href="../en/mod/mod_authn_file.html" hreflang="en" rel="alternate" title="English"> en </a> | +<a href="../fr/mod/mod_authn_file.html" title="Français"> fr </a> | +<a href="../ja/mod/mod_authn_file.html" hreflang="ja" rel="alternate" title="Japanese"> ja </a> | +<a href="../ko/mod/mod_authn_file.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>Authentification utilisateur à l'aide de fichiers +texte</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>authn_file_module</td></tr> +<tr><th><a href="module-dict.html#SourceFile">Fichier Source:</a></th><td>mod_authn_file.c</td></tr> +<tr><th><a href="module-dict.html#Compatibility">Compatibilité:</a></th><td>Disponible depuis les versions 2.1 et supérieures +d'Apache</td></tr></table> +<h3>Sommaire</h3> + + <p>Ce module permet aux frontaux d'authentification comme + <code class="module"><a href="../mod/mod_auth_digest.html">mod_auth_digest</a></code> et <code class="module"><a href="../mod/mod_auth_basic.html">mod_auth_basic</a></code> + d'authentifier les utilisateurs en les recherchant dans des fichiers + de mots de passe au format texte. <code class="module"><a href="../mod/mod_authn_dbm.html">mod_authn_dbm</a></code> + fournit une fonctionnalité similaire.</p> + + <p>Lorsqu'on utilise <code class="module"><a href="../mod/mod_auth_basic.html">mod_auth_basic</a></code> ou + <code class="module"><a href="../mod/mod_auth_digest.html">mod_auth_digest</a></code>, ce module peut être invoqué en + affectant la valeur <code>file</code> à la directive <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>.</p> +</div> +<div id="quickview"><h3 class="directives">Directives</h3> +<ul id="toc"> +<li><img alt="" src="../images/down.gif" /> <a href="#authuserfile">AuthUserFile</a></li> +</ul> +<h3>Voir aussi</h3> +<ul class="seealso"> +<li> + <code class="directive"><a href="../mod/mod_auth_basic.html#authbasicprovider">AuthBasicProvider</a></code> +</li> +<li> + <code class="directive"><a href="../mod/mod_auth_digest.html#authdigestprovider">AuthDigestProvider</a></code> +</li> +<li><code class="program"><a href="../programs/htpasswd.html">htpasswd</a></code></li> +<li><code class="program"><a href="../programs/htdigest.html">htdigest</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="AuthUserFile" id="AuthUserFile">AuthUserFile</a> <a name="authuserfile" id="authuserfile">Directive</a></h2> +<table class="directive"> +<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Définit le nom d'un fichier texte pour l'authentification +contenant la liste des utilisateurs et de leurs mots de +passe</td></tr> +<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>AuthUserFile <var>chemin-fichier</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">Annuler:</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_authn_file</td></tr> +</table> + <p>La directive <code class="directive">AuthUserFile</code> permet de + définir le nom d'un fichier texte pour l'authentification contenant + la liste des utilisateurs et de leurs mots de passe. + <var>chemin-fichier</var> est le chemin vers le fichier + des utilisateurs. S'il n'est pas absolu, il est considéré comme + relatif au répertoire défini par la directive <code class="directive"><a href="../mod/core.html#serverroot">ServerRoot</a></code>.</p> + + <p>Chaque ligne du fichier des utilisateurs se compose du nom de + l'utilisateur, du caractère ':' et du mot de passe chiffré. Si le + même identifiant utilisateur est référencé plusieurs fois, + <code class="module"><a href="../mod/mod_authn_file.html">mod_authn_file</a></code> utilisera la première occurence pour + vérifier le mot de passe.</p> + + <p>Pour l'<em>Authentification de base HTTP</em>, on utilise + l'utilitaire <code class="program"><a href="../programs/htpasswd.html">htpasswd</a></code>, installé avec la + distribution binaire ou se trouvant dans <code>src/support</code>, + pour maintenir le fichier des mots de passe. Voir sa <a href="../programs/htpasswd.html">page de manuel</a> pour plus de + détails. En bref :</p> + + <p>On crée un fichier de mots de passe <code>nom-fichier</code> avec + <code>nom-utilisateur</code> comme identifiant initial. Le mot de + passe correspondant sera alors demandé :</p> + + <div class="example"><p><code> + htpasswd -c nom-fichier nom-utilisateur + </code></p></div> + + <p>Pour ajouter ou modifier <code>nom-utilisateur2</code> dans le + fichier de mots de passe <code>nom-fichier</code> :</p> + + <div class="example"><p><code> + htpasswd nom-fichier nom-utilisateur2 + </code></p></div> + + <p>Noter qu'une recherche dans de grands fichiers texte peut être + très longue ; dans ce cas, il vaut mieux utiliser les fichiers DBM + avec la directive <code class="directive"><a href="../mod/mod_authn_dbm.html#authdbmuserfile">AuthDBMUserFile</a></code>.</p> + + <p>Si vous utilisez l'<em>Authentification HTTP à base de + condensé</em>, l'utilitaire <code class="program"><a href="../programs/htpasswd.html">htpasswd</a></code> ne convient + pas. Vous devez utiliser <code class="program"><a href="../programs/htdigest.html">htdigest</a></code> à la place. + Notez que vous ne pouvez pas mélanger des données utilisateur pour + l'Authentification HTTP à base de condensé et des données pour + l'Authentification de Base dans le même fichier.</p> + + <div class="warning"><h3>Sécurité</h3> + <p>Assurez-vous que le fichier <code class="directive">AuthUserFile</code> + soit bien stocké en dehors de l'arborescence des documents du + serveur web. Ne placez <strong>pas</strong> ce fichier dans le + répertoire qu'il protège. Dans le cas contraire, les clients + seraient en mesure de télécharger le fichier des mots de passe.</p> + </div> + +</div> +</div> +<div class="bottomlang"> +<p><span>Langues Disponibles: </span><a href="../en/mod/mod_authn_file.html" hreflang="en" rel="alternate" title="English"> en </a> | +<a href="../fr/mod/mod_authn_file.html" title="Français"> fr </a> | +<a href="../ja/mod/mod_authn_file.html" hreflang="ja" rel="alternate" title="Japanese"> ja </a> | +<a href="../ko/mod/mod_authn_file.html" hreflang="ko" rel="alternate" title="Korean"> ko </a></p> +</div><div id="footer"> +<p class="apache">Copyright 2009 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="../faq/">FAQ</a> | <a href="../glossary.html">Glossaire</a> | <a href="../sitemap.html">Plan du site</a></p></div> +</body></html>
\ No newline at end of file diff --git a/docs/manual/mod/mod_authn_file.xml.fr b/docs/manual/mod/mod_authn_file.xml.fr new file mode 100644 index 0000000000..c684bcd174 --- /dev/null +++ b/docs/manual/mod/mod_authn_file.xml.fr @@ -0,0 +1,127 @@ +<?xml version="1.0"?> +<!DOCTYPE modulesynopsis SYSTEM "../style/modulesynopsis.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. +--> + +<modulesynopsis metafile="mod_authn_file.xml.meta"> + +<name>mod_authn_file</name> +<description>Authentification utilisateur à l'aide de fichiers +texte</description> +<status>Base</status> +<sourcefile>mod_authn_file.c</sourcefile> +<identifier>authn_file_module</identifier> +<compatibility>Disponible depuis les versions 2.1 et supérieures +d'Apache</compatibility> + +<summary> + <p>Ce module permet aux frontaux d'authentification comme + <module>mod_auth_digest</module> et <module>mod_auth_basic</module> + d'authentifier les utilisateurs en les recherchant dans des fichiers + de mots de passe au format texte. <module>mod_authn_dbm</module> + fournit une fonctionnalité similaire.</p> + + <p>Lorsqu'on utilise <module>mod_auth_basic</module> ou + <module>mod_auth_digest</module>, ce module peut être invoqué en + affectant la valeur <code>file</code> à la directive <directive + module="mod_auth_basic">AuthBasicProvider</directive> ou <directive + module="mod_auth_digest">AuthDigestProvider</directive>.</p> +</summary> +<seealso> + <directive module="mod_auth_basic">AuthBasicProvider</directive> +</seealso> +<seealso> + <directive module="mod_auth_digest">AuthDigestProvider</directive> +</seealso> +<seealso><program>htpasswd</program></seealso> +<seealso><program>htdigest</program></seealso> + +<directivesynopsis> +<name>AuthUserFile</name> +<description>Définit le nom d'un fichier texte pour l'authentification +contenant la liste des utilisateurs et de leurs mots de +passe</description> +<syntax>AuthUserFile <var>chemin-fichier</var></syntax> +<contextlist><context>directory</context><context>.htaccess</context> +</contextlist> +<override>AuthConfig</override> + +<usage> + <p>La directive <directive>AuthUserFile</directive> permet de + définir le nom d'un fichier texte pour l'authentification contenant + la liste des utilisateurs et de leurs mots de passe. + <var>chemin-fichier</var> est le chemin vers le fichier + des utilisateurs. S'il n'est pas absolu, il est considéré comme + relatif au répertoire défini par la directive <directive + module="core">ServerRoot</directive>.</p> + + <p>Chaque ligne du fichier des utilisateurs se compose du nom de + l'utilisateur, du caractère ':' et du mot de passe chiffré. Si le + même identifiant utilisateur est référencé plusieurs fois, + <module>mod_authn_file</module> utilisera la première occurence pour + vérifier le mot de passe.</p> + + <p>Pour l'<em>Authentification de base HTTP</em>, on utilise + l'utilitaire <program>htpasswd</program>, installé avec la + distribution binaire ou se trouvant dans <code>src/support</code>, + pour maintenir le fichier des mots de passe. Voir sa <a + href="../programs/htpasswd.html">page de manuel</a> pour plus de + détails. En bref :</p> + + <p>On crée un fichier de mots de passe <code>nom-fichier</code> avec + <code>nom-utilisateur</code> comme identifiant initial. Le mot de + passe correspondant sera alors demandé :</p> + + <example> + htpasswd -c nom-fichier nom-utilisateur + </example> + + <p>Pour ajouter ou modifier <code>nom-utilisateur2</code> dans le + fichier de mots de passe <code>nom-fichier</code> :</p> + + <example> + htpasswd nom-fichier nom-utilisateur2 + </example> + + <p>Noter qu'une recherche dans de grands fichiers texte peut être + très longue ; dans ce cas, il vaut mieux utiliser les fichiers DBM + avec la directive <directive + module="mod_authn_dbm">AuthDBMUserFile</directive>.</p> + + <p>Si vous utilisez l'<em>Authentification HTTP à base de + condensé</em>, l'utilitaire <program>htpasswd</program> ne convient + pas. Vous devez utiliser <program>htdigest</program> à la place. + Notez que vous ne pouvez pas mélanger des données utilisateur pour + l'Authentification HTTP à base de condensé et des données pour + l'Authentification de Base dans le même fichier.</p> + + <note type="warning"><title>Sécurité</title> + <p>Assurez-vous que le fichier <directive>AuthUserFile</directive> + soit bien stocké en dehors de l'arborescence des documents du + serveur web. Ne placez <strong>pas</strong> ce fichier dans le + répertoire qu'il protège. Dans le cas contraire, les clients + seraient en mesure de télécharger le fichier des mots de passe.</p> + </note> +</usage> +</directivesynopsis> + +</modulesynopsis> diff --git a/docs/manual/mod/mod_authn_file.xml.meta b/docs/manual/mod/mod_authn_file.xml.meta index ad6bbc4baf..de79635381 100644 --- a/docs/manual/mod/mod_authn_file.xml.meta +++ b/docs/manual/mod/mod_authn_file.xml.meta @@ -8,6 +8,7 @@ <variants> <variant>en</variant> + <variant>fr</variant> <variant>ja</variant> <variant outdated="yes">ko</variant> </variants> diff --git a/docs/manual/mod/mod_authz_host.html b/docs/manual/mod/mod_authz_host.html index 374fb7f4fd..f46aa2e275 100644 --- a/docs/manual/mod/mod_authz_host.html +++ b/docs/manual/mod/mod_authz_host.html @@ -3,3 +3,7 @@ URI: mod_authz_host.html.en Content-Language: en Content-type: text/html; charset=ISO-8859-1 + +URI: mod_authz_host.html.fr +Content-Language: fr +Content-type: text/html; charset=ISO-8859-1 diff --git a/docs/manual/mod/mod_authz_host.html.en b/docs/manual/mod/mod_authz_host.html.en index 141faff98c..bc46c8c722 100644 --- a/docs/manual/mod/mod_authz_host.html.en +++ b/docs/manual/mod/mod_authz_host.html.en @@ -21,7 +21,8 @@ <div id="page-content"> <div id="preamble"><h1>Apache Module mod_authz_host</h1> <div class="toplang"> -<p><span>Available Languages: </span><a href="../en/mod/mod_authz_host.html" title="English"> en </a></p> +<p><span>Available Languages: </span><a href="../en/mod/mod_authz_host.html" title="English"> en </a> | +<a href="../fr/mod/mod_authz_host.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>Group authorizations based on host (name or IP address)</td></tr> @@ -215,7 +216,8 @@ address)</td></tr> </div> </div> <div class="bottomlang"> -<p><span>Available Languages: </span><a href="../en/mod/mod_authz_host.html" title="English"> en </a></p> +<p><span>Available Languages: </span><a href="../en/mod/mod_authz_host.html" title="English"> en </a> | +<a href="../fr/mod/mod_authz_host.html" hreflang="fr" rel="alternate" title="Français"> fr </a></p> </div><div id="footer"> <p class="apache">Copyright 2009 The Apache Software Foundation.<br />Licensed under the <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="../faq/">FAQ</a> | <a href="../glossary.html">Glossary</a> | <a href="../sitemap.html">Sitemap</a></p></div> diff --git a/docs/manual/mod/mod_authz_host.html.fr b/docs/manual/mod/mod_authz_host.html.fr new file mode 100644 index 0000000000..26ace39635 --- /dev/null +++ b/docs/manual/mod/mod_authz_host.html.fr @@ -0,0 +1,230 @@ +<?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_host - 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 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="../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.3</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.3</a> > <a href="./">Modules</a></div> +<div id="page-content"> +<div id="preamble"><h1>Module Apache mod_authz_host</h1> +<div class="toplang"> +<p><span>Langues Disponibles: </span><a href="../en/mod/mod_authz_host.html" hreflang="en" rel="alternate" title="English"> en </a> | +<a href="../fr/mod/mod_authz_host.html" title="Français"> fr </a></p> +</div> +<table class="module"><tr><th><a href="module-dict.html#Description">Description:</a></th><td>Autorisations de groupe basées sur l'hôte (nom ou adresse +IP)</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_host_module</td></tr> +<tr><th><a href="module-dict.html#SourceFile">Fichier Source:</a></th><td>mod_authz_host.c</td></tr> +<tr><th><a href="module-dict.html#Compatibility">Compatibilité:</a></th><td>Disponible depuis les versions 2.3 et supérieures +d'Apache</td></tr></table> +<h3>Sommaire</h3> + + <p>Les fournisseurs d'autorisation implémentés par le module + <code class="module"><a href="../mod/mod_authz_host.html">mod_authz_host</a></code> sont enregistrés à l'aide des + directives <code class="directive"><a href="../mod/mod_authz_core.html#require">Require</a></code> ou + <code class="directive"><a href="../mod/mod_authz_core.html#match">Match</a></code>. On peut + utiliser ces directives à l'intérieur de sections <code class="directive"><a href="../mod/core.html#directory"><Directory></a></code>, <code class="directive"><a href="../mod/core.html#files"><Files></a></code>, ou <code class="directive"><a href="../mod/core.html#location"><Location></a></code> ou de fichiers + <code><a href="core.html#accessfilename">.htaccess</a> </code> pour + contrôler l'accès à certaines zones du serveur. Le contrôle d'accès + peut être effectué en fonction du nom d'hôte, de l'adresse IP, ou + d'autres caractéristiques de la requête client, telles qu'elles sont + enregistrées dans des <a href="../env.html">variables + d'environnement</a>.</p> + + <p>En général, les directives de restriction d'accès s'appliquent à + toutes les méthodes d'accès (<code>GET</code>, <code>PUT</code>, + <code>POST</code>, etc...). C'est d'ailleurs ce que l'on souhaite + dans la plupart des cas. Il est cependant possible de ne restreindre + l'accès que pour certaines méthodes, tout en laissant les autres + méthodes sans protection, en plaçant les directives dans une section + <code class="directive"><a href="../mod/core.html#limit"><Limit></a></code>.</p> +</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="#requiredirectives">Les directives Require</a></li> +</ul><h3>Voir aussi</h3> +<ul class="seealso"> +<li><a href="../howto/auth.html">Authentification, autorisation et +contrôle d'accès</a></li> +<li><code class="directive"><a href="../mod/mod_authz_core.html#require">Require</a></code></li> +<li><code class="directive"><a href="../mod/mod_authz_core.html#match">Match</a></code></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="requiredirectives" id="requiredirectives">Les directives Require</a></h2> + + <p>Les directives d'Apache <code class="directive"><a href="../mod/mod_authz_core.html#require">Require</a></code> et <code class="directive"><a href="../mod/mod_authz_core.html#match">Match</a></code> sont utilisées au cours de + la phase d'autorisation pour vérifier si un utilisateur se voit + accorder ou refuser l'accès à une ressource. mod_authz_host fournit + les types d'autorisation <code>env</code>, <code>ip</code>, + <code>host</code> et <code>all</code>. D'autres types d'autorisation + sont aussi disponibles, mais nécessitent le chargement des modules + d'autorisation appropriés.</p> + + <p>Ces fournisseurs d'autorisation permettent de déterminer quels + hôtes peuvent accéder à une zone du serveur. On peut contrôler + l'accès en fonction du nom d'hôte, de l'adresse IP, d'un intervalle + d'adresses IP, ou d'autres caractéristiques de la requête client + enregistrées dans des variables d'environnement.</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-var</var></code> est spécifié, la + requête est autorisée si la variable d'environnement + <var>env-var</var> existe. Le serveur fournit la possibilité + de définir des variables d'environnement avec une grande souplesse + en fonction des caractéristiques de la requête client à l'aide des + directives fournies par le module <code class="module"><a href="../mod/mod_setenvif.html">mod_setenvif</a></code>. On + peut ainsi utiliser cette directive pour contrôler l'accès en + fonction de certains en-têtes comme <code>User-Agent</code> (type de + navigateur), <code>Referer</code>, etc...</p> + + <div class="example"><h3>Exemple :</h3><p><code> + SetEnvIf User-Agent ^KnockKnock/2\.0 laisse_moi_entrer<br /> + <Directory /docroot><br /> + <span class="indent"> + Require env laisse_moi_entrer<br /> + </span> + </Directory> + </code></p></div> + + <p>Dans cet exemple, les navigateurs dont la chaîne de description + de l'en-tête user-agent commence par <code>KnockKnock/2.0</code> se + verront accorder l'accès, alors que tous les autres se le verront + refuser.</p> + + + +<h3><a name="reqip" id="reqip">Require ip</a></h3> + + <p>Le fournisseur <code>ip</code> permet de contrôler l'accès au + serveur en fonction de l'adresse IP du client distant. Lorsque + <code>Require ip <var>adresse-ip</var></code> est spécifié, la + requête est autorisée si l'adresse IP du client distant correspond + à</p> + + <p>Une adresse IP complète :</p> + + <div class="example"><p><code> + Require ip 10.1.2.3<br /> + Require ip 192.168.1.104 192.168.1.205 + </code></p></div> + + <p>L'adresse IP d'un hôte pour qui l'accès est accordé</p> + + <p>Une adresse IP partielle :</p> + + <div class="example"><p><code> + Require ip 10.1<br /> + Require ip 10 172.20 192.168.2 + </code></p></div> + <p>Les 1 à 3 premiers octets d'une adresse IP, pour une restriction + à un sous-réseau.</p> + + <p>Une paire réseau/masque de sous-réseau :</p> + + <div class="example"><p><code> + Require ip 10.1.0.0/255.255.0.0 + </code></p></div> + <p>Un réseau a.b.c.d, et un masque de sous-réseau w.x.y.z. pour une + restriction de sous-réseau plus fine.</p> + + <p>Une spécification CIDR réseau/nnn :</p> + + <div class="example"><p><code> + Require ip 10.1.0.0/16 + </code></p></div> + <p>Identique au cas précédent, excepté que le masque de sous-réseau + représente les nnn premiers bits de poids fort.</p> + + <p>Notez que les trois derniers exemples correspondent exectement au + même ensemble d'hôtes.</p> + + <p>On peut spécifier des adresses et des sous-réseaux IPv6 comme + suit :</p> + + <div class="example"><p><code> + Require ip 2001:db8::a00:20ff:fea7:ccea<br /> + Require ip 2001:db8::a00:20ff:fea7:ccea/10 + </code></p></div> + + + + +<h3><a name="reqhost" id="reqhost">Require host</a></h3> + + <p>Le fournisseur <code>host</code> permet de contrôler l'accès au + serveur en fonction du nom d'hôte du client distant. Lorsque + <code>Require host <var>nom-hôte</var></code> est spécifié, la + requête est autorisée si le nom d'hôte correspond à</p> + + <p>Un nom de domaine (éventuellement partiel)</p> + + <div class="example"><p><code> + Require host apache.org<br /> + Require host .net example.edu + </code></p></div> + + <p>Les hôtes dont les noms correspondent ou se terminent par la + chaîne spécifiée se voient accorder l'accès. Seuls les élément de + nom de domaine complets sont mis en correspondance ; ainsi, + l'exemple ci-dessus correspondra à <code>foo.apache.org</code>, mais + ne correspondra pas à <code>fooapache.org</code>. Avec cette + configuration, Apache va effectuer une double recherche DNS sur + l'adresse IP du client, sans tenir compte de la définition de la + directive <code class="directive"><a href="../mod/core.html#hostnamelookups">HostnameLookups</a></code>. Il + va effectuer une recherche DNS inverse sur l'adresse IP pour trouver + le nom d'hôte associé, puis une recherche DNS directe sur le nom + d'hôte pour vérifier qu'il correspond bien à l'adresse IP originale. + L'accès ne sera accordé que si le nom d'hôte correspond et si les + recherches DNS inverse et directe sont cohérentes.</p> + + + +<h3><a name="reqall" id="reqall">Require all</a></h3> + + <p>Le fournisseur <code>all</code> imite la fonctionnalité + précédemment fournie par les directives 'Allow from all' et 'Deny + from all'. Le fournisseur accepte un des deux arguments 'granted' ou + 'denied'. Dans les exemples suivants, le premier + accorde l'accès à toutes les requêtes, alors que le second le + refuse.</p> + + <div class="example"><p><code> + Require all granted<br /> + </code></p></div> + + <div class="example"><p><code> + Require all denied<br /> + </code></p></div> + + + + +</div> +</div> +<div class="bottomlang"> +<p><span>Langues Disponibles: </span><a href="../en/mod/mod_authz_host.html" hreflang="en" rel="alternate" title="English"> en </a> | +<a href="../fr/mod/mod_authz_host.html" title="Français"> fr </a></p> +</div><div id="footer"> +<p class="apache">Copyright 2009 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="../faq/">FAQ</a> | <a href="../glossary.html">Glossaire</a> | <a href="../sitemap.html">Plan du site</a></p></div> +</body></html>
\ No newline at end of file diff --git a/docs/manual/mod/mod_authz_host.xml.fr b/docs/manual/mod/mod_authz_host.xml.fr new file mode 100644 index 0000000000..d287df21af --- /dev/null +++ b/docs/manual/mod/mod_authz_host.xml.fr @@ -0,0 +1,224 @@ +<?xml version="1.0"?> +<!DOCTYPE modulesynopsis SYSTEM "../style/modulesynopsis.dtd"> +<?xml-stylesheet type="text/xsl" href="../style/manual.fr.xsl"?> +<!-- English Revision : 709841 --> +<!-- 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_host.xml.meta"> + +<name>mod_authz_host</name> +<description>Autorisations de groupe basées sur l'hôte (nom ou adresse +IP)</description> +<status>Base</status> +<sourcefile>mod_authz_host.c</sourcefile> +<identifier>authz_host_module</identifier> +<compatibility>Disponible depuis les versions 2.3 et supérieures +d'Apache</compatibility> + +<summary> + <p>Les fournisseurs d'autorisation implémentés par le module + <module>mod_authz_host</module> sont enregistrés à l'aide des + directives <directive module="mod_authz_core">Require</directive> ou + <directive module="mod_authz_core">Match</directive>. On peut + utiliser ces directives à l'intérieur de sections <directive + module="core" type="section">Directory</directive>, <directive + module="core" type="section">Files</directive>, ou <directive + module="core" type="section">Location</directive> ou de fichiers + <code><a href="core.html#accessfilename">.htaccess</a> </code> pour + contrôler l'accès à certaines zones du serveur. Le contrôle d'accès + peut être effectué en fonction du nom d'hôte, de l'adresse IP, ou + d'autres caractéristiques de la requête client, telles qu'elles sont + enregistrées dans des <a href="../env.html">variables + d'environnement</a>.</p> + + <p>En général, les directives de restriction d'accès s'appliquent à + toutes les méthodes d'accès (<code>GET</code>, <code>PUT</code>, + <code>POST</code>, etc...). C'est d'ailleurs ce que l'on souhaite + dans la plupart des cas. Il est cependant possible de ne restreindre + l'accès que pour certaines méthodes, tout en laissant les autres + méthodes sans protection, en plaçant les directives dans une section + <directive module="core" type="section">Limit</directive>.</p> +</summary> + +<seealso><a href="../howto/auth.html">Authentification, autorisation et +contrôle d'accès</a></seealso> +<seealso><directive module="mod_authz_core">Require</directive></seealso> +<seealso><directive module="mod_authz_core">Match</directive></seealso> + +<section id="requiredirectives"><title>Les directives Require</title> + + <p>Les directives d'Apache <directive + module="mod_authz_core">Require</directive> et <directive + module="mod_authz_core">Match</directive> sont utilisées au cours de + la phase d'autorisation pour vérifier si un utilisateur se voit + accorder ou refuser l'accès à une ressource. mod_authz_host fournit + les types d'autorisation <code>env</code>, <code>ip</code>, + <code>host</code> et <code>all</code>. D'autres types d'autorisation + sont aussi disponibles, mais nécessitent le chargement des modules + d'autorisation appropriés.</p> + + <p>Ces fournisseurs d'autorisation permettent de déterminer quels + hôtes peuvent accéder à une zone du serveur. On peut contrôler + l'accès en fonction du nom d'hôte, de l'adresse IP, d'un intervalle + d'adresses IP, ou d'autres caractéristiques de la requête client + enregistrées dans des variables d'environnement.</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-var</var></code> est spécifié, la + requête est autorisée si la variable d'environnement + <var>env-var</var> existe. Le serveur fournit la possibilité + de définir des variables d'environnement avec une grande souplesse + en fonction des caractéristiques de la requête client à l'aide des + directives fournies par le module <module>mod_setenvif</module>. On + peut ainsi utiliser cette directive pour contrôler l'accès en + fonction de certains en-têtes comme <code>User-Agent</code> (type de + navigateur), <code>Referer</code>, etc...</p> + + <example><title>Exemple :</title> + SetEnvIf User-Agent ^KnockKnock/2\.0 laisse_moi_entrer<br /> + <Directory /docroot><br /> + <indent> + Require env laisse_moi_entrer<br /> + </indent> + </Directory> + </example> + + <p>Dans cet exemple, les navigateurs dont la chaîne de description + de l'en-tête user-agent commence par <code>KnockKnock/2.0</code> se + verront accorder l'accès, alors que tous les autres se le verront + refuser.</p> + +</section> + +<section id="reqip"><title>Require ip</title> + + <p>Le fournisseur <code>ip</code> permet de contrôler l'accès au + serveur en fonction de l'adresse IP du client distant. Lorsque + <code>Require ip <var>adresse-ip</var></code> est spécifié, la + requête est autorisée si l'adresse IP du client distant correspond + à</p> + + <p>Une adresse IP complète :</p> + + <example> + Require ip 10.1.2.3<br /> + Require ip 192.168.1.104 192.168.1.205 + </example> + + <p>L'adresse IP d'un hôte pour qui l'accès est accordé</p> + + <p>Une adresse IP partielle :</p> + + <example> + Require ip 10.1<br /> + Require ip 10 172.20 192.168.2 + </example> + <p>Les 1 à 3 premiers octets d'une adresse IP, pour une restriction + à un sous-réseau.</p> + + <p>Une paire réseau/masque de sous-réseau :</p> + + <example> + Require ip 10.1.0.0/255.255.0.0 + </example> + <p>Un réseau a.b.c.d, et un masque de sous-réseau w.x.y.z. pour une + restriction de sous-réseau plus fine.</p> + + <p>Une spécification CIDR réseau/nnn :</p> + + <example> + Require ip 10.1.0.0/16 + </example> + <p>Identique au cas précédent, excepté que le masque de sous-réseau + représente les nnn premiers bits de poids fort.</p> + + <p>Notez que les trois derniers exemples correspondent exectement au + même ensemble d'hôtes.</p> + + <p>On peut spécifier des adresses et des sous-réseaux IPv6 comme + suit :</p> + + <example> + Require ip 2001:db8::a00:20ff:fea7:ccea<br /> + Require ip 2001:db8::a00:20ff:fea7:ccea/10 + </example> + + +</section> + +<section id="reqhost"><title>Require host</title> + + <p>Le fournisseur <code>host</code> permet de contrôler l'accès au + serveur en fonction du nom d'hôte du client distant. Lorsque + <code>Require host <var>nom-hôte</var></code> est spécifié, la + requête est autorisée si le nom d'hôte correspond à</p> + + <p>Un nom de domaine (éventuellement partiel)</p> + + <example> + Require host apache.org<br /> + Require host .net example.edu + </example> + + <p>Les hôtes dont les noms correspondent ou se terminent par la + chaîne spécifiée se voient accorder l'accès. Seuls les élément de + nom de domaine complets sont mis en correspondance ; ainsi, + l'exemple ci-dessus correspondra à <code>foo.apache.org</code>, mais + ne correspondra pas à <code>fooapache.org</code>. Avec cette + configuration, Apache va effectuer une double recherche DNS sur + l'adresse IP du client, sans tenir compte de la définition de la + directive <directive module="core">HostnameLookups</directive>. Il + va effectuer une recherche DNS inverse sur l'adresse IP pour trouver + le nom d'hôte associé, puis une recherche DNS directe sur le nom + d'hôte pour vérifier qu'il correspond bien à l'adresse IP originale. + L'accès ne sera accordé que si le nom d'hôte correspond et si les + recherches DNS inverse et directe sont cohérentes.</p> + +</section> + +<section id="reqall"><title>Require all</title> + + <p>Le fournisseur <code>all</code> imite la fonctionnalité + précédemment fournie par les directives 'Allow from all' et 'Deny + from all'. Le fournisseur accepte un des deux arguments 'granted' ou + 'denied'. Dans les exemples suivants, le premier + accorde l'accès à toutes les requêtes, alors que le second le + refuse.</p> + + <example> + Require all granted<br /> + </example> + + <example> + Require all denied<br /> + </example> + +</section> + + +</section> + + +</modulesynopsis> diff --git a/docs/manual/mod/mod_authz_host.xml.meta b/docs/manual/mod/mod_authz_host.xml.meta index b98a1852c1..697c3af893 100644 --- a/docs/manual/mod/mod_authz_host.xml.meta +++ b/docs/manual/mod/mod_authz_host.xml.meta @@ -8,5 +8,6 @@ <variants> <variant>en</variant> + <variant>fr</variant> </variants> </metafile> diff --git a/docs/manual/mod/mod_authz_owner.html b/docs/manual/mod/mod_authz_owner.html index b70f2eab69..e021070ec1 100644 --- a/docs/manual/mod/mod_authz_owner.html +++ b/docs/manual/mod/mod_authz_owner.html @@ -4,6 +4,10 @@ URI: mod_authz_owner.html.en Content-Language: en Content-type: text/html; charset=ISO-8859-1 +URI: mod_authz_owner.html.fr +Content-Language: fr +Content-type: text/html; charset=ISO-8859-1 + URI: mod_authz_owner.html.ja.utf8 Content-Language: ja Content-type: text/html; charset=UTF-8 diff --git a/docs/manual/mod/mod_authz_owner.html.en b/docs/manual/mod/mod_authz_owner.html.en index bfb323d44b..f69f6031ae 100644 --- a/docs/manual/mod/mod_authz_owner.html.en +++ b/docs/manual/mod/mod_authz_owner.html.en @@ -22,6 +22,7 @@ <div id="preamble"><h1>Apache Module mod_authz_owner</h1> <div class="toplang"> <p><span>Available Languages: </span><a href="../en/mod/mod_authz_owner.html" title="English"> en </a> | +<a href="../fr/mod/mod_authz_owner.html" hreflang="fr" rel="alternate" title="Français"> fr </a> | <a href="../ja/mod/mod_authz_owner.html" hreflang="ja" rel="alternate" title="Japanese"> ja </a> | <a href="../ko/mod/mod_authz_owner.html" hreflang="ko" rel="alternate" title="Korean"> ko </a></p> </div> @@ -139,6 +140,7 @@ </div> <div class="bottomlang"> <p><span>Available Languages: </span><a href="../en/mod/mod_authz_owner.html" title="English"> en </a> | +<a href="../fr/mod/mod_authz_owner.html" hreflang="fr" rel="alternate" title="Français"> fr </a> | <a href="../ja/mod/mod_authz_owner.html" hreflang="ja" rel="alternate" title="Japanese"> ja </a> | <a href="../ko/mod/mod_authz_owner.html" hreflang="ko" rel="alternate" title="Korean"> ko </a></p> </div><div id="footer"> diff --git a/docs/manual/mod/mod_authz_owner.html.fr b/docs/manual/mod/mod_authz_owner.html.fr new file mode 100644 index 0000000000..6a105d90e4 --- /dev/null +++ b/docs/manual/mod/mod_authz_owner.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_authz_owner - 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 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="../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.3</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.3</a> > <a href="./">Modules</a></div> +<div id="page-content"> +<div id="preamble"><h1>Module Apache mod_authz_owner</h1> +<div class="toplang"> +<p><span>Langues Disponibles: </span><a href="../en/mod/mod_authz_owner.html" hreflang="en" rel="alternate" title="English"> en </a> | +<a href="../fr/mod/mod_authz_owner.html" title="Français"> fr </a> | +<a href="../ja/mod/mod_authz_owner.html" hreflang="ja" rel="alternate" title="Japanese"> ja </a> | +<a href="../ko/mod/mod_authz_owner.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>Autorisation basée sur l'appartenance des +fichiers</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>authz_owner_module</td></tr> +<tr><th><a href="module-dict.html#SourceFile">Fichier Source:</a></th><td>mod_authz_owner.c</td></tr> +<tr><th><a href="module-dict.html#Compatibility">Compatibilité:</a></th><td>Disponible depuis les versions 2.1 et supérieures +d'Apache</td></tr></table> +<h3>Sommaire</h3> + + <p>Ce module permet de contrôler l'accès aux fichiers en comparant + l'identifiant utilisateur ayant servi à l'authentification HTTP + (l'identifiant utilisateur web) avec le propriétaire ou le groupe + du fichier demandé du point de vue du système de fichiers. Le nom + d'utilisateur et le mot de passe doivent déjà avoir été vérifiés par + un module d'authentification comme <code class="module"><a href="../mod/mod_auth_basic.html">mod_auth_basic</a></code> + ou <code class="module"><a href="../mod/mod_auth_digest.html">mod_auth_digest</a></code>. + <code class="module"><a href="../mod/mod_authz_owner.html">mod_authz_owner</a></code> reconnaît deux arguments pour la + directive <code class="directive"><a href="../mod/core.html#require">Require</a></code> : + <code>file-owner</code> et <code>file-group</code> :</p> + + <dl> + <dt><code>file-owner</code></dt> + <dd>Le nom d'utilisateur web utilisé pour l'authentification doit + correspondre au nom système du propriétaire du fichier demandé. En + d'autres termes, si le système indique <code>jones</code> comme + propriétaire du fichier demandé, le nom d'utilisateur fourni pour + l'authentification HTTP doit aussi être <code>jones</code>.</dd> + + <dt><code>file-group</code></dt> + <dd>Le nom du groupe système du fichier demandé doit être présent + dans une base de données de groupes fournie, par exemple, par + <code class="module"><a href="../mod/mod_authz_groupfile.html">mod_authz_groupfile</a></code> ou + <code class="module"><a href="../mod/mod_authz_dbm.html">mod_authz_dbm</a></code>, et le nom d'utilisateur web fourni + pour l'authentification doit être un membre de ce groupe. Par + exemple, si le système indique que le groupe (système) du fichier + demandé est <code>accounts</code>, le groupe <code>accounts</code> + doit apparaître dans la base de données des groupes, et le nom + d'utilisateur web utilisé pour l'authentification doit être un + membre de ce groupe.</dd> + </dl> + + <div class="note"><h3>Note</h3> + <p>Si le module <code class="module"><a href="../mod/mod_authz_owner.html">mod_authz_owner</a></code> est utilisé pour + vérifier l'autorisation d'accès à une ressource qui n'est pas + vraiment présente dans le système de fichiers (en d'autres termes + une ressource virtuelle), il refusera l'accès.</p> + + <p>En particulier, il n'accordera jamais l'accès à une ressource + du type <a href="../content-negotiation.html#multiviews">"Vues + multiples" (MultiViews) d'un contenu négocié</a>.</p> + </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="#examples">Exemples de configuration</a></li> +</ul><h3>Voir aussi</h3> +<ul class="seealso"> +<li><code class="directive"><a href="../mod/mod_authz_core.html#require">Require</a></code></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 de configuration</a></h2> + + <h3><a name="examples.file-owner" id="examples.file-owner">Require file-owner</a></h3> + <p>Considérons un serveur Web Apache fonctionnant sous un système + multi-utilisateurs, où les fichiers de chaque utilisateur sont + stockés dans <code>~/public_html/private</code>. En supposant + qu'il n'existe qu'une seule base de données contenant les noms + d'utilisateurs web, et que ces noms d'utilisateurs correspondent + aux noms d'utilisateurs système qui sont les propriétaires + effectifs des fichiers, la configuration de l'exemple suivant + n'accordera l'autorisation d'accès aux fichiers qu'à leur + propriétaire. L'utilisateur <code>jones</code> ne sera pas + autorisé à accéder aux fichiers situés dans + <code>/home/smith/public_html/private</code>, à moins que leur + propriétaire ne soit <code>jones</code> au lieu de + <code>smith</code>.</p> + + <div class="example"><p><code> + <Directory /home/*/public_html/private><br /> + <span class="indent"> + AuthType Basic<br /> + AuthName mes-fichiers-prive<br /> + AuthBasicProvider dbm<br /> + AuthDBMUserFile /usr/local/apache2/etc/.htdbm-all<br /> + Require file-owner<br /> + </span> + </Directory> + </code></p></div> + + + <h3><a name="examples.file-group" id="examples.file-group">Require file-group</a></h3> + <p>Considérons un système similaire à celui décrit ci-dessus, mais + où certains utilisateurs partagent leurs fichiers de projets dans + <code>~/public_html/project-foo</code>. Le groupe système des + fichiers est <code>foo</code>, et il n'existe qu'une seule base de + données <code class="directive"><a href="../mod/mod_authz_dbm.html#authdbmgroupfile">AuthDBMGroupFile</a></code> qui contient + tous les noms d'utilisateurs web et leurs groupes d'appartenance. + Ces noms d'utilisateurs web doivent alors appartenir au moins au + groupe <code>foo</code>. En d'autres termes, si <code>jones</code> + et <code>smith</code> sont tous deux membres du groupe + <code>foo</code>, ils seront autorisés à accéder aux + répertoires <code>project-foo</code> de chacun d'entre eux.</p> + + <div class="example"><p><code> + <Directory /home/*/public_html/project-foo><br /> + <span class="indent"> + AuthType Basic<br /> + AuthName "Project Foo Files"<br /> + AuthBasicProvider dbm<br /> + <br /> + # combined user/group database<br /> + AuthDBMUserFile /usr/local/apache2/etc/.htdbm-all<br /> + AuthDBMGroupFile /usr/local/apache2/etc/.htdbm-all<br /> + <br /> + Satisfy All<br /> + Require file-group<br /> + </span> + </Directory> + </code></p></div> + +</div> +</div> +<div class="bottomlang"> +<p><span>Langues Disponibles: </span><a href="../en/mod/mod_authz_owner.html" hreflang="en" rel="alternate" title="English"> en </a> | +<a href="../fr/mod/mod_authz_owner.html" title="Français"> fr </a> | +<a href="../ja/mod/mod_authz_owner.html" hreflang="ja" rel="alternate" title="Japanese"> ja </a> | +<a href="../ko/mod/mod_authz_owner.html" hreflang="ko" rel="alternate" title="Korean"> ko </a></p> +</div><div id="footer"> +<p class="apache">Copyright 2009 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="../faq/">FAQ</a> | <a href="../glossary.html">Glossaire</a> | <a href="../sitemap.html">Plan du site</a></p></div> +</body></html>
\ No newline at end of file diff --git a/docs/manual/mod/mod_authz_owner.xml.fr b/docs/manual/mod/mod_authz_owner.xml.fr new file mode 100644 index 0000000000..914e5171e9 --- /dev/null +++ b/docs/manual/mod/mod_authz_owner.xml.fr @@ -0,0 +1,146 @@ +<?xml version="1.0"?> +<!DOCTYPE modulesynopsis SYSTEM "../style/modulesynopsis.dtd"> +<?xml-stylesheet type="text/xsl" href="../style/manual.fr.xsl"?> +<!-- English Revision : 574882 --> +<!-- 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_owner.xml.meta"> + +<name>mod_authz_owner</name> +<description>Autorisation basée sur l'appartenance des +fichiers</description> +<status>Extension</status> +<sourcefile>mod_authz_owner.c</sourcefile> +<identifier>authz_owner_module</identifier> +<compatibility>Disponible depuis les versions 2.1 et supérieures +d'Apache</compatibility> + +<summary> + <p>Ce module permet de contrôler l'accès aux fichiers en comparant + l'identifiant utilisateur ayant servi à l'authentification HTTP + (l'identifiant utilisateur web) avec le propriétaire ou le groupe + du fichier demandé du point de vue du système de fichiers. Le nom + d'utilisateur et le mot de passe doivent déjà avoir été vérifiés par + un module d'authentification comme <module>mod_auth_basic</module> + ou <module>mod_auth_digest</module>. + <module>mod_authz_owner</module> reconnaît deux arguments pour la + directive <directive module="core">Require</directive> : + <code>file-owner</code> et <code>file-group</code> :</p> + + <dl> + <dt><code>file-owner</code></dt> + <dd>Le nom d'utilisateur web utilisé pour l'authentification doit + correspondre au nom système du propriétaire du fichier demandé. En + d'autres termes, si le système indique <code>jones</code> comme + propriétaire du fichier demandé, le nom d'utilisateur fourni pour + l'authentification HTTP doit aussi être <code>jones</code>.</dd> + + <dt><code>file-group</code></dt> + <dd>Le nom du groupe système du fichier demandé doit être présent + dans une base de données de groupes fournie, par exemple, par + <module>mod_authz_groupfile</module> ou + <module>mod_authz_dbm</module>, et le nom d'utilisateur web fourni + pour l'authentification doit être un membre de ce groupe. Par + exemple, si le système indique que le groupe (système) du fichier + demandé est <code>accounts</code>, le groupe <code>accounts</code> + doit apparaître dans la base de données des groupes, et le nom + d'utilisateur web utilisé pour l'authentification doit être un + membre de ce groupe.</dd> + </dl> + + <note><title>Note</title> + <p>Si le module <module>mod_authz_owner</module> est utilisé pour + vérifier l'autorisation d'accès à une ressource qui n'est pas + vraiment présente dans le système de fichiers (en d'autres termes + une ressource virtuelle), il refusera l'accès.</p> + + <p>En particulier, il n'accordera jamais l'accès à une ressource + du type <a href="../content-negotiation.html#multiviews">"Vues + multiples" (MultiViews) d'un contenu négocié</a>.</p> + </note> +</summary> +<seealso><directive module="mod_authz_core">Require</directive></seealso> + +<section id="examples"><title>Exemples de configuration</title> + + <section id="examples.file-owner"><title>Require file-owner</title> + <p>Considérons un serveur Web Apache fonctionnant sous un système + multi-utilisateurs, où les fichiers de chaque utilisateur sont + stockés dans <code>~/public_html/private</code>. En supposant + qu'il n'existe qu'une seule base de données contenant les noms + d'utilisateurs web, et que ces noms d'utilisateurs correspondent + aux noms d'utilisateurs système qui sont les propriétaires + effectifs des fichiers, la configuration de l'exemple suivant + n'accordera l'autorisation d'accès aux fichiers qu'à leur + propriétaire. L'utilisateur <code>jones</code> ne sera pas + autorisé à accéder aux fichiers situés dans + <code>/home/smith/public_html/private</code>, à moins que leur + propriétaire ne soit <code>jones</code> au lieu de + <code>smith</code>.</p> + + <example> + <Directory /home/*/public_html/private><br /> + <indent> + AuthType Basic<br /> + AuthName mes-fichiers-prive<br /> + AuthBasicProvider dbm<br /> + AuthDBMUserFile /usr/local/apache2/etc/.htdbm-all<br /> + Require file-owner<br /> + </indent> + </Directory> + </example> + </section> + + <section id="examples.file-group"><title>Require file-group</title> + <p>Considérons un système similaire à celui décrit ci-dessus, mais + où certains utilisateurs partagent leurs fichiers de projets dans + <code>~/public_html/project-foo</code>. Le groupe système des + fichiers est <code>foo</code>, et il n'existe qu'une seule base de + données <directive + module="mod_authz_dbm">AuthDBMGroupFile</directive> qui contient + tous les noms d'utilisateurs web et leurs groupes d'appartenance. + Ces noms d'utilisateurs web doivent alors appartenir au moins au + groupe <code>foo</code>. En d'autres termes, si <code>jones</code> + et <code>smith</code> sont tous deux membres du groupe + <code>foo</code>, ils seront autorisés à accéder aux + répertoires <code>project-foo</code> de chacun d'entre eux.</p> + + <example> + <Directory /home/*/public_html/project-foo><br /> + <indent> + AuthType Basic<br /> + AuthName "Project Foo Files"<br /> + AuthBasicProvider dbm<br /> + <br /> + # combined user/group database<br /> + AuthDBMUserFile /usr/local/apache2/etc/.htdbm-all<br /> + AuthDBMGroupFile /usr/local/apache2/etc/.htdbm-all<br /> + <br /> + Satisfy All<br /> + Require file-group<br /> + </indent> + </Directory> + </example> + </section> +</section> + +</modulesynopsis> diff --git a/docs/manual/mod/mod_authz_owner.xml.meta b/docs/manual/mod/mod_authz_owner.xml.meta index 4c449c23ff..949ea64125 100644 --- a/docs/manual/mod/mod_authz_owner.xml.meta +++ b/docs/manual/mod/mod_authz_owner.xml.meta @@ -8,6 +8,7 @@ <variants> <variant>en</variant> + <variant>fr</variant> <variant>ja</variant> <variant outdated="yes">ko</variant> </variants> diff --git a/docs/manual/mod/mod_authz_user.html b/docs/manual/mod/mod_authz_user.html index e0ec3cc654..82294b4184 100644 --- a/docs/manual/mod/mod_authz_user.html +++ b/docs/manual/mod/mod_authz_user.html @@ -4,6 +4,10 @@ URI: mod_authz_user.html.en Content-Language: en Content-type: text/html; charset=ISO-8859-1 +URI: mod_authz_user.html.fr +Content-Language: fr +Content-type: text/html; charset=ISO-8859-1 + URI: mod_authz_user.html.ja.utf8 Content-Language: ja Content-type: text/html; charset=UTF-8 diff --git a/docs/manual/mod/mod_authz_user.html.en b/docs/manual/mod/mod_authz_user.html.en index 63c6f25b51..efc912c3e2 100644 --- a/docs/manual/mod/mod_authz_user.html.en +++ b/docs/manual/mod/mod_authz_user.html.en @@ -22,6 +22,7 @@ <div id="preamble"><h1>Apache Module mod_authz_user</h1> <div class="toplang"> <p><span>Available Languages: </span><a href="../en/mod/mod_authz_user.html" title="English"> en </a> | +<a href="../fr/mod/mod_authz_user.html" hreflang="fr" rel="alternate" title="Français"> fr </a> | <a href="../ja/mod/mod_authz_user.html" hreflang="ja" rel="alternate" title="Japanese"> ja </a> | <a href="../ko/mod/mod_authz_user.html" hreflang="ko" rel="alternate" title="Korean"> ko </a></p> </div> @@ -50,6 +51,7 @@ </div> <div class="bottomlang"> <p><span>Available Languages: </span><a href="../en/mod/mod_authz_user.html" title="English"> en </a> | +<a href="../fr/mod/mod_authz_user.html" hreflang="fr" rel="alternate" title="Français"> fr </a> | <a href="../ja/mod/mod_authz_user.html" hreflang="ja" rel="alternate" title="Japanese"> ja </a> | <a href="../ko/mod/mod_authz_user.html" hreflang="ko" rel="alternate" title="Korean"> ko </a></p> </div><div id="footer"> diff --git a/docs/manual/mod/mod_authz_user.html.fr b/docs/manual/mod/mod_authz_user.html.fr new file mode 100644 index 0000000000..73f6a00039 --- /dev/null +++ b/docs/manual/mod/mod_authz_user.html.fr @@ -0,0 +1,61 @@ +<?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_user - 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 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="../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.3</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.3</a> > <a href="./">Modules</a></div> +<div id="page-content"> +<div id="preamble"><h1>Module Apache mod_authz_user</h1> +<div class="toplang"> +<p><span>Langues Disponibles: </span><a href="../en/mod/mod_authz_user.html" hreflang="en" rel="alternate" title="English"> en </a> | +<a href="../fr/mod/mod_authz_user.html" title="Français"> fr </a> | +<a href="../ja/mod/mod_authz_user.html" hreflang="ja" rel="alternate" title="Japanese"> ja </a> | +<a href="../ko/mod/mod_authz_user.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>Autorisation basée sur l'utilisateur</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_user_module</td></tr> +<tr><th><a href="module-dict.html#SourceFile">Fichier Source:</a></th><td>mod_authz_user.c</td></tr> +<tr><th><a href="module-dict.html#Compatibility">Compatibilité:</a></th><td>Disponible depuis les versions 2.1 et supérieures +d'Apache</td></tr></table> +<h3>Sommaire</h3> + + <p>Ce module permet d'accorder ou de refuser l'accès à certaines + zones du site web aux utilisateurs authentifiés. + <code class="module"><a href="../mod/mod_authz_user.html">mod_authz_user</a></code> accorde l'accès si l'utilisateur + authentifié fait partie de la liste spécifiée par une directive + <code>Require user</code>. On peut aussi utiliser la directive + <code>Require valid-user</code> pour accorder l'accès à tous les + utilisateurs qui ont été authentifiés avec succès.</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="directive"><a href="../mod/mod_authz_core.html#require">Require</a></code></li> +</ul></div> + +</div> +<div class="bottomlang"> +<p><span>Langues Disponibles: </span><a href="../en/mod/mod_authz_user.html" hreflang="en" rel="alternate" title="English"> en </a> | +<a href="../fr/mod/mod_authz_user.html" title="Français"> fr </a> | +<a href="../ja/mod/mod_authz_user.html" hreflang="ja" rel="alternate" title="Japanese"> ja </a> | +<a href="../ko/mod/mod_authz_user.html" hreflang="ko" rel="alternate" title="Korean"> ko </a></p> +</div><div id="footer"> +<p class="apache">Copyright 2009 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="../faq/">FAQ</a> | <a href="../glossary.html">Glossaire</a> | <a href="../sitemap.html">Plan du site</a></p></div> +</body></html>
\ No newline at end of file diff --git a/docs/manual/mod/mod_authz_user.xml.fr b/docs/manual/mod/mod_authz_user.xml.fr new file mode 100644 index 0000000000..05b3a6ef31 --- /dev/null +++ b/docs/manual/mod/mod_authz_user.xml.fr @@ -0,0 +1,46 @@ +<?xml version="1.0"?> +<!DOCTYPE modulesynopsis SYSTEM "../style/modulesynopsis.dtd"> +<?xml-stylesheet type="text/xsl" href="../style/manual.fr.xsl"?> +<!-- English Revision : 635137 --> +<!-- 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_user.xml.meta"> + +<name>mod_authz_user</name> +<description>Autorisation basée sur l'utilisateur</description> +<status>Base</status> +<sourcefile>mod_authz_user.c</sourcefile> +<identifier>authz_user_module</identifier> +<compatibility>Disponible depuis les versions 2.1 et supérieures +d'Apache</compatibility> + +<summary> + <p>Ce module permet d'accorder ou de refuser l'accès à certaines + zones du site web aux utilisateurs authentifiés. + <module>mod_authz_user</module> accorde l'accès si l'utilisateur + authentifié fait partie de la liste spécifiée par une directive + <code>Require user</code>. On peut aussi utiliser la directive + <code>Require valid-user</code> pour accorder l'accès à tous les + utilisateurs qui ont été authentifiés avec succès.</p> +</summary> +<seealso><directive module="mod_authz_core">Require</directive></seealso> + +</modulesynopsis> diff --git a/docs/manual/mod/mod_authz_user.xml.meta b/docs/manual/mod/mod_authz_user.xml.meta index 5b8a9fca59..dd1e0c706e 100644 --- a/docs/manual/mod/mod_authz_user.xml.meta +++ b/docs/manual/mod/mod_authz_user.xml.meta @@ -8,6 +8,7 @@ <variants> <variant>en</variant> + <variant>fr</variant> <variant>ja</variant> <variant outdated="yes">ko</variant> </variants> diff --git a/docs/manual/mod/mod_buffer.html b/docs/manual/mod/mod_buffer.html index e427e44f19..8f90c41661 100644 --- a/docs/manual/mod/mod_buffer.html +++ b/docs/manual/mod/mod_buffer.html @@ -3,3 +3,7 @@ URI: mod_buffer.html.en Content-Language: en Content-type: text/html; charset=ISO-8859-1 + +URI: mod_buffer.html.fr +Content-Language: fr +Content-type: text/html; charset=ISO-8859-1 diff --git a/docs/manual/mod/mod_buffer.html.en b/docs/manual/mod/mod_buffer.html.en index 60ea0f20c9..d565745e31 100644 --- a/docs/manual/mod/mod_buffer.html.en +++ b/docs/manual/mod/mod_buffer.html.en @@ -21,7 +21,8 @@ <div id="page-content"> <div id="preamble"><h1>Apache Module mod_buffer</h1> <div class="toplang"> -<p><span>Available Languages: </span><a href="../en/mod/mod_buffer.html" title="English"> en </a></p> +<p><span>Available Languages: </span><a href="../en/mod/mod_buffer.html" title="English"> en </a> | +<a href="../fr/mod/mod_buffer.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>Support for request buffering</td></tr> <tr><th><a href="module-dict.html#Status">Status:</a></th><td>Extension</td></tr> @@ -94,7 +95,8 @@ </div> </div> <div class="bottomlang"> -<p><span>Available Languages: </span><a href="../en/mod/mod_buffer.html" title="English"> en </a></p> +<p><span>Available Languages: </span><a href="../en/mod/mod_buffer.html" title="English"> en </a> | +<a href="../fr/mod/mod_buffer.html" hreflang="fr" rel="alternate" title="Français"> fr </a></p> </div><div id="footer"> <p class="apache">Copyright 2009 The Apache Software Foundation.<br />Licensed under the <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="../faq/">FAQ</a> | <a href="../glossary.html">Glossary</a> | <a href="../sitemap.html">Sitemap</a></p></div> diff --git a/docs/manual/mod/mod_buffer.html.fr b/docs/manual/mod/mod_buffer.html.fr new file mode 100644 index 0000000000..7053daa81a --- /dev/null +++ b/docs/manual/mod/mod_buffer.html.fr @@ -0,0 +1,106 @@ +<?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_buffer - 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 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="../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.3</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.3</a> > <a href="./">Modules</a></div> +<div id="page-content"> +<div id="preamble"><h1>Module Apache mod_buffer</h1> +<div class="toplang"> +<p><span>Langues Disponibles: </span><a href="../en/mod/mod_buffer.html" hreflang="en" rel="alternate" title="English"> en </a> | +<a href="../fr/mod/mod_buffer.html" title="Français"> fr </a></p> +</div> +<table class="module"><tr><th><a href="module-dict.html#Description">Description:</a></th><td>Support de la mise en tampon des requêtes</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>buffer_module</td></tr> +<tr><th><a href="module-dict.html#SourceFile">Fichier Source:</a></th><td>mod_buffer.c</td></tr> +<tr><th><a href="module-dict.html#Compatibility">Compatibilité:</a></th><td>Disponible depuis les versions 2.3 et supérieures +d'Apache</td></tr></table> +<h3>Sommaire</h3> + + <p>Ce module fournit la possibilité de mettre en tampon les piles + des filtres en entrée et sortie.</p> + + <p>Dans certaines situations, les générateurs de contenu créent des + contenus composés de petits tronçons. Afin de permettre la + réutilisation de la mémoire, les éléments de mémoire attribués aux + tronçons ont toujours une taille de 8k, quelle que soit la taille du + tronçon lui-même. Lorsqu'une requête génère de nombreux petits + tronçons, une grande quantité de mémoire peut être mobilisée par le + traitement de la requête, et une grande quantité de données + transmises sans nécessité. Pour y remédier, l'utilisation d'un + tampon rassemble la réponse en un nombre de tronçons le plus petit + possible.</p> + + <p>Lorsque httpd est utilisé comme frontal d'un générateur de + contenu consommant beaucoup de ressources, la mise en tampon de la + réponse peut permettre à ce dernier d'effectuer le traitement et de + libérer les ressources plus ou moins rapidement, en fonction de la + manière dont il a été conçu.</p> + + <p>Le filtre de mise en tampon peut être ajouté aux piles des + filtres en entrée ou en sortie, selon les besoins, à l'aide des + directives <code class="directive"><a href="../mod/core.html#setinputfilter">SetInputFilter</a></code>, + <code class="directive"><a href="../mod/core.html#setoutputfilter">SetOutputFilter</a></code>, <code class="directive"><a href="../mod/mod_mime.html#addoutputfilter">AddOutputFilter</a></code> ou <code class="directive"><a href="../mod/core.html#addoutputfilterbytype">AddOutputFilterByType</a></code>.</p> + + <div class="example"><h3>Utilisation d'un tampon avec mod_include</h3><p><code> + AddOutputFilterByType INCLUDES;BUFFER text/html<br /> + </code></p></div> + + <div class="warning">Les filtres de mise en tampon lisent la + requête/réponse en RAM, puis la reconditionnent sous la forme d'un + nombre d'éléments mémoire le plus petit possible, au prix d'une + consommation de temps CPU. Lorsque la requête/réponse est déjà + conditionnée de manière satisfaisante, sa mise en tampon pourrait + s'avérer encore plus lente qu'en l'absence d'utilisation de tampon. + C'est pourquoi ces filtres doivent être utilisés avec précautions, + et seulement si nécessaire.</div> + +</div> +<div id="quickview"><h3 class="directives">Directives</h3> +<ul id="toc"> +<li><img alt="" src="../images/down.gif" /> <a href="#buffersize">BufferSize</a></li> +</ul> +<h3>Voir aussi</h3> +<ul class="seealso"> +<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="BufferSize" id="BufferSize">BufferSize</a> <a name="buffersize" id="buffersize">Directive</a></h2> +<table class="directive"> +<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Taille maximale en octets du filtre par tampon</td></tr> +<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>BufferSize entier</code></td></tr> +<tr><th><a href="directive-dict.html#Default">Défaut:</a></th><td><code>BufferSize 131072</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>Extension</td></tr> +<tr><th><a href="directive-dict.html#Module">Module:</a></th><td>mod_buffer</td></tr> +</table> + <p>La directive <code class="directive"><a href="#buffersize">BufferSize</a></code> permet de spécifier la + quantité de données en octets qui sera mise en tampon avant d'être + lue depuis ou écrite vers chaque requête. La valeur par défaut est + 128 ko.</p> + +</div> +</div> +<div class="bottomlang"> +<p><span>Langues Disponibles: </span><a href="../en/mod/mod_buffer.html" hreflang="en" rel="alternate" title="English"> en </a> | +<a href="../fr/mod/mod_buffer.html" title="Français"> fr </a></p> +</div><div id="footer"> +<p class="apache">Copyright 2009 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="../faq/">FAQ</a> | <a href="../glossary.html">Glossaire</a> | <a href="../sitemap.html">Plan du site</a></p></div> +</body></html>
\ No newline at end of file diff --git a/docs/manual/mod/mod_buffer.xml.fr b/docs/manual/mod/mod_buffer.xml.fr new file mode 100644 index 0000000000..4fe8e5da1d --- /dev/null +++ b/docs/manual/mod/mod_buffer.xml.fr @@ -0,0 +1,99 @@ +<?xml version="1.0"?> +<!DOCTYPE modulesynopsis SYSTEM "../style/modulesynopsis.dtd"> +<?xml-stylesheet type="text/xsl" href="../style/manual.fr.xsl"?> +<!-- English Revision : 718086 --> +<!-- 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_buffer.xml.meta"> + +<name>mod_buffer</name> +<description>Support de la mise en tampon des requêtes</description> +<status>Extension</status> +<sourcefile>mod_buffer.c</sourcefile> +<identifier>buffer_module</identifier> +<compatibility>Disponible depuis les versions 2.3 et supérieures +d'Apache</compatibility> + +<summary> + <p>Ce module fournit la possibilité de mettre en tampon les piles + des filtres en entrée et sortie.</p> + + <p>Dans certaines situations, les générateurs de contenu créent des + contenus composés de petits tronçons. Afin de permettre la + réutilisation de la mémoire, les éléments de mémoire attribués aux + tronçons ont toujours une taille de 8k, quelle que soit la taille du + tronçon lui-même. Lorsqu'une requête génère de nombreux petits + tronçons, une grande quantité de mémoire peut être mobilisée par le + traitement de la requête, et une grande quantité de données + transmises sans nécessité. Pour y remédier, l'utilisation d'un + tampon rassemble la réponse en un nombre de tronçons le plus petit + possible.</p> + + <p>Lorsque httpd est utilisé comme frontal d'un générateur de + contenu consommant beaucoup de ressources, la mise en tampon de la + réponse peut permettre à ce dernier d'effectuer le traitement et de + libérer les ressources plus ou moins rapidement, en fonction de la + manière dont il a été conçu.</p> + + <p>Le filtre de mise en tampon peut être ajouté aux piles des + filtres en entrée ou en sortie, selon les besoins, à l'aide des + directives <directive module="core">SetInputFilter</directive>, + <directive module="core">SetOutputFilter</directive>, <directive + module="mod_mime">AddOutputFilter</directive> ou <directive + module="core">AddOutputFilterByType</directive>.</p> + + <example><title>Utilisation d'un tampon avec mod_include</title> + AddOutputFilterByType INCLUDES;BUFFER text/html<br /> + </example> + + <note type="warning">Les filtres de mise en tampon lisent la + requête/réponse en RAM, puis la reconditionnent sous la forme d'un + nombre d'éléments mémoire le plus petit possible, au prix d'une + consommation de temps CPU. Lorsque la requête/réponse est déjà + conditionnée de manière satisfaisante, sa mise en tampon pourrait + s'avérer encore plus lente qu'en l'absence d'utilisation de tampon. + C'est pourquoi ces filtres doivent être utilisés avec précautions, + et seulement si nécessaire.</note> + +</summary> +<seealso><a href="../filter.html">Les filtres</a></seealso> + +<directivesynopsis> +<name>BufferSize</name> +<description>Taille maximale en octets du filtre par tampon</description> +<syntax>BufferSize entier</syntax> +<default>BufferSize 131072</default> +<contextlist><context>server config</context> +<context>virtual host</context> +<context>directory</context> +<context>.htaccess</context> +</contextlist> + +<usage> + <p>La directive <directive + module="mod_buffer">BufferSize</directive> permet de spécifier la + quantité de données en octets qui sera mise en tampon avant d'être + lue depuis ou écrite vers chaque requête. La valeur par défaut est + 128 ko.</p> +</usage> +</directivesynopsis> + +</modulesynopsis> diff --git a/docs/manual/mod/mod_buffer.xml.meta b/docs/manual/mod/mod_buffer.xml.meta index 8b2eb8efd8..7e26364e54 100644 --- a/docs/manual/mod/mod_buffer.xml.meta +++ b/docs/manual/mod/mod_buffer.xml.meta @@ -8,5 +8,6 @@ <variants> <variant>en</variant> + <variant>fr</variant> </variants> </metafile> diff --git a/docs/manual/mod/mod_dir.html.fr b/docs/manual/mod/mod_dir.html.fr index 5092791bde..f3d2d29e3e 100644 --- a/docs/manual/mod/mod_dir.html.fr +++ b/docs/manual/mod/mod_dir.html.fr @@ -59,38 +59,13 @@ de répertoire</td></tr> </div> <div id="quickview"><h3 class="directives">Directives</h3> <ul id="toc"> -<li><img alt="" src="../images/down.gif" /> <a href="#defaultmapping">DefaultMapping</a></li> <li><img alt="" src="../images/down.gif" /> <a href="#directoryindex">DirectoryIndex</a></li> <li><img alt="" src="../images/down.gif" /> <a href="#directoryslash">DirectorySlash</a></li> +<li><img alt="" src="../images/down.gif" /> <a href="#fallbackresource">FallbackResource</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="DefaultMapping" id="DefaultMapping">DefaultMapping</a> <a name="defaultmapping" id="defaultmapping">Directive</a></h2> -<table class="directive"> -<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Définit une URL par défaut pour les requêtes qui ne ciblent -aucun fichier</td></tr> -<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>DefaultMapping <var>url-locale</var></code></td></tr> -<tr><th><a href="directive-dict.html#Default">Défaut:</a></th><td><code>Aucune - httpd renvoie un code d'erreur 404 (Not Found)</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">Annuler:</a></th><td>Indexes</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_dir</td></tr> -</table> - <p>Cette directive permet de définir un traitement pour toute URL - qui ne correspond à aucune ressource de votre système de fichiers, - et qui provoquerait sans cela l'envoi d'un code d'erreur HTTP 404 - (Not Found). - Par exemple</p> - <div class="example"><p><code> - <code>DefaultMapping default.php</code> - </code></p></div> - <p>fait en sorte que les requêtes ne correspondant à aucun fichier - soient traitées par <code>default.php</code>, sans affecter les - requêtes pour des fichiers existants.</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="DirectoryIndex" id="DirectoryIndex">DirectoryIndex</a> <a name="directoryindex" id="directoryindex">Directive</a></h2> <table class="directive"> <tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Liste des fichiers ressources à rechercher lorsque le @@ -210,6 +185,46 @@ d'Apache</td></tr> </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="FallbackResource" id="FallbackResource">FallbackResource</a> <a name="fallbackresource" id="fallbackresource">Directive</a></h2> +<table class="directive"> +<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Définit une URL par défaut pour les requêtes qui ne ciblent +aucun fichier</td></tr> +<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>FallbackResource <var>url-locale</var></code></td></tr> +<tr><th><a href="directive-dict.html#Default">Défaut:</a></th><td><code>Aucune - httpd renvoie un code d'erreur 404 (Not Found)</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">Annuler:</a></th><td>Indexes</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_dir</td></tr> +</table> + <p>Cette directive permet de définir un traitement pour toute URL + qui ne correspond à aucune ressource de votre système de fichiers, + et qui provoquerait sans cela l'envoi d'un code d'erreur HTTP 404 + (Not Found). + Par exemple</p> + <div class="example"><p><code> + <code>FallbackResource non-404.php</code> + </code></p></div> + <p>fait en sorte que les requêtes ne correspondant à aucun fichier + soient traitées par <code>non-404.php</code>, sans affecter les + requêtes pour des fichiers existants.</p> + <p>Il est souvent souhaitable qu'un seul fichier ou ressource traite + toutes les requêtes à destination d'un répertoire + particulier, sauf pour les requêtes qui correspondent à un fichier + ou script existant. On y fait souvent référence sous le terme + 'contrôleur frontal'.</p> + <p>Dans les versions plus anciennes de httpd, cet effet nécessitait + en général <code class="module"><a href="../mod/mod_rewrite.html">mod_rewrite</a></code>, et l'utilisation des tests + conditionnels <code>-f</code> et <code>-d</code> pour vérifier + l'existence des fichiers et répertoires. Maintenant, une seule ligne + de configuration est nécessaire.</p> + <div class="example"><p><code> + <code>FallbackResource index.php</code> + </code></p></div> + <p>Les fichiers existants comme des images, des fichiers css, etc... + seront traités normalement.</p> + +</div> </div> <div class="bottomlang"> <p><span>Langues Disponibles: </span><a href="../en/mod/mod_dir.html" hreflang="en" rel="alternate" title="English"> en </a> | diff --git a/docs/manual/mod/mod_dir.xml.fr b/docs/manual/mod/mod_dir.xml.fr index 0a5e538acb..7e1d80d147 100644 --- a/docs/manual/mod/mod_dir.xml.fr +++ b/docs/manual/mod/mod_dir.xml.fr @@ -1,7 +1,7 @@ <?xml version="1.0"?> <!DOCTYPE modulesynopsis SYSTEM "../style/modulesynopsis.dtd"> <?xml-stylesheet type="text/xsl" href="../style/manual.fr.xsl"?> -<!-- English Revision : 795450 --> +<!-- English Revision : 815782 --> <!-- French translation : Lucien GENTIS --> <!-- Reviewed by : Vincent Deffontaines --> @@ -178,10 +178,10 @@ d'Apache</compatibility> </usage> </directivesynopsis> <directivesynopsis> -<name>DefaultMapping</name> +<name>FallbackResource</name> <description>Définit une URL par défaut pour les requêtes qui ne ciblent aucun fichier</description> -<syntax>DefaultMapping <var>url-locale</var></syntax> +<syntax>FallbackResource <var>url-locale</var></syntax> <default>Aucune - httpd renvoie un code d'erreur 404 (Not Found)</default> <contextlist><context>server config</context><context>virtual host</context> <context>directory</context><context>.htaccess</context></contextlist> @@ -193,11 +193,26 @@ aucun fichier</description> (Not Found). Par exemple</p> <example> - <code>DefaultMapping default.php</code> + <code>FallbackResource non-404.php</code> </example> <p>fait en sorte que les requêtes ne correspondant à aucun fichier - soient traitées par <code>default.php</code>, sans affecter les + soient traitées par <code>non-404.php</code>, sans affecter les requêtes pour des fichiers existants.</p> + <p>Il est souvent souhaitable qu'un seul fichier ou ressource traite + toutes les requêtes à destination d'un répertoire + particulier, sauf pour les requêtes qui correspondent à un fichier + ou script existant. On y fait souvent référence sous le terme + 'contrôleur frontal'.</p> + <p>Dans les versions plus anciennes de httpd, cet effet nécessitait + en général <module>mod_rewrite</module>, et l'utilisation des tests + conditionnels <code>-f</code> et <code>-d</code> pour vérifier + l'existence des fichiers et répertoires. Maintenant, une seule ligne + de configuration est nécessaire.</p> + <example> + <code>FallbackResource index.php</code> + </example> + <p>Les fichiers existants comme des images, des fichiers css, etc... + seront traités normalement.</p> </usage> </directivesynopsis> diff --git a/docs/manual/mod/mod_disk_cache.html b/docs/manual/mod/mod_disk_cache.html index 614907d5ce..7d9c1d0a58 100644 --- a/docs/manual/mod/mod_disk_cache.html +++ b/docs/manual/mod/mod_disk_cache.html @@ -4,6 +4,10 @@ URI: mod_disk_cache.html.en Content-Language: en Content-type: text/html; charset=ISO-8859-1 +URI: mod_disk_cache.html.fr +Content-Language: fr +Content-type: text/html; charset=ISO-8859-1 + URI: mod_disk_cache.html.ja.utf8 Content-Language: ja Content-type: text/html; charset=UTF-8 diff --git a/docs/manual/mod/mod_disk_cache.html.en b/docs/manual/mod/mod_disk_cache.html.en index 62f3916770..0b5d6e9010 100644 --- a/docs/manual/mod/mod_disk_cache.html.en +++ b/docs/manual/mod/mod_disk_cache.html.en @@ -22,6 +22,7 @@ <div id="preamble"><h1>Apache Module mod_disk_cache</h1> <div class="toplang"> <p><span>Available Languages: </span><a href="../en/mod/mod_disk_cache.html" title="English"> en </a> | +<a href="../fr/mod/mod_disk_cache.html" hreflang="fr" rel="alternate" title="Français"> fr </a> | <a href="../ja/mod/mod_disk_cache.html" hreflang="ja" rel="alternate" title="Japanese"> ja </a> | <a href="../ko/mod/mod_disk_cache.html" hreflang="ko" rel="alternate" title="Korean"> ko </a></p> </div> @@ -184,6 +185,7 @@ stored</td></tr> </div> <div class="bottomlang"> <p><span>Available Languages: </span><a href="../en/mod/mod_disk_cache.html" title="English"> en </a> | +<a href="../fr/mod/mod_disk_cache.html" hreflang="fr" rel="alternate" title="Français"> fr </a> | <a href="../ja/mod/mod_disk_cache.html" hreflang="ja" rel="alternate" title="Japanese"> ja </a> | <a href="../ko/mod/mod_disk_cache.html" hreflang="ko" rel="alternate" title="Korean"> ko </a></p> </div><div id="footer"> diff --git a/docs/manual/mod/mod_disk_cache.html.fr b/docs/manual/mod/mod_disk_cache.html.fr new file mode 100644 index 0000000000..4121363714 --- /dev/null +++ b/docs/manual/mod/mod_disk_cache.html.fr @@ -0,0 +1,205 @@ +<?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_disk_cache - 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 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="../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.3</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.3</a> > <a href="./">Modules</a></div> +<div id="page-content"> +<div id="preamble"><h1>Module Apache mod_disk_cache</h1> +<div class="toplang"> +<p><span>Langues Disponibles: </span><a href="../en/mod/mod_disk_cache.html" hreflang="en" rel="alternate" title="English"> en </a> | +<a href="../fr/mod/mod_disk_cache.html" title="Français"> fr </a> | +<a href="../ja/mod/mod_disk_cache.html" hreflang="ja" rel="alternate" title="Japanese"> ja </a> | +<a href="../ko/mod/mod_disk_cache.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>Gestionnaire de stockage du cache de contenu à base +d'URIs</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>disk_cache_module</td></tr> +<tr><th><a href="module-dict.html#SourceFile">Fichier Source:</a></th><td>mod_disk_cache.c</td></tr></table> +<h3>Sommaire</h3> + + <p><code class="module"><a href="../mod/mod_disk_cache.html">mod_disk_cache</a></code> implémente un gestionnaire de + stockage sur disque. Il s'utilise principalement avec + <code class="module"><a href="../mod/mod_cache.html">mod_cache</a></code>.</p> + + <p>Les contenus sont stockés dans le cache et extraits de ce dernier + en utilisant des clés à base d'URIs. Les contenus dont l'accès est + protégé ne sont pas mis en cache.</p> + + <p>Le programme <code class="program"><a href="../programs/htcacheclean.html">htcacheclean</a></code> permet de maintenir + la taille du cache à un niveau maximum.</p> + + <div class="note"><h3>Note :</h3> + <p><code class="module"><a href="../mod/mod_cache.html">mod_cache</a></code> doit être chargé pour que + <code class="module"><a href="../mod/mod_disk_cache.html">mod_disk_cache</a></code> puisse fonctionner.</p> + </div> + <p>Lorsque la plate-forme la supporte, et si elle est activée via la + directive <code class="directive"><a href="../mod/core.html#enablesendfile">EnableSendfile</a></code>, + <code class="module"><a href="../mod/mod_disk_cache.html">mod_disk_cache</a></code> utilise la fonctionnalité sendfile + pour servir les fichiers à partir du cache. Cependant, + <code class="module"><a href="../mod/mod_disk_cache.html">mod_disk_cache</a></code> ignore la configuration de la + directive <code class="directive"><a href="../mod/core.html#enablesendfile">EnableSendfile</a></code> dans + un contexte de répertoire ou de fichier .htaccess, car le module ne + dispose pas des définitions correspondantes lorsque la requête est + servie depuis le cache.</p> +</div> +<div id="quickview"><h3 class="directives">Directives</h3> +<ul id="toc"> +<li><img alt="" src="../images/down.gif" /> <a href="#cachedirlength">CacheDirLength</a></li> +<li><img alt="" src="../images/down.gif" /> <a href="#cachedirlevels">CacheDirLevels</a></li> +<li><img alt="" src="../images/down.gif" /> <a href="#cachemaxfilesize">CacheMaxFileSize</a></li> +<li><img alt="" src="../images/down.gif" /> <a href="#cacheminfilesize">CacheMinFileSize</a></li> +<li><img alt="" src="../images/down.gif" /> <a href="#cacheroot">CacheRoot</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="CacheDirLength" id="CacheDirLength">CacheDirLength</a> <a name="cachedirlength" id="cachedirlength">Directive</a></h2> +<table class="directive"> +<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Le nombre de caractères des noms des +sous-répertoires</td></tr> +<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>CacheDirLength <var>longueur</var></code></td></tr> +<tr><th><a href="directive-dict.html#Default">Défaut:</a></th><td><code>CacheDirLength 2</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_disk_cache</td></tr> +</table> + <p>la directive <code class="directive">CacheDirLength</code> permet de + définir le nombre de caractères que comportera chaque nom de + sous-répertoire de la hiérarchie du cache. On peut l'utiliser en + conjonction avec <code class="directive">CacheDirLevels</code> pour + déterminer une structure approximative de la hiérarchie de + cache.</p> + <p>Une valeur haute pour <code class="directive">CacheDirLength</code> + combinée avec une valeur basse pour + <code class="directive">CacheDirLevels</code> générera une hiérarchie + relativement peu profonde, avec un grand nombre de sous-répertoires + à chaque niveau.</p> + + <div class="note"> + <p>La valeur du produit <code class="directive">CacheDirLevels</code> * + <code class="directive"><a href="#cachedirlength">CacheDirLength</a></code> ne + doit pas dépasser 20.</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="CacheDirLevels" id="CacheDirLevels">CacheDirLevels</a> <a name="cachedirlevels" id="cachedirlevels">Directive</a></h2> +<table class="directive"> +<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Le nombre de niveaux de sous-répertoires que comportera le +cache.</td></tr> +<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>CacheDirLevels <var>niveaux</var></code></td></tr> +<tr><th><a href="directive-dict.html#Default">Défaut:</a></th><td><code>CacheDirLevels 2</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_disk_cache</td></tr> +</table> + <p>La directive <code class="directive">CacheDirLevels</code> permet de + définir le nombre de niveaux de sous-répertoires que comportera le + cache. Les données du cache seront stokées au niveau correspondant + par rapport au répertoire <code class="directive"><a href="#cacheroot">CacheRoot</a></code>.</p> + <p>Une valeur haute pour <code class="directive">CacheDirLevels</code> + combinée avec une valeur basse pour + <code class="directive">CacheDirLength</code> générera une arborescence + très développée, avec un petit nombre de sous-répertoires à chaque + niveau.</p> + + <div class="note"> + <p>La valeur du produit <code class="directive">CacheDirLevels</code> * + <code class="directive"><a href="#cachedirlength">CacheDirLength</a></code> ne + doit pas dépasser 20.</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="CacheMaxFileSize" id="CacheMaxFileSize">CacheMaxFileSize</a> <a name="cachemaxfilesize" id="cachemaxfilesize">Directive</a></h2> +<table class="directive"> +<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>>La taille maximale (en octets) d'un document pour pouvoir +être stocké dans le cache</td></tr> +<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>CacheMaxFileSize <var>octets</var></code></td></tr> +<tr><th><a href="directive-dict.html#Default">Défaut:</a></th><td><code>CacheMaxFileSize 1000000</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_disk_cache</td></tr> +</table> + <p>La directive <code class="directive">CacheMaxFileSize</code> permet de + définir la taille maximale d'un document, en octets, pour que + celui-ci puisse faire l'objet d'un stockage dans le cache.</p> + + <div class="example"><p><code> + CacheMaxFileSize 64000 + </code></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="CacheMinFileSize" id="CacheMinFileSize">CacheMinFileSize</a> <a name="cacheminfilesize" id="cacheminfilesize">Directive</a></h2> +<table class="directive"> +<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>La taille minimale (en octets) d'un document pour pouvoir +être stocké dans le cache</td></tr> +<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>CacheMinFileSize <var>octets</var></code></td></tr> +<tr><th><a href="directive-dict.html#Default">Défaut:</a></th><td><code>CacheMinFileSize 1</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_disk_cache</td></tr> +</table> + <p>La directive <code class="directive">CacheMinFileSize</code> permet de + définir la taille minimale d'un document, en octets, pour que + celui-ci puisse faire l'objet d'un stockage dans le cache.</p> + + <div class="example"><p><code> + CacheMinFileSize 64 + </code></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="CacheRoot" id="CacheRoot">CacheRoot</a> <a name="cacheroot" id="cacheroot">Directive</a></h2> +<table class="directive"> +<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>La racine du répertoire dans lequel les fichiers du cache +seront stockés</td></tr> +<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>CacheRoot <var>répertoire</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_disk_cache</td></tr> +</table> + <p>La directive <code class="directive">CacheRoot</code> permet de définir + le nom du répertoire sur disque qui contiendra les fichiers du + cache. Si le module <code class="module"><a href="../mod/mod_disk_cache.html">mod_disk_cache</a></code> a été chargé ou + compilé dans le serveur Apache, cette directive <em>doit</em> être + définie. L'absence de définition de la directive + <code class="directive">CacheRoot</code> provoquera une erreur de traitement + du fichier de configuration. Les directives <code class="directive"><a href="#cachedirlevels">CacheDirLevels</a></code> et <code class="directive"><a href="#cachedirlength">CacheDirLength</a></code> permettent de + définir la structure des sous-répertoires du répertoire racine + spécifié.</p> + + <div class="example"><p><code> + CacheRoot c:/cacheroot + </code></p></div> + +</div> +</div> +<div class="bottomlang"> +<p><span>Langues Disponibles: </span><a href="../en/mod/mod_disk_cache.html" hreflang="en" rel="alternate" title="English"> en </a> | +<a href="../fr/mod/mod_disk_cache.html" title="Français"> fr </a> | +<a href="../ja/mod/mod_disk_cache.html" hreflang="ja" rel="alternate" title="Japanese"> ja </a> | +<a href="../ko/mod/mod_disk_cache.html" hreflang="ko" rel="alternate" title="Korean"> ko </a></p> +</div><div id="footer"> +<p class="apache">Copyright 2009 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="../faq/">FAQ</a> | <a href="../glossary.html">Glossaire</a> | <a href="../sitemap.html">Plan du site</a></p></div> +</body></html>
\ No newline at end of file diff --git a/docs/manual/mod/mod_disk_cache.xml.fr b/docs/manual/mod/mod_disk_cache.xml.fr new file mode 100644 index 0000000000..60bc46234b --- /dev/null +++ b/docs/manual/mod/mod_disk_cache.xml.fr @@ -0,0 +1,189 @@ +<?xml version="1.0"?> +<!DOCTYPE modulesynopsis SYSTEM "../style/modulesynopsis.dtd"> +<?xml-stylesheet type="text/xsl" href="../style/manual.fr.xsl"?> +<!-- English Revision : 746668 --> +<!-- 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_disk_cache.xml.meta"> + +<name>mod_disk_cache</name> +<description>Gestionnaire de stockage du cache de contenu à base +d'URIs</description> +<status>Extension</status> +<sourcefile>mod_disk_cache.c</sourcefile> +<identifier>disk_cache_module</identifier> + +<summary> + <p><module>mod_disk_cache</module> implémente un gestionnaire de + stockage sur disque. Il s'utilise principalement avec + <module>mod_cache</module>.</p> + + <p>Les contenus sont stockés dans le cache et extraits de ce dernier + en utilisant des clés à base d'URIs. Les contenus dont l'accès est + protégé ne sont pas mis en cache.</p> + + <p>Le programme <program>htcacheclean</program> permet de maintenir + la taille du cache à un niveau maximum.</p> + + <note><title>Note :</title> + <p><module>mod_cache</module> doit être chargé pour que + <module>mod_disk_cache</module> puisse fonctionner.</p> + </note> + <p>Lorsque la plate-forme la supporte, et si elle est activée via la + directive <directive module="core">EnableSendfile</directive>, + <module>mod_disk_cache</module> utilise la fonctionnalité sendfile + pour servir les fichiers à partir du cache. Cependant, + <module>mod_disk_cache</module> ignore la configuration de la + directive <directive module="core">EnableSendfile</directive> dans + un contexte de répertoire ou de fichier .htaccess, car le module ne + dispose pas des définitions correspondantes lorsque la requête est + servie depuis le cache.</p> +</summary> + +<directivesynopsis> +<name>CacheRoot</name> +<description>La racine du répertoire dans lequel les fichiers du cache +seront stockés</description> +<syntax>CacheRoot <var>répertoire</var></syntax> +<contextlist><context>server config</context><context>virtual host</context> +</contextlist> + +<usage> + <p>La directive <directive>CacheRoot</directive> permet de définir + le nom du répertoire sur disque qui contiendra les fichiers du + cache. Si le module <module>mod_disk_cache</module> a été chargé ou + compilé dans le serveur Apache, cette directive <em>doit</em> être + définie. L'absence de définition de la directive + <directive>CacheRoot</directive> provoquera une erreur de traitement + du fichier de configuration. Les directives <directive + module="mod_disk_cache">CacheDirLevels</directive> et <directive + module="mod_disk_cache">CacheDirLength</directive> permettent de + définir la structure des sous-répertoires du répertoire racine + spécifié.</p> + + <example> + CacheRoot c:/cacheroot + </example> +</usage> +</directivesynopsis> + +<directivesynopsis> +<name>CacheDirLevels</name> +<description>Le nombre de niveaux de sous-répertoires que comportera le +cache.</description> +<syntax>CacheDirLevels <var>niveaux</var></syntax> +<default>CacheDirLevels 2</default> +<contextlist><context>server config</context><context>virtual host</context> +</contextlist> + +<usage> + <p>La directive <directive>CacheDirLevels</directive> permet de + définir le nombre de niveaux de sous-répertoires que comportera le + cache. Les données du cache seront stokées au niveau correspondant + par rapport au répertoire <directive module="mod_disk_cache" + >CacheRoot</directive>.</p> + <p>Une valeur haute pour <directive>CacheDirLevels</directive> + combinée avec une valeur basse pour + <directive>CacheDirLength</directive> générera une arborescence + très développée, avec un petit nombre de sous-répertoires à chaque + niveau.</p> + + <note> + <p>La valeur du produit <directive>CacheDirLevels</directive> * + <directive module="mod_disk_cache">CacheDirLength</directive> ne + doit pas dépasser 20.</p> + </note> + +</usage> +</directivesynopsis> + +<directivesynopsis> +<name>CacheDirLength</name> +<description>Le nombre de caractères des noms des +sous-répertoires</description> +<syntax>CacheDirLength <var>longueur</var></syntax> +<default>CacheDirLength 2</default> +<contextlist><context>server config</context><context>virtual host</context> +</contextlist> + +<usage> + <p>la directive <directive>CacheDirLength</directive> permet de + définir le nombre de caractères que comportera chaque nom de + sous-répertoire de la hiérarchie du cache. On peut l'utiliser en + conjonction avec <directive>CacheDirLevels</directive> pour + déterminer une structure approximative de la hiérarchie de + cache.</p> + <p>Une valeur haute pour <directive>CacheDirLength</directive> + combinée avec une valeur basse pour + <directive>CacheDirLevels</directive> générera une hiérarchie + relativement peu profonde, avec un grand nombre de sous-répertoires + à chaque niveau.</p> + + <note> + <p>La valeur du produit <directive>CacheDirLevels</directive> * + <directive module="mod_disk_cache">CacheDirLength</directive> ne + doit pas dépasser 20.</p> + </note> + +</usage> +</directivesynopsis> + +<directivesynopsis> +<name>CacheMinFileSize</name> +<description>La taille minimale (en octets) d'un document pour pouvoir +être stocké dans le cache</description> +<syntax>CacheMinFileSize <var>octets</var></syntax> +<default>CacheMinFileSize 1</default> +<contextlist><context>server config</context><context>virtual host</context> +</contextlist> + +<usage> + <p>La directive <directive>CacheMinFileSize</directive> permet de + définir la taille minimale d'un document, en octets, pour que + celui-ci puisse faire l'objet d'un stockage dans le cache.</p> + + <example> + CacheMinFileSize 64 + </example> +</usage> +</directivesynopsis> + +<directivesynopsis> +<name>CacheMaxFileSize</name> +<description>>La taille maximale (en octets) d'un document pour pouvoir +être stocké dans le cache</description> +<syntax>CacheMaxFileSize <var>octets</var></syntax> +<default>CacheMaxFileSize 1000000</default> +<contextlist><context>server config</context><context>virtual host</context> +</contextlist> + +<usage> + <p>La directive <directive>CacheMaxFileSize</directive> permet de + définir la taille maximale d'un document, en octets, pour que + celui-ci puisse faire l'objet d'un stockage dans le cache.</p> + + <example> + CacheMaxFileSize 64000 + </example> +</usage> +</directivesynopsis> + +</modulesynopsis> diff --git a/docs/manual/mod/mod_disk_cache.xml.meta b/docs/manual/mod/mod_disk_cache.xml.meta index c05ae2f84d..f2adf7a421 100644 --- a/docs/manual/mod/mod_disk_cache.xml.meta +++ b/docs/manual/mod/mod_disk_cache.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_echo.html b/docs/manual/mod/mod_echo.html index fb021cc78d..c10e97b491 100644 --- a/docs/manual/mod/mod_echo.html +++ b/docs/manual/mod/mod_echo.html @@ -4,6 +4,10 @@ URI: mod_echo.html.en Content-Language: en Content-type: text/html; charset=ISO-8859-1 +URI: mod_echo.html.fr +Content-Language: fr +Content-type: text/html; charset=ISO-8859-1 + URI: mod_echo.html.ja.utf8 Content-Language: ja Content-type: text/html; charset=UTF-8 diff --git a/docs/manual/mod/mod_echo.html.en b/docs/manual/mod/mod_echo.html.en index 2081f54c20..f1543892db 100644 --- a/docs/manual/mod/mod_echo.html.en +++ b/docs/manual/mod/mod_echo.html.en @@ -22,6 +22,7 @@ <div id="preamble"><h1>Apache Module mod_echo</h1> <div class="toplang"> <p><span>Available Languages: </span><a href="../en/mod/mod_echo.html" title="English"> en </a> | +<a href="../fr/mod/mod_echo.html" hreflang="fr" rel="alternate" title="Français"> fr </a> | <a href="../ja/mod/mod_echo.html" hreflang="ja" rel="alternate" title="Japanese"> ja </a> | <a href="../ko/mod/mod_echo.html" hreflang="ko" rel="alternate" title="Korean"> ko </a></p> </div> @@ -66,6 +67,7 @@ later.</td></tr> </div> <div class="bottomlang"> <p><span>Available Languages: </span><a href="../en/mod/mod_echo.html" title="English"> en </a> | +<a href="../fr/mod/mod_echo.html" hreflang="fr" rel="alternate" title="Français"> fr </a> | <a href="../ja/mod/mod_echo.html" hreflang="ja" rel="alternate" title="Japanese"> ja </a> | <a href="../ko/mod/mod_echo.html" hreflang="ko" rel="alternate" title="Korean"> ko </a></p> </div><div id="footer"> diff --git a/docs/manual/mod/mod_echo.html.fr b/docs/manual/mod/mod_echo.html.fr new file mode 100644 index 0000000000..db6fb4fbfd --- /dev/null +++ b/docs/manual/mod/mod_echo.html.fr @@ -0,0 +1,76 @@ +<?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_echo - 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 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="../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.3</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.3</a> > <a href="./">Modules</a></div> +<div id="page-content"> +<div id="preamble"><h1>Module Apache mod_echo</h1> +<div class="toplang"> +<p><span>Langues Disponibles: </span><a href="../en/mod/mod_echo.html" hreflang="en" rel="alternate" title="English"> en </a> | +<a href="../fr/mod/mod_echo.html" title="Français"> fr </a> | +<a href="../ja/mod/mod_echo.html" hreflang="ja" rel="alternate" title="Japanese"> ja </a> | +<a href="../ko/mod/mod_echo.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>Un simple serveur d'écho pour illustrer les modules de +protocole</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>echo_module</td></tr> +<tr><th><a href="module-dict.html#SourceFile">Fichier Source:</a></th><td>mod_echo.c</td></tr> +<tr><th><a href="module-dict.html#Compatibility">Compatibilité:</a></th><td>Disponible depuis la version 2.0 d'Apache</td></tr></table> +<h3>Sommaire</h3> + + <p>Ce module est un module de protocole exemple permettant d'en + illustrer le concept. Il fournit un simple serveur d'écho. Envoyez + lui une phrase par telnet, et il vous la renverra.</p> +</div> +<div id="quickview"><h3 class="directives">Directives</h3> +<ul id="toc"> +<li><img alt="" src="../images/down.gif" /> <a href="#protocolecho">ProtocolEcho</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="ProtocolEcho" id="ProtocolEcho">ProtocolEcho</a> <a name="protocolecho" id="protocolecho">Directive</a></h2> +<table class="directive"> +<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Active ou désactive le serveur d'écho</td></tr> +<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>ProtocolEcho On|Off</code></td></tr> +<tr><th><a href="directive-dict.html#Default">Défaut:</a></th><td><code>ProtocolEcho 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>Expérimental</td></tr> +<tr><th><a href="directive-dict.html#Module">Module:</a></th><td>mod_echo</td></tr> +<tr><th><a href="directive-dict.html#Compatibility">Compatibilité:</a></th><td>ProtocolEcho est disponible depuis la version 2.0 +d'Apache.</td></tr> +</table> + <p>La directive <code class="directive">ProtocolEcho</code> permet d'activer + ou de désactiver le serveur d'écho.</p> + + <div class="example"><h3>Exemple</h3><p><code> + ProtocolEcho On + </code></p></div> + +</div> +</div> +<div class="bottomlang"> +<p><span>Langues Disponibles: </span><a href="../en/mod/mod_echo.html" hreflang="en" rel="alternate" title="English"> en </a> | +<a href="../fr/mod/mod_echo.html" title="Français"> fr </a> | +<a href="../ja/mod/mod_echo.html" hreflang="ja" rel="alternate" title="Japanese"> ja </a> | +<a href="../ko/mod/mod_echo.html" hreflang="ko" rel="alternate" title="Korean"> ko </a></p> +</div><div id="footer"> +<p class="apache">Copyright 2009 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="../faq/">FAQ</a> | <a href="../glossary.html">Glossaire</a> | <a href="../sitemap.html">Plan du site</a></p></div> +</body></html>
\ No newline at end of file diff --git a/docs/manual/mod/mod_echo.xml.fr b/docs/manual/mod/mod_echo.xml.fr new file mode 100644 index 0000000000..3564f39e7d --- /dev/null +++ b/docs/manual/mod/mod_echo.xml.fr @@ -0,0 +1,63 @@ +<?xml version="1.0"?> +<!DOCTYPE modulesynopsis SYSTEM "../style/modulesynopsis.dtd"> +<?xml-stylesheet type="text/xsl" href="../style/manual.fr.xsl"?> +<!-- English Revision : 654507 --> +<!-- 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_echo.xml.meta"> + +<name>mod_echo</name> +<description>Un simple serveur d'écho pour illustrer les modules de +protocole</description> +<status>Experimental</status> +<sourcefile>mod_echo.c</sourcefile> +<identifier>echo_module</identifier> +<compatibility>Disponible depuis la version 2.0 d'Apache</compatibility> + +<summary> + <p>Ce module est un module de protocole exemple permettant d'en + illustrer le concept. Il fournit un simple serveur d'écho. Envoyez + lui une phrase par telnet, et il vous la renverra.</p> +</summary> + +<directivesynopsis> + +<name>ProtocolEcho</name> +<description>Active ou désactive le serveur d'écho</description> +<syntax>ProtocolEcho On|Off</syntax> +<default>ProtocolEcho Off</default> +<contextlist><context>server config</context> +<context>virtual host</context></contextlist> +<compatibility>ProtocolEcho est disponible depuis la version 2.0 +d'Apache.</compatibility> + +<usage> + <p>La directive <directive>ProtocolEcho</directive> permet d'activer + ou de désactiver le serveur d'écho.</p> + + <example><title>Exemple</title> + ProtocolEcho On + </example> +</usage> + +</directivesynopsis> +</modulesynopsis> + diff --git a/docs/manual/mod/mod_echo.xml.meta b/docs/manual/mod/mod_echo.xml.meta index 4c51a4eb6f..760acb096f 100644 --- a/docs/manual/mod/mod_echo.xml.meta +++ b/docs/manual/mod/mod_echo.xml.meta @@ -8,6 +8,7 @@ <variants> <variant>en</variant> + <variant>fr</variant> <variant>ja</variant> <variant outdated="yes">ko</variant> </variants> diff --git a/docs/manual/mod/mod_env.html b/docs/manual/mod/mod_env.html index df9103110e..98ef2d976a 100644 --- a/docs/manual/mod/mod_env.html +++ b/docs/manual/mod/mod_env.html @@ -4,6 +4,10 @@ URI: mod_env.html.en Content-Language: en Content-type: text/html; charset=ISO-8859-1 +URI: mod_env.html.fr +Content-Language: fr +Content-type: text/html; charset=ISO-8859-1 + URI: mod_env.html.ja.utf8 Content-Language: ja Content-type: text/html; charset=UTF-8 diff --git a/docs/manual/mod/mod_env.html.en b/docs/manual/mod/mod_env.html.en index 59de5c4b76..0a744a34ec 100644 --- a/docs/manual/mod/mod_env.html.en +++ b/docs/manual/mod/mod_env.html.en @@ -22,6 +22,7 @@ <div id="preamble"><h1>Apache Module mod_env</h1> <div class="toplang"> <p><span>Available Languages: </span><a href="../en/mod/mod_env.html" title="English"> en </a> | +<a href="../fr/mod/mod_env.html" hreflang="fr" rel="alternate" title="Français"> fr </a> | <a href="../ja/mod/mod_env.html" hreflang="ja" rel="alternate" title="Japanese"> ja </a> | <a href="../ko/mod/mod_env.html" hreflang="ko" rel="alternate" title="Korean"> ko </a> | <a href="../tr/mod/mod_env.html" hreflang="tr" rel="alternate" title="Türkçe"> tr </a></p> @@ -110,6 +111,7 @@ SSI pages</td></tr> </div> <div class="bottomlang"> <p><span>Available Languages: </span><a href="../en/mod/mod_env.html" title="English"> en </a> | +<a href="../fr/mod/mod_env.html" hreflang="fr" rel="alternate" title="Français"> fr </a> | <a href="../ja/mod/mod_env.html" hreflang="ja" rel="alternate" title="Japanese"> ja </a> | <a href="../ko/mod/mod_env.html" hreflang="ko" rel="alternate" title="Korean"> ko </a> | <a href="../tr/mod/mod_env.html" hreflang="tr" rel="alternate" title="Türkçe"> tr </a></p> diff --git a/docs/manual/mod/mod_env.html.fr b/docs/manual/mod/mod_env.html.fr new file mode 100644 index 0000000000..a4be31ecde --- /dev/null +++ b/docs/manual/mod/mod_env.html.fr @@ -0,0 +1,122 @@ +<?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_env - 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 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="../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.3</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.3</a> > <a href="./">Modules</a></div> +<div id="page-content"> +<div id="preamble"><h1>Module Apache mod_env</h1> +<div class="toplang"> +<p><span>Langues Disponibles: </span><a href="../en/mod/mod_env.html" hreflang="en" rel="alternate" title="English"> en </a> | +<a href="../fr/mod/mod_env.html" title="Français"> fr </a> | +<a href="../ja/mod/mod_env.html" hreflang="ja" rel="alternate" title="Japanese"> ja </a> | +<a href="../ko/mod/mod_env.html" hreflang="ko" rel="alternate" title="Korean"> ko </a> | +<a href="../tr/mod/mod_env.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>Modifie l'environnement transmis aux scripts CGI et aux +pages SSI</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>env_module</td></tr> +<tr><th><a href="module-dict.html#SourceFile">Fichier Source:</a></th><td>mod_env.c</td></tr></table> +<h3>Sommaire</h3> + + <p>Ce module permet de contrôler l'environnement transmis aux + scripts CGI et aux pages SSI. Les variables d'environnement peuvent + être transmises depuis le shell qui a lancé le processus + <code class="program"><a href="../programs/httpd.html">httpd</a></code>. Elles peuvent également être définies ou + supprimées au cours du processus de configuration.</p> +</div> +<div id="quickview"><h3 class="directives">Directives</h3> +<ul id="toc"> +<li><img alt="" src="../images/down.gif" /> <a href="#passenv">PassEnv</a></li> +<li><img alt="" src="../images/down.gif" /> <a href="#setenv">SetEnv</a></li> +<li><img alt="" src="../images/down.gif" /> <a href="#unsetenv">UnsetEnv</a></li> +</ul> +<h3>Voir aussi</h3> +<ul class="seealso"> +<li><a href="../env.html">Variables d'environnement</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="PassEnv" id="PassEnv">PassEnv</a> <a name="passenv" id="passenv">Directive</a></h2> +<table class="directive"> +<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Transmet des variables d'environnement depuis le +shell</td></tr> +<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>PassEnv <var>var-env</var> [<var>var-env</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">Annuler:</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_env</td></tr> +</table> + <p>Spécifie une ou plusieurs variables d'environnement à transmettre + aux scripts CGI et aux pages SSI depuis l'environnement du shell qui + a lancé le processus <code class="program"><a href="../programs/httpd.html">httpd</a></code>.</p> + + <div class="example"><h3>Exemple</h3><p><code> + PassEnv LD_LIBRARY_PATH + </code></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="SetEnv" id="SetEnv">SetEnv</a> <a name="setenv" id="setenv">Directive</a></h2> +<table class="directive"> +<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Définit des variables d'environnement</td></tr> +<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>SetEnv <var>var-env</var> <var>valeur</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">Annuler:</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_env</td></tr> +</table> + <p>Définit une variable d'environnement, cette dernière étant + ensuite transmise aux scripts CGI et aux pages SSI.</p> + + <div class="example"><h3>Exemple</h3><p><code> + SetEnv SPECIAL_PATH /foo/bin + </code></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="UnsetEnv" id="UnsetEnv">UnsetEnv</a> <a name="unsetenv" id="unsetenv">Directive</a></h2> +<table class="directive"> +<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Supprime des variables de l'environnement</td></tr> +<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>UnsetEnv <var>var-env</var> [<var>var-env</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">Annuler:</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_env</td></tr> +</table> + <p>Supprime une ou plusieurs variables d'environnement parmi celles + qui sont transmises aux scripts CGI et aux pages SSI.</p> + + <div class="example"><h3>Exemple</h3><p><code> + UnsetEnv LD_LIBRARY_PATH + </code></p></div> + +</div> +</div> +<div class="bottomlang"> +<p><span>Langues Disponibles: </span><a href="../en/mod/mod_env.html" hreflang="en" rel="alternate" title="English"> en </a> | +<a href="../fr/mod/mod_env.html" title="Français"> fr </a> | +<a href="../ja/mod/mod_env.html" hreflang="ja" rel="alternate" title="Japanese"> ja </a> | +<a href="../ko/mod/mod_env.html" hreflang="ko" rel="alternate" title="Korean"> ko </a> | +<a href="../tr/mod/mod_env.html" hreflang="tr" rel="alternate" title="Türkçe"> tr </a></p> +</div><div id="footer"> +<p class="apache">Copyright 2009 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="../faq/">FAQ</a> | <a href="../glossary.html">Glossaire</a> | <a href="../sitemap.html">Plan du site</a></p></div> +</body></html>
\ No newline at end of file diff --git a/docs/manual/mod/mod_env.xml.fr b/docs/manual/mod/mod_env.xml.fr new file mode 100644 index 0000000000..551dee8975 --- /dev/null +++ b/docs/manual/mod/mod_env.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 : 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. +--> + +<modulesynopsis metafile="mod_env.xml.meta"> + +<name>mod_env</name> +<description>Modifie l'environnement transmis aux scripts CGI et aux +pages SSI</description> +<status>Base</status> +<sourcefile>mod_env.c</sourcefile> +<identifier>env_module</identifier> +<summary> + <p>Ce module permet de contrôler l'environnement transmis aux + scripts CGI et aux pages SSI. Les variables d'environnement peuvent + être transmises depuis le shell qui a lancé le processus + <program>httpd</program>. Elles peuvent également être définies ou + supprimées au cours du processus de configuration.</p> +</summary> +<seealso><a href="../env.html">Variables d'environnement</a></seealso> + +<directivesynopsis> +<name>PassEnv</name> +<description>Transmet des variables d'environnement depuis le +shell</description> +<syntax>PassEnv <var>var-env</var> [<var>var-env</var>] +...</syntax> +<contextlist><context>server config</context><context>virtual host</context> +<context>directory</context><context>.htaccess</context></contextlist> +<override>FileInfo</override> + +<usage> + <p>Spécifie une ou plusieurs variables d'environnement à transmettre + aux scripts CGI et aux pages SSI depuis l'environnement du shell qui + a lancé le processus <program>httpd</program>.</p> + + <example><title>Exemple</title> + PassEnv LD_LIBRARY_PATH + </example> +</usage> +</directivesynopsis> + +<directivesynopsis> +<name>SetEnv</name> +<description>Définit des variables d'environnement</description> +<syntax>SetEnv <var>var-env</var> <var>valeur</var></syntax> +<contextlist><context>server config</context><context>virtual host</context> +<context>directory</context><context>.htaccess</context></contextlist> +<override>FileInfo</override> + +<usage> + <p>Définit une variable d'environnement, cette dernière étant + ensuite transmise aux scripts CGI et aux pages SSI.</p> + + <example><title>Exemple</title> + SetEnv SPECIAL_PATH /foo/bin + </example> +</usage> +</directivesynopsis> + +<directivesynopsis> +<name>UnsetEnv</name> +<description>Supprime des variables de l'environnement</description> +<syntax>UnsetEnv <var>var-env</var> [<var>var-env</var>] +...</syntax> +<contextlist><context>server config</context><context>virtual host</context> +<context>directory</context><context>.htaccess</context></contextlist> +<override>FileInfo</override> + +<usage> + <p>Supprime une ou plusieurs variables d'environnement parmi celles + qui sont transmises aux scripts CGI et aux pages SSI.</p> + + <example><title>Exemple</title> + UnsetEnv LD_LIBRARY_PATH + </example> +</usage> +</directivesynopsis> + +</modulesynopsis> + diff --git a/docs/manual/mod/mod_env.xml.meta b/docs/manual/mod/mod_env.xml.meta index b5ee37525e..0b34bdab14 100644 --- a/docs/manual/mod/mod_env.xml.meta +++ b/docs/manual/mod/mod_env.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/mod_ident.html b/docs/manual/mod/mod_ident.html index ed28d2acc8..b6f2cea8a1 100644 --- a/docs/manual/mod/mod_ident.html +++ b/docs/manual/mod/mod_ident.html @@ -4,6 +4,10 @@ URI: mod_ident.html.en Content-Language: en Content-type: text/html; charset=ISO-8859-1 +URI: mod_ident.html.fr +Content-Language: fr +Content-type: text/html; charset=ISO-8859-1 + URI: mod_ident.html.ja.utf8 Content-Language: ja Content-type: text/html; charset=UTF-8 diff --git a/docs/manual/mod/mod_ident.html.en b/docs/manual/mod/mod_ident.html.en index 539c2814fc..a5a2ebec4f 100644 --- a/docs/manual/mod/mod_ident.html.en +++ b/docs/manual/mod/mod_ident.html.en @@ -22,6 +22,7 @@ <div id="preamble"><h1>Apache Module mod_ident</h1> <div class="toplang"> <p><span>Available Languages: </span><a href="../en/mod/mod_ident.html" title="English"> en </a> | +<a href="../fr/mod/mod_ident.html" hreflang="fr" rel="alternate" title="Français"> fr </a> | <a href="../ja/mod/mod_ident.html" hreflang="ja" rel="alternate" title="Japanese"> ja </a> | <a href="../ko/mod/mod_ident.html" hreflang="ko" rel="alternate" title="Korean"> ko </a></p> </div> @@ -95,6 +96,7 @@ user</td></tr> </div> <div class="bottomlang"> <p><span>Available Languages: </span><a href="../en/mod/mod_ident.html" title="English"> en </a> | +<a href="../fr/mod/mod_ident.html" hreflang="fr" rel="alternate" title="Français"> fr </a> | <a href="../ja/mod/mod_ident.html" hreflang="ja" rel="alternate" title="Japanese"> ja </a> | <a href="../ko/mod/mod_ident.html" hreflang="ko" rel="alternate" title="Korean"> ko </a></p> </div><div id="footer"> diff --git a/docs/manual/mod/mod_ident.html.fr b/docs/manual/mod/mod_ident.html.fr new file mode 100644 index 0000000000..7023e1a1af --- /dev/null +++ b/docs/manual/mod/mod_ident.html.fr @@ -0,0 +1,114 @@ +<?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_ident - 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 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="../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.3</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.3</a> > <a href="./">Modules</a></div> +<div id="page-content"> +<div id="preamble"><h1>Module Apache mod_ident</h1> +<div class="toplang"> +<p><span>Langues Disponibles: </span><a href="../en/mod/mod_ident.html" hreflang="en" rel="alternate" title="English"> en </a> | +<a href="../fr/mod/mod_ident.html" title="Français"> fr </a> | +<a href="../ja/mod/mod_ident.html" hreflang="ja" rel="alternate" title="Japanese"> ja </a> | +<a href="../ko/mod/mod_ident.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>Recherche d'identité conformément à la RFC +1413</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>ident_module</td></tr> +<tr><th><a href="module-dict.html#SourceFile">Fichier Source:</a></th><td>mod_ident.c</td></tr> +<tr><th><a href="module-dict.html#Compatibility">Compatibilité:</a></th><td>Disponible depuis la version 2.2 d'Apache</td></tr></table> +<h3>Sommaire</h3> + + <p>Ce module interroge un démon compatible <a href="http://www.ietf.org/rfc/rfc1413.txt">RFC 1413</a> sur un + serveur distant afin de déterminer le propriétaire d'une + connexion.</p> +</div> +<div id="quickview"><h3 class="directives">Directives</h3> +<ul id="toc"> +<li><img alt="" src="../images/down.gif" /> <a href="#identitycheck">IdentityCheck</a></li> +<li><img alt="" src="../images/down.gif" /> <a href="#identitychecktimeout">IdentityCheckTimeout</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> +</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="IdentityCheck" id="IdentityCheck">IdentityCheck</a> <a name="identitycheck" id="identitycheck">Directive</a></h2> +<table class="directive"> +<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Active la journalisation de l'identité RFC 1413 de +l'utilisateur distant</td></tr> +<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>IdentityCheck On|Off</code></td></tr> +<tr><th><a href="directive-dict.html#Default">Défaut:</a></th><td><code>IdentityCheck 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_ident</td></tr> +<tr><th><a href="directive-dict.html#Compatibility">Compatibilité:</a></th><td>Retiré du serveur de base depuis Apache +2.1</td></tr> +</table> + <p>Cette directive permet d'activer la journalisation compatible <a href="http://www.ietf.org/rfc/rfc1413.txt">RFC 1413</a> du nom de + l'utilisateur distant pour chaque connexion, si la machine du client + exécute identd ou un démon similaire. Cette information est + enregistrée dans le journal des accès en utilisant la <a href="mod_log_config.html#formats">chaîne de formatage</a> + <code>%...l</code>.</p> + + <div class="note"> + Cette information ne doit pas faire l'objet d'une confiance + absolue, et elle ne doit être utilisée que dans le cadre d'un + traçage grossier. + </div> + + <p>Notez que de sérieux problèmes de délais peuvent survenir lors + des accès à votre serveur, car chaque requête nécessite l'exécution + d'un de ces processus de recherche. Lorsque des pare-feu ou des + serveurs mandataires sont impliqués, chaque recherche est + susceptible d'échouer et ajouter un temps de latence conformément + à la directive <code class="directive"><a href="#identitychecktimeout">IdentityCheckTimeout</a></code>. En général, ces + recherches ne se révèlent donc pas très utiles sur des serveurs + publics accessibles depuis l'Internet.</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="IdentityCheckTimeout" id="IdentityCheckTimeout">IdentityCheckTimeout</a> <a name="identitychecktimeout" id="identitychecktimeout">Directive</a></h2> +<table class="directive"> +<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Détermine le délai d'attente pour les requêtes +ident</td></tr> +<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>IdentityCheckTimeout <var>secondes</var></code></td></tr> +<tr><th><a href="directive-dict.html#Default">Défaut:</a></th><td><code>IdentityCheckTimeout 30</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_ident</td></tr> +</table> + <p>Cette directive permet de spécifier le délai d'attente d'une + requête ident. Une valeur par défaut de 30 secondes est recommandée + par la <a href="http://www.ietf.org/rfc/rfc1413.txt">RFC 1413</a>, + principalement pour prévenir les problèmes qui pourraient être + induits par la charge du réseau. Vous pouvez cependant ajuster la + valeur de ce délai en fonction du débit de votre réseau local.</p> + +</div> +</div> +<div class="bottomlang"> +<p><span>Langues Disponibles: </span><a href="../en/mod/mod_ident.html" hreflang="en" rel="alternate" title="English"> en </a> | +<a href="../fr/mod/mod_ident.html" title="Français"> fr </a> | +<a href="../ja/mod/mod_ident.html" hreflang="ja" rel="alternate" title="Japanese"> ja </a> | +<a href="../ko/mod/mod_ident.html" hreflang="ko" rel="alternate" title="Korean"> ko </a></p> +</div><div id="footer"> +<p class="apache">Copyright 2009 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="../faq/">FAQ</a> | <a href="../glossary.html">Glossaire</a> | <a href="../sitemap.html">Plan du site</a></p></div> +</body></html>
\ No newline at end of file diff --git a/docs/manual/mod/mod_ident.xml.fr b/docs/manual/mod/mod_ident.xml.fr new file mode 100644 index 0000000000..1650c47892 --- /dev/null +++ b/docs/manual/mod/mod_ident.xml.fr @@ -0,0 +1,100 @@ +<?xml version="1.0"?> +<!DOCTYPE modulesynopsis SYSTEM "../style/modulesynopsis.dtd"> +<?xml-stylesheet type="text/xsl" href="../style/manual.fr.xsl"?> +<!-- English Revision : 420993 --> +<!-- 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_ident.xml.meta"> + +<name>mod_ident</name> +<description>Recherche d'identité conformément à la RFC +1413</description> +<status>Extension</status> +<sourcefile>mod_ident.c</sourcefile> +<identifier>ident_module</identifier> +<compatibility>Disponible depuis la version 2.2 d'Apache</compatibility> + +<summary> + <p>Ce module interroge un démon compatible <a + href="http://www.ietf.org/rfc/rfc1413.txt">RFC 1413</a> sur un + serveur distant afin de déterminer le propriétaire d'une + connexion.</p> +</summary> +<seealso><module>mod_log_config</module></seealso> + +<directivesynopsis> +<name>IdentityCheck</name> +<description>Active la journalisation de l'identité RFC 1413 de +l'utilisateur distant</description> +<syntax>IdentityCheck On|Off</syntax> +<default>IdentityCheck Off</default> +<contextlist><context>server config</context><context>virtual host</context> +<context>directory</context></contextlist> +<compatibility>Retiré du serveur de base depuis Apache +2.1</compatibility> + +<usage> + <p>Cette directive permet d'activer la journalisation compatible <a + href="http://www.ietf.org/rfc/rfc1413.txt">RFC 1413</a> du nom de + l'utilisateur distant pour chaque connexion, si la machine du client + exécute identd ou un démon similaire. Cette information est + enregistrée dans le journal des accès en utilisant la <a + href="mod_log_config.html#formats">chaîne de formatage</a> + <code>%...l</code>.</p> + + <note> + Cette information ne doit pas faire l'objet d'une confiance + absolue, et elle ne doit être utilisée que dans le cadre d'un + traçage grossier. + </note> + + <p>Notez que de sérieux problèmes de délais peuvent survenir lors + des accès à votre serveur, car chaque requête nécessite l'exécution + d'un de ces processus de recherche. Lorsque des pare-feu ou des + serveurs mandataires sont impliqués, chaque recherche est + susceptible d'échouer et ajouter un temps de latence conformément + à la directive <directive + module="mod_ident">IdentityCheckTimeout</directive>. En général, ces + recherches ne se révèlent donc pas très utiles sur des serveurs + publics accessibles depuis l'Internet.</p> +</usage> +</directivesynopsis> + +<directivesynopsis> +<name>IdentityCheckTimeout</name> +<description>Détermine le délai d'attente pour les requêtes +ident</description> +<syntax>IdentityCheckTimeout <var>secondes</var></syntax> +<default>IdentityCheckTimeout 30</default> +<contextlist><context>server config</context><context>virtual host</context> +<context>directory</context></contextlist> +<usage> + <p>Cette directive permet de spécifier le délai d'attente d'une + requête ident. Une valeur par défaut de 30 secondes est recommandée + par la <a href="http://www.ietf.org/rfc/rfc1413.txt">RFC 1413</a>, + principalement pour prévenir les problèmes qui pourraient être + induits par la charge du réseau. Vous pouvez cependant ajuster la + valeur de ce délai en fonction du débit de votre réseau local.</p> +</usage> +</directivesynopsis> + +</modulesynopsis> + diff --git a/docs/manual/mod/mod_ident.xml.meta b/docs/manual/mod/mod_ident.xml.meta index 408ffdaa37..2d39cc0a11 100644 --- a/docs/manual/mod/mod_ident.xml.meta +++ b/docs/manual/mod/mod_ident.xml.meta @@ -8,6 +8,7 @@ <variants> <variant>en</variant> + <variant>fr</variant> <variant>ja</variant> <variant>ko</variant> </variants> diff --git a/docs/manual/mod/mod_info.html b/docs/manual/mod/mod_info.html index 2b70dae6ea..23d714e208 100644 --- a/docs/manual/mod/mod_info.html +++ b/docs/manual/mod/mod_info.html @@ -4,6 +4,10 @@ URI: mod_info.html.en Content-Language: en Content-type: text/html; charset=ISO-8859-1 +URI: mod_info.html.fr +Content-Language: fr +Content-type: text/html; charset=ISO-8859-1 + URI: mod_info.html.ja.utf8 Content-Language: ja Content-type: text/html; charset=UTF-8 diff --git a/docs/manual/mod/mod_info.html.en b/docs/manual/mod/mod_info.html.en index 3ad5775163..b07ff8135d 100644 --- a/docs/manual/mod/mod_info.html.en +++ b/docs/manual/mod/mod_info.html.en @@ -22,6 +22,7 @@ <div id="preamble"><h1>Apache Module mod_info</h1> <div class="toplang"> <p><span>Available Languages: </span><a href="../en/mod/mod_info.html" title="English"> en </a> | +<a href="../fr/mod/mod_info.html" hreflang="fr" rel="alternate" title="Français"> fr </a> | <a href="../ja/mod/mod_info.html" hreflang="ja" rel="alternate" title="Japanese"> ja </a> | <a href="../ko/mod/mod_info.html" hreflang="ko" rel="alternate" title="Korean"> ko </a></p> </div> @@ -186,6 +187,7 @@ information displayed by the server-info handler</td></tr> </div> <div class="bottomlang"> <p><span>Available Languages: </span><a href="../en/mod/mod_info.html" title="English"> en </a> | +<a href="../fr/mod/mod_info.html" hreflang="fr" rel="alternate" title="Français"> fr </a> | <a href="../ja/mod/mod_info.html" hreflang="ja" rel="alternate" title="Japanese"> ja </a> | <a href="../ko/mod/mod_info.html" hreflang="ko" rel="alternate" title="Korean"> ko </a></p> </div><div id="footer"> diff --git a/docs/manual/mod/mod_info.html.fr b/docs/manual/mod/mod_info.html.fr new file mode 100644 index 0000000000..d4d0893ade --- /dev/null +++ b/docs/manual/mod/mod_info.html.fr @@ -0,0 +1,202 @@ +<?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_info - 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 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="../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.3</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.3</a> > <a href="./">Modules</a></div> +<div id="page-content"> +<div id="preamble"><h1>Module Apache mod_info</h1> +<div class="toplang"> +<p><span>Langues Disponibles: </span><a href="../en/mod/mod_info.html" hreflang="en" rel="alternate" title="English"> en </a> | +<a href="../fr/mod/mod_info.html" title="Français"> fr </a> | +<a href="../ja/mod/mod_info.html" hreflang="ja" rel="alternate" title="Japanese"> ja </a> | +<a href="../ko/mod/mod_info.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>Affiche une présentation complète de la configuration du +serveur</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>info_module</td></tr> +<tr><th><a href="module-dict.html#SourceFile">Fichier Source:</a></th><td>mod_info.c</td></tr></table> +<h3>Sommaire</h3> + + <p>Pour activer <code class="module"><a href="../mod/mod_info.html">mod_info</a></code>, ajoutez les lignes + suivantes à votre fichier <code>httpd.conf</code>.</p> + + <div class="example"><p><code> + <Location /infos-serveur><br /> + <span class="indent"> + SetHandler server-info<br /> + </span> + </Location> + </code></p></div> + + <p>Il est recommandé d'utiliser <code class="module"><a href="../mod/mod_access.html">mod_access</a></code> à + l'intérieur de la section <code class="directive"><a href="../mod/core.html#location"><Location></a></code> afin de restreindre l'accès aux + informations de configuration de votre serveur :</p> + + <div class="example"><p><code> + <Location /infos-serveur><br /> + <span class="indent"> + SetHandler server-info<br /> + Order deny,allow<br /> + Deny from all<br /> + Allow from votre-entreprise.com<br /> + </span> + </Location> + </code></p></div> + + <p>Une fois cette configuration effectuée, les informations du + serveur sont disponibles à l'adresse + <code>http://votre-serveur.com/infos-serveur</code>.</p> +</div> +<div id="quickview"><h3 class="directives">Directives</h3> +<ul id="toc"> +<li><img alt="" src="../images/down.gif" /> <a href="#addmoduleinfo">AddModuleInfo</a></li> +</ul> +<h3>Sujets</h3> +<ul id="topics"> +<li><img alt="" src="../images/down.gif" /> <a href="#security">Problèmes liés à la sécurité</a></li> +<li><img alt="" src="../images/down.gif" /> <a href="#queries">Filtrage des informations affichées</a></li> +<li><img alt="" src="../images/down.gif" /> <a href="#limitations">Limitations connues</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="security" id="security">Problèmes liés à la sécurité</a></h2> + <p>Une fois <code class="module"><a href="../mod/mod_info.html">mod_info</a></code> chargé dans le serveur, sa + fonctionnalité de gestionnaire est disponible dans <em>tous</em> les + fichiers de configuration, y compris les fichiers de configuration + des répertoires (par exemple <code>.htaccess</code>). Ceci peut + avoir des répercutions en matière de sécurité pour votre site.</p> + + <p>En particulier, l'utilisation de ce module peut conduire à la + divulgation d'informations sensibles à partir des directives de + configuration d'autres modules Apache comme des chemins systèmes, + des couples nom d'utilisateur/mot de passe, des noms de bases de + données, etc... C'est pourquoi ce module ne doit être utilisé + <strong>que</strong> dans un environnement sous contrôle et toujours + avec les plus grandes précautions.</p> + + <p>Il est recommandé d'utiliser <code class="module"><a href="../mod/mod_authz_host.html">mod_authz_host</a></code> pour + restreindre l'accès aux informations de configuration de votre + serveur.</p> + + <div class="example"><h3>Contrôle d'accès</h3><p><code> + <Location /infos-serveur><br /> + <span class="indent"> + SetHandler server-info<br /> + Order allow,deny<br /> + # Autorisation d'accès depuis le serveur lui-même<br /> + Allow from 127.0.0.1<br /> + # Autorisation d'accès depuis une station de travail du réseau + # local<br /> + Allow from 192.168.1.17<br /> + </span> + </Location> + </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="queries" id="queries">Filtrage des informations affichées</a></h2> + <p>Par défaut, les informations affichées comprennent une liste de + tous les modules activés, et pour chaque module, une description des + directives qu'il accepte, les branchements (hooks) qu'il + implémente, ainsi que les directives concernées dans la + configuration courante.</p> + + <p>Il est possible d'afficher d'autres vues de la configuration en + ajoutant un argument à la requête <code>infos-serveur</code>. Par + exemple, <code>http://votre-serveur.com/infos-serveur?config</code> + affichera toutes les directives de configuration.</p> + + <dl> + <dt><code>?<module-name></code></dt> + <dd>Uniquement les informations relatives au module + spécifié</dd> + <dt><code>?config</code></dt> + <dd>Uniquement les directives de configuration, non triées + par module</dd> + <dt><code>?hooks</code></dt> + <dd>Uniquement la liste des branchements (hooks) + auxquels le module est attaché</dd> + <dt><code>?list</code></dt> + <dd>Une simple liste des modules activés</dd> + <dt><code>?server</code></dt> + <dd>Uniquement des informations de base sur le serveur</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="limitations" id="limitations">Limitations connues</a></h2> + <p><code class="module"><a href="../mod/mod_info.html">mod_info</a></code> tire ses informations de + la configuration interprétée, et non du fichier de configuration + original. La manière dont l'arbre de configuration interprété est + créé induit quelques limitations :</p> + <ul> + <li>Les directives qui sont traitées immédiatement sans être + enregistrées dans l'arbre de configuration interprété ne sont pas + prises en compte. Celles-ci comprennent <code class="directive"><a href="../mod/core.html#serverroot">ServerRoot</a></code>, <code class="directive"><a href="../mod/mod_so.html#loadmodule">LoadModule</a></code> et <code class="directive"><a href="../mod/mod_so.html#loadfile">LoadFile</a></code>.</li> + <li>Les directives qui contrôlent le fichier de configuration + lui-même, comme <code class="directive"><a href="../mod/core.html#include">Include</a></code>, + <code class="directive"><a href="../mod/core.html#<ifmodule>"><IfModule></a></code> et + <code class="directive"><a href="../mod/core.html#<ifdefine>"><IfDefine></a></code> ne sont pas + prises en compte, mais les directives de configuration incluses le + sont.</li> + <li>Les commentaires ne sont pas pris en compte (Ce qui peut être + considéré comme une fonctionnalité).</li> + <li>Les directives de configuration des fichiers + <code>.htaccess</code> ne sont pas prises en compte (car elles ne + font pas partie de la configuration permanente du serveur).</li> + <li>Les directives de conteneur comme <code class="directive"><a href="../mod/core.html#<directory>"><Directory></a></code> sont affichées + normalement, mais <code class="module"><a href="../mod/mod_info.html">mod_info</a></code> est incapable de + déterminer le numéro de ligne de la balise fermante <code class="directive"><a href="../mod/core.html#</directory>"></Directory></a></code>.</li> + <li>Les directives générées par des modules tiers comme + <a href="http://perl.apache.org">mod_perl</a> peuvent ne pas être + prises en compte.</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="AddModuleInfo" id="AddModuleInfo">AddModuleInfo</a> <a name="addmoduleinfo" id="addmoduleinfo">Directive</a></h2> +<table class="directive"> +<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Ajoute des données supplémentaires aux informations de +module affichées par le gestionnaire server-info</td></tr> +<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>AddModuleInfo <var>nom-module</var> <var>chaîne</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_info</td></tr> +<tr><th><a href="directive-dict.html#Compatibility">Compatibilité:</a></th><td>Disponible depuis la version 1.3 d'Apache</td></tr> +</table> + <p>Cette directive permet d'afficher le contenu de <var>chaîne</var> + en tant qu'<strong>Information supplémentaire</strong> interprétée + en HTML pour le module <var>nom-module</var>. Exemple :</p> + + <div class="example"><p><code> + AddModuleInfo mod_deflate.c 'Voir <a \<br /> + <span class="indent"> + href="http://www.apache.org/docs/trunk/mod/mod_deflate.html">\<br /> + http://www.apache.org/docs/trunk/mod/mod_deflate.html</a>' + </span> + </code></p></div> + +</div> +</div> +<div class="bottomlang"> +<p><span>Langues Disponibles: </span><a href="../en/mod/mod_info.html" hreflang="en" rel="alternate" title="English"> en </a> | +<a href="../fr/mod/mod_info.html" title="Français"> fr </a> | +<a href="../ja/mod/mod_info.html" hreflang="ja" rel="alternate" title="Japanese"> ja </a> | +<a href="../ko/mod/mod_info.html" hreflang="ko" rel="alternate" title="Korean"> ko </a></p> +</div><div id="footer"> +<p class="apache">Copyright 2009 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="../faq/">FAQ</a> | <a href="../glossary.html">Glossaire</a> | <a href="../sitemap.html">Plan du site</a></p></div> +</body></html>
\ No newline at end of file diff --git a/docs/manual/mod/mod_info.xml.fr b/docs/manual/mod/mod_info.xml.fr new file mode 100644 index 0000000000..3d9a0d2169 --- /dev/null +++ b/docs/manual/mod/mod_info.xml.fr @@ -0,0 +1,188 @@ +<?xml version="1.0"?> +<!DOCTYPE modulesynopsis SYSTEM "../style/modulesynopsis.dtd"> +<?xml-stylesheet type="text/xsl" href="../style/manual.fr.xsl"?> +<!-- English Revision : 804977 --> +<!-- 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_info.xml.meta"> + +<name>mod_info</name> +<description>Affiche une présentation complète de la configuration du +serveur</description> +<status>Extension</status> +<sourcefile>mod_info.c</sourcefile> +<identifier>info_module</identifier> + +<summary> + <p>Pour activer <module>mod_info</module>, ajoutez les lignes + suivantes à votre fichier <code>httpd.conf</code>.</p> + + <example> + <Location /infos-serveur><br /> + <indent> + SetHandler server-info<br /> + </indent> + </Location> + </example> + + <p>Il est recommandé d'utiliser <module>mod_access</module> à + l'intérieur de la section <directive type="section" + module="core">Location</directive> afin de restreindre l'accès aux + informations de configuration de votre serveur :</p> + + <example> + <Location /infos-serveur><br /> + <indent> + SetHandler server-info<br /> + Order deny,allow<br /> + Deny from all<br /> + Allow from votre-entreprise.com<br /> + </indent> + </Location> + </example> + + <p>Une fois cette configuration effectuée, les informations du + serveur sont disponibles à l'adresse + <code>http://votre-serveur.com/infos-serveur</code>.</p> +</summary> + +<section id="security"><title>Problèmes liés à la sécurité</title> + <p>Une fois <module>mod_info</module> chargé dans le serveur, sa + fonctionnalité de gestionnaire est disponible dans <em>tous</em> les + fichiers de configuration, y compris les fichiers de configuration + des répertoires (par exemple <code>.htaccess</code>). Ceci peut + avoir des répercutions en matière de sécurité pour votre site.</p> + + <p>En particulier, l'utilisation de ce module peut conduire à la + divulgation d'informations sensibles à partir des directives de + configuration d'autres modules Apache comme des chemins systèmes, + des couples nom d'utilisateur/mot de passe, des noms de bases de + données, etc... C'est pourquoi ce module ne doit être utilisé + <strong>que</strong> dans un environnement sous contrôle et toujours + avec les plus grandes précautions.</p> + + <p>Il est recommandé d'utiliser <module>mod_authz_host</module> pour + restreindre l'accès aux informations de configuration de votre + serveur.</p> + + <example><title>Contrôle d'accès</title> + <Location /infos-serveur><br /> + <indent> + SetHandler server-info<br /> + Order allow,deny<br /> + # Autorisation d'accès depuis le serveur lui-même<br /> + Allow from 127.0.0.1<br /> + # Autorisation d'accès depuis une station de travail du réseau + # local<br /> + Allow from 192.168.1.17<br /> + </indent> + </Location> + </example> +</section> + +<section id="queries"><title>Filtrage des informations affichées</title> + <p>Par défaut, les informations affichées comprennent une liste de + tous les modules activés, et pour chaque module, une description des + directives qu'il accepte, les branchements (hooks) qu'il + implémente, ainsi que les directives concernées dans la + configuration courante.</p> + + <p>Il est possible d'afficher d'autres vues de la configuration en + ajoutant un argument à la requête <code>infos-serveur</code>. Par + exemple, <code>http://votre-serveur.com/infos-serveur?config</code> + affichera toutes les directives de configuration.</p> + + <dl> + <dt><code>?<module-name></code></dt> + <dd>Uniquement les informations relatives au module + spécifié</dd> + <dt><code>?config</code></dt> + <dd>Uniquement les directives de configuration, non triées + par module</dd> + <dt><code>?hooks</code></dt> + <dd>Uniquement la liste des branchements (hooks) + auxquels le module est attaché</dd> + <dt><code>?list</code></dt> + <dd>Une simple liste des modules activés</dd> + <dt><code>?server</code></dt> + <dd>Uniquement des informations de base sur le serveur</dd> + </dl> +</section> + +<section id="limitations"><title>Limitations connues</title> + <p><module>mod_info</module> tire ses informations de + la configuration interprétée, et non du fichier de configuration + original. La manière dont l'arbre de configuration interprété est + créé induit quelques limitations :</p> + <ul> + <li>Les directives qui sont traitées immédiatement sans être + enregistrées dans l'arbre de configuration interprété ne sont pas + prises en compte. Celles-ci comprennent <directive + module="core">ServerRoot</directive>, <directive + module="mod_so">LoadModule</directive> et <directive + module="mod_so">LoadFile</directive>.</li> + <li>Les directives qui contrôlent le fichier de configuration + lui-même, comme <directive module="core">Include</directive>, + <directive module="core"><IfModule></directive> et + <directive module="core"><IfDefine></directive> ne sont pas + prises en compte, mais les directives de configuration incluses le + sont.</li> + <li>Les commentaires ne sont pas pris en compte (Ce qui peut être + considéré comme une fonctionnalité).</li> + <li>Les directives de configuration des fichiers + <code>.htaccess</code> ne sont pas prises en compte (car elles ne + font pas partie de la configuration permanente du serveur).</li> + <li>Les directives de conteneur comme <directive + module="core"><Directory></directive> sont affichées + normalement, mais <module>mod_info</module> est incapable de + déterminer le numéro de ligne de la balise fermante <directive + module="core"></Directory></directive>.</li> + <li>Les directives générées par des modules tiers comme + <a href="http://perl.apache.org">mod_perl</a> peuvent ne pas être + prises en compte.</li> + </ul> +</section> + +<directivesynopsis> +<name>AddModuleInfo</name> +<description>Ajoute des données supplémentaires aux informations de +module affichées par le gestionnaire server-info</description> +<syntax>AddModuleInfo <var>nom-module</var> <var>chaîne</var></syntax> +<contextlist><context>server config</context><context>virtual host</context> +</contextlist> +<compatibility>Disponible depuis la version 1.3 d'Apache</compatibility> + +<usage> + <p>Cette directive permet d'afficher le contenu de <var>chaîne</var> + en tant qu'<strong>Information supplémentaire</strong> interprétée + en HTML pour le module <var>nom-module</var>. Exemple :</p> + + <example> + AddModuleInfo mod_deflate.c 'Voir <a \<br /> + <indent> + href="http://www.apache.org/docs/&httpd.docs;/mod/mod_deflate.html">\<br /> + http://www.apache.org/docs/&httpd.docs;/mod/mod_deflate.html</a>' + </indent> + </example> +</usage> + +</directivesynopsis> +</modulesynopsis> diff --git a/docs/manual/mod/mod_info.xml.meta b/docs/manual/mod/mod_info.xml.meta index 1008060725..7e158f156a 100644 --- a/docs/manual/mod/mod_info.xml.meta +++ b/docs/manual/mod/mod_info.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_negotiation.html b/docs/manual/mod/mod_negotiation.html index dbedc3d00d..d6d7332ba8 100644 --- a/docs/manual/mod/mod_negotiation.html +++ b/docs/manual/mod/mod_negotiation.html @@ -4,6 +4,10 @@ URI: mod_negotiation.html.en Content-Language: en Content-type: text/html; charset=ISO-8859-1 +URI: mod_negotiation.html.fr +Content-Language: fr +Content-type: text/html; charset=ISO-8859-1 + URI: mod_negotiation.html.ja.utf8 Content-Language: ja Content-type: text/html; charset=UTF-8 diff --git a/docs/manual/mod/mod_negotiation.html.en b/docs/manual/mod/mod_negotiation.html.en index 15f2bf9c85..61f8f48fb1 100644 --- a/docs/manual/mod/mod_negotiation.html.en +++ b/docs/manual/mod/mod_negotiation.html.en @@ -22,6 +22,7 @@ <div id="preamble"><h1>Apache Module mod_negotiation</h1> <div class="toplang"> <p><span>Available Languages: </span><a href="../en/mod/mod_negotiation.html" title="English"> en </a> | +<a href="../fr/mod/mod_negotiation.html" hreflang="fr" rel="alternate" title="Français"> fr </a> | <a href="../ja/mod/mod_negotiation.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>Provides for <a href="../content-negotiation.html">content negotiation</a></td></tr> @@ -300,6 +301,7 @@ the client does not express a preference</td></tr> </div> <div class="bottomlang"> <p><span>Available Languages: </span><a href="../en/mod/mod_negotiation.html" title="English"> en </a> | +<a href="../fr/mod/mod_negotiation.html" hreflang="fr" rel="alternate" title="Français"> fr </a> | <a href="../ja/mod/mod_negotiation.html" hreflang="ja" rel="alternate" title="Japanese"> ja </a></p> </div><div id="footer"> <p class="apache">Copyright 2009 The Apache Software Foundation.<br />Licensed under the <a href="http://www.apache.org/licenses/LICENSE-2.0">Apache License, Version 2.0</a>.</p> diff --git a/docs/manual/mod/mod_negotiation.html.fr b/docs/manual/mod/mod_negotiation.html.fr new file mode 100644 index 0000000000..4117db9165 --- /dev/null +++ b/docs/manual/mod/mod_negotiation.html.fr @@ -0,0 +1,325 @@ +<?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_negotiation - 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 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="../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.3</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.3</a> > <a href="./">Modules</a></div> +<div id="page-content"> +<div id="preamble"><h1>Module Apache mod_negotiation</h1> +<div class="toplang"> +<p><span>Langues Disponibles: </span><a href="../en/mod/mod_negotiation.html" hreflang="en" rel="alternate" title="English"> en </a> | +<a href="../fr/mod/mod_negotiation.html" title="Français"> fr </a> | +<a href="../ja/mod/mod_negotiation.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>Effectue la <a href="../content-negotiation.html">négociation de +contenu</a></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>negotiation_module</td></tr> +<tr><th><a href="module-dict.html#SourceFile">Fichier Source:</a></th><td>mod_negotiation.c</td></tr></table> +<h3>Sommaire</h3> + + <p>La négociation de contenu, ou plus précisément la sélection de + contenu, est la sélection parmi plusieurs documents disponibles, du + document qui "colle" au plus près des possibilités du client. Pour y + parvenir, deux méthodes sont employées.</p> + + <ul> + <li>Une table de correspondances de types (un fichier associé au + gestionnaire <code>type-map</code>) qui contient une liste + explicite des fichiers contenant les différentes variantes.</li> + + <li>Une recherche multivues (Multiviews) (activée par l'<code class="directive"><a href="../mod/core.html#options">Options</a></code> <code>Multiviews</code>), où le + serveur effectue une recherche de correspondance de modèle de nom + de fichier implicite, et fait son choix parmi les résultats.</li> + </ul> +</div> +<div id="quickview"><h3 class="directives">Directives</h3> +<ul id="toc"> +<li><img alt="" src="../images/down.gif" /> <a href="#cachenegotiateddocs">CacheNegotiatedDocs</a></li> +<li><img alt="" src="../images/down.gif" /> <a href="#forcelanguagepriority">ForceLanguagePriority</a></li> +<li><img alt="" src="../images/down.gif" /> <a href="#languagepriority">LanguagePriority</a></li> +</ul> +<h3>Sujets</h3> +<ul id="topics"> +<li><img alt="" src="../images/down.gif" /> <a href="#typemaps">Tables de correspondances de types</a></li> +<li><img alt="" src="../images/down.gif" /> <a href="#multiviews">Multivues</a></li> +</ul><h3>Voir aussi</h3> +<ul class="seealso"> +<li><code class="directive"><a href="../mod/core.html#options">Options</a></code></li> +<li><code class="module"><a href="../mod/mod_mime.html">mod_mime</a></code></li> +<li><a href="../content-negotiation.html">Négociation de +contenu</a></li> +<li><a href="../env.html">Variables d'environnement</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="typemaps" id="typemaps">Tables de correspondances de types</a></h2> + <p>Une table de correspondances de types possède un format similaire + à celui des en-têtes de messagerie RFC822. Elle contient des + descriptions de documents séparées par des lignes vides, toute ligne + commençant par un dièse ('#') étant considérée comme un + commentaire. Une description de document comporte plusieurs + enregistrements d'en-têtes ; chaque enregistrement peut être réparti + sur plusieurs lignes à condition que les lignes supplémentaires + commencent par un ou plusieurs espaces. Lors du traitement, les + espaces de début de ligne seront supprimés et les lignes + concaténées. L'enregistrement d'un en-tête comprend un mot-clé qui + se termine toujours par un caractère "deux-points" ':', suivi d'une + valeur. Les espaces sont autorisés entre le nom d'en-tête et sa + valeur, ainsi qu'entre les différents éléments de la valeur. Les + en-têtes autorisés sont :</p> + + <dl> + <dt><code>Content-Encoding:</code></dt> + <dd>Le codage du fichier. Apache ne reconnaît que les codages + définis par une directive <code class="directive"><a href="../mod/mod_mime.html#addencoding">AddEncoding</a></code>. Sont normalement inclus + les codages <code>x-compress</code> pour les fichiers compressés + avec compress, et <code>x-gzip</code> pour les fichiers compressés + avec gzip. Le préfixe <code>x-</code> est ignoré lors des + comparaisons de codages.</dd> + + <dt><code>Content-Language:</code></dt> + <dd>Le(s) langage(s) de la variante, sous la forme d'un symbole de + langage Internet standard (<a href="http://www.ietf.org/rfc/rfc1766.txt">RFC 1766</a>). Par + exemple, <code>en</code> correspond à l'anglais. Si la variante + contient plusieurs langages, ils sont séparés par des + virgules.</dd> + + <dt><code>Content-Length:</code></dt> + <dd>La taille du fichier en octets. Si cet en-tête n'est pas + présent, c'est la taille réelle du fichier qui est utilisée.</dd> + + <dt><code>Content-Type:</code></dt> + + <dd> + Le <a class="glossarylink" href="../glossary.html#mime-type" title="voir glossaire">type MIME</a> du document + avec des paramètres optionnels. Les paramètres sont séparés du + type de médium ainsi qu'entre eux par un point-virgule, et + possèdent la syntaxe <code>nom=valeur</code>. Les paramètres + courants sont : + + <dl> + <dt><code>level</code></dt> + <dd>un entier spécifiant la version du type de média. Pour + <code>text/html</code>, la valeur par défaut est 2, sinon + 0.</dd> + + <dt><code>qs</code></dt> + <dd>un nombre en virgule flottante de 0.0 à 1.0, indiquant la + "qualité" relative de la variante courante par rapport aux + autres variantes disponibles, indépendamment des possibilités + du client. Par exemple, un fichier jpeg est en général une + source de qualité supérieure à un fichier ascii s'il est censé + représenter une image. Cependant, si la ressource représentée + est une image ascii, un fichier ascii possèdera une qualité + supérieure à un fichier jpeg. Toutes les valeurs de + <code>qs</code> sont donc spécifiques à une certaine + ressource.</dd> + </dl> + + <div class="example"><h3>Exemple</h3><p><code> + Content-Type: image/jpeg; qs=0.8 + </code></p></div> + </dd> + + <dt><code>URI:</code></dt> + <dd>l'URI du fichier contenant la variante (du type de médium + donné, codé selon le codage de contenu donné). Cet URI est + considéré comme relatif au fichier de correspondances ; il doit + être situé sur le même serveur (!), et doit faire référence au + fichier auquel le client se verrait accorder l'accès s'il était + requis directement.</dd> + + <dt><code>Body:</code></dt> + <dd>une nouveauté d'Apache 2.0 : le contenu réel de la ressource + peut être inclus dans la table de correspondances en utilisant + l'en-tête Body. Cet en-tête doit contenir une chaîne désignant un + délimiteur pour le contenu du corps. Les lignes suivantes du + fichier de correspondances de types seront alors considérées comme + parties du corps de la ressource jusqu'à ce que le délimiteur soit + détecté. + + <div class="example"><h3>Exemple:</h3><p><code> + Body:----xyz----<br /> + <html><br /> + <body><br /> + <p>Contenu de la page.</p><br /> + </body><br /> + </html><br /> + ----xyz---- + </code></p></div> + </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="multiviews" id="multiviews">Multivues</a></h2> + <p>Une recherche Multivues est activée par l'<code class="directive"><a href="../mod/core.html#options">Options</a></code> <code>Multiviews</code>. Si le + serveur reçoit une requête pour <code>/un/répertoire/foo</code>, et + si <code>/un/répertoire/foo</code> n'existe pas, le serveur parcourt + le répertoire à la recherche de tous les fichiers de nom + <code>foo.*</code>, et simule véritablement une correspondance de + type qui nomme tous ces fichiers en leur assignant les mêmes type + de média et codage de contenu qu'ils auraient eus si le client avait + requis l'un d'entre eux avec son nom complet. Il choisit ensuite le + fichier qui correspond le mieux au profile du client, puis renvoie + le document.</p> + + <p>La directive <code class="directive"><a href="../mod/mod_mime.html#multiviewsmatch">MultiviewsMatch</a></code> définit si Apache doit + prendre en compte les fichiers qui ne comportent pas de métadonnées + de négociation de contenu lors du choix du fichier à servir.</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="CacheNegotiatedDocs" id="CacheNegotiatedDocs">CacheNegotiatedDocs</a> <a name="cachenegotiateddocs" id="cachenegotiateddocs">Directive</a></h2> +<table class="directive"> +<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Permet la mise en cache au niveau des serveurs mandataires +des documents dont le contenu a été négocié</td></tr> +<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>CacheNegotiatedDocs On|Off</code></td></tr> +<tr><th><a href="directive-dict.html#Default">Défaut:</a></th><td><code>CacheNegotiatedDocs 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>Base</td></tr> +<tr><th><a href="directive-dict.html#Module">Module:</a></th><td>mod_negotiation</td></tr> +<tr><th><a href="directive-dict.html#Compatibility">Compatibilité:</a></th><td>La syntaxe a été modifiée dans la version +2.0.</td></tr> +</table> + <p>Si elle est définie à "on", cette directive permet la mise en + cache au niveau des serveurs mandataires des documents dont le + contenu a été négocié. Le processus de mise en cache sera alors plus + efficace, mais des clients se trouvant derrière le mandataire + seront alors susceptibles de se voir servir des versions de + documents qui ne correspondent pas forcément à leurs attentes.</p> + + <p>Cette directive ne s'applique qu'aux requêtes en provenance de + navigateurs HTTP/1.0. HTTP/1.1 fournit un bien meilleur contrôle de + la mise en cache des documents au contenu négocié, et cette + directive n'a aucun effet sur les réponses aux requêtes + HTTP/1.1.</p> + + <p>Avant la version 2.0, la directive + <code class="directive">CacheNegotiatedDocs</code> n'acceptait aucun + argument ; la seule présence de la directive suffisait à la définir + à "on".</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="ForceLanguagePriority" id="ForceLanguagePriority">ForceLanguagePriority</a> <a name="forcelanguagepriority" id="forcelanguagepriority">Directive</a></h2> +<table class="directive"> +<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Action à entreprendre si un document acceptable unique +n'est pas trouvé</td></tr> +<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>ForceLanguagePriority None|Prefer|Fallback [Prefer|Fallback]</code></td></tr> +<tr><th><a href="directive-dict.html#Default">Défaut:</a></th><td><code>ForceLanguagePriority Prefer</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">Annuler:</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_negotiation</td></tr> +<tr><th><a href="directive-dict.html#Compatibility">Compatibilité:</a></th><td>Disponible depuis la version 2.0.30</td></tr> +</table> + <p>La directive <code class="directive">ForceLanguagePriority</code> utilise + le langage défini par la directive <code class="directive"><a href="#languagepriority">LanguagePriority</a></code> pour terminer + la négociation lorsque le serveur n'est pas en mesure de trouver une + solution satisfaisante unique.</p> + + <p><code>ForceLanguagePriority Prefer</code> utilise la directive + <code>LanguagePriority</code> pour servir le résultat d'un choix + unique, au lieu de renvoyer un résultat HTTP 300 (MULTIPLE CHOICES), + lorsque que plusieurs choix équivalents sont disponibles. Par + exemple, avec les deux directives ci-dessous, si l'en-tête + <code>Accept-Language</code> de l'utilisateur assigne à + <code>en</code> et <code>de</code> une qualité de <code>.500</code> + (les deux langages sont également acceptables), alors c'est la + première variante acceptable de langue <code>en</code> qui sera + servie.</p> + + <div class="example"><p><code> + LanguagePriority en fr de<br /> + ForceLanguagePriority Prefer + </code></p></div> + + <p><code>ForceLanguagePriority Fallback</code> utilise la directive + <code class="directive"><a href="#languagepriority">LanguagePriority</a></code> + pour servir un résultat valide, au lieu de renvoyer un résultat HTTP + 406 (NOT ACCEPTABLE). Avec les deux directives ci-dessous, si + l'en-tête <code>Accept-Language</code> de l'utilisateur ne mentionne + que les réponses de langage <code>es</code>, et si aucune variante + dans cette langue n'est trouvée, c'est la première variante de la + liste définie par la directive <code class="directive"><a href="#languagepriority">LanguagePriority</a></code> qui sera servie.</p> + + <div class="example"><p><code> + LanguagePriority en fr de<br /> + ForceLanguagePriority Fallback + </code></p></div> + + <p>Les deux options, <code>Prefer</code> et <code>Fallback</code>, + peuvent être spécifiées, de façon à ce que la variante servie soit + la première variante qui convient définie par la directive + <code class="directive"><a href="#languagepriority">LanguagePriority</a></code> si + plusieurs variantes sont également acceptables, ou le premier + document disponible si aucune variante ne convient à la liste de + langages acceptables fournie par le client.</p> + +<h3>Voir aussi</h3> +<ul> +<li><code class="directive"><a href="../mod/mod_mime.html#addlanguage">AddLanguage</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="LanguagePriority" id="LanguagePriority">LanguagePriority</a> <a name="languagepriority" id="languagepriority">Directive</a></h2> +<table class="directive"> +<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>L'ordre de priorité des variantes de langages pour les +cas où le client n'a pas formulé de préférences</td></tr> +<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>LanguagePriority <var>langage-MIME</var> [<var>langage-MIME</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">Annuler:</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_negotiation</td></tr> +</table> + <p>La directive <code class="directive">LanguagePriority</code> permet de + définir, au cours du traitement d'une requête Multivues, l'ordre de + priorité des variantes de langages pour les cas + où le client n'a pas formulé de préférences. La liste énumère les + <var>langages-MIME</var> dans un ordre de préférences + décroissantes.</p> + + <div class="example"><h3>Exemple:</h3><p><code> + LanguagePriority en fr de + </code></p></div> + + <p>Dans le cas d'une requête pour <code>foo.html</code>, si + <code>foo.html.fr</code> et <code>foo.html.de</code> existent, et si + le client n'a pas formulé de préférences, c'est le fichier + <code>foo.html.fr</code> qui sera renvoyé.</p> + + <p>Notez que cette directive n'a d'effet que si le 'meilleur' + langage n'a pas pu être déterminé d'une autre manière ou si la + valeur de la directive <code class="directive"><a href="#forcelanguagepriority">ForceLanguagePriority</a></code> est + différente de <code>None</code>. En général, c'est le client qui + détermine le langage préféré, non le serveur.</p> + +<h3>Voir aussi</h3> +<ul> +<li><code class="directive"><a href="../mod/mod_mime.html#addlanguage">AddLanguage</a></code></li> +</ul> +</div> +</div> +<div class="bottomlang"> +<p><span>Langues Disponibles: </span><a href="../en/mod/mod_negotiation.html" hreflang="en" rel="alternate" title="English"> en </a> | +<a href="../fr/mod/mod_negotiation.html" title="Français"> fr </a> | +<a href="../ja/mod/mod_negotiation.html" hreflang="ja" rel="alternate" title="Japanese"> ja </a></p> +</div><div id="footer"> +<p class="apache">Copyright 2009 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="../faq/">FAQ</a> | <a href="../glossary.html">Glossaire</a> | <a href="../sitemap.html">Plan du site</a></p></div> +</body></html>
\ No newline at end of file diff --git a/docs/manual/mod/mod_negotiation.xml.fr b/docs/manual/mod/mod_negotiation.xml.fr new file mode 100644 index 0000000000..a4c1b89f61 --- /dev/null +++ b/docs/manual/mod/mod_negotiation.xml.fr @@ -0,0 +1,307 @@ +<?xml version="1.0"?> +<!DOCTYPE modulesynopsis SYSTEM "../style/modulesynopsis.dtd"> +<?xml-stylesheet type="text/xsl" href="../style/manual.fr.xsl"?> +<!-- English Revision : 774533 --> +<!-- 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_negotiation.xml.meta"> + +<name>mod_negotiation</name> +<description>Effectue la <a +href="../content-negotiation.html">négociation de +contenu</a></description> +<status>Base</status> +<sourcefile>mod_negotiation.c</sourcefile> +<identifier>negotiation_module</identifier> + +<summary> + <p>La négociation de contenu, ou plus précisément la sélection de + contenu, est la sélection parmi plusieurs documents disponibles, du + document qui "colle" au plus près des possibilités du client. Pour y + parvenir, deux méthodes sont employées.</p> + + <ul> + <li>Une table de correspondances de types (un fichier associé au + gestionnaire <code>type-map</code>) qui contient une liste + explicite des fichiers contenant les différentes variantes.</li> + + <li>Une recherche multivues (Multiviews) (activée par l'<directive + module="core">Options</directive> <code>Multiviews</code>), où le + serveur effectue une recherche de correspondance de modèle de nom + de fichier implicite, et fait son choix parmi les résultats.</li> + </ul> +</summary> +<seealso><directive module="core">Options</directive></seealso> +<seealso><module>mod_mime</module></seealso> +<seealso><a href="../content-negotiation.html">Négociation de +contenu</a></seealso> +<seealso><a href="../env.html">Variables d'environnement</a></seealso> + +<section id="typemaps"><title>Tables de correspondances de types</title> + <p>Une table de correspondances de types possède un format similaire + à celui des en-têtes de messagerie RFC822. Elle contient des + descriptions de documents séparées par des lignes vides, toute ligne + commençant par un dièse ('#') étant considérée comme un + commentaire. Une description de document comporte plusieurs + enregistrements d'en-têtes ; chaque enregistrement peut être réparti + sur plusieurs lignes à condition que les lignes supplémentaires + commencent par un ou plusieurs espaces. Lors du traitement, les + espaces de début de ligne seront supprimés et les lignes + concaténées. L'enregistrement d'un en-tête comprend un mot-clé qui + se termine toujours par un caractère "deux-points" ':', suivi d'une + valeur. Les espaces sont autorisés entre le nom d'en-tête et sa + valeur, ainsi qu'entre les différents éléments de la valeur. Les + en-têtes autorisés sont :</p> + + <dl> + <dt><code>Content-Encoding:</code></dt> + <dd>Le codage du fichier. Apache ne reconnaît que les codages + définis par une directive <directive + module="mod_mime">AddEncoding</directive>. Sont normalement inclus + les codages <code>x-compress</code> pour les fichiers compressés + avec compress, et <code>x-gzip</code> pour les fichiers compressés + avec gzip. Le préfixe <code>x-</code> est ignoré lors des + comparaisons de codages.</dd> + + <dt><code>Content-Language:</code></dt> + <dd>Le(s) langage(s) de la variante, sous la forme d'un symbole de + langage Internet standard (<a + href="http://www.ietf.org/rfc/rfc1766.txt">RFC 1766</a>). Par + exemple, <code>en</code> correspond à l'anglais. Si la variante + contient plusieurs langages, ils sont séparés par des + virgules.</dd> + + <dt><code>Content-Length:</code></dt> + <dd>La taille du fichier en octets. Si cet en-tête n'est pas + présent, c'est la taille réelle du fichier qui est utilisée.</dd> + + <dt><code>Content-Type:</code></dt> + + <dd> + Le <glossary ref="mime-type">type MIME</glossary> du document + avec des paramètres optionnels. Les paramètres sont séparés du + type de médium ainsi qu'entre eux par un point-virgule, et + possèdent la syntaxe <code>nom=valeur</code>. Les paramètres + courants sont : + + <dl> + <dt><code>level</code></dt> + <dd>un entier spécifiant la version du type de média. Pour + <code>text/html</code>, la valeur par défaut est 2, sinon + 0.</dd> + + <dt><code>qs</code></dt> + <dd>un nombre en virgule flottante de 0.0 à 1.0, indiquant la + "qualité" relative de la variante courante par rapport aux + autres variantes disponibles, indépendamment des possibilités + du client. Par exemple, un fichier jpeg est en général une + source de qualité supérieure à un fichier ascii s'il est censé + représenter une image. Cependant, si la ressource représentée + est une image ascii, un fichier ascii possèdera une qualité + supérieure à un fichier jpeg. Toutes les valeurs de + <code>qs</code> sont donc spécifiques à une certaine + ressource.</dd> + </dl> + + <example><title>Exemple</title> + Content-Type: image/jpeg; qs=0.8 + </example> + </dd> + + <dt><code>URI:</code></dt> + <dd>l'URI du fichier contenant la variante (du type de médium + donné, codé selon le codage de contenu donné). Cet URI est + considéré comme relatif au fichier de correspondances ; il doit + être situé sur le même serveur (!), et doit faire référence au + fichier auquel le client se verrait accorder l'accès s'il était + requis directement.</dd> + + <dt><code>Body:</code></dt> + <dd>une nouveauté d'Apache 2.0 : le contenu réel de la ressource + peut être inclus dans la table de correspondances en utilisant + l'en-tête Body. Cet en-tête doit contenir une chaîne désignant un + délimiteur pour le contenu du corps. Les lignes suivantes du + fichier de correspondances de types seront alors considérées comme + parties du corps de la ressource jusqu'à ce que le délimiteur soit + détecté. + + <example><title>Exemple:</title> + Body:----xyz----<br /> + <html><br /> + <body><br /> + <p>Contenu de la page.</p><br /> + </body><br /> + </html><br /> + ----xyz---- + </example> + </dd> + </dl> +</section> + +<section id="multiviews"><title>Multivues</title> + <p>Une recherche Multivues est activée par l'<directive + module="core">Options</directive> <code>Multiviews</code>. Si le + serveur reçoit une requête pour <code>/un/répertoire/foo</code>, et + si <code>/un/répertoire/foo</code> n'existe pas, le serveur parcourt + le répertoire à la recherche de tous les fichiers de nom + <code>foo.*</code>, et simule véritablement une correspondance de + type qui nomme tous ces fichiers en leur assignant les mêmes type + de média et codage de contenu qu'ils auraient eus si le client avait + requis l'un d'entre eux avec son nom complet. Il choisit ensuite le + fichier qui correspond le mieux au profile du client, puis renvoie + le document.</p> + + <p>La directive <directive + module="mod_mime">MultiviewsMatch</directive> définit si Apache doit + prendre en compte les fichiers qui ne comportent pas de métadonnées + de négociation de contenu lors du choix du fichier à servir.</p> +</section> + +<directivesynopsis> +<name>CacheNegotiatedDocs</name> +<description>Permet la mise en cache au niveau des serveurs mandataires +des documents dont le contenu a été négocié</description> +<syntax>CacheNegotiatedDocs On|Off</syntax> +<default>CacheNegotiatedDocs Off</default> +<contextlist><context>server config</context><context>virtual host</context> +</contextlist> +<compatibility>La syntaxe a été modifiée dans la version +2.0.</compatibility> + +<usage> + <p>Si elle est définie à "on", cette directive permet la mise en + cache au niveau des serveurs mandataires des documents dont le + contenu a été négocié. Le processus de mise en cache sera alors plus + efficace, mais des clients se trouvant derrière le mandataire + seront alors susceptibles de se voir servir des versions de + documents qui ne correspondent pas forcément à leurs attentes.</p> + + <p>Cette directive ne s'applique qu'aux requêtes en provenance de + navigateurs HTTP/1.0. HTTP/1.1 fournit un bien meilleur contrôle de + la mise en cache des documents au contenu négocié, et cette + directive n'a aucun effet sur les réponses aux requêtes + HTTP/1.1.</p> + + <p>Avant la version 2.0, la directive + <directive>CacheNegotiatedDocs</directive> n'acceptait aucun + argument ; la seule présence de la directive suffisait à la définir + à "on".</p> +</usage> +</directivesynopsis> + +<directivesynopsis> +<name>ForceLanguagePriority</name> +<description>Action à entreprendre si un document acceptable unique +n'est pas trouvé</description> +<syntax>ForceLanguagePriority None|Prefer|Fallback [Prefer|Fallback]</syntax> +<default>ForceLanguagePriority Prefer</default> +<contextlist><context>server config</context><context>virtual host</context> +<context>directory</context><context>.htaccess</context></contextlist> +<override>FileInfo</override> +<compatibility>Disponible depuis la version 2.0.30</compatibility> + +<usage> + <p>La directive <directive>ForceLanguagePriority</directive> utilise + le langage défini par la directive <directive + module="mod_negotiation">LanguagePriority</directive> pour terminer + la négociation lorsque le serveur n'est pas en mesure de trouver une + solution satisfaisante unique.</p> + + <p><code>ForceLanguagePriority Prefer</code> utilise la directive + <code>LanguagePriority</code> pour servir le résultat d'un choix + unique, au lieu de renvoyer un résultat HTTP 300 (MULTIPLE CHOICES), + lorsque que plusieurs choix équivalents sont disponibles. Par + exemple, avec les deux directives ci-dessous, si l'en-tête + <code>Accept-Language</code> de l'utilisateur assigne à + <code>en</code> et <code>de</code> une qualité de <code>.500</code> + (les deux langages sont également acceptables), alors c'est la + première variante acceptable de langue <code>en</code> qui sera + servie.</p> + + <example> + LanguagePriority en fr de<br /> + ForceLanguagePriority Prefer + </example> + + <p><code>ForceLanguagePriority Fallback</code> utilise la directive + <directive module="mod_negotiation">LanguagePriority</directive> + pour servir un résultat valide, au lieu de renvoyer un résultat HTTP + 406 (NOT ACCEPTABLE). Avec les deux directives ci-dessous, si + l'en-tête <code>Accept-Language</code> de l'utilisateur ne mentionne + que les réponses de langage <code>es</code>, et si aucune variante + dans cette langue n'est trouvée, c'est la première variante de la + liste définie par la directive <directive module="mod_negotiation" + >LanguagePriority</directive> qui sera servie.</p> + + <example> + LanguagePriority en fr de<br /> + ForceLanguagePriority Fallback + </example> + + <p>Les deux options, <code>Prefer</code> et <code>Fallback</code>, + peuvent être spécifiées, de façon à ce que la variante servie soit + la première variante qui convient définie par la directive + <directive module="mod_negotiation">LanguagePriority</directive> si + plusieurs variantes sont également acceptables, ou le premier + document disponible si aucune variante ne convient à la liste de + langages acceptables fournie par le client.</p> +</usage> +<seealso><directive module="mod_mime">AddLanguage</directive></seealso> +</directivesynopsis> + +<directivesynopsis> +<name>LanguagePriority</name> +<description>L'ordre de priorité des variantes de langages pour les +cas où le client n'a pas formulé de préférences</description> +<syntax>LanguagePriority <var>langage-MIME</var> [<var>langage-MIME</var>] +...</syntax> +<contextlist><context>server config</context><context>virtual host</context> +<context>directory</context><context>.htaccess</context></contextlist> +<override>FileInfo</override> + +<usage> + <p>La directive <directive>LanguagePriority</directive> permet de + définir, au cours du traitement d'une requête Multivues, l'ordre de + priorité des variantes de langages pour les cas + où le client n'a pas formulé de préférences. La liste énumère les + <var>langages-MIME</var> dans un ordre de préférences + décroissantes.</p> + + <example><title>Exemple:</title> + LanguagePriority en fr de + </example> + + <p>Dans le cas d'une requête pour <code>foo.html</code>, si + <code>foo.html.fr</code> et <code>foo.html.de</code> existent, et si + le client n'a pas formulé de préférences, c'est le fichier + <code>foo.html.fr</code> qui sera renvoyé.</p> + + <p>Notez que cette directive n'a d'effet que si le 'meilleur' + langage n'a pas pu être déterminé d'une autre manière ou si la + valeur de la directive <directive + module="mod_negotiation">ForceLanguagePriority</directive> est + différente de <code>None</code>. En général, c'est le client qui + détermine le langage préféré, non le serveur.</p> +</usage> +<seealso><directive module="mod_mime">AddLanguage</directive></seealso> +</directivesynopsis> + +</modulesynopsis> diff --git a/docs/manual/mod/mod_negotiation.xml.meta b/docs/manual/mod/mod_negotiation.xml.meta index 838e17f383..a6f22c10da 100644 --- a/docs/manual/mod/mod_negotiation.xml.meta +++ b/docs/manual/mod/mod_negotiation.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_remoteip.html b/docs/manual/mod/mod_remoteip.html index 188a3c6e51..45439c7431 100644 --- a/docs/manual/mod/mod_remoteip.html +++ b/docs/manual/mod/mod_remoteip.html @@ -3,3 +3,7 @@ URI: mod_remoteip.html.en Content-Language: en Content-type: text/html; charset=ISO-8859-1 + +URI: mod_remoteip.html.fr +Content-Language: fr +Content-type: text/html; charset=ISO-8859-1 diff --git a/docs/manual/mod/mod_remoteip.html.en b/docs/manual/mod/mod_remoteip.html.en index 4263570135..c9c9d9f884 100644 --- a/docs/manual/mod/mod_remoteip.html.en +++ b/docs/manual/mod/mod_remoteip.html.en @@ -21,7 +21,8 @@ <div id="page-content"> <div id="preamble"><h1>Apache Module mod_remoteip</h1> <div class="toplang"> -<p><span>Available Languages: </span><a href="../en/mod/mod_remoteip.html" title="English"> en </a></p> +<p><span>Available Languages: </span><a href="../en/mod/mod_remoteip.html" title="English"> en </a> | +<a href="../fr/mod/mod_remoteip.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>Replaces the apparent client remote IP address and hostname for the request with the IP address list presented by a proxies or a load @@ -271,7 +272,8 @@ balancer via the request headers. </div> </div> <div class="bottomlang"> -<p><span>Available Languages: </span><a href="../en/mod/mod_remoteip.html" title="English"> en </a></p> +<p><span>Available Languages: </span><a href="../en/mod/mod_remoteip.html" title="English"> en </a> | +<a href="../fr/mod/mod_remoteip.html" hreflang="fr" rel="alternate" title="Français"> fr </a></p> </div><div id="footer"> <p class="apache">Copyright 2009 The Apache Software Foundation.<br />Licensed under the <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="../faq/">FAQ</a> | <a href="../glossary.html">Glossary</a> | <a href="../sitemap.html">Sitemap</a></p></div> diff --git a/docs/manual/mod/mod_remoteip.html.fr b/docs/manual/mod/mod_remoteip.html.fr new file mode 100644 index 0000000000..7005b02541 --- /dev/null +++ b/docs/manual/mod/mod_remoteip.html.fr @@ -0,0 +1,322 @@ +<?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_remoteip - 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 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="../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.3</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.3</a> > <a href="./">Modules</a></div> +<div id="page-content"> +<div id="preamble"><h1>Module Apache mod_remoteip</h1> +<div class="toplang"> +<p><span>Langues Disponibles: </span><a href="../en/mod/mod_remoteip.html" hreflang="en" rel="alternate" title="English"> en </a> | +<a href="../fr/mod/mod_remoteip.html" title="Français"> fr </a></p> +</div> +<table class="module"><tr><th><a href="module-dict.html#Description">Description:</a></th><td>Remplace l'adresse IP et le nom d'hôte apparents du client +pour la requête par l'adresse IP présentée par un mandataire ou un +répartiteur de charge via les en-têtes de la requête. +</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>remoteip_module</td></tr> +<tr><th><a href="module-dict.html#SourceFile">Fichier Source:</a></th><td>mod_remoteip.c</td></tr></table> +<h3>Sommaire</h3> + + <p>Ce module permet de traiter l'hôte distant qui a initié la + requête en tant qu'hôte distant original du point de vue de httpd à + des fins d'autorisation et de connexion, même si cet hôte distant se + trouve derrière un répartiteur de charge, un serveur frontal, ou un + serveur mandataire.</p> + + <p>Le module remplace les adresse IP et nom d'hôte apparents + distants (du client) pour la requête par l'adresse IP indiquée dans + l'en-tête de requête configuré via la directive + <code class="directive">RemoteIPHeader</code>.</p> + + <p>Une fois remplacée comme indiqué, cette adresse IP apparente est + utilisée pour les fonctionnalités <code class="directive"><a href="../mod/mod_authz_host.html#require host"><Require host></a></code> et <code class="directive"><a href="../mod/mod_authz_host.html#require ip"><Require ip></a></code> de + <code class="module"><a href="../mod/mod_authz_host.html">mod_authz_host</a></code> ; elle est aussi affichée par + <code class="module"><a href="../mod/mod_status.html">mod_status</a></code>, et enregistrée via les directives + <code>%a</code> et <code>%h</code> du module + <code class="module"><a href="../mod/mod_log_config.html">mod_log_config</a></code>. Elle permet aussi d'identifier la + machine en essayant de lui attribuer une identité inetd via le + module <code class="module"><a href="../mod/mod_ident.html">mod_ident</a></code> et en fonction de la configuration + de la directive <code class="directive"><a href="../mod/mod_ident.html#identitycheck">IdentityCheck</a></code>.</p> + + <div class="warning">Il est essentiel de n'activer cette + fonctionnalité que pour les requêtes en provenance des serveurs + intermédiaires (mandataires, etc...) auxquels le serveur peut faire + confiance, car il est trivial pour le client distant d'usurper + l'identité d'un autre client.</div> +</div> +<div id="quickview"><h3 class="directives">Directives</h3> +<ul id="toc"> +<li><img alt="" src="../images/down.gif" /> <a href="#remoteipheader">RemoteIPHeader</a></li> +<li><img alt="" src="../images/down.gif" /> <a href="#remoteipinternalproxy">RemoteIPInternalProxy</a></li> +<li><img alt="" src="../images/down.gif" /> <a href="#remoteipinternalproxylist">RemoteIPInternalProxyList</a></li> +<li><img alt="" src="../images/down.gif" /> <a href="#remoteipproxiesheader">RemoteIPProxiesHeader</a></li> +<li><img alt="" src="../images/down.gif" /> <a href="#remoteiptrustedproxy">RemoteIPTrustedProxy</a></li> +<li><img alt="" src="../images/down.gif" /> <a href="#remoteiptrustedproxylist">RemoteIPTrustedProxyList</a></li> +</ul> +<h3>Sujets</h3> +<ul id="topics"> +<li><img alt="" src="../images/down.gif" /> <a href="#processing">Traitement des adresses distantes</a></li> +</ul><h3>Voir aussi</h3> +<ul class="seealso"> +<li><code class="module"><a href="../mod/mod_authz_host.html">mod_authz_host</a></code></li> +<li><code class="module"><a href="../mod/mod_status.html">mod_status</a></code></li> +<li><code class="module"><a href="../mod/mod_log_config.html">mod_log_config</a></code></li> +<li><code class="module"><a href="../mod/mod_ident.html">mod_ident</a></code></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="processing" id="processing">Traitement des adresses distantes</a></h2> + + <p>Apache identifie le client par la valeur remote_ip de la + connexion, et de cette valeur découlent les valeurs remote_host et + remote_logname de la connexion. Ces champs jouent un rôle + dans l'authentification, l'autorisation et la connexion, ainsi que + dans d'autres traitements effectués par d'autres modules + chargeables.</p> + + <p>mod_remoteip remplace la véritable remote_ip par la remote_ip + indiquée par exemple par un mandataire chaque fois que le serveur + effectue une évaluation du client, et réinitialise les valeurs de + remote_host et remote_logname afin de déclencher une nouvelle + requête dns ou ident sur l'adresse IP distante.</p> + + <p>Lorsque la valeur de l'en-tête comporte plusieurs adresses IP + distantes séparées par des virgules, celles-ci sont traitées de la + droite vers la gauche. Le traitement s'arrête lorsque l'adresse IP + distante courante n'est pas digne de confiance pour présenter + l'adresse IP précédente. Le champ d'en-tête est alors mis à jour de + façon à ne contenir que cette liste d'adresses non confirmées, ou + bien, si toutes les adresses IP sont dignes de confiance, cet + en-tête est tout bonnement supprimé de la requête.</p> + + <p>Lors du remplacement de l'adresse IP distante, le module stocke + la liste des hôtes intermédiaires dans un mémo + remoteip-proxy-ip-list, que l'on peut faire enregistrer par + <code class="module"><a href="../mod/mod_log_config.html">mod_log_config</a></code> en utilisant le symbole de format + <code>%{remoteip-proxy-ip-list}n</code>. Si l'administrateur doit + stocker ceci dans un en-tête additionnel, la même valeur peut aussi + être enregistrée sous la forme d'un en-tête en utilisant la + directive <code class="directive">RemoteIPProxiesHeader</code>.</p> + + <div class="note"><h3>Adresses IPv4 converties au format IPv6</h3> + Avec httpd, d'une manière générale, toute adresse IPv4 convertie au + format IPv6 est enregistrée sous sa forme IPv4.</div> + + <div class="note"><h3>Adresses internes (privées)</h3> + Tous les blocs d'adresses internes 10/8, 172.16/12, 192.168/16, + 169.254/16 and 127/8 (ainsi que les adresses IPv6 en dehors du bloc + public 2000::/3 block) ne sont évaluées par mod_remoteip que lorsque + des mandataires internes (intranet) + <code class="directive">RemoteIPInternalProxy</code> sont enregistrés.</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="RemoteIPHeader" id="RemoteIPHeader">RemoteIPHeader</a> <a name="remoteipheader" id="remoteipheader">Directive</a></h2> +<table class="directive"> +<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Définit le champ d'en-tête qui contiendra les adresses IP +du client</td></tr> +<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>RemoteIPHeader <var>en-tête</var></code></td></tr> +<tr><th><a href="directive-dict.html#Context">Contexte:</a></th><td>configuration du serveur, serveur virtuel</td></tr> +<tr><th><a href="directive-dict.html#Status">Statut:</a></th><td>Base</td></tr> +<tr><th><a href="directive-dict.html#Module">Module:</a></th><td>mod_remoteip</td></tr> +</table> + <p>La directive <code class="directive">RemoteIPHeader</code> indique à + <code class="module"><a href="../mod/mod_remoteip.html">mod_remoteip</a></code> de traiter la valeur de + l'<var>en-tête</var> spécifié comme l'adresse IP du client, ou comme + une liste d'adresses IP clients intermédiaires, en fonction de la + configuration des directives + <code class="directive">RemoteIPInternalProxy</code> et + <code class="directive">RemoteIPTrustedProxy</code>. Si ces deux dernières + directives ne sont pas utilisées, <code class="module"><a href="../mod/mod_remoteip.html">mod_remoteip</a></code> + traitera tout hôte présentant une valeur d'IP + <code class="directive">RemoteIPHeader</code> comme hôte de confiance.</p> + + <div class="example"><h3>Exemple à usage interne (répartiteur de + charge)</h3><p><code> + RemoteIPHeader X-Client-IP + </code></p></div> + + <div class="example"><h3>Exemple dans le cas d'un mandataire</h3><p><code> + RemoteIPHeader X-Forwarded-For + </code></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="RemoteIPInternalProxy" id="RemoteIPInternalProxy">RemoteIPInternalProxy</a> <a name="remoteipinternalproxy" id="remoteipinternalproxy">Directive</a></h2> +<table class="directive"> +<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Déclare les adresses IP intranet clients comme dignes de +confiance pour présenter la valeur RemoteIPHeader</td></tr> +<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>RemoteIPInternalProxy +<var>ip-mandataire</var>|<var>ip-mandataire/sous-réseau</var>|<var>nom-hôte</var> ...</code></td></tr> +<tr><th><a href="directive-dict.html#Context">Contexte:</a></th><td>configuration du serveur, serveur virtuel</td></tr> +<tr><th><a href="directive-dict.html#Status">Statut:</a></th><td>Base</td></tr> +<tr><th><a href="directive-dict.html#Module">Module:</a></th><td>mod_remoteip</td></tr> +</table> + <p>La directive <code class="directive">RemoteIPInternalProxy</code> permet + d'ajouter une ou plusieurs adresses (ou blocs d'adresses) auxquelles + on peut faire confiance pour présenter une valeur RemoteIPHeader + valide de l'adresse IP du client. A la différence de la directive + <code class="directive">RemoteIPTrustedProxy</code>, toute adresse IP + présentée dans cet en-tête, y comprises les adresses intranet + privées, sont considérées comme dignes de confiance lorsqu'elles + sont indiquées par ces mandataires.</p> + + <div class="example"><h3>Exemple à usage interne (répartiteur de + charge)</h3><p><code> + RemoteIPHeader X-Client-IP<br /> + RemoteIPTrustedProxy 10.0.2.0/24<br /> + RemoteIPTrustedProxy passerelle.domaine-local + </code></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="RemoteIPInternalProxyList" id="RemoteIPInternalProxyList">RemoteIPInternalProxyList</a> <a name="remoteipinternalproxylist" id="remoteipinternalproxylist">Directive</a></h2> +<table class="directive"> +<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Déclare les adresses IP intranet clients comme dignes de +confiance pour présenter la valeur RemoteIPHeader</td></tr> +<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>RemoteIPInternalProxyList <var>nom-fichier</var></code></td></tr> +<tr><th><a href="directive-dict.html#Context">Contexte:</a></th><td>configuration du serveur, serveur virtuel</td></tr> +<tr><th><a href="directive-dict.html#Status">Statut:</a></th><td>Base</td></tr> +<tr><th><a href="directive-dict.html#Module">Module:</a></th><td>mod_remoteip</td></tr> +</table> + <p>La directive <code class="directive">RemoteIPInternalProxyList</code> + permet de spécifier un fichier parcouru au démarrage du serveur pour + construire une liste d'adresses (ou blocs d'adresses), auxquelles + on peut faire confiance pour présenter une valeur RemoteIPHeader + valide de l'adresse IP du client.</p> + + <p>Le caractère '<code>#</code>' indique une ligne de commentaires, + sinon, toutes les lignes séparées par un caractère <code>nouvelle + ligne</code> ou + tous les éléments d'une ligne séparés par un espace sont traités de + la même façon qu'avec la directive + <code class="directive">RemoteIPInternalProxy</code>.</p> + + <div class="example"><h3>Exemple à usage interne (répartiteur de + charge)</h3><p><code> + RemoteIPHeader X-Client-IP<br /> + RemoteIPTrustedProxyList conf/mandataires-de-confiance.lst + </code></p></div> + + <div class="example"><h3>contenu de conf/mandataires-de-confiance.lst</h3><p><code> + # Nos mandataires internes de confiance<br /> + 10.0.2.0/24 # Tout le monde dans le groupe de test<br /> + passerelle.domaine-local # Le frontal répartiteur de charge + </code></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="RemoteIPProxiesHeader" id="RemoteIPProxiesHeader">RemoteIPProxiesHeader</a> <a name="remoteipproxiesheader" id="remoteipproxiesheader">Directive</a></h2> +<table class="directive"> +<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Déclare le champ d'en-tête qui contiendra toutes les +adresses IP intermédiaires</td></tr> +<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>RemoteIPProxiesHeader <var>Nom_en-tête</var></code></td></tr> +<tr><th><a href="directive-dict.html#Context">Contexte:</a></th><td>configuration du serveur, serveur virtuel</td></tr> +<tr><th><a href="directive-dict.html#Status">Statut:</a></th><td>Base</td></tr> +<tr><th><a href="directive-dict.html#Module">Module:</a></th><td>mod_remoteip</td></tr> +</table> + <p>La directive <code class="directive">RemoteIPProxiesHeader</code> permet + de spécifier l'en-tête dans lequel <code class="module"><a href="../mod/mod_remoteip.html">mod_remoteip</a></code> va + collecter une liste de toutes les adresses IP clients intermédiaires + auxquelles on pourra faire confiance pour résoudre la véritable + adresse IP distante. Notez que les adresses intermédiaires + <code class="directive">RemoteIPTrustedProxy</code> sont enregistrées dans + cet en-tête, alors que toute adresse intermédiaire + <code class="directive">RemoteIPInternalProxy</code> est omise.</p> + + <div class="example"><h3>Exemple</h3><p><code> + RemoteIPHeader X-Forwarded-For<br /> + RemoteIPProxiesHeader X-Forwarded-By + </code></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="RemoteIPTrustedProxy" id="RemoteIPTrustedProxy">RemoteIPTrustedProxy</a> <a name="remoteiptrustedproxy" id="remoteiptrustedproxy">Directive</a></h2> +<table class="directive"> +<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Déclare les adresses IP intranet clients comme dignes de +confiance pour présenter la valeur RemoteIPHeader</td></tr> +<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>RemoteIPTrustedProxy +<var>ip-mandataire</var>|<var>ip-mandataire/sous-réseau</var>|<var>nom-hôte</var> ...</code></td></tr> +<tr><th><a href="directive-dict.html#Context">Contexte:</a></th><td>configuration du serveur, serveur virtuel</td></tr> +<tr><th><a href="directive-dict.html#Status">Statut:</a></th><td>Base</td></tr> +<tr><th><a href="directive-dict.html#Module">Module:</a></th><td>mod_remoteip</td></tr> +</table> + <p>La directive <code class="directive">RemoteIPTrustedProxy</code> permet + d'ajouter une ou plusieurs adresses, ou blocs d'adresses, auxquelles + on peut faire confiance pour présenter une valeur RemoteIPHeader + valide de l'adresse IP du client. A la différence de la directive + <code class="directive">RemoteIPInternalProxy</code>, toutes les adresses IP + intranet ou privées indiquées par de tels mandataires, y compris les + blocs d'adresses 10/8, 172.16/12, 192.168/16, 169.254/16 et 127/8 + (ou située en dehors du bloc IPv6 public 2000::/3), ne sont pas + dignes de confiance en tant qu'adresses IP distantes, et se situent + à gauche dans le contenu de l'en-tête + <code class="directive">RemoteIPHeader</code>.</p> + + <div class="example"><h3>Exemple d'adresse de confiance (répartiteur de + charge</h3><p><code> + RemoteIPHeader X-Forwarded-For<br /> + RemoteIPTrustedProxy 10.0.2.16/28<br /> + RemoteIPTrustedProxy proxy.example.com + </code></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="RemoteIPTrustedProxyList" id="RemoteIPTrustedProxyList">RemoteIPTrustedProxyList</a> <a name="remoteiptrustedproxylist" id="remoteiptrustedproxylist">Directive</a></h2> +<table class="directive"> +<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Déclare les adresses IP intranet clients comme dignes de +confiance pour présenter la valeur RemoteIPHeader</td></tr> +<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>RemoteIPTrustedProxyList <var>nom-fichier</var></code></td></tr> +<tr><th><a href="directive-dict.html#Context">Contexte:</a></th><td>configuration du serveur, serveur virtuel</td></tr> +<tr><th><a href="directive-dict.html#Status">Statut:</a></th><td>Base</td></tr> +<tr><th><a href="directive-dict.html#Module">Module:</a></th><td>mod_remoteip</td></tr> +</table> + <p>La directive <code class="directive">RemoteIPTrustedProxyList</code> + permet de spécifier un fichier parcouru au démarrage du serveur pour + construire une liste d'adresses (ou blocs d'adresses), auxquelles + on peut faire confiance pour présenter une valeur RemoteIPHeader + valide de l'adresse IP du client.</p> + + <p>Le caractère '<code>#</code>' indique une ligne de commentaires, + sinon, toutes les lignes séparées par un caractère nouvelle ligne ou + tous les éléments d'une ligne séparés par un espace sont traités de + la même façon qu'avec la directive + <code class="directive">RemoteIPTrustedProxy</code>.</p> + + <div class="example"><h3>Exemple d'adresse de confiance (répartiteur de + charge</h3><p><code> + RemoteIPHeader X-Forwarded-For<br /> + RemoteIPTrustedProxyList conf/mandataires-de-confiance.lst + </code></p></div> + + <div class="example"><h3>conf/mandataires-de-confiance.lst contents</h3><p><code> + # Mandataires externes identifiés<br /> + 192.0.2.16/28 #groupe wap phone de mandataires<br /> + proxy.isp.example.com #un FAI bien connu + </code></p></div> + +</div> +</div> +<div class="bottomlang"> +<p><span>Langues Disponibles: </span><a href="../en/mod/mod_remoteip.html" hreflang="en" rel="alternate" title="English"> en </a> | +<a href="../fr/mod/mod_remoteip.html" title="Français"> fr </a></p> +</div><div id="footer"> +<p class="apache">Copyright 2009 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="../faq/">FAQ</a> | <a href="../glossary.html">Glossaire</a> | <a href="../sitemap.html">Plan du site</a></p></div> +</body></html>
\ No newline at end of file diff --git a/docs/manual/mod/mod_remoteip.xml.fr b/docs/manual/mod/mod_remoteip.xml.fr new file mode 100644 index 0000000000..26f6bd34b7 --- /dev/null +++ b/docs/manual/mod/mod_remoteip.xml.fr @@ -0,0 +1,301 @@ +<?xml version="1.0"?> +<!DOCTYPE modulesynopsis SYSTEM "../style/modulesynopsis.dtd"> +<?xml-stylesheet type="text/xsl" href="../style/manual.fr.xsl"?> +<!-- English Revision : 784558 --> +<!-- 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_remoteip.xml.meta"> + +<name>mod_remoteip</name> +<description>Remplace l'adresse IP et le nom d'hôte apparents du client +pour la requête par l'adresse IP présentée par un mandataire ou un +répartiteur de charge via les en-têtes de la requête. +</description> + +<status>Base</status> +<sourcefile>mod_remoteip.c</sourcefile> +<identifier>remoteip_module</identifier> + +<summary> + <p>Ce module permet de traiter l'hôte distant qui a initié la + requête en tant qu'hôte distant original du point de vue de httpd à + des fins d'autorisation et de connexion, même si cet hôte distant se + trouve derrière un répartiteur de charge, un serveur frontal, ou un + serveur mandataire.</p> + + <p>Le module remplace les adresse IP et nom d'hôte apparents + distants (du client) pour la requête par l'adresse IP indiquée dans + l'en-tête de requête configuré via la directive + <directive>RemoteIPHeader</directive>.</p> + + <p>Une fois remplacée comme indiqué, cette adresse IP apparente est + utilisée pour les fonctionnalités <directive module="mod_authz_host" + type="section">Require host</directive> et <directive + module="mod_authz_host" type="section">Require ip</directive> de + <module>mod_authz_host</module> ; elle est aussi affichée par + <module>mod_status</module>, et enregistrée via les directives + <code>%a</code> et <code>%h</code> du module + <module>mod_log_config</module>. Elle permet aussi d'identifier la + machine en essayant de lui attribuer une identité inetd via le + module <module>mod_ident</module> et en fonction de la configuration + de la directive <directive + module="mod_ident">IdentityCheck</directive>.</p> + + <note type="warning">Il est essentiel de n'activer cette + fonctionnalité que pour les requêtes en provenance des serveurs + intermédiaires (mandataires, etc...) auxquels le serveur peut faire + confiance, car il est trivial pour le client distant d'usurper + l'identité d'un autre client.</note> +</summary> + +<seealso><module>mod_authz_host</module></seealso> +<seealso><module>mod_status</module></seealso> +<seealso><module>mod_log_config</module></seealso> +<seealso><module>mod_ident</module></seealso> + +<section id="processing"><title>Traitement des adresses distantes</title> + + <p>Apache identifie le client par la valeur remote_ip de la + connexion, et de cette valeur découlent les valeurs remote_host et + remote_logname de la connexion. Ces champs jouent un rôle + dans l'authentification, l'autorisation et la connexion, ainsi que + dans d'autres traitements effectués par d'autres modules + chargeables.</p> + + <p>mod_remoteip remplace la véritable remote_ip par la remote_ip + indiquée par exemple par un mandataire chaque fois que le serveur + effectue une évaluation du client, et réinitialise les valeurs de + remote_host et remote_logname afin de déclencher une nouvelle + requête dns ou ident sur l'adresse IP distante.</p> + + <p>Lorsque la valeur de l'en-tête comporte plusieurs adresses IP + distantes séparées par des virgules, celles-ci sont traitées de la + droite vers la gauche. Le traitement s'arrête lorsque l'adresse IP + distante courante n'est pas digne de confiance pour présenter + l'adresse IP précédente. Le champ d'en-tête est alors mis à jour de + façon à ne contenir que cette liste d'adresses non confirmées, ou + bien, si toutes les adresses IP sont dignes de confiance, cet + en-tête est tout bonnement supprimé de la requête.</p> + + <p>Lors du remplacement de l'adresse IP distante, le module stocke + la liste des hôtes intermédiaires dans un mémo + remoteip-proxy-ip-list, que l'on peut faire enregistrer par + <module>mod_log_config</module> en utilisant le symbole de format + <code>%{remoteip-proxy-ip-list}n</code>. Si l'administrateur doit + stocker ceci dans un en-tête additionnel, la même valeur peut aussi + être enregistrée sous la forme d'un en-tête en utilisant la + directive <directive>RemoteIPProxiesHeader</directive>.</p> + + <note><title>Adresses IPv4 converties au format IPv6</title> + Avec httpd, d'une manière générale, toute adresse IPv4 convertie au + format IPv6 est enregistrée sous sa forme IPv4.</note> + + <note><title>Adresses internes (privées)</title> + Tous les blocs d'adresses internes 10/8, 172.16/12, 192.168/16, + 169.254/16 and 127/8 (ainsi que les adresses IPv6 en dehors du bloc + public 2000::/3 block) ne sont évaluées par mod_remoteip que lorsque + des mandataires internes (intranet) + <directive>RemoteIPInternalProxy</directive> sont enregistrés.</note> + +</section> + +<directivesynopsis> +<name>RemoteIPHeader</name> +<description>Définit le champ d'en-tête qui contiendra les adresses IP +du client</description> +<syntax>RemoteIPHeader <var>en-tête</var></syntax> +<contextlist><context>server config</context><context>virtual host</context></contextlist> + +<usage> + <p>La directive <directive>RemoteIPHeader</directive> indique à + <module>mod_remoteip</module> de traiter la valeur de + l'<var>en-tête</var> spécifié comme l'adresse IP du client, ou comme + une liste d'adresses IP clients intermédiaires, en fonction de la + configuration des directives + <directive>RemoteIPInternalProxy</directive> et + <directive>RemoteIPTrustedProxy</directive>. Si ces deux dernières + directives ne sont pas utilisées, <module>mod_remoteip</module> + traitera tout hôte présentant une valeur d'IP + <directive>RemoteIPHeader</directive> comme hôte de confiance.</p> + + <example><title>Exemple à usage interne (répartiteur de + charge)</title> + RemoteIPHeader X-Client-IP + </example> + + <example><title>Exemple dans le cas d'un mandataire</title> + RemoteIPHeader X-Forwarded-For + </example> +</usage> +</directivesynopsis> + +<directivesynopsis> +<name>RemoteIPInternalProxy</name> +<description>Déclare les adresses IP intranet clients comme dignes de +confiance pour présenter la valeur RemoteIPHeader</description> +<syntax>RemoteIPInternalProxy +<var>ip-mandataire</var>|<var>ip-mandataire/sous-réseau</var>|<var>nom-hôte</var> ...</syntax> +<contextlist><context>server config</context><context>virtual host</context></contextlist> + +<usage> + <p>La directive <directive>RemoteIPInternalProxy</directive> permet + d'ajouter une ou plusieurs adresses (ou blocs d'adresses) auxquelles + on peut faire confiance pour présenter une valeur RemoteIPHeader + valide de l'adresse IP du client. A la différence de la directive + <directive>RemoteIPTrustedProxy</directive>, toute adresse IP + présentée dans cet en-tête, y comprises les adresses intranet + privées, sont considérées comme dignes de confiance lorsqu'elles + sont indiquées par ces mandataires.</p> + + <example><title>Exemple à usage interne (répartiteur de + charge)</title> + RemoteIPHeader X-Client-IP<br/> + RemoteIPTrustedProxy 10.0.2.0/24<br/> + RemoteIPTrustedProxy passerelle.domaine-local + </example> +</usage> +</directivesynopsis> + +<directivesynopsis> +<name>RemoteIPInternalProxyList</name> +<description>Déclare les adresses IP intranet clients comme dignes de +confiance pour présenter la valeur RemoteIPHeader</description> +<syntax>RemoteIPInternalProxyList <var>nom-fichier</var></syntax> +<contextlist><context>server config</context><context>virtual host</context></contextlist> + +<usage> + <p>La directive <directive>RemoteIPInternalProxyList</directive> + permet de spécifier un fichier parcouru au démarrage du serveur pour + construire une liste d'adresses (ou blocs d'adresses), auxquelles + on peut faire confiance pour présenter une valeur RemoteIPHeader + valide de l'adresse IP du client.</p> + + <p>Le caractère '<code>#</code>' indique une ligne de commentaires, + sinon, toutes les lignes séparées par un caractère <code>nouvelle + ligne</code> ou + tous les éléments d'une ligne séparés par un espace sont traités de + la même façon qu'avec la directive + <directive>RemoteIPInternalProxy</directive>.</p> + + <example><title>Exemple à usage interne (répartiteur de + charge)</title> + RemoteIPHeader X-Client-IP<br/> + RemoteIPTrustedProxyList conf/mandataires-de-confiance.lst + </example> + + <example><title>contenu de conf/mandataires-de-confiance.lst</title> + # Nos mandataires internes de confiance<br/> + 10.0.2.0/24 # Tout le monde dans le groupe de test<br/> + passerelle.domaine-local # Le frontal répartiteur de charge + </example> +</usage> +</directivesynopsis> + +<directivesynopsis> +<name>RemoteIPProxiesHeader</name> +<description>Déclare le champ d'en-tête qui contiendra toutes les +adresses IP intermédiaires</description> +<syntax>RemoteIPProxiesHeader <var>Nom_en-tête</var></syntax> +<contextlist><context>server config</context><context>virtual host</context></contextlist> + +<usage> + <p>La directive <directive>RemoteIPProxiesHeader</directive> permet + de spécifier l'en-tête dans lequel <module>mod_remoteip</module> va + collecter une liste de toutes les adresses IP clients intermédiaires + auxquelles on pourra faire confiance pour résoudre la véritable + adresse IP distante. Notez que les adresses intermédiaires + <directive>RemoteIPTrustedProxy</directive> sont enregistrées dans + cet en-tête, alors que toute adresse intermédiaire + <directive>RemoteIPInternalProxy</directive> est omise.</p> + + <example><title>Exemple</title> + RemoteIPHeader X-Forwarded-For<br/> + RemoteIPProxiesHeader X-Forwarded-By + </example> +</usage> +</directivesynopsis> + +<directivesynopsis> +<name>RemoteIPTrustedProxy</name> +<description>Déclare les adresses IP intranet clients comme dignes de +confiance pour présenter la valeur RemoteIPHeader</description> +<syntax>RemoteIPTrustedProxy +<var>ip-mandataire</var>|<var>ip-mandataire/sous-réseau</var>|<var>nom-hôte</var> ...</syntax> +<contextlist><context>server config</context><context>virtual host</context></contextlist> + +<usage> + <p>La directive <directive>RemoteIPTrustedProxy</directive> permet + d'ajouter une ou plusieurs adresses, ou blocs d'adresses, auxquelles + on peut faire confiance pour présenter une valeur RemoteIPHeader + valide de l'adresse IP du client. A la différence de la directive + <directive>RemoteIPInternalProxy</directive>, toutes les adresses IP + intranet ou privées indiquées par de tels mandataires, y compris les + blocs d'adresses 10/8, 172.16/12, 192.168/16, 169.254/16 et 127/8 + (ou située en dehors du bloc IPv6 public 2000::/3), ne sont pas + dignes de confiance en tant qu'adresses IP distantes, et se situent + à gauche dans le contenu de l'en-tête + <directive>RemoteIPHeader</directive>.</p> + + <example><title>Exemple d'adresse de confiance (répartiteur de + charge</title> + RemoteIPHeader X-Forwarded-For<br/> + RemoteIPTrustedProxy 10.0.2.16/28<br/> + RemoteIPTrustedProxy proxy.example.com + </example> +</usage> +</directivesynopsis> + +<directivesynopsis> +<name>RemoteIPTrustedProxyList</name> +<description>Déclare les adresses IP intranet clients comme dignes de +confiance pour présenter la valeur RemoteIPHeader</description> +<syntax>RemoteIPTrustedProxyList <var>nom-fichier</var></syntax> +<contextlist><context>server config</context><context>virtual host</context></contextlist> + +<usage> + <p>La directive <directive>RemoteIPTrustedProxyList</directive> + permet de spécifier un fichier parcouru au démarrage du serveur pour + construire une liste d'adresses (ou blocs d'adresses), auxquelles + on peut faire confiance pour présenter une valeur RemoteIPHeader + valide de l'adresse IP du client.</p> + + <p>Le caractère '<code>#</code>' indique une ligne de commentaires, + sinon, toutes les lignes séparées par un caractère nouvelle ligne ou + tous les éléments d'une ligne séparés par un espace sont traités de + la même façon qu'avec la directive + <directive>RemoteIPTrustedProxy</directive>.</p> + + <example><title>Exemple d'adresse de confiance (répartiteur de + charge</title> + RemoteIPHeader X-Forwarded-For<br/> + RemoteIPTrustedProxyList conf/mandataires-de-confiance.lst + </example> + + <example><title>conf/mandataires-de-confiance.lst contents</title> + # Mandataires externes identifiés<br/> + 192.0.2.16/28 #groupe wap phone de mandataires<br/> + proxy.isp.example.com #un FAI bien connu + </example> +</usage> +</directivesynopsis> + + +</modulesynopsis> diff --git a/docs/manual/mod/mod_remoteip.xml.meta b/docs/manual/mod/mod_remoteip.xml.meta index 0bfcf1e3be..cf645d620d 100644 --- a/docs/manual/mod/mod_remoteip.xml.meta +++ b/docs/manual/mod/mod_remoteip.xml.meta @@ -8,5 +8,6 @@ <variants> <variant>en</variant> + <variant>fr</variant> </variants> </metafile> diff --git a/docs/manual/mod/mod_so.html b/docs/manual/mod/mod_so.html index 451b67ee9b..17eec825b8 100644 --- a/docs/manual/mod/mod_so.html +++ b/docs/manual/mod/mod_so.html @@ -4,6 +4,10 @@ URI: mod_so.html.en Content-Language: en Content-type: text/html; charset=ISO-8859-1 +URI: mod_so.html.fr +Content-Language: fr +Content-type: text/html; charset=ISO-8859-1 + URI: mod_so.html.ja.utf8 Content-Language: ja Content-type: text/html; charset=UTF-8 diff --git a/docs/manual/mod/mod_so.html.en b/docs/manual/mod/mod_so.html.en index 16107c544a..4bc9595159 100644 --- a/docs/manual/mod/mod_so.html.en +++ b/docs/manual/mod/mod_so.html.en @@ -22,6 +22,7 @@ <div id="preamble"><h1>Apache Module mod_so</h1> <div class="toplang"> <p><span>Available Languages: </span><a href="../en/mod/mod_so.html" title="English"> en </a> | +<a href="../fr/mod/mod_so.html" hreflang="fr" rel="alternate" title="Français"> fr </a> | <a href="../ja/mod/mod_so.html" hreflang="ja" rel="alternate" title="Japanese"> ja </a> | <a href="../ko/mod/mod_so.html" hreflang="ko" rel="alternate" title="Korean"> ko </a> | <a href="../tr/mod/mod_so.html" hreflang="tr" rel="alternate" title="Türkçe"> tr </a></p> @@ -183,6 +184,7 @@ of active modules</td></tr> </div> <div class="bottomlang"> <p><span>Available Languages: </span><a href="../en/mod/mod_so.html" title="English"> en </a> | +<a href="../fr/mod/mod_so.html" hreflang="fr" rel="alternate" title="Français"> fr </a> | <a href="../ja/mod/mod_so.html" hreflang="ja" rel="alternate" title="Japanese"> ja </a> | <a href="../ko/mod/mod_so.html" hreflang="ko" rel="alternate" title="Korean"> ko </a> | <a href="../tr/mod/mod_so.html" hreflang="tr" rel="alternate" title="Türkçe"> tr </a></p> diff --git a/docs/manual/mod/mod_so.html.fr b/docs/manual/mod/mod_so.html.fr new file mode 100644 index 0000000000..b0ec3ba8fd --- /dev/null +++ b/docs/manual/mod/mod_so.html.fr @@ -0,0 +1,206 @@ +<?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_so - 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 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="../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.3</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.3</a> > <a href="./">Modules</a></div> +<div id="page-content"> +<div id="preamble"><h1>Module Apache mod_so</h1> +<div class="toplang"> +<p><span>Langues Disponibles: </span><a href="../en/mod/mod_so.html" hreflang="en" rel="alternate" title="English"> en </a> | +<a href="../fr/mod/mod_so.html" title="Français"> fr </a> | +<a href="../ja/mod/mod_so.html" hreflang="ja" rel="alternate" title="Japanese"> ja </a> | +<a href="../ko/mod/mod_so.html" hreflang="ko" rel="alternate" title="Korean"> ko </a> | +<a href="../tr/mod/mod_so.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>Chargement de modules ou de code exécutable au cours du +démarrage ou du redémarrage du serveur</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>so_module</td></tr> +<tr><th><a href="module-dict.html#SourceFile">Fichier Source:</a></th><td>mod_so.c</td></tr> +<tr><th><a href="module-dict.html#Compatibility">Compatibilité:</a></th><td>Sous Windows, c'est un module de base (toujours +inclus)</td></tr></table> +<h3>Sommaire</h3> + + + <p>Sur les systèmes d'exploitation sélectionnés, ce module peut être + utilisé pour charger des modules dans Apache en cours d'exécution + grâce au mécanisme des <a href="../dso.html">Dynamic Shared Object ou Objets Partagés + Dynamiquement</a> (DSO), et évite ainsi de devoir effectuer une + recompilation.</p> + + <p>Sous Unix, le code chargé provient en général de fichiers objet + partagés possèdant en général l'extension <code>.so</code>, alors + que sous Windows, l'extension peut être soit <code>.so</code>, soit + <code>.dll</code>.</p> + + <div class="warning"><h3>Avertissement</h3> + <p>Les modules Apache 1.3 ne peuvent pas être utilisés directement + avec Apache 2.0 - ils doivent être modifiés pour pouvoir être + chargés dynamiquement ou compilés dans Apache 2.0.</p> + </div> +</div> +<div id="quickview"><h3 class="directives">Directives</h3> +<ul id="toc"> +<li><img alt="" src="../images/down.gif" /> <a href="#loadfile">LoadFile</a></li> +<li><img alt="" src="../images/down.gif" /> <a href="#loadmodule">LoadModule</a></li> +</ul> +<h3>Sujets</h3> +<ul id="topics"> +<li><img alt="" src="../images/down.gif" /> <a href="#windows">Création de modules chargeables pour +Windows</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="windows" id="windows">Création de modules chargeables pour +Windows</a></h2> + + <div class="note"><h3>Note</h3> + <p>Le format des noms de modules pour Windows a été modifié avec + Apache 1.3.15 et 2.0 - les modules possèdent maintenant un nom du + style "mod_foo.so".</p> + + <p>Bien que mod_so puisse encore charger des modules possèdant un + nom du style ApacheModuleFoo.dll, il est préférable d'utiliser la + nouvelle convention de nommage ; si vous modifiez votre module + chargeable pour la version 2.0, veuillez aussi modifier son nom pour + respecter cette nouvelle convention.</p></div> + + <p>Les API des modules Apache sous Unix et Windows sont identiques. + Alors que certains modules s'appuient sur certains + aspects de l'architecture Unix non présents dans Windows, et ne + fonctionneront donc pas sur cette dernière plate-forme, de nombreux + modules fonctionnent sous Windows avec peu ou pas de modification + par rapport à leur version Unix.</p> + + <p>Lorsqu'un module fonctionne, il peut être ajouté au serveur de + deux manières. Sous Unix, il peut être compilé dans le serveur. + Comme Apache pour Windows ne dispose pas du programme + <code>Configure</code> propre à Apache pour Unix, le fichier source + du module doit être ajouté au fichier projet Apache de base, et ses + symboles ajoutés au fichier <code>os\win32\modules.c</code>.</p> + + <p>La seconde méthode consiste à compiler le module en tant que DLL, + à savoir une bibliothèque partagée qui pourra être chargée dans le + serveur en cours d'exécution via la directive + <code><code class="directive">LoadModule</code></code>. Ces modules DLL + peuvent être distribués et exécutés sur toute installation d'Apache + pour Windows, sans avoir à recompiler le serveur.</p> + + <p>Pour créer un module DLL, il est nécessaire d'apporter une légère + modification à son fichier source : l'enregistrement du module doit + être exporté depuis la DLL (qui sera elle-même créée plus tard ; + voir plus loin). Pour ce faire, ajoutez la macro + <code>AP_MODULE_DECLARE_DATA</code> (définie dans les fichiers + d'en-têtes d'Apache) à la définition de l'enregistrement de votre + module. Par exemple, si votre module est déclaré comme suit :</p> + +<div class="example"><p><code> + module foo_module; +</code></p></div> + + <p>Remplacez cette ligne par :</p> +<div class="example"><p><code> + module AP_MODULE_DECLARE_DATA foo_module; +</code></p></div> + + <p>Notez que cette macro ne sera prise en compte que sous Windows, + si bien que le module poura être utilisé sans changement sous Unix, + si besoin est. Alternativement, si vous êtes familier avec les + fichiers <code>.DEF</code>, vous pouvez les utiliser pour exporter + l'enregistrement du module.</p> + + <p>Maintenant, nous sommes prêts à créer une DLL contenant notre + module. Il va falloir pour cela la lier avec la bibliothèque + d'export libhttpd.lib qui a été créée au cours de la compilation de + la bibliothèque partagée libhttpd.dll. Il sera peut-être aussi + nécessaire de modifier la configuration du compilateur pour + s'assurer que les fichiers d'en-têtes d'Apache seront correctement + localisés. Vous trouverez cette bibliothèque à la racine du + répertoire des modules de votre serveur. Il est souhaitable + d'utiliser un fichier de module .dsp existant dans l'arborescence + afin de s'assurer que l'environnement de compilation est + correctement configuré, mais vous pouvez aussi comparer les options + de compilation et d'édition de liens à votre fichier .dsp.</p> + + <p>Ceci devrait créer une version DLL de votre module. Il vous + suffit maintenant de l'enregistrer dans le répertoire + <code>modules</code> à la racine de votre serveur, et d'utiliser la + directive <code class="directive">LoadModule</code> pour la charger.</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="LoadFile" id="LoadFile">LoadFile</a> <a name="loadfile" id="loadfile">Directive</a></h2> +<table class="directive"> +<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Liaison du fichier objet ou de la bibliothèque +spécifié</td></tr> +<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>LoadFile <em>nom-fichier</em> [<em>nom-fichier</em>] ...</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>Extension</td></tr> +<tr><th><a href="directive-dict.html#Module">Module:</a></th><td>mod_so</td></tr> +</table> + + <p>La directive LoadFile permet de lier le fichier objet ou la + bibliothèque spécifié au serveur lors du démarrage ou du redémarrage + de ce dernier ; ceci permet d'ajouter tout code additionnel + nécessaire au fonctionnement d'un module. + <em>nom-fichier</em> est soit un chemin absolu, soit un chemin + relatif au répertoire défini par la directive <a href="core.html#serverroot">ServerRoot</a>.</p> + + <p>Par exemple:</p> + + <div class="example"><p><code>LoadFile libexec/libxmlparse.so</code></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="LoadModule" id="LoadModule">LoadModule</a> <a name="loadmodule" id="loadmodule">Directive</a></h2> +<table class="directive"> +<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Liaison avec le serveur du fichier objet ou de la +bibliothèque spécifié, et ajout de ce dernier à la liste des modules +actifs</td></tr> +<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>LoadModule <em>module nom-fichier</em></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>Extension</td></tr> +<tr><th><a href="directive-dict.html#Module">Module:</a></th><td>mod_so</td></tr> +</table> + <p>La directive LoadModule permet de lier le fichier objet ou la + bibliothèque <em>nom-fichier</em> avec le serveur, et d'ajouter la + structure de module nommée <em>module</em> à la liste des modules + actifs. <em>module</em> est le nom de la variable externe de type + <code>module</code> dans le fichier, et est référencé comme <a href="module-dict.html#ModuleIdentifier">Identificateur de + module</a> dans la documentation des modules. Exemple :</p> + + <div class="example"><p><code> + LoadModule status_module modules/mod_status.so + </code></p></div> + + <p>charge le module spécifié depuis le sous-répertoire des modules + situé à la racine du serveur.</p> + +</div> +</div> +<div class="bottomlang"> +<p><span>Langues Disponibles: </span><a href="../en/mod/mod_so.html" hreflang="en" rel="alternate" title="English"> en </a> | +<a href="../fr/mod/mod_so.html" title="Français"> fr </a> | +<a href="../ja/mod/mod_so.html" hreflang="ja" rel="alternate" title="Japanese"> ja </a> | +<a href="../ko/mod/mod_so.html" hreflang="ko" rel="alternate" title="Korean"> ko </a> | +<a href="../tr/mod/mod_so.html" hreflang="tr" rel="alternate" title="Türkçe"> tr </a></p> +</div><div id="footer"> +<p class="apache">Copyright 2009 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="../faq/">FAQ</a> | <a href="../glossary.html">Glossaire</a> | <a href="../sitemap.html">Plan du site</a></p></div> +</body></html>
\ No newline at end of file diff --git a/docs/manual/mod/mod_so.xml.fr b/docs/manual/mod/mod_so.xml.fr new file mode 100644 index 0000000000..1578b9bf01 --- /dev/null +++ b/docs/manual/mod/mod_so.xml.fr @@ -0,0 +1,190 @@ +<?xml version="1.0"?> +<!DOCTYPE modulesynopsis SYSTEM "../style/modulesynopsis.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. +--> + +<modulesynopsis metafile="mod_so.xml.meta"> + +<name>mod_so</name> +<description>Chargement de modules ou de code exécutable au cours du +démarrage ou du redémarrage du serveur</description> +<status>Extension</status> +<sourcefile>mod_so.c</sourcefile> +<identifier>so_module</identifier> +<compatibility>Sous Windows, c'est un module de base (toujours +inclus)</compatibility> + +<summary> + + <p>Sur les systèmes d'exploitation sélectionnés, ce module peut être + utilisé pour charger des modules dans Apache en cours d'exécution + grâce au mécanisme des <a + href="../dso.html">Dynamic Shared Object ou Objets Partagés + Dynamiquement</a> (DSO), et évite ainsi de devoir effectuer une + recompilation.</p> + + <p>Sous Unix, le code chargé provient en général de fichiers objet + partagés possèdant en général l'extension <code>.so</code>, alors + que sous Windows, l'extension peut être soit <code>.so</code>, soit + <code>.dll</code>.</p> + + <note type="warning"><title>Avertissement</title> + <p>Les modules Apache 1.3 ne peuvent pas être utilisés directement + avec Apache 2.0 - ils doivent être modifiés pour pouvoir être + chargés dynamiquement ou compilés dans Apache 2.0.</p> + </note> +</summary> + +<section id="windows"><title>Création de modules chargeables pour +Windows</title> + + <note><title>Note</title> + <p>Le format des noms de modules pour Windows a été modifié avec + Apache 1.3.15 et 2.0 - les modules possèdent maintenant un nom du + style "mod_foo.so".</p> + + <p>Bien que mod_so puisse encore charger des modules possèdant un + nom du style ApacheModuleFoo.dll, il est préférable d'utiliser la + nouvelle convention de nommage ; si vous modifiez votre module + chargeable pour la version 2.0, veuillez aussi modifier son nom pour + respecter cette nouvelle convention.</p></note> + + <p>Les API des modules Apache sous Unix et Windows sont identiques. + Alors que certains modules s'appuient sur certains + aspects de l'architecture Unix non présents dans Windows, et ne + fonctionneront donc pas sur cette dernière plate-forme, de nombreux + modules fonctionnent sous Windows avec peu ou pas de modification + par rapport à leur version Unix.</p> + + <p>Lorsqu'un module fonctionne, il peut être ajouté au serveur de + deux manières. Sous Unix, il peut être compilé dans le serveur. + Comme Apache pour Windows ne dispose pas du programme + <code>Configure</code> propre à Apache pour Unix, le fichier source + du module doit être ajouté au fichier projet Apache de base, et ses + symboles ajoutés au fichier <code>os\win32\modules.c</code>.</p> + + <p>La seconde méthode consiste à compiler le module en tant que DLL, + à savoir une bibliothèque partagée qui pourra être chargée dans le + serveur en cours d'exécution via la directive + <code><directive>LoadModule</directive></code>. Ces modules DLL + peuvent être distribués et exécutés sur toute installation d'Apache + pour Windows, sans avoir à recompiler le serveur.</p> + + <p>Pour créer un module DLL, il est nécessaire d'apporter une légère + modification à son fichier source : l'enregistrement du module doit + être exporté depuis la DLL (qui sera elle-même créée plus tard ; + voir plus loin). Pour ce faire, ajoutez la macro + <code>AP_MODULE_DECLARE_DATA</code> (définie dans les fichiers + d'en-têtes d'Apache) à la définition de l'enregistrement de votre + module. Par exemple, si votre module est déclaré comme suit :</p> + +<example> + module foo_module; +</example> + + <p>Remplacez cette ligne par :</p> +<example> + module AP_MODULE_DECLARE_DATA foo_module; +</example> + + <p>Notez que cette macro ne sera prise en compte que sous Windows, + si bien que le module poura être utilisé sans changement sous Unix, + si besoin est. Alternativement, si vous êtes familier avec les + fichiers <code>.DEF</code>, vous pouvez les utiliser pour exporter + l'enregistrement du module.</p> + + <p>Maintenant, nous sommes prêts à créer une DLL contenant notre + module. Il va falloir pour cela la lier avec la bibliothèque + d'export libhttpd.lib qui a été créée au cours de la compilation de + la bibliothèque partagée libhttpd.dll. Il sera peut-être aussi + nécessaire de modifier la configuration du compilateur pour + s'assurer que les fichiers d'en-têtes d'Apache seront correctement + localisés. Vous trouverez cette bibliothèque à la racine du + répertoire des modules de votre serveur. Il est souhaitable + d'utiliser un fichier de module .dsp existant dans l'arborescence + afin de s'assurer que l'environnement de compilation est + correctement configuré, mais vous pouvez aussi comparer les options + de compilation et d'édition de liens à votre fichier .dsp.</p> + + <p>Ceci devrait créer une version DLL de votre module. Il vous + suffit maintenant de l'enregistrer dans le répertoire + <code>modules</code> à la racine de votre serveur, et d'utiliser la + directive <directive>LoadModule</directive> pour la charger.</p> + +</section> + +<directivesynopsis> +<name>LoadFile</name> +<description>Liaison du fichier objet ou de la bibliothèque +spécifié</description> +<syntax>LoadFile <em>nom-fichier</em> [<em>nom-fichier</em>] ...</syntax> +<contextlist> +<context>server config</context> +</contextlist> + +<usage> + + <p>La directive LoadFile permet de lier le fichier objet ou la + bibliothèque spécifié au serveur lors du démarrage ou du redémarrage + de ce dernier ; ceci permet d'ajouter tout code additionnel + nécessaire au fonctionnement d'un module. + <em>nom-fichier</em> est soit un chemin absolu, soit un chemin + relatif au répertoire défini par la directive <a + href="core.html#serverroot">ServerRoot</a>.</p> + + <p>Par exemple:</p> + + <example>LoadFile libexec/libxmlparse.so</example> + +</usage> +</directivesynopsis> + +<directivesynopsis> +<name>LoadModule</name> +<description>Liaison avec le serveur du fichier objet ou de la +bibliothèque spécifié, et ajout de ce dernier à la liste des modules +actifs</description> +<syntax>LoadModule <em>module nom-fichier</em></syntax> +<contextlist> +<context>server config</context> +</contextlist> + +<usage> + <p>La directive LoadModule permet de lier le fichier objet ou la + bibliothèque <em>nom-fichier</em> avec le serveur, et d'ajouter la + structure de module nommée <em>module</em> à la liste des modules + actifs. <em>module</em> est le nom de la variable externe de type + <code>module</code> dans le fichier, et est référencé comme <a + href="module-dict.html#ModuleIdentifier">Identificateur de + module</a> dans la documentation des modules. Exemple :</p> + + <example> + LoadModule status_module modules/mod_status.so + </example> + + <p>charge le module spécifié depuis le sous-répertoire des modules + situé à la racine du serveur.</p> +</usage> + +</directivesynopsis> +</modulesynopsis> + diff --git a/docs/manual/mod/mod_so.xml.meta b/docs/manual/mod/mod_so.xml.meta index d31c4ebdf0..617e01ebee 100644 --- a/docs/manual/mod/mod_so.xml.meta +++ b/docs/manual/mod/mod_so.xml.meta @@ -8,6 +8,7 @@ <variants> <variant>en</variant> + <variant>fr</variant> <variant>ja</variant> <variant>ko</variant> <variant>tr</variant> diff --git a/docs/manual/mod/mod_status.html b/docs/manual/mod/mod_status.html index 065e8e1228..22c6f0e3e9 100644 --- a/docs/manual/mod/mod_status.html +++ b/docs/manual/mod/mod_status.html @@ -4,6 +4,10 @@ URI: mod_status.html.en Content-Language: en Content-type: text/html; charset=ISO-8859-1 +URI: mod_status.html.fr +Content-Language: fr +Content-type: text/html; charset=ISO-8859-1 + URI: mod_status.html.ja.utf8 Content-Language: ja Content-type: text/html; charset=UTF-8 diff --git a/docs/manual/mod/mod_status.html.en b/docs/manual/mod/mod_status.html.en index dfe08c31b3..51e86d173f 100644 --- a/docs/manual/mod/mod_status.html.en +++ b/docs/manual/mod/mod_status.html.en @@ -22,6 +22,7 @@ <div id="preamble"><h1>Apache Module mod_status</h1> <div class="toplang"> <p><span>Available Languages: </span><a href="../en/mod/mod_status.html" title="English"> en </a> | +<a href="../fr/mod/mod_status.html" hreflang="fr" rel="alternate" title="Français"> fr </a> | <a href="../ja/mod/mod_status.html" hreflang="ja" rel="alternate" title="Japanese"> ja </a> | <a href="../ko/mod/mod_status.html" hreflang="ko" rel="alternate" title="Korean"> ko </a> | <a href="../tr/mod/mod_status.html" hreflang="tr" rel="alternate" title="Türkçe"> tr </a></p> @@ -192,6 +193,7 @@ of a request or the last 63, assuming the request itself is greater than </div> <div class="bottomlang"> <p><span>Available Languages: </span><a href="../en/mod/mod_status.html" title="English"> en </a> | +<a href="../fr/mod/mod_status.html" hreflang="fr" rel="alternate" title="Français"> fr </a> | <a href="../ja/mod/mod_status.html" hreflang="ja" rel="alternate" title="Japanese"> ja </a> | <a href="../ko/mod/mod_status.html" hreflang="ko" rel="alternate" title="Korean"> ko </a> | <a href="../tr/mod/mod_status.html" hreflang="tr" rel="alternate" title="Türkçe"> tr </a></p> diff --git a/docs/manual/mod/mod_status.html.fr b/docs/manual/mod/mod_status.html.fr new file mode 100644 index 0000000000..7ad1e33371 --- /dev/null +++ b/docs/manual/mod/mod_status.html.fr @@ -0,0 +1,208 @@ +<?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_status - 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 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="../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.3</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.3</a> > <a href="./">Modules</a></div> +<div id="page-content"> +<div id="preamble"><h1>Module Apache mod_status</h1> +<div class="toplang"> +<p><span>Langues Disponibles: </span><a href="../en/mod/mod_status.html" hreflang="en" rel="alternate" title="English"> en </a> | +<a href="../fr/mod/mod_status.html" title="Français"> fr </a> | +<a href="../ja/mod/mod_status.html" hreflang="ja" rel="alternate" title="Japanese"> ja </a> | +<a href="../ko/mod/mod_status.html" hreflang="ko" rel="alternate" title="Korean"> ko </a> | +<a href="../tr/mod/mod_status.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>Fournit des informations sur les performances et l'activité +du serveur</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>status_module</td></tr> +<tr><th><a href="module-dict.html#SourceFile">Fichier Source:</a></th><td>mod_status.c</td></tr></table> +<h3>Sommaire</h3> + + <p>Le module Status permet à un administrateur de déterminer le + niveau de performances de son serveur. Les statistiques instantanées + du serveur sont présentées dans une page HTML sous une forme + aisément lisible. Si nécessaire, cette page peut être configurée + pour être automatiquement actualisée (sous réserve de + compatibilité du navigateur). Une autre page fournit l'état + instantané du serveur sous la forme d'une simple liste lisible par + une machine.</p> + + <p>Les détails fournis sont :</p> + + <ul> + <li>Le nombre de processus servant les requêtes</li> + + <li>Le nombre de processus inactifs</li> + + <li>L'état de chaque processus, le nombre de requêtes qu'il a + traitées et le nombre total d'octets qu'il a servis (*)</li> + + <li>Le nombre total d'accès effectués et d'octets servis (*)</li> + + <li>Le moment où le serveur a été démarré/redémarré et le temps + écoulé depuis</li> + + <li>Les valeurs moyennes du nombre de requêtes par seconde, du + nombre d'octets servis par seconde et du nombre d'octets par + requête (*)</li> + + <li>Le pourcentage CPU instantané utilisé par chaque processus et + par Apache tout entier (*)</li> + + <li>Les hôtes et requêtes actuellement en cours de traitement + (*)</li> + </ul> + + <p>Les lignes se terminant par "(*)" ne sont disponibles que si la + directive <code class="directive"><a href="#extendedstatus">ExtendedStatus</a></code> + est définie à <code>On</code>.</p> +</div> +<div id="quickview"><h3 class="directives">Directives</h3> +<ul id="toc"> +<li><img alt="" src="../images/down.gif" /> <a href="#extendedstatus">ExtendedStatus</a></li> +<li><img alt="" src="../images/down.gif" /> <a href="#seerequesttail">SeeRequestTail</a></li> +</ul> +<h3>Sujets</h3> +<ul id="topics"> +<li><img alt="" src="../images/down.gif" /> <a href="#enable">Activation du rapport d'état</a></li> +<li><img alt="" src="../images/down.gif" /> <a href="#autoupdate">Actualisation automatique</a></li> +<li><img alt="" src="../images/down.gif" /> <a href="#machinereadable">Fichier d'état lisible par une machine</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="enable" id="enable">Activation du rapport d'état</a></h2> + + + <p>Pour n'activer les rapports d'état que pour les navigateurs + appartenent au domaine exemple.com, ajoutez ces lignes à votre + fichier de configuration <code>httpd.conf</code> :</p> +<div class="example"><p><code> + <Location /etat-serveur><br /> + SetHandler server-status<br /> +<br /> + Order Deny,Allow<br /> + Deny from all<br /> + Allow from .exemple.com<br /> + </Location> +</code></p></div> + + <p>Il est alors possible d'obtenir les statistiques du serveur en + utilisant un navigateur web et en accédant à la page + <code>http://votre.serveur/etat-serveur</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="autoupdate" id="autoupdate">Actualisation automatique</a></h2> + + + <p>Vous pouvez faire en sorte que cette page d'état s'actualise + elle-même automatiquement si votre navigateur supporte "refresh". + Pour ce faire, accédez à la page + <code>http://votre.serveur/etat-serveur?refresh=N</code>, pour que + cette dernière soit actualisée toutes les N secondes.</p> + +</div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div> +<div class="section"> +<h2><a name="machinereadable" id="machinereadable">Fichier d'état lisible par une machine</a></h2> + + + <p>La page <code>http://votre.serveur/etat-serveur?auto</code> + permet d'obtenir une version du fichier d'état lisible par une + machine. Ceci s'avère intéressant dans le cadre d'une exécution + automatique : voir le programme en Perl + <code>log_server_status</code>situé dans le répertoire + <code>/support</code> de la distribution d'Apache.</p> + + <div class="note"> + <strong>Veuillez noter que si <code class="module"><a href="../mod/mod_status.html">mod_status</a></code> a été + compilé dans le serveur, son gestionnaire sera disponible dans + <em>tous</em> les fichiers de configuration, y compris les + fichiers de configuration de <em>niveau répertoire</em> (par + exemple <code>.htaccess</code>), ce qui peut avoir des + répercutions quant à la sécurité de votre site.</strong> + </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="ExtendedStatus" id="ExtendedStatus">ExtendedStatus</a> <a name="extendedstatus" id="extendedstatus">Directive</a></h2> +<table class="directive"> +<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Extrait des informations d'état étendues pour chaque +requête</td></tr> +<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>ExtendedStatus On|Off</code></td></tr> +<tr><th><a href="directive-dict.html#Default">Défaut:</a></th><td><code>ExtendedStatus Off</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_status</td></tr> +</table> + <p>Cette directive s'applique au serveur dans son ensemble, et ne + peut pas être activée/désactivée pour un serveur virtuel + particulier. Notez que l'extraction des informations d'état étendues + peut ralentir le serveur.</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="SeeRequestTail" id="SeeRequestTail">SeeRequestTail</a> <a name="seerequesttail" id="seerequesttail">Directive</a></h2> +<table class="directive"> +<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Détermine si mod_status affiche les 63 premiers caractères +d'une requête ou les 63 derniers, en supposant que la requête +elle-même possède plus de 63 caractères.</td></tr> +<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>SeeRequestTail On|Off</code></td></tr> +<tr><th><a href="directive-dict.html#Default">Défaut:</a></th><td><code>SeeRequestTail Off</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_status</td></tr> +<tr><th><a href="directive-dict.html#Compatibility">Compatibilité:</a></th><td>Disponible depuis la version 2.2.7 +d'Apache.</td></tr> +</table> + <p>Avec <code>ExtendedStatus On</code>, mod_status affiche la + véritable requête en cours de traitement. Pour des raisons + historiques, seuls 63 caractères de la requête sont réellement + stockés à des fins d'affichage. Cette directive permet de déterminer + si ce sont les 63 premiers caractères qui seront stockés (c'est le + comportement par défaut et celui des versions antérieures à 2.2.7), + ou si ce sont les 63 derniers. Ceci ne s'applique bien entendu que + si la taille de la requête est de 64 caractères ou plus.</p> + + <p>Si Apache traite la requête <code>GET /disque1/stockage/apache/htdocs/images/rep-images1/nourriture/pommes.jpg HTTP/1.1</code> + , l'affichage de la requête par mod_status se présentera comme suit : + </p> + + <table class="bordered"> + <tr> + <th>Off (défaut)</th> + <td>GET /disque1/stockage/apache/htdocs/images/rep-images1/nourritu</td> + </tr> + <tr> + <th>On</th> + <td>apache/htdocs/images/rep-images1/nourriture/pommes.jpg HTTP/1.1</td> + </tr> + </table> + + +</div> +</div> +<div class="bottomlang"> +<p><span>Langues Disponibles: </span><a href="../en/mod/mod_status.html" hreflang="en" rel="alternate" title="English"> en </a> | +<a href="../fr/mod/mod_status.html" title="Français"> fr </a> | +<a href="../ja/mod/mod_status.html" hreflang="ja" rel="alternate" title="Japanese"> ja </a> | +<a href="../ko/mod/mod_status.html" hreflang="ko" rel="alternate" title="Korean"> ko </a> | +<a href="../tr/mod/mod_status.html" hreflang="tr" rel="alternate" title="Türkçe"> tr </a></p> +</div><div id="footer"> +<p class="apache">Copyright 2009 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="../faq/">FAQ</a> | <a href="../glossary.html">Glossaire</a> | <a href="../sitemap.html">Plan du site</a></p></div> +</body></html>
\ No newline at end of file diff --git a/docs/manual/mod/mod_status.xml.fr b/docs/manual/mod/mod_status.xml.fr new file mode 100644 index 0000000000..6432473fc7 --- /dev/null +++ b/docs/manual/mod/mod_status.xml.fr @@ -0,0 +1,189 @@ +<?xml version="1.0"?> +<!DOCTYPE modulesynopsis SYSTEM "../style/modulesynopsis.dtd"> +<?xml-stylesheet type="text/xsl" href="../style/manual.fr.xsl"?> +<!-- English Revision : 779139 --> +<!-- 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_status.xml.meta"> + +<name>mod_status</name> +<description>Fournit des informations sur les performances et l'activité +du serveur</description> +<status>Base</status> +<sourcefile>mod_status.c</sourcefile> +<identifier>status_module</identifier> + + +<summary> + <p>Le module Status permet à un administrateur de déterminer le + niveau de performances de son serveur. Les statistiques instantanées + du serveur sont présentées dans une page HTML sous une forme + aisément lisible. Si nécessaire, cette page peut être configurée + pour être automatiquement actualisée (sous réserve de + compatibilité du navigateur). Une autre page fournit l'état + instantané du serveur sous la forme d'une simple liste lisible par + une machine.</p> + + <p>Les détails fournis sont :</p> + + <ul> + <li>Le nombre de processus servant les requêtes</li> + + <li>Le nombre de processus inactifs</li> + + <li>L'état de chaque processus, le nombre de requêtes qu'il a + traitées et le nombre total d'octets qu'il a servis (*)</li> + + <li>Le nombre total d'accès effectués et d'octets servis (*)</li> + + <li>Le moment où le serveur a été démarré/redémarré et le temps + écoulé depuis</li> + + <li>Les valeurs moyennes du nombre de requêtes par seconde, du + nombre d'octets servis par seconde et du nombre d'octets par + requête (*)</li> + + <li>Le pourcentage CPU instantané utilisé par chaque processus et + par Apache tout entier (*)</li> + + <li>Les hôtes et requêtes actuellement en cours de traitement + (*)</li> + </ul> + + <p>Les lignes se terminant par "(*)" ne sont disponibles que si la + directive <directive module="mod_status">ExtendedStatus</directive> + est définie à <code>On</code>.</p> +</summary> + +<section id="enable"> + <title>Activation du rapport d'état</title> + + <p>Pour n'activer les rapports d'état que pour les navigateurs + appartenent au domaine exemple.com, ajoutez ces lignes à votre + fichier de configuration <code>httpd.conf</code> :</p> +<example> + <Location /etat-serveur><br /> + SetHandler server-status<br /> +<br /> + Order Deny,Allow<br /> + Deny from all<br /> + Allow from .exemple.com<br /> + </Location> +</example> + + <p>Il est alors possible d'obtenir les statistiques du serveur en + utilisant un navigateur web et en accédant à la page + <code>http://votre.serveur/etat-serveur</code>.</p> +</section> + +<section id="autoupdate"> + + <title>Actualisation automatique</title> + <p>Vous pouvez faire en sorte que cette page d'état s'actualise + elle-même automatiquement si votre navigateur supporte "refresh". + Pour ce faire, accédez à la page + <code>http://votre.serveur/etat-serveur?refresh=N</code>, pour que + cette dernière soit actualisée toutes les N secondes.</p> + +</section> + +<section id="machinereadable"> + + <title>Fichier d'état lisible par une machine</title> + <p>La page <code>http://votre.serveur/etat-serveur?auto</code> + permet d'obtenir une version du fichier d'état lisible par une + machine. Ceci s'avère intéressant dans le cadre d'une exécution + automatique : voir le programme en Perl + <code>log_server_status</code>situé dans le répertoire + <code>/support</code> de la distribution d'Apache.</p> + + <note> + <strong>Veuillez noter que si <module>mod_status</module> a été + compilé dans le serveur, son gestionnaire sera disponible dans + <em>tous</em> les fichiers de configuration, y compris les + fichiers de configuration de <em>niveau répertoire</em> (par + exemple <code>.htaccess</code>), ce qui peut avoir des + répercutions quant à la sécurité de votre site.</strong> + </note> + +</section> + +<directivesynopsis> + +<name>ExtendedStatus</name> +<description>Extrait des informations d'état étendues pour chaque +requête</description> +<syntax>ExtendedStatus On|Off</syntax> +<default>ExtendedStatus Off</default> +<contextlist><context>server config</context></contextlist> + +<usage> + <p>Cette directive s'applique au serveur dans son ensemble, et ne + peut pas être activée/désactivée pour un serveur virtuel + particulier. Notez que l'extraction des informations d'état étendues + peut ralentir le serveur.</p> +</usage> + +</directivesynopsis> +<directivesynopsis> + +<name>SeeRequestTail</name> +<description>Détermine si mod_status affiche les 63 premiers caractères +d'une requête ou les 63 derniers, en supposant que la requête +elle-même possède plus de 63 caractères.</description> +<syntax>SeeRequestTail On|Off</syntax> +<default>SeeRequestTail Off</default> +<contextlist><context>server config</context></contextlist> +<compatibility>Disponible depuis la version 2.2.7 +d'Apache.</compatibility> + +<usage> + <p>Avec <code>ExtendedStatus On</code>, mod_status affiche la + véritable requête en cours de traitement. Pour des raisons + historiques, seuls 63 caractères de la requête sont réellement + stockés à des fins d'affichage. Cette directive permet de déterminer + si ce sont les 63 premiers caractères qui seront stockés (c'est le + comportement par défaut et celui des versions antérieures à 2.2.7), + ou si ce sont les 63 derniers. Ceci ne s'applique bien entendu que + si la taille de la requête est de 64 caractères ou plus.</p> + + <p>Si Apache traite la requête <code + >GET /disque1/stockage/apache/htdocs/images/rep-images1/nourriture/pommes.jpg HTTP/1.1</code> + , l'affichage de la requête par mod_status se présentera comme suit : + </p> + + <table border="1"> + <tr> + <th>Off (défaut)</th> + <td>GET /disque1/stockage/apache/htdocs/images/rep-images1/nourritu</td> + </tr> + <tr> + <th>On</th> + <td>apache/htdocs/images/rep-images1/nourriture/pommes.jpg HTTP/1.1</td> + </tr> + </table> + +</usage> + +</directivesynopsis> + +</modulesynopsis> + diff --git a/docs/manual/mod/mod_status.xml.meta b/docs/manual/mod/mod_status.xml.meta index 02f8e8faf9..1fbf83f309 100644 --- a/docs/manual/mod/mod_status.xml.meta +++ b/docs/manual/mod/mod_status.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> |