diff options
| author | Lucien Gentis <lgentis@apache.org> | 2011-01-29 15:39:45 +0100 |
|---|---|---|
| committer | Lucien Gentis <lgentis@apache.org> | 2011-01-29 15:39:45 +0100 |
| commit | baf13770c690bbaab96709033193fe455bf5b43b (patch) | |
| tree | 54a8c27eefa254316c4b3f292a1e55e5c783579b /docs/manual | |
| parent | Revert an old (~10yr) change to the fd Q; move back to (diff) | |
| download | apache2-baf13770c690bbaab96709033193fe455bf5b43b.tar.xz apache2-baf13770c690bbaab96709033193fe455bf5b43b.zip | |
Updates.
git-svn-id: https://svn.apache.org/repos/asf/httpd/httpd/trunk@1065023 13f79535-47bb-0310-9956-ffa450edef68
Diffstat (limited to 'docs/manual')
| -rw-r--r-- | docs/manual/caching.xml.fr | 26 | ||||
| -rw-r--r-- | docs/manual/dso.xml.fr | 27 | ||||
| -rw-r--r-- | docs/manual/mod/mod_alias.xml.fr | 342 | ||||
| -rw-r--r-- | docs/manual/mod/mod_rewrite.xml.fr | 184 | ||||
| -rw-r--r-- | docs/manual/rewrite/flags.xml.fr | 12 | ||||
| -rw-r--r-- | docs/manual/upgrading.xml.fr | 9 | ||||
| -rw-r--r-- | docs/manual/vhosts/ip-based.xml.fr | 16 |
7 files changed, 333 insertions, 283 deletions
diff --git a/docs/manual/caching.xml.fr b/docs/manual/caching.xml.fr index cb48a6ae78..11ceb3e29f 100644 --- a/docs/manual/caching.xml.fr +++ b/docs/manual/caching.xml.fr @@ -3,7 +3,7 @@ <?xml-stylesheet type="text/xsl" href="style/manual.fr.xsl"?> <!-- French translation : Lucien GENTIS --> <!-- Reviewed by : Vincent Deffontaines --> -<!-- English Revision : 1037244 --> +<!-- English Revision : 1058639 --> <!-- Licensed to the Apache Software Foundation (ASF) under one or more @@ -163,12 +163,11 @@ <a href="howto/ssi.html">Inclusions Côté Serveur (SSI)</a>;</p> <example> - <pre> -<!-- L'inclusion suivante peut être mise en cache --> -<!--#include virtual="/footer.html" --> - -<!-- L'inclusion suivante ne peut pas être mise en cache --> -<!--#include file="/path/to/footer.html" --></pre> +<!-- L'inclusion suivante peut être mise en cache --><br /> +<!--#include virtual="/footer.html" --><br /> +<br /> +<!-- L'inclusion suivante ne peut pas être mise en cache --><br /> +<!--#include file="/path/to/footer.html" --> <br /> </example> <p>Si vous utilisez les SSI, et voulez bénéficier de la vitesse de @@ -487,7 +486,7 @@ Vary: negotiate,accept-language,accept-charset accès ultérieurs à ce fichier.</p> <example> - <pre>CacheFile /usr/local/apache2/htdocs/index.html</pre> + CacheFile /usr/local/apache2/htdocs/index.html </example> <p>Si vous avez l'intention de mettre en cache un grand nombre de @@ -608,7 +607,7 @@ sys 0m0.000s</pre> toutes les demandes d'accès à ce fichier.</p> <example> - <pre>MMapFile /usr/local/apache2/htdocs/index.html</pre> + MMapFile /usr/local/apache2/htdocs/index.html </example> <p>Comme dans le cas de la directive @@ -649,11 +648,10 @@ sys 0m0.000s</pre> <p>Typiquement, le module sera configuré comme suit :</p> <example> - <pre> -CacheRoot /var/cache/apache/ -CacheEnable disk / -CacheDirLevels 2 -CacheDirLength 1</pre> +CacheRoot /var/cache/apache/<br /> +CacheEnable disk /<br /> +CacheDirLevels 2<br /> +CacheDirLength 1 </example> <p>Il est important de savoir que, les fichiers mis en cache étant stockés diff --git a/docs/manual/dso.xml.fr b/docs/manual/dso.xml.fr index b4144d13e5..70fdd97bb4 100644 --- a/docs/manual/dso.xml.fr +++ b/docs/manual/dso.xml.fr @@ -3,7 +3,7 @@ <?xml-stylesheet type="text/xsl" href="./style/manual.fr.xsl"?> <!-- French translation : Lucien GENTIS --> <!-- Reviewed by : Vincent Deffontaines --> -<!-- English Revision : 952009 --> +<!-- English Revision : 1058587 --> <!-- Licensed to the Apache Software Foundation (ASF) under one or more @@ -65,8 +65,8 @@ distribués seront alors compilés en tant que modules DSO. Une fois compilé en tant que module DSO nommé <code>mod_foo.so</code>, un module peut être chargé en mémoire au - démarrage ou redémarrage du serveur à l'aide de la commande - <directive module="mod_so">LoadModule</directive> du module + démarrage ou redémarrage du serveur à l'aide de + la directive <directive module="mod_so">LoadModule</directive> du module <module>mod_so</module>, placée dans votre fichier <code>httpd.conf</code>.</p> <p>La compilation en mode DSO peut être désactivée pour certains @@ -149,8 +149,8 @@ $ apxs -cia mod_foo.c <section id="background"><title>Les dessous du fonctionnement des DSO</title> - <p>Les clônes modernes d'UNIX proposent un astucieux mécanisme - communément appelé édition de liens et chargement dynamiques d' + <p>Les clônes modernes d'UNIX proposent un mécanisme + appelé édition de liens et chargement dynamiques d' <em>Objets Dynamiques Partagés</em> (DSO), qui permet de construire un morceau de programme dans un format spécial pour le rendre chargeable à l'exécution dans l'espace d'adressage d'un programme exécutable.</p> @@ -240,8 +240,7 @@ $ apxs -cia mod_foo.c c'est dans cette optique que le mécanisme DSO a été conçu ; c'est cette approche qui est ainsi utilisée par pratiquement tous les types de bibliothèques que fournit le - système d'exploitation. Par contre, les objets partagés sont relativement - peu utilisés pour étendre les fonctionnalités d'un programme.</p> + système d'exploitation.</p> </section> @@ -252,23 +251,23 @@ $ apxs -cia mod_foo.c <ul> <li>Le paquetage du serveur est plus flexible à l'exécution car le - processus serveur effectif peut être assemblé à l'exécution via la + processus serveur peut être assemblé à l'exécution via la directive <directive module="mod_so">LoadModule</directive> du fichier de configuration <code>httpd.conf</code> plutôt que par des options du script <program>configure</program> à la compilation. Par exemple, on peut ainsi exécuter différentes instances du serveur - (standard et version SSL, version minimale et version étoffée - [mod_perl, PHP3], <em>etc...</em>) à partir d'une seule installation + (standard et version SSL, version minimale et version dynamique + [mod_perl, mod_php], <em>etc...</em>) à partir d'une seule installation d'Apache httpd.</li> <li>Le paquetage du serveur peut être facilement étendu avec des modules - tiers, même après l'installation. Ceci présente en tout cas un gros + tiers, même après l'installation. Ceci présente un gros avantage pour les mainteneurs de paquetages destinés aux distributions, car ils peuvent créer un paquetage Apache httpd de base, et des paquetages additionnels contenant des extensions telles que PHP, mod_perl, mod_fastcgi, <em>etc...</em></li> - <li>Une facilité de prototypage des modules Apache httpd car la paire + <li>Une facilité de prototypage des modules Apache httpd, car la paire DSO/<program>apxs</program> vous permet d'une part de travailler en dehors de l'arborescence des sources d'Apache httpd, et d'autre part de n'avoir besoin que de la commande <code>apxs -i</code> @@ -280,10 +279,6 @@ $ apxs -cia mod_foo.c <p>Inconvénients des DSO :</p> <ul> - <li>Le mécanisme DSO n'est pas disponible sur toutes les plates-formes - car tous les systèmes d'exploitation ne supportent pas le chargement - dynamique de code dans l'espace d'adressage d'un programme.</li> - <li>Le serveur est environ 20 % plus lent au démarrage à cause des résolutions de symboles supplémentaires que le chargeur Unix doit effectuer.</li> diff --git a/docs/manual/mod/mod_alias.xml.fr b/docs/manual/mod/mod_alias.xml.fr index b8a6ae9297..37d04bd9db 100644 --- a/docs/manual/mod/mod_alias.xml.fr +++ b/docs/manual/mod/mod_alias.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 : 1042758 --> +<!-- English Revision : 1055611 --> <!-- French translation : Lucien GENTIS --> <!-- Reviewed by : Vincent Deffontaines --> @@ -25,7 +25,7 @@ <modulesynopsis metafile="mod_alias.xml.meta"> <name>mod_alias</name> -<description>Permet d'atteindre différentes parties du système de +<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> @@ -34,129 +34,131 @@ redirection d'URL</description> <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 + 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 + 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="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 + 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> + 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> + <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> +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" + <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 + <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 + 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> + 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 + <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 + <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> + <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 +<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> +<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 + 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 + (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> + 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 + <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>. + <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 + 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> + 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>l'alias précédent ne s'appliquera pas à l'url + <code>/icons</code> à cause de l'absence du slash final. Ainsi, si + le slash final est absent du <var>chemin de l'URL</var>, il doit + aussi l'être du <var>chemin du fichier</var>.</p> - <p>Notez qu'il pourra s'avérer nécessaire de définir des sections + <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. + 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 + 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 + 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 + <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> + probablement permettre explicitement l'accès à ce répertoire.</p> <example><title>Exemple :</title> Alias /image /ftp/pub/image<br /> @@ -172,23 +174,23 @@ de fichiers</description> <directivesynopsis> <name>AliasMatch</name> -<description>Met en correspondance des URLs avec le système de fichiers +<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> +<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 + <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 + 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 + 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 + Par exemple, pour activer le répertoire <code>/icons</code>, on peut utiliser :</p> <example> @@ -196,32 +198,32 @@ en faisant intervenir les expressions rationnelles</description> </example> <p>Toute la puissance des <glossary ref="regex">expressions - rationnelles</glossary> peut être mise à contribution. Par exemple, - il est possible de construire un alias avec un modèle de chemin URL - insensible à la casse :</p> + rationnelles</glossary> peut être mise à contribution. Par exemple, + il est possible de construire un alias avec un modèle de chemin URL + insensible à la casse :</p> <example> AliasMatch (?i)^/image(.*) /ftp/pub/image$1 </example> - <p>Il existe une différence subtile entre <directive + <p>Il existe une différence subtile entre <directive module="mod_alias">Alias</directive> et <directive module="mod_alias">AliasMatch</directive> : <directive module="mod_alias">Alias</directive> copie automatiquement toute - portion supplémentaire de l'URI située après la partie du modèle qui - correspond, à la fin du chemin du fichier de la partie droite, alors + portion supplémentaire de l'URI située après la partie du modèle qui + correspond, à la fin du chemin du fichier de la partie droite, alors que <directive module="mod_alias">AliasMatch</directive> ne le fait - pas. Cela signifie qu'il sera préférable dans la plupart des cas de - comparer l'expression rationnelle du modèle à la totalité de l'URI - de la requête, et d'utiliser les substitutions dans la partie + pas. Cela signifie qu'il sera préférable dans la plupart des cas de + comparer l'expression rationnelle du modèle à la totalité de l'URI + de la requête, et d'utiliser les substitutions dans la partie droite.</p> <p>En d'autres termes, le remplacement d'<directive module="mod_alias">Alias</directive> par <directive - module="mod_alias">AliasMatch</directive> ne produira pas le même - résultat. Au minimum, vous devez ajouter <code>^</code> au début de - l'expression rationnelle, <code>(.*)$</code> à sa fin et - <code>$1</code> à la fin de la chaîne de remplacement.</p> + module="mod_alias">AliasMatch</directive> ne produira pas le même + résultat. Au minimum, vous devez ajouter <code>^</code> au début de + l'expression rationnelle, <code>(.*)$</code> à sa fin et + <code>$1</code> à la fin de la chaîne de remplacement.</p> <p>Par exemple, supposons que nous voulions reformuler cet alias avec AliasMatch :</p> @@ -231,14 +233,14 @@ en faisant intervenir les expressions rationnelles</description> </example> <p>Le simple remplacement d'Alias par AliasMatch ne produira pas le - même résultat. Ainsi, ce qui suit va rediriger toutes les requêtes + même résultat. Ainsi, ce qui suit va rediriger toutes les requêtes qui contiennent /image/ vers /ftp/pub/image/ :</p> <example> AliasMatch /image/ /ftp/pub/image/ </example> - <p>Voici la directive AliasMatch qui produira le même résultat que + <p>Voici la directive AliasMatch qui produira le même résultat que la directive Alias ci-dessus :</p> <example> @@ -246,12 +248,12 @@ en faisant intervenir les expressions rationnelles</description> </example> <p>Bien entendu, il n'y a aucune raison d'utiliser <directive - module="mod_alias">AliasMatch</directive> dans le cas où <directive + module="mod_alias">AliasMatch</directive> dans le cas où <directive module="mod_alias">Alias</directive> suffit. <directive module="mod_alias">AliasMatch</directive> vous permet d'effectuer - des choses beaucoup plus sophistiquées. Par exemple, vous pouvez - servir différentes sortes de fichiers à partir de répertoires - différents :</p> + des choses beaucoup plus sophistiquées. Par exemple, vous pouvez + servir différentes sortes de fichiers à partir de répertoires + différents :</p> <example> AliasMatch ^/image/(.*)\.jpg$ /fichiers/jpg.images/$1.jpg<br/> @@ -264,7 +266,7 @@ en faisant intervenir les expressions rationnelles</description> <directivesynopsis> <name>Redirect</name> <description>Envoie une redirection externe demandant au client -d'effectuer une autre requête avec une URL différente</description> +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> @@ -273,58 +275,58 @@ d'effectuer une autre requête avec une URL différente</description> <usage> <p>La directive Redirect permet de faire correspondre une ancienne - URL à une nouvelle en demandant au client d'aller chercher la ressource à + 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>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> + 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 + <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> + é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 /> + # Redirige vers une URL sur un serveur différent<br /> Redirect /service http://foo2.example.com/service<br /> <br /> - # Redirige vers une URL sur le même serveur<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é + <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>. Ceci concerne - les requêtes avec paramètres <code>GET</code>, comme + les requêtes avec paramètres <code>GET</code>, comme <code>http://example.com/service/foo.pl?q=23&a=42</code>, qui - seront redirigées vers + seront redirigées vers <code>http://foo2.example.com/service/foo.pl?q=23&a=42</code>. - Notez que les <code>POST</code>s seront ignorés.<br /> + Notez que les <code>POST</code>s seront ignorés.<br /> Seuls les - éléments de chemin complets sont testés, si bien que l'exemple - précédent ne s'appliquera pas à l'URL + é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 + 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 + <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 + <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 + 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> @@ -332,30 +334,30 @@ d'effectuer une autre requête avec une URL différente</description> <dt>permanent</dt> <dd>Renvoie un statut de redirection permanente (301), indiquant - que la ressource a été définitivement déplacée.</dd> + 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> + 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> + 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 + é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>. + <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 + <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> @@ -379,29 +381,29 @@ courante</description> <override>FileInfo</override> <usage> - <p>Cette directive est identique à la directive <directive + <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 + <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 + 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 + les fichiers GIF vers les fichiers JPEG de même nom sur un autre serveur, on peut utiliser :</p> <example> RedirectMatch (.*)\.gif$ http://autre.example.com$1.jpg </example> - <p>Les remarques à propos de la différence entre <directive + <p>Les remarques à propos de la différence entre <directive module="mod_alias">Alias</directive> et <directive - module="mod_alias">AliasMatch</directive> s'appliquent aussi à la - différence entre les directives <directive + module="mod_alias">AliasMatch</directive> s'appliquent aussi à la + différence entre les directives <directive module="mod_alias">Redirect</directive> et <directive module="mod_alias">RedirectMatch</directive>. Voir la directive <directive module="mod_alias">AliasMatch</directive> pour plus de - détails.</p> + détails.</p> </usage> </directivesynopsis> @@ -409,8 +411,8 @@ courante</description> <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> +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> @@ -418,7 +420,7 @@ différente</description> <usage> <p>Cette directive informe le client que la redirection n'est - que temporaire (statut 302). Son comportement est exactement le même + que temporaire (statut 302). Son comportement est exactement le même que celui de <code>Redirect temp</code>.</p> </usage> </directivesynopsis> @@ -426,8 +428,8 @@ différente</description> <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> +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> @@ -435,40 +437,40 @@ différente</description> <usage> <p>Cette directive informe le client que la redirection est - permanente (statut 301). Son comportement est exactement le même + 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> +<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> +<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 + <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 + 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 + 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 + 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 + <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> + équivalente à :</p> <example> Alias /cgi-bin/ /web/cgi-bin/<br /> <Location /cgi-bin ><br /> @@ -486,22 +488,22 @@ et désigne la cible comme script CGI</description> 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 + <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 + <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 + 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 + 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 + 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 + <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 : @@ -513,10 +515,10 @@ et désigne la cible comme script CGI</description> </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 + 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> @@ -525,23 +527,23 @@ et désigne la cible comme script CGI</description> <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 +<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> +<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 + <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 + <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 + 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> @@ -549,22 +551,22 @@ comme un script CGI</description> </example> <p>Comme dans le cas d'AliasMatch, toute la puissance des <glossary - ref="rexex">expressions rationnelles</glossary> peut être mise à + ref="rexex">expressions rationnelles</glossary> peut être mise à contribution. Par exemple, il est possible de construire un alias - avec une comparaison du modèle du chemin URL insensible à la casse :</p> + avec une comparaison du modèle du chemin URL insensible à la casse :</p> <example> ScriptAliasMatch (?i)^/cgi-bin(.*) /usr/local/apache/cgi-bin$1 </example> - <p>Les remarques à propos de la différence entre <directive + <p>Les remarques à propos de la différence entre <directive module="mod_alias">Alias</directive> et <directive - module="mod_alias">AliasMatch</directive> s'appliquent aussi à la - différence entre les directives <directive + module="mod_alias">AliasMatch</directive> s'appliquent aussi à la + différence entre les directives <directive module="mod_alias">ScriptAlias</directive> et <directive module="mod_alias">ScriptAliasMatch</directive>. Voir la directive <directive module="mod_alias">AliasMatch</directive> pour plus de - détails.</p> + détails.</p> </usage> </directivesynopsis> diff --git a/docs/manual/mod/mod_rewrite.xml.fr b/docs/manual/mod/mod_rewrite.xml.fr index e9a9c14ebc..9204c20721 100644 --- a/docs/manual/mod/mod_rewrite.xml.fr +++ b/docs/manual/mod/mod_rewrite.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 : 1044738 --> +<!-- English Revision : 1063587 --> <!-- French translation : Lucien GENTIS --> <!-- Reviewed by : Vincent Deffontaines --> @@ -316,17 +316,22 @@ répertoire</description> <p>La directive <directive>RewriteBase</directive> définit explicitement le chemin URL de base (et non le chemin du répertoire dans le système de fichiers !) pour les réécritures dans un contexte - de répertoire. Lorsque vous utilisez une directive <directive + de répertoire dont le résultat est la substitution d'un + chemin relatif. Lorsque vous utilisez une directive <directive module="mod_rewrite">RewriteRule</directive> dans un fichier <code>.htaccess</code>, <module>mod_rewrite</module> enlève le préfixe de répertoire local avant d'effectuer le traitement, puis réécrit ce qui reste de l'URL. Lorsque la réécriture est terminée, - <module>mod_rewrite</module> rajoute automatiquement le préfixe de - répertoire local au chemin.</p> + <module>mod_rewrite</module> ajoute automatiquement le préfixe de + répertoire local (ou la valeur de la directive + <directive>RewriteBase</directive> si cette dernière est définie) + à la chaîne de substitution avant de la remettre à disposition du + serveur, comme s'il s'agissait de l'URL d'origine.</p> <p>Cette directive est <em>requise</em> pour les réécritures dans un contexte de répertoire défini via la directive - <directive module="mod_alias">Alias</directive>.</p> + <directive module="mod_alias">Alias</directive> lorsque la + substitution utilise un chemin relatif.</p> <p>Si votre chemin URL n'existe pas réellement dans le système de fichiers, ou ne trouve pas directement sous le répertoire défini @@ -481,6 +486,7 @@ la réécriture soit effectuée REQUEST_FILENAME<br /> IS_SUBREQ<br /> HTTPS<br /> + REQUEST_SCHEME<br /> </td> </tr> </table> @@ -489,7 +495,14 @@ la réécriture soit effectuée HTTP de mêmes noms, au variables C du serveur HTTP Apache, ou aux champs <code>struct tm</code> du système Unix. La plupart d'entre elles sont documentées ailleurs dans le - manuel ou dans la spécification CGI. Parmi les variables + manuel ou dans la spécification CGI.</p> + + <p>SERVER_NAME et SERVER_PORT dépendent respectivement + des valeurs des directives <directive + module="core">UseCanonicalName</directive> et <directive + module="core">UseCanonicalPhysicalPort</directive>.</p> + + <p>Parmi les variables spécifiques à mod_rewrite, ou trouve les suivantes :</p> <note> <dl> @@ -543,11 +556,23 @@ la réécriture soit effectuée (Cette variable peut être utilisée sans problème, que <module>mod_ssl</module> soit chargé ou non.</dd> + <dt><code>REQUEST_SCHEME</code></dt> + + <dd>Contient le protocole de la requête (en général + "http" ou "https"). La valeur peut être modifiée par + la directive <directive + module="core">ServerName</directive>.</dd> + </dl> </note> </li> </ul> + <p>Si la <em>chaîne de test</em> contient la valeur spéciale + <code>expr</code>, <em>expression de comparaison</em> sera traité + en tant qu'expression rationnelle de type <a + href="../expr.html">ap_expr</a>.</p> + <p>Autres points à connaître ::</p> <ol> <li> @@ -824,6 +849,25 @@ la réécriture soit effectuée </note> </li> + <li> + <p>Si la <em>chaîne de test</em> contient la valeur spéciale + <code>expr</code>, la <em>chaîne de comparaison</em> sera + traitée en tant qu'expression rationnelle de type <a + href="../expr.html">ap_expr</a>.</p> + + <p> + Dans l'exemple ci-dessous, on utilise <code>-strmatch</code> + pour comparer le <code>REFERER</code> avec le nom d'hôte du + site afin de bloquer le hotlinking (référencement direct) + non désiré. + </p> + + <example> + RewriteCond expr "! %{HTTP_REFERER} -strmatch '*://%{HTTP_HOST}/*'"<br /> + RewriteRule ^/images - [F] + </example> + </li> + <li>Vous pouvez aussi définir certains drapeaux pour l'<em>expression de comparaison</em> en ajoutant ces <strong><code>[</code><em>drapeaux</em><code>]</code></strong> @@ -933,35 +977,79 @@ RewriteRule ^/$ /homepage.std.html [L] <p><a id="patterns" name="patterns"><em>Modèle</em></a> est une <a id="regexp" name="regexp">expression rationnelle</a> compatible perl. Dans la première règle de réécriture, - l'expression est comparée au (%-encoded) + l'expression est comparée au (%-decoded) <a href="./directive-dict.html#Syntax">chemin de l'URL</a> de la requête ; les expressions suivantes sont comparées à la sortie de la dernière règle de réécriture qui a été appliquée.</p> <note><title>Qu'est-ce qui est comparé ?</title> - <p>Le <em>Modèle</em> est d'abord comparé à la partie - de l'URL après le nom d'hôte et le port, et avant la chaîne de - requête.</p> - - <p>Dans un contexte de répertoire, <em>Modèle</em> est comparé à - ce qui reste de l'URL après suppression du préfixe qui a conduit - Apache httpd à la règle courante (voir la directive <directive - module="mod_rewrite">RewriteBase</directive>). Le préfixe supprimé - se termine toujours par un slash, ce qui signifie que la - correspondance se fera toujours avec une chaîne qui ne commence - pas par un slash. Un <em>Modèle</em> contenant <code>^/</code> ne - correspondra jamais dans un contexte de répertoire.</p> + <p>Dans un contexte de serveur virtuel <directive + module="core">VirtualHost</directive>, le <em>modèle</em> est tout + d'abord comparé à la portion de l'URL située entre le nom d'hôte + éventuellement accompagné du port, et la chaîne de paramètres (par + exemple "/app1/index.html").</p> + + <p>Dans les contextes de répertoire <directive + module="core">Directory</directive> et htaccess, le + <em>modèle</em> est tout d'abord comparé au chemin du <em>système + de fichiers</em>, après suppression du préfixe ou chemin de base + ayant conduit à la règle <directive>RewriteRule</directive> (par + exemple "app1/index.html" ou + "index.html" selon l'endroit où les directives sont définies).</p> <p>Si vous souhaitez faire une comparaison sur le nom d'hôte, le port, ou la chaîne de requête, utilisez une directive <directive module="mod_rewrite">RewriteCond</directive> comportant respectivement les variables <code>%{HTTP_HOST}</code>, <code>%{SERVER_PORT}</code>, ou - <code>%{QUERY_STRING}</code>. Si vous désirez effectuer une - correspondance avec l'ensemble du chemin de l'URL dans un contexte - de répertoire (htaccess), utilisez la variable - <code>%{REQUEST_URI}</code>.</p> + <code>%{QUERY_STRING}</code>.</p> +</note> + +<note><title>Réécritures dans un contexte de répertoire</title> +<ul> +<li>L'utilisation du moteur de réécriture dans les +fichiers <a href="../howto/htaccess.html">.htaccess</a> et les sections +<directive +type="section" module="core">Directory</directive> est un peu plus +complexe.</li> + +<li>Pour activer le moteur de réécriture dans ces contextes, vous devez +définir "<code>RewriteEngine On</code>" <strong>et</strong> +"<code>Options FollowSymLinks</code>". Si l'administrateur a désactivé +la possibilité de modifier l'option <code>FollowSymLinks</code> au +niveau du répertoire d'un utilisateur, vous ne pouvez pas utiliser le +moteur de réécriture. Cette restriction a été instaurée à des fins de +sécurité.</li> + +<li>Lorsqu'on utilise le moteur de réécriture dans un fichier +<code>.htaccess</code>, le chemin de base du répertoire courant (qui est +toujours le même pour ce même répertoire) est automatiquement +<em>supprimé</em> au cours de la comparaison avec le modèle de la règle +de réécriture, et automatiquement <em>ajouté</em> lorsqu'une +substitution relative (ne débutant pas par un slash ou un nom de +protocole) arrive à la fin d'un jeu de règles. Voir la directive +<directive module="mod_rewrite">RewriteBase</directive> pour plus de +détails à propos de l'ajout du préfixe après les substitutions +relatives.</li> + +<li>Si vous souhaitez effectuer une comparaison en prenant en compte +l'intégralité du +chemin de l'URL dans un contexte de répertoire (htaccess), vous devez +utiliser la variable <code>%{REQUEST_URI}</code> dans la directive +<directive>RewriteCond</directive>.</li> + +<li>Le prefixe supprimé se termine toujours par un slash, ce qui +signifie que la comparaison s'effectue avec une chaîne qui ne comporte +<em>jamais</em> de slash de début. Ainsi, un <em>modèle</em> contenant +<code>^/</code> ne correspondra jamais dans un contexte de répertoire.</li> + +<li>Bien que les règles de réécriture soient permises du point de vue de +la syntaxe dans les sections <directive type="section" +module="core">Location</directive> et <directive type="section" +module="core">Files</directive>, elles n'y sont pas prises en compte, et +n'y sont à priori d'aucune utilité.</li> +</ul> </note> <p>Pour quelques conseils à propos des <glossary @@ -1131,15 +1219,16 @@ substitution ! </td> </tr> <tr> - <td>discardpathinfo|DPI</td> + <td>discardpath|DPI</td> <td>Supprime la partie PATH_INFO de l'URI réécrit. <em><a href="../rewrite/flags.html#flag_dpi">détails ...</a></em></td> </tr> <tr> - <td>env|E=<em>VAR</em>[:<em>VAL</em>]</td> + <td>env|E=[!]<em>VAR</em>[:<em>VAL</em>]</td> <td>Définit la variable d'environnement <em>VAR</em> (à la valeur - <em>VAL</em> si elle est fournie). <em><a + <em>VAL</em> si elle est fournie). La variante !<em>VAR</em> + annule la définition de la variable <em>VAR</em>.<em><a href="../rewrite/flags.html#flag_e">détails ...</a></em></td> </tr> <tr> @@ -1259,49 +1348,6 @@ configuration du module <module>mod_userdir</module>.</p> utilisé dans la directive <directive module="mod_rewrite">RewriteRule</directive></p> </note> -<note><title>Réécritures dans le contexte de répertoire</title> - -<p>Le moteur de réécriture peut être utilisé dans les fichiers <a -href="../howto/htaccess.html">.htaccess</a>. Pour activer le moteur de -réécriture pour ces fichiers, vous devez préciser "<code>RewriteEngine -On</code>" <strong>et</strong> "<code>Options FollowSymLinks</code>" -doit être activé. Si votre administrateur a interdit la surcharge de -<code>FollowSymLinks</code> pour un répertoire utilisateur, vous ne -pouvez pas utiliser le moteur de réécriture. Cette restriction est -nécessaire pour des raisons de sécurité.</p> - -<p>Lorsqu'on utilise le moteur de réécriture dans les fichiers -<code>.htaccess</code>, le préfixe du répertoire (qui est -toujours le même pour un répertoire donné) est automatiquement -<em>supprimé</em> pour la comparaison du modèle et automatiquement -<em>ajouté</em> une fois la substitution effectuée. Cette fonctionnalité -est nécessaire pour de nombreux cas de réécriture ; sans elle, vous -seriez obligé de tenir compte du répertoire parent pour la comparaison, -ce qui n'est pas toujours -possible. Il y a une exception : si une chaîne de substitution commence -par <code>http://</code>, le préfixe du répertoire ne sera -<strong>pas</strong> ajouté, et une redirection externe (ou le passage -par un mandataire, si le drapeau <strong>P</strong> est utilisé) sera -initiée. Voir la directive <directive -module="mod_rewrite">RewriteBase</directive> pour plus de détails.</p> - -<p>Le moteur de réécriture peut aussi être utilisé dans les sections -<directive type="section" module="core">Directory</directive> avec les -mêmes règles de comparaison des préfixes que celles qui s'appliquent -pour les fichiers <code>.htaccess</code>. Cependant, il est en général -plus simple, pour éviter la complication des substitutions de préfixes, -de définir les règles de réécriture dans le contexte du serveur -principal ou des hôtes virtuels, plutôt que dans une section -<directive type="section" module="core">Directory</directive>.</p> - -<p>Bien que du point de vue syntaxique, il soit permis de définir des -règles de réécriture dans les sections <directive type="section" -module="core">Location</directive> et <directive -type="section" module="core">Files</directive>, ce n'est à priori -d'aucune utilité et n'est pas supporté.</p> - -</note> - <p>Voici toutes les combinaisons de substitution et leurs significations :</p> diff --git a/docs/manual/rewrite/flags.xml.fr b/docs/manual/rewrite/flags.xml.fr index 8aa4bb5a76..4b349345ab 100644 --- a/docs/manual/rewrite/flags.xml.fr +++ b/docs/manual/rewrite/flags.xml.fr @@ -1,7 +1,7 @@ <?xml version="1.0" encoding="ISO-8859-1" ?> <!DOCTYPE manualpage SYSTEM "../style/manualpage.dtd"> <?xml-stylesheet type="text/xsl" href="../style/manual.fr.xsl"?> -<!-- English Revision : 1043126 --> +<!-- English Revision : 1053726 --> <!-- French translation : Lucien GENTIS --> <!-- Reviewed by : Vincent Deffontaines --> @@ -226,7 +226,7 @@ fonctionnement des variables d'environnement.</p> <p>La syntaxe complète pour ce drapeau est :</p> <example> -[E=VAR:VAL] +[E=!VAR] </example> <p><code>VAL</code> peut comporter des références arrières @@ -241,6 +241,14 @@ fonctionnement des variables d'environnement.</p> <p>vous pouvez définir la variable d'environnement nommée <code>VAR</code> avec une valeur vide.</p> +<p>La forme</p> + +<example> +[E=!VAR] +</example> + +<p>permet d'annuler la définition de la variable <code>VAR</code>.</p> + <p>Les variables d'environnement s'emploient dans différents contextes, comme les programmes CGI, d'autres directives RewriteRule, ou des directives CustomLog.</p> diff --git a/docs/manual/upgrading.xml.fr b/docs/manual/upgrading.xml.fr index a0a1a71717..0d1e5618ce 100644 --- a/docs/manual/upgrading.xml.fr +++ b/docs/manual/upgrading.xml.fr @@ -3,7 +3,7 @@ <?xml-stylesheet type="text/xsl" href="./style/manual.fr.xsl"?> <!-- French translation : Lucien GENTIS --> <!-- Reviewed by : Vincent Deffontaines --> -<!-- English Revision: 1043126:1054323 (outdated) --> +<!-- English Revision: 1054323 --> <!-- Licensed to the Apache Software Foundation (ASF) under one or more @@ -252,6 +252,13 @@ nécessiter une modification des fichiers de configuration de la version <li><module>mod_auto_index</module>: extrait maintenant les titres et affiche la description pour les fichiers .xhtml qui étaient jusqu'alors ignorés.</li> + + <li><module>mod_ssl</module> : le format par défaut des variables + <code>*_DN</code> a changé. Il est cependant encore possible + d'utiliser l'ancien format via la nouvelle option + <code>LegacyDNStringFormat</code> de la directive <directive + module="mod_ssl">SSLOptions</directive>.</li> + <li><program>htpasswd</program> utilise maintenant par défaut les condensés MD5 sur toutes les plates-formes.</li> </ul> diff --git a/docs/manual/vhosts/ip-based.xml.fr b/docs/manual/vhosts/ip-based.xml.fr index b9cac6a2dd..06969aa2f6 100644 --- a/docs/manual/vhosts/ip-based.xml.fr +++ b/docs/manual/vhosts/ip-based.xml.fr @@ -1,7 +1,7 @@ <?xml version='1.0' encoding='ISO-8859-1' ?> <!DOCTYPE manualpage SYSTEM "../style/manualpage.dtd"> <?xml-stylesheet type="text/xsl" href="../style/manual.en.xsl"?> -<!-- English Revision: 1043126:1057632 (outdated) --> +<!-- English Revision: 1057632 --> <!-- French translation by alain B, review by Vincent Deffontaines --> <!-- Updated by Lucien Gentis --> @@ -42,15 +42,9 @@ IP" et la commande "ifconfig" pour les activer), et/ou utiliser plusieurs numéros de port.</p> - <p>Dans la plupart des cas, les <a href="name-based.html">serveurs - virtuels à base de nom</a> sont plus appropriés, car ils permettent - de partager une seule paire adresse/port entre de nombreux serveurs - virtuels. Voir le document <a - href="name-based.html#namevip">Serveurs virtuels à base de noms ou - serveurs virtuels à base d'adresse IP</a> pour vous aider à prendre - une décision. - </p> - + <p>Selon la terminologie du serveur HTTP Apache, l'utilisation d'une + seule adresse IP avec plusieurs ports TCP s'apparente aussi à de + l'hébergement virtuel basé sur IP.</p> </section> <section id="howto"><title>Comment configurer Apache</title> @@ -109,7 +103,7 @@ que le processus résident doit gérer. Par exemple :</p> <example> - Listen www.example.com:80 + Listen 192.0.2.100:80 </example> <p>Il est recommandé d'utiliser une adresse IP plutôt qu'un nom |