You are viewing a plain text version of this content. The canonical link for it is here.
Posted to cvs@httpd.apache.org by jo...@apache.org on 2016/11/14 10:26:34 UTC
svn commit: r1769588 [7/17] - in
/httpd/httpd/branches/2.4.x-openssl-1.1.0-compat: ./ docs/conf/
docs/manual/ docs/manual/howto/ docs/manual/mod/ docs/manual/platform/
docs/manual/programs/ docs/manual/rewrite/ include/ modules/ modules/aaa/
modules/ar...
Modified: httpd/httpd/branches/2.4.x-openssl-1.1.0-compat/docs/manual/mod/mod_imagemap.xml.fr
URL: http://svn.apache.org/viewvc/httpd/httpd/branches/2.4.x-openssl-1.1.0-compat/docs/manual/mod/mod_imagemap.xml.fr?rev=1769588&r1=1769587&r2=1769588&view=diff
==============================================================================
--- httpd/httpd/branches/2.4.x-openssl-1.1.0-compat/docs/manual/mod/mod_imagemap.xml.fr (original)
+++ httpd/httpd/branches/2.4.x-openssl-1.1.0-compat/docs/manual/mod/mod_imagemap.xml.fr Mon Nov 14 10:26:31 2016
@@ -1,4 +1,4 @@
-<?xml version="1.0"?>
+<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE modulesynopsis SYSTEM "../style/modulesynopsis.dtd">
<?xml-stylesheet type="text/xsl" href="../style/manual.fr.xsl"?>
<!-- English Revision : 1432445 -->
@@ -33,51 +33,51 @@
<summary>
<p>Ce module traite les fichiers <code>.map</code>, et remplace
- ainsi la fonctionnalité du programme CGI <code>imagemap</code>. Tout
- répertoire ou type de document configuré pour utiliser le
- gestionnaire <code>imap-file</code> (à l'aide des directives
+ ainsi la fonctionnalité du programme CGI <code>imagemap</code>. Tout
+ répertoire ou type de document configuré pour utiliser le
+ gestionnaire <code>imap-file</code> (à l'aide des directives
<directive module="mod_mime">AddHandler</directive> ou <directive
- module="core">SetHandler</directive>), sera traité par ce
+ module="core">SetHandler</directive>), sera traité par ce
module.</p>
- <p>La directive suivante confère aux fichiers possèdant l'extension
+ <p>La directive suivante confère aux fichiers possèdant l'extension
<code>.map</code> le statut de fichiers imagemap :</p>
<highlight language="config">AddHandler imap-file map</highlight>
- <p>Notez que la syntaxe suivante reste encore supportée :</p>
+ <p>Notez que la syntaxe suivante reste encore supportée :</p>
<highlight language="config">AddType application/x-httpd-imap map</highlight>
<p>Cependant, nous essayons d'abandonner progressivement les "types
MIME magiques", et cette syntaxe est sur le point de devenir
- obsolète.</p>
+ obsolète.</p>
</summary>
-<section id="features"><title>Nouvelles fonctionnalités</title>
+<section id="features"><title>Nouvelles fonctionnalités</title>
- <p>Le module imagemap propose quelques nouvelles fonctionnalités qui
- n'étaient pas disponibles avec les programmes imagemap précédemment
- distribués.</p>
+ <p>Le module imagemap propose quelques nouvelles fonctionnalités qui
+ n'étaient pas disponibles avec les programmes imagemap précédemment
+ distribués.</p>
<ul>
- <li>Références d'URLs relatives à l'information contenue dans
- l'en-tête Referer: .</li>
+ <li>Références d'URLs relatives à l'information contenue dans
+ l'en-tête Referer: .</li>
- <li>Assignement <code><base></code> par défaut via la
+ <li>Assignement <code><base></code> par défaut via la
nouvelle directive <code>base</code>.</li>
<li>Fichier <code>imagemap.conf</code> non requis.</li>
- <li>Références à des points.</li>
+ <li>Références à des points.</li>
- <li>Génération configurable de menus d'images interactives.</li>
+ <li>Génération configurable de menus d'images interactives.</li>
</ul>
</section>
<section id="imapfile"><title>Fichier imagemap</title>
- <p>Les lignes d'un fichier imagemap peuvent se présenter sous
+ <p>Les lignes d'un fichier imagemap peuvent se présenter sous
plusieurs formats :</p>
<example>
@@ -90,137 +90,137 @@
<p>Les directives sont <code>base</code>, <code>default</code>,
<code>poly</code>, <code>circle</code>, <code>rect</code>, ou
<code>point</code>. valeur est une URL absolue ou relative, ou une
- des valeurs spéciales énumérées ci-dessous. Les coordonnées sont des
- paires <code><var>x</var>,<var>y</var></code> séparées par des
+ des valeurs spéciales énumérées ci-dessous. Les coordonnées sont des
+ paires <code><var>x</var>,<var>y</var></code> séparées par des
espaces. Le texte entre guillemets est le texte du lien si un menu
- imagemap est généré. Les lignes commençant par '#' sont des
+ imagemap est généré. Les lignes commençant par '#' sont des
commentaires.</p>
<section id="imapfile.directives"><title>Directives d'un fichier
imagemap</title>
- <p>Les directives autorisées dans un fichier imagemap sont au
- nombre de six. Elles peuvent se trouver à n'importe quelle
- position dans le fichier, mais sont traitées dans l'ordre selon
- lequel elles sont enregistrées dans le fichier imagemap.</p>
+ <p>Les directives autorisées dans un fichier imagemap sont au
+ nombre de six. Elles peuvent se trouver à n'importe quelle
+ position dans le fichier, mais sont traitées dans l'ordre selon
+ lequel elles sont enregistrées dans le fichier imagemap.</p>
<dl>
<dt>Directive <code>base</code></dt>
- <dd><p>Elle a le même effet que <code><base
+ <dd><p>Elle a le même effet que <code><base
href="<var>valeur</var>"></code>. Les URLs non absolues du
- fichier imagemap sont considérées comme relatives à cette valeur.
+ fichier imagemap sont considérées comme relatives à cette valeur.
La directive <code>base</code> l'emporte sur une directive
- <directive module="mod_imagemap">ImapBase</directive> définie dans
+ <directive module="mod_imagemap">ImapBase</directive> définie dans
un fichier <code>.htaccess</code> ou dans le fichier de
configuration du serveur. En l'absence de directive de
configuration <directive>ImapBase</directive>, la valeur par
- défaut de <code>base</code> est
+ défaut de <code>base</code> est
<code>http://nom_serveur/</code>.</p>
<p><code>base_uri</code> est un synonyme de <code>base</code>.
- Notez que la présence ou l'absence d'un slash de fin dans l'URL
+ Notez que la présence ou l'absence d'un slash de fin dans l'URL
est importante.</p></dd>
<dt>Directive <code>default</code></dt>
- <dd>La décision à prendre si les coordonnées fournies ne
- correspondent à aucune des directives <code>poly</code>,
+ <dd>La décision à prendre si les coordonnées fournies ne
+ correspondent à aucune des directives <code>poly</code>,
<code>circle</code>, ou <code>rect</code>, et si aucune directive
- <code>point</code> n'est présente. En l'absence de définition
+ <code>point</code> n'est présente. En l'absence de définition
d'une directive de configuration <directive module="mod_imagemap"
- >ImapDefault</directive>, la valeur par défaut est
+ >ImapDefault</directive>, la valeur par défaut est
<code>nocontent</code> et provoque l'envoi d'un code de statut
- <code>204 No Content</code>. Le client verra toujours la même
+ <code>204 No Content</code>. Le client verra toujours la même
page s'afficher.</dd>
<dt>Directive <code>poly</code></dt>
- <dd>Accepte comme arguments trois à cent points, et est actionnée
- si les coordonnées sélectionnées par l'utilisateur tombent dans le
- polygone défini par ces points.</dd>
+ <dd>Accepte comme arguments trois à cent points, et est actionnée
+ si les coordonnées sélectionnées par l'utilisateur tombent dans le
+ polygone défini par ces points.</dd>
<dt>Directive <code>circle</code></dt>
- <dd>Accepte comme arguments les coordonnées du centre d'un cercle
- et celles d'un point de ce cercle. Elle est actionnée si les
- coordonnées sélectionnées par l'utilisateur tombent dans ce
+ <dd>Accepte comme arguments les coordonnées du centre d'un cercle
+ et celles d'un point de ce cercle. Elle est actionnée si les
+ coordonnées sélectionnées par l'utilisateur tombent dans ce
cercle.</dd>
<dt>Directive <code>rect</code></dt>
- <dd>Accepte comme arguments les coordonnées des sommets de deux
- angles opposés d'un rectangle. Elle est actionnée si les
- coordonnées sélectionnées par l'utilisateur tombent dans ce
+ <dd>Accepte comme arguments les coordonnées des sommets de deux
+ angles opposés d'un rectangle. Elle est actionnée si les
+ coordonnées sélectionnées par l'utilisateur tombent dans ce
rectangle.</dd>
<dt>Directive <code>point</code></dt>
<dd>Elle n'accepte qu'un seul point comme argument. Si aucune
autre directive ne correspond, c'est la directive
- dont le point spécifié est le plus près du point sélectionné par
- l'utilisateur qui est actionnée. Notez que la directive
+ dont le point spécifié est le plus près du point sélectionné par
+ l'utilisateur qui est actionnée. Notez que la directive
<code>default</code> ne sera pas suivie si une directive
- <code>point</code> est présente et si des coordonnées valides sont
+ <code>point</code> est présente et si des coordonnées valides sont
fournies.</dd>
</dl>
</section>
<section id="imapfile.values"><title>Valeurs</title>
- <p>Les valeurs passées aux directives peuvent contenir :</p>
+ <p>Les valeurs passées aux directives peuvent contenir :</p>
<dl>
<dt>une URL</dt>
- <dd><p>L'URL peut être absolue ou relative. Les URLs relatives
- peuvent contenir '..' et seront considérées comme relatives à la
+ <dd><p>L'URL peut être absolue ou relative. Les URLs relatives
+ peuvent contenir '..' et seront considérées comme relatives à la
valeur de <code>base</code>.</p>
- <p><code>base</code> en lui-même, ne sera pas résolu en fonction
+ <p><code>base</code> en lui-même, ne sera pas résolu en fonction
de la valeur courante. Cependant, une directive <code>base
mailto:</code> fonctionnera correctement.</p></dd>
<dt><code>map</code></dt>
- <dd>Équivalent à l'URL du fichier imagemap lui-même. Aucune
- coordonnée n'est spécifiée, et un menu sera donc généré, à moins
+ <dd>Équivalent à l'URL du fichier imagemap lui-même. Aucune
+ coordonnée n'est spécifiée, et un menu sera donc généré, à moins
qu'une directive <directive
- module="mod_imagemap">ImapMenu</directive> n'ait été définie à
+ module="mod_imagemap">ImapMenu</directive> n'ait été définie à
<code>none</code>.</dd>
<dt><code>menu</code></dt>
- <dd>Équivalent à <code>map</code>.</dd>
+ <dd>Équivalent à <code>map</code>.</dd>
<dt><code>referer</code></dt>
- <dd>Équivalent à l'URL du document référant. La valeur par défaut
- est <code>http://nom_serveur/</code> si aucun en-tête
- <code>Referer:</code> n'est présent.</dd>
+ <dd>Équivalent à l'URL du document référant. La valeur par défaut
+ est <code>http://nom_serveur/</code> si aucun en-tête
+ <code>Referer:</code> n'est présent.</dd>
<dt><code>nocontent</code></dt>
<dd>Envoie un code de statut <code>204 No Content</code>,
- indiquant au client qu'il doit continuer à afficher la même page.
+ indiquant au client qu'il doit continuer à afficher la même page.
Valide pour toutes les directives, sauf <code>base</code>.</dd>
<dt><code>error</code></dt>
- <dd>Envoie un code de statut d'échec <code>500 Server
+ <dd>Envoie un code de statut d'échec <code>500 Server
Error</code>. Valide pour toutes les directives, sauf
<code>base</code>, mais n'a de sens qu'avec la directive
<code>default</code>.</dd>
</dl>
</section>
- <section id="imapfile.coords"><title>Coordonnées</title>
+ <section id="imapfile.coords"><title>Coordonnées</title>
<dl>
<dt><code>0,0 200,200</code></dt>
- <dd>Une coordonnée se compose de deux valeurs, <var>x</var> et
- <var>y</var>, séparées par une virgule. Les coordonnées sont
- séparées entre elles par des espaces. Pour s'adapter à la manière
- dont Lynx traite les images interactives, la sélection par un
- utilisateur de la coordonnée <code>0,0</code> a le même effet que
- si aucune coordonnée n'a été sélectionnée.</dd>
+ <dd>Une coordonnée se compose de deux valeurs, <var>x</var> et
+ <var>y</var>, séparées par une virgule. Les coordonnées sont
+ séparées entre elles par des espaces. Pour s'adapter à la manière
+ dont Lynx traite les images interactives, la sélection par un
+ utilisateur de la coordonnée <code>0,0</code> a le même effet que
+ si aucune coordonnée n'a été sélectionnée.</dd>
</dl>
</section>
@@ -231,23 +231,23 @@
<dl>
<dt><code>"<var>Texte du menu</var>"</code></dt>
- <dd><p>Après la valeur ou les coordonnées, la ligne peut
- éventuellement contenir un texte entre guillemets. Cette chaîne
- constitue le texte du lien si un menu est généré :</p>
+ <dd><p>Après la valeur ou les coordonnées, la ligne peut
+ éventuellement contenir un texte entre guillemets. Cette chaîne
+ constitue le texte du lien si un menu est généré :</p>
<example>
<a href="http://example.com/"><var>Texte de
menu</var></a>
</example>
- <p>Si aucun texte entre guillemets n'est présent, le texte sera
- constitué du nom du lien :</p>
+ <p>Si aucun texte entre guillemets n'est présent, le texte sera
+ constitué du nom du lien :</p>
<example>
<a href="http://example.com/">http://example.com</a>
</example>
- <p>Si vous voulez insérer des guillemets dans le texte, vous devez
+ <p>Si vous voulez insérer des guillemets dans le texte, vous devez
les inscrire sous la forme <code>&quot;</code>.</p></dd>
</dl>
@@ -257,14 +257,14 @@
<section id="example"><title>Exemple de fichier imagemap</title>
<example>
- #Les commentaires sont affichés dans un menu 'formaté' ou
- #'semi-formaté'.<br />
+ #Les commentaires sont affichés dans un menu 'formaté' ou
+ #'semi-formaté'.<br />
#Et peuvent contenir des balises html. <hr><br />
base referer<br />
poly map "Puis-je avoir un menu, s'il vous plait ?" 0,0 0,10 10,10 10,0<br />
- rect .. 0,0 77,27 "le répertoire du référant"<br />
+ rect .. 0,0 77,27 "le répertoire du référant"<br />
circle http://www.inetnebr.example.com/lincoln/feedback/ 195,0 305,27<br />
- rect autre_fichier "dans le même répertoire que le référant" 306,0 419,27<br />
+ rect autre_fichier "dans le même répertoire que le référant" 306,0 419,27<br />
point http://www.zyzzyva.example.com/ 100,100<br />
point http://www.tripod.example.com/ 200,200<br />
rect mailto:nate@tripod.example.com 100,150 200,0 "Bogues?"<br />
@@ -272,7 +272,7 @@
</section>
-<section id="referencing"><title>Référencement de votre fichier
+<section id="referencing"><title>Référencement de votre fichier
imagemap</title>
<example><title>Exemple HTML</title>
@@ -295,7 +295,7 @@ imagemap</title>
<directivesynopsis>
<name>ImapMenu</name>
-<description>Action à entreprendre si aucune coordonnée n'est fournie
+<description>Action à entreprendre si aucune coordonnée n'est fournie
lorsqu'on invoque un fichier imagemap</description>
<syntax>ImapMenu none|formatted|semiformatted|unformatted</syntax>
<default>ImapMenu formatted</default>
@@ -304,37 +304,37 @@ lorsqu'on invoque un fichier imagemap</d
<override>Indexes</override>
<usage>
- <p>La directive <directive>ImapMenu</directive> permet de spécifier
- l'action à entreprendre lorsqu'un fichier imagemap est invoqué sans
- coordonnées valides.</p>
+ <p>La directive <directive>ImapMenu</directive> permet de spécifier
+ l'action à entreprendre lorsqu'un fichier imagemap est invoqué sans
+ coordonnées valides.</p>
<dl>
<dt><code>none</code></dt>
<dd>Si l'argument d'ImapMenu est <code>none</code>, aucun menu
- n'est généré, et l'action <code>default</code> est effectuée.</dd>
+ n'est généré, et l'action <code>default</code> est effectuée.</dd>
<dt><code>formatted</code></dt>
<dd>Le menu <code>formatted</code> est le menu le plus simple. Les
- commentaires du fichier imagemap sont ignorés. Un en-tête de
- niveau un est affiché, puis un séparateur horizontal, puis chacun
- des liens sur une ligne séparée. L'aspect du menu est similaire à
- celui d'un listing de répertoire.</dd>
+ commentaires du fichier imagemap sont ignorés. Un en-tête de
+ niveau un est affiché, puis un séparateur horizontal, puis chacun
+ des liens sur une ligne séparée. L'aspect du menu est similaire à
+ celui d'un listing de répertoire.</dd>
<dt><code>semiformatted</code></dt>
<dd>Dans le menu <code>semiformatted</code>, les commentaires sont
- affichés au moment où ils apparaissent dans le fichier imagemap.
- Les lignes vides sont interprètées comme des lignes de séparation
- HTML. Aucun en-tête ni séparateur horizontal n'est affiché. À part
- ces différences, le menu <code>semiformatted</code> est identique
+ affichés au moment où ils apparaissent dans le fichier imagemap.
+ Les lignes vides sont interprètées comme des lignes de séparation
+ HTML. Aucun en-tête ni séparateur horizontal n'est affiché. À part
+ ces différences, le menu <code>semiformatted</code> est identique
au menu <code>formatted</code>.</dd>
<dt><code>unformatted</code></dt>
- <dd>Les commentaires sont affichés et les lignes vides sont
- ignorées. N'est affiché que ce qui apparait dans le fichier
- imagemap. Toutes les lignes de séparation HTML et les
- en-têtes doivent être inclus en tant que commentaires dans le
+ <dd>Les commentaires sont affichés et les lignes vides sont
+ ignorées. N'est affiché que ce qui apparait dans le fichier
+ imagemap. Toutes les lignes de séparation HTML et les
+ en-têtes doivent être inclus en tant que commentaires dans le
fichier imagemap. Cela vous procure une grande souplesse pour
- définir l'apparence de vos menus, mais vous oblige à rédiger vos
+ définir l'apparence de vos menus, mais vous oblige à rédiger vos
fichiers imagemap en HTML, et non en texte plat.</dd>
</dl>
</usage>
@@ -342,8 +342,8 @@ lorsqu'on invoque un fichier imagemap</d
<directivesynopsis>
<name>ImapDefault</name>
-<description>Action à entreprendre par défaut lorsqu'un fichier imagemap
-est invoqué avec des coordonnées qui ne correspondent à aucune
+<description>Action à entreprendre par défaut lorsqu'un fichier imagemap
+est invoqué avec des coordonnées qui ne correspondent à aucune
cible</description>
<syntax>ImapDefault error|nocontent|map|referer|<var>URL</var></syntax>
<default>ImapDefault nocontent</default>
@@ -352,20 +352,20 @@ cible</description>
<override>Indexes</override>
<usage>
- <p>La directive <directive>ImapDefault</directive> permet de définir
- la valeur par défaut de la directive <code>default</code> utilisée
- dans les fichiers imagemap. Sa valeur est écrasée par la présence
- éventuelle d'une directive <code>default</code> dans le fichier
- imagemap. Si cette directive est absente, l'action associée à
+ <p>La directive <directive>ImapDefault</directive> permet de définir
+ la valeur par défaut de la directive <code>default</code> utilisée
+ dans les fichiers imagemap. Sa valeur est écrasée par la présence
+ éventuelle d'une directive <code>default</code> dans le fichier
+ imagemap. Si cette directive est absente, l'action associée à
<code>default</code> est <code>nocontent</code>, ce qui implique
l'envoi d'un code de statut <code>204 No Content</code> au client.
- Dans ce cas, le client doit continuer à afficher la même page.</p>
+ Dans ce cas, le client doit continuer à afficher la même page.</p>
</usage>
</directivesynopsis>
<directivesynopsis>
<name>ImapBase</name>
-<description>Valeur par défaut de la directive <code>base</code> des
+<description>Valeur par défaut de la directive <code>base</code> des
fichiers imagemap</description>
<syntax>ImapBase map|referer|<var>URL</var></syntax>
<default>ImapBase http://nom_serveur/</default>
@@ -374,11 +374,11 @@ fichiers imagemap</description>
<override>Indexes</override>
<usage>
- <p>La directive <directive>ImapBase</directive> permet de définir la
- valeur par défaut de la directive <code>base</code> des fichiers
- imagemap. Sa valeur est écrasée par la présence éventuelle d'une
+ <p>La directive <directive>ImapBase</directive> permet de définir la
+ valeur par défaut de la directive <code>base</code> des fichiers
+ imagemap. Sa valeur est écrasée par la présence éventuelle d'une
directive <code>base</code> dans le fichier imagemap. Si cette
- directive est absente, la valeur par défaut de la directive
+ directive est absente, la valeur par défaut de la directive
<code>base</code> est
<code>http://<var>nom_serveur</var>/</code>.</p>
</usage>
Modified: httpd/httpd/branches/2.4.x-openssl-1.1.0-compat/docs/manual/mod/mod_isapi.xml.fr
URL: http://svn.apache.org/viewvc/httpd/httpd/branches/2.4.x-openssl-1.1.0-compat/docs/manual/mod/mod_isapi.xml.fr?rev=1769588&r1=1769587&r2=1769588&view=diff
==============================================================================
--- httpd/httpd/branches/2.4.x-openssl-1.1.0-compat/docs/manual/mod/mod_isapi.xml.fr (original)
+++ httpd/httpd/branches/2.4.x-openssl-1.1.0-compat/docs/manual/mod/mod_isapi.xml.fr Mon Nov 14 10:26:31 2016
@@ -1,4 +1,4 @@
-<?xml version="1.0"?>
+<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE modulesynopsis SYSTEM "../style/modulesynopsis.dtd">
<?xml-stylesheet type="text/xsl" href="../style/manual.fr.xsl"?>
<!-- English Revision : 1584684 -->
Modified: httpd/httpd/branches/2.4.x-openssl-1.1.0-compat/docs/manual/mod/mod_proxy_html.html.en
URL: http://svn.apache.org/viewvc/httpd/httpd/branches/2.4.x-openssl-1.1.0-compat/docs/manual/mod/mod_proxy_html.html.en?rev=1769588&r1=1769587&r2=1769588&view=diff
==============================================================================
--- httpd/httpd/branches/2.4.x-openssl-1.1.0-compat/docs/manual/mod/mod_proxy_html.html.en (original)
+++ httpd/httpd/branches/2.4.x-openssl-1.1.0-compat/docs/manual/mod/mod_proxy_html.html.en Mon Nov 14 10:26:31 2016
@@ -278,13 +278,29 @@ for earlier 2.x versions</td></tr>
for earlier 2.x versions</td></tr>
</table>
<p>Specifies elements that have URL attributes that should be rewritten
-using standard <code class="directive">ProxyHTMLURLMap</code>s. You will need one
-ProxyHTMLLinks directive per element, but it can have any number of attributes.</p>
+using standard <code class="directive"><a href="#proxyhtmlurlmap">ProxyHTMLURLMap</a></code>s.
+You will need one ProxyHTMLLinks directive per element,
+but it can have any number of attributes.</p>
<p>Normally you'll set this globally. If you set ProxyHTMLLinks in more than
one scope so that one overrides the other, you'll need to specify a complete
set in each of those scopes.</p>
<p>A default configuration is supplied in <var>proxy-html.conf</var>
and defines the HTML links for standard HTML 4 and XHTML 1.</p>
+<div class="example"><h3>Examples from proxy-html.conf</h3><pre class="prettyprint lang-config">ProxyHTMLLinks a href
+ProxyHTMLLinks area href
+ProxyHTMLLinks link href
+ProxyHTMLLinks img src longdesc usemap
+ProxyHTMLLinks object classid codebase data usemap
+ProxyHTMLLinks q cite
+ProxyHTMLLinks blockquote cite
+ProxyHTMLLinks ins cite
+ProxyHTMLLinks del cite
+ProxyHTMLLinks form action
+ProxyHTMLLinks input src usemap
+ProxyHTMLLinks head profile
+ProxyHTMLLinks base href
+ProxyHTMLLinks script src for</pre>
+</div>
</div>
<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
@@ -322,6 +338,15 @@ module for earlier 2.x versions.</td></t
them to real HTTP headers, in keeping with the original purpose
of this form of the HTML <meta> element.</p>
+ <div class="warning"><h3>Warning</h3>
+ Because ProxyHTMLMeta promotes <strong>all</strong>
+ <code>http-equiv</code> elements to HTTP headers, it is important that you
+ only enable it in cases where you trust the HTML content as much as you
+ trust the upstream server. If the HTML is controlled by bad actors, it
+ will be possible for them to inject arbitrary, possibly malicious, HTTP
+ headers into your server's responses.
+ </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="ProxyHTMLStripComments" id="ProxyHTMLStripComments">ProxyHTMLStripComments</a> <a name="proxyhtmlstripcomments" id="proxyhtmlstripcomments">Directive</a></h2>
@@ -355,11 +380,14 @@ filter chain if stripping comments!</p>
<tr><th><a href="directive-dict.html#Compatibility">Compatibility:</a></th><td>Version 2.4 and later; available as a third-party
module for earlier 2.x versions.</td></tr>
</table>
-<p>This is the key directive for rewriting HTML links. When parsing a document,
+<p>This is the key directive for rewriting HTML links. When parsing a document,
whenever a link target matches <var>from-pattern</var>, the matching
portion will be rewritten to <var>to-pattern</var>, as modified by any
-flags supplied and by the <code class="directive">ProxyHTMLExtended</code>
-directive.</p>
+flags supplied and by the
+<code class="directive"><a href="#proxyhtmlextended">ProxyHTMLExtended</a></code> directive.
+Only the elements specified using
+the <code class="directive"><a href="#proxyhtmllinks">ProxyHTMLLinks</a></code> directive
+will be considered as HTML links.</p>
<p>The optional third argument may define any of the following
<strong>Flags</strong>. Flags are case-sensitive.</p>
Modified: httpd/httpd/branches/2.4.x-openssl-1.1.0-compat/docs/manual/mod/mod_proxy_html.html.fr
URL: http://svn.apache.org/viewvc/httpd/httpd/branches/2.4.x-openssl-1.1.0-compat/docs/manual/mod/mod_proxy_html.html.fr?rev=1769588&r1=1769587&r2=1769588&view=diff
==============================================================================
--- httpd/httpd/branches/2.4.x-openssl-1.1.0-compat/docs/manual/mod/mod_proxy_html.html.fr (original)
+++ httpd/httpd/branches/2.4.x-openssl-1.1.0-compat/docs/manual/mod/mod_proxy_html.html.fr Mon Nov 14 10:26:31 2016
@@ -313,18 +313,30 @@ Disponible en tant que module tiers dans
<tr><th><a href="directive-dict.html#Compatibility">Compatibilit�:</a></th><td>Disponible depuis la version 2.4 du serveur HTTP Apache.
Disponible en tant que module tiers dans les versions 2.x ant�rieures.</td></tr>
</table>
-<p>Cette directive permet de sp�cifier les �l�ments dont les attributs
-d'URL doivent �tre r��crits en utilisant les r�gles standards
-<code class="directive">ProxyHTMLURLMap</code>. Vous devez d�finir une directive
-ProxyHTMLLinks pour chaque �l�ment, mais chacune d'entre elles peut
-sp�cifier un nombre quelconque d'attributs</p>
-<p>Normalement, cette directive est d�finie globalement. Si vous
-d�finissez ProxyHTMLLinks � plusieurs niveaux, certains niveaux
-l'emportant sur d'autres, vous devrez sp�cifier un jeu complet
-de liens pour chaque niveau.</p>
-<p>Le fichier <var>proxy-html.conf</var> fournit une configuration par
-d�faut et d�finit les liens HTML selon les standards
-HTML 4 et XHTML 1.</p>
+<p>Cette directive permet de sp�cifier les �l�ments dont les attributs d'URL
+doivent �tre r��crits en utilisant les r�gles standards <code class="directive"><a href="#proxyhtmlurlmap">ProxyHTMLURLMap</a></code>. Vous devez d�finir une
+directive ProxyHTMLLinks pour chaque �l�ment, mais chacune d'entre elles peut
+sp�cifier un nombre quelconque d'attributs</p> <p>Normalement, cette directive
+est d�finie globalement. Si vous d�finissez ProxyHTMLLinks � plusieurs niveaux,
+certains niveaux l'emportant sur d'autres, vous devrez sp�cifier un jeu complet
+de liens pour chaque niveau.</p> <p>Le fichier <var>proxy-html.conf</var>
+fournit une configuration par d�faut et d�finit les liens HTML selon les
+standards HTML 4 et XHTML 1.</p>
+<div class="example"><h3>Exemples issus de proxy-html.conf</h3><pre class="prettyprint lang-config">ProxyHTMLLinks a href
+ProxyHTMLLinks area href
+ProxyHTMLLinks link href
+ProxyHTMLLinks img src longdesc usemap
+ProxyHTMLLinks object classid codebase data usemap
+ProxyHTMLLinks q cite
+ProxyHTMLLinks blockquote cite
+ProxyHTMLLinks ins cite
+ProxyHTMLLinks del cite
+ProxyHTMLLinks form action
+ProxyHTMLLinks input src usemap
+ProxyHTMLLinks head profile
+ProxyHTMLLinks base href
+ProxyHTMLLinks script src for</pre>
+</div>
</div>
<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
@@ -368,6 +380,16 @@ pr�c�dentes.</td></tr>
en-t�tes HTTP, afin de conserver le but original de cette forme
de m�ta�l�ment HTML.</p>
+ <div class="warning"><h3>Avertissement</h3> Compte tenu du fait que la
+ directive ProxyHTMLMeta promeut <strong>tous</strong> les �l�ments
+ <code>http-equiv</code> au rang d'en-t�tes HTTP, il est conseill� de ne
+ l'activer que si vous faites autant confiance au contenu HTML qu'� votre
+ serveur mandataire. Avec cette directive en effet, si ce contenu est g�r�
+ par des gens malintentionn�s, ces derniers seront en mesure d'injecter des
+ en-t�tes HTTP arbitraires et peut-�tre malveillants dans les r�ponses de
+ votre serveur.
+ </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="proxyhtmlstripcomments" id="proxyhtmlstripcomments">Directive</a> <a name="ProxyHTMLStripComments" id="ProxyHTMLStripComments">ProxyHTMLStripComments</a></h2>
@@ -407,7 +429,9 @@ liens HTML. Lors de l'interpr�tation d'
lien correspond � <var>mod�le-source</var>, la partie du lien concern�e
sera r��crite en <var>mod�le-cible</var>, en tenant compte des
modifications induites par les drapeaux �ventuellement sp�cifi�s et par
-la directive <code class="directive">ProxyHTMLExtended</code>.</p>
+la directive <code class="directive"><a href="#proxyhtmlextended">ProxyHTMLExtended</a></code>.
+Ne seront consid�r�s comme des liens HTML que les �l�ments sp�cifi�s via la
+directive <code class="directive"><a href="#proxyhtmllinks">ProxyHTMLLinks</a></code>.</p>
<p>Le troisi�me argument optionnel permet de f�finir un des drapeaux
suivants (les drapeaux sont sensibles � la casse) :</p>
Modified: httpd/httpd/branches/2.4.x-openssl-1.1.0-compat/docs/manual/mod/mod_proxy_html.xml
URL: http://svn.apache.org/viewvc/httpd/httpd/branches/2.4.x-openssl-1.1.0-compat/docs/manual/mod/mod_proxy_html.xml?rev=1769588&r1=1769587&r2=1769588&view=diff
==============================================================================
--- httpd/httpd/branches/2.4.x-openssl-1.1.0-compat/docs/manual/mod/mod_proxy_html.xml (original)
+++ httpd/httpd/branches/2.4.x-openssl-1.1.0-compat/docs/manual/mod/mod_proxy_html.xml Mon Nov 14 10:26:31 2016
@@ -88,6 +88,15 @@ module for earlier 2.x versions.</compat
<code><meta http-equiv=...></code> declarations and convert
them to real HTTP headers, in keeping with the original purpose
of this form of the HTML <meta> element.</p>
+
+ <note type="warning"><title>Warning</title>
+ Because ProxyHTMLMeta promotes <strong>all</strong>
+ <code>http-equiv</code> elements to HTTP headers, it is important that you
+ only enable it in cases where you trust the HTML content as much as you
+ trust the upstream server. If the HTML is controlled by bad actors, it
+ will be possible for them to inject arbitrary, possibly malicious, HTTP
+ headers into your server's responses.
+ </note>
</usage>
</directivesynopsis>
@@ -124,11 +133,14 @@ module for earlier 2.x versions.</compat
module for earlier 2.x versions.</compatibility>
<usage>
-<p>This is the key directive for rewriting HTML links. When parsing a document,
+<p>This is the key directive for rewriting HTML links. When parsing a document,
whenever a link target matches <var>from-pattern</var>, the matching
portion will be rewritten to <var>to-pattern</var>, as modified by any
-flags supplied and by the <directive>ProxyHTMLExtended</directive>
-directive.</p>
+flags supplied and by the
+<directive module="mod_proxy_html">ProxyHTMLExtended</directive> directive.
+Only the elements specified using
+the <directive module="mod_proxy_html">ProxyHTMLLinks</directive> directive
+will be considered as HTML links.</p>
<p>The optional third argument may define any of the following
<strong>Flags</strong>. Flags are case-sensitive.</p>
@@ -386,13 +398,33 @@ and defines the events in standard HTML
for earlier 2.x versions</compatibility>
<usage>
<p>Specifies elements that have URL attributes that should be rewritten
-using standard <directive>ProxyHTMLURLMap</directive>s. You will need one
-ProxyHTMLLinks directive per element, but it can have any number of attributes.</p>
+using standard <directive module="mod_proxy_html">ProxyHTMLURLMap</directive>s.
+You will need one ProxyHTMLLinks directive per element,
+but it can have any number of attributes.</p>
<p>Normally you'll set this globally. If you set ProxyHTMLLinks in more than
one scope so that one overrides the other, you'll need to specify a complete
set in each of those scopes.</p>
<p>A default configuration is supplied in <var>proxy-html.conf</var>
and defines the HTML links for standard HTML 4 and XHTML 1.</p>
+<example>
+<title>Examples from proxy-html.conf</title>
+<highlight language="config">
+ProxyHTMLLinks a href
+ProxyHTMLLinks area href
+ProxyHTMLLinks link href
+ProxyHTMLLinks img src longdesc usemap
+ProxyHTMLLinks object classid codebase data usemap
+ProxyHTMLLinks q cite
+ProxyHTMLLinks blockquote cite
+ProxyHTMLLinks ins cite
+ProxyHTMLLinks del cite
+ProxyHTMLLinks form action
+ProxyHTMLLinks input src usemap
+ProxyHTMLLinks head profile
+ProxyHTMLLinks base href
+ProxyHTMLLinks script src for
+</highlight>
+</example>
</usage>
</directivesynopsis>
Modified: httpd/httpd/branches/2.4.x-openssl-1.1.0-compat/docs/manual/mod/mod_proxy_html.xml.fr
URL: http://svn.apache.org/viewvc/httpd/httpd/branches/2.4.x-openssl-1.1.0-compat/docs/manual/mod/mod_proxy_html.xml.fr?rev=1769588&r1=1769587&r2=1769588&view=diff
==============================================================================
--- httpd/httpd/branches/2.4.x-openssl-1.1.0-compat/docs/manual/mod/mod_proxy_html.xml.fr (original)
+++ httpd/httpd/branches/2.4.x-openssl-1.1.0-compat/docs/manual/mod/mod_proxy_html.xml.fr Mon Nov 14 10:26:31 2016
@@ -1,7 +1,7 @@
-<?xml version="1.0"?>
+<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE modulesynopsis SYSTEM "../style/modulesynopsis.dtd">
<?xml-stylesheet type="text/xsl" href="../style/manual.fr.xsl"?>
-<!-- English Revision : 1530513 -->
+<!-- English Revision: 1765368 -->
<!-- French translation : Lucien GENTIS -->
<!-- Reviewed by : Vincent Deffontaines -->
@@ -102,6 +102,16 @@ précédentes.</compatibility>
<code><meta http-equiv=...></code> et leur conversion en
en-têtes HTTP, afin de conserver le but original de cette forme
de métaélément HTML.</p>
+
+ <note type="warning"><title>Avertissement</title> Compte tenu du fait que la
+ directive ProxyHTMLMeta promeut <strong>tous</strong> les éléments
+ <code>http-equiv</code> au rang d'en-têtes HTTP, il est conseillé de ne
+ l'activer que si vous faites autant confiance au contenu HTML qu'à votre
+ serveur mandataire. Avec cette directive en effet, si ce contenu est géré
+ par des gens malintentionnés, ces derniers seront en mesure d'injecter des
+ en-têtes HTTP arbitraires et peut-être malveillants dans les réponses de
+ votre serveur.
+ </note>
</usage>
</directivesynopsis>
@@ -145,7 +155,9 @@ liens HTML. Lors de l'interprétation
lien correspond à <var>modèle-source</var>, la partie du lien concernée
sera réécrite en <var>modèle-cible</var>, en tenant compte des
modifications induites par les drapeaux éventuellement spécifiés et par
-la directive <directive>ProxyHTMLExtended</directive>.</p>
+la directive <directive module="mod_proxy_html">ProxyHTMLExtended</directive>.
+Ne seront considérés comme des liens HTML que les éléments spécifiés via la
+directive <directive module="mod_proxy_html">ProxyHTMLLinks</directive>.</p>
<p>Le troisième argument optionnel permet de féfinir un des drapeaux
suivants (les drapeaux sont sensibles à la casse) :</p>
@@ -447,18 +459,35 @@ HTML 4 et XHTML 1.</p>
<compatibility>Disponible depuis la version 2.4 du serveur HTTP Apache.
Disponible en tant que module tiers dans les versions 2.x antérieures.</compatibility>
<usage>
-<p>Cette directive permet de spécifier les éléments dont les attributs
-d'URL doivent être réécrits en utilisant les règles standards
-<directive>ProxyHTMLURLMap</directive>. Vous devez définir une directive
-ProxyHTMLLinks pour chaque élément, mais chacune d'entre elles peut
-spécifier un nombre quelconque d'attributs</p>
-<p>Normalement, cette directive est définie globalement. Si vous
-définissez ProxyHTMLLinks à plusieurs niveaux, certains niveaux
-l'emportant sur d'autres, vous devrez spécifier un jeu complet
-de liens pour chaque niveau.</p>
-<p>Le fichier <var>proxy-html.conf</var> fournit une configuration par
-défaut et définit les liens HTML selon les standards
-HTML 4 et XHTML 1.</p>
+<p>Cette directive permet de spécifier les éléments dont les attributs d'URL
+doivent être réécrits en utilisant les règles standards <directive
+module="mod_proxy_html">ProxyHTMLURLMap</directive>. Vous devez définir une
+directive ProxyHTMLLinks pour chaque élément, mais chacune d'entre elles peut
+spécifier un nombre quelconque d'attributs</p> <p>Normalement, cette directive
+est définie globalement. Si vous définissez ProxyHTMLLinks à plusieurs niveaux,
+certains niveaux l'emportant sur d'autres, vous devrez spécifier un jeu complet
+de liens pour chaque niveau.</p> <p>Le fichier <var>proxy-html.conf</var>
+fournit une configuration par défaut et définit les liens HTML selon les
+standards HTML 4 et XHTML 1.</p>
+<example>
+<title>Exemples issus de proxy-html.conf</title>
+<highlight language="config">
+ProxyHTMLLinks a href
+ProxyHTMLLinks area href
+ProxyHTMLLinks link href
+ProxyHTMLLinks img src longdesc usemap
+ProxyHTMLLinks object classid codebase data usemap
+ProxyHTMLLinks q cite
+ProxyHTMLLinks blockquote cite
+ProxyHTMLLinks ins cite
+ProxyHTMLLinks del cite
+ProxyHTMLLinks form action
+ProxyHTMLLinks input src usemap
+ProxyHTMLLinks head profile
+ProxyHTMLLinks base href
+ProxyHTMLLinks script src for
+</highlight>
+</example>
</usage>
</directivesynopsis>
Modified: httpd/httpd/branches/2.4.x-openssl-1.1.0-compat/docs/manual/mod/mod_rewrite.html.en
URL: http://svn.apache.org/viewvc/httpd/httpd/branches/2.4.x-openssl-1.1.0-compat/docs/manual/mod/mod_rewrite.html.en?rev=1769588&r1=1769587&r2=1769588&view=diff
==============================================================================
--- httpd/httpd/branches/2.4.x-openssl-1.1.0-compat/docs/manual/mod/mod_rewrite.html.en (original)
+++ httpd/httpd/branches/2.4.x-openssl-1.1.0-compat/docs/manual/mod/mod_rewrite.html.en Mon Nov 14 10:26:31 2016
@@ -123,7 +123,7 @@ URLs on the fly</td></tr>
<code class="directive"><a href="#rewriterule">RewriteRule</a></code> directives that
substitute a relative path.</p>
<p> This directive is <em>required</em> when you use a relative path
- in a substitution in per-directory (htaccess) context unless either
+ in a substitution in per-directory (htaccess) context unless any
of the following conditions are true:</p>
<ul>
<li> The original request, and the substitution, are underneath the
@@ -163,7 +163,7 @@ AliasMatch "^/myapp" "/opt/myapp-1.2.3"
<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Defines a condition under which rewriting will take place
</td></tr>
<tr><th><a href="directive-dict.html#Syntax">Syntax:</a></th><td><code> RewriteCond
- <em>TestString</em> <em>CondPattern</em></code></td></tr>
+ <em>TestString</em> <em>CondPattern</em> [<em>flags</em>]</code></td></tr>
<tr><th><a href="directive-dict.html#Context">Context:</a></th><td>server config, virtual host, directory, .htaccess</td></tr>
<tr><th><a href="directive-dict.html#Override">Override:</a></th><td>FileInfo</td></tr>
<tr><th><a href="directive-dict.html#Status">Status:</a></th><td>Extension</td></tr>
@@ -686,14 +686,14 @@ RewriteRule ^(.+) /other/archive/$1 [R]<
RewriteRule "^/images" "-" [F]</pre>
</li>
+ </ol>
- <li>You can also set special flags for
- <em>CondPattern</em> by appending
+ <p>You can also set special flags for <em>CondPattern</em> by appending
<strong><code>[</code><em>flags</em><code>]</code></strong>
as the third argument to the <code>RewriteCond</code>
directive, where <em>flags</em> is a comma-separated list of any of the
- following flags:
-
+ following flags:</p>
+
<ul>
<li>'<strong><code>nocase|NC</code></strong>'
(<strong>n</strong>o <strong>c</strong>ase)<br />
@@ -730,8 +730,6 @@ RewriteRule ...some special stuff for an
is well understood.
</li>
</ul>
- </li>
- </ol>
<p><strong>Example:</strong></p>
@@ -1037,35 +1035,40 @@ RewriteRule "^/$" "/hom
<p><a id="patterns" name="patterns"><em>Pattern</em></a> is
a perl compatible <a id="regexp" name="regexp">regular
- expression</a>. On the first RewriteRule, it is matched against
- the (%-decoded) <a href="directive-dict.html#Syntax">URL-path</a>
- of the request, or, in per-directory context (see below), the URL
- path relative to that per-directory context. Subsequent patterns
- are matched against the output of the last matching RewriteRule.</p>
+ expression</a>. What this pattern is compared against varies depending
+ on where the <code class="directive">RewriteRule</code> directive is defined. </p>
<div class="note"><h3><a id="what_is_matched" name="what_is_matched">What is matched?</a></h3>
- <p>In <code class="directive"><a href="../mod/core.html#virtualhost">VirtualHost</a></code> context,
+
+<ul>
+ <li><p>In <code class="directive"><a href="../mod/core.html#virtualhost">VirtualHost</a></code> context,
The <em>Pattern</em> will initially be matched against the part of the
- URL after the hostname and port, and before the query string (e.g. "/app1/index.html").</p>
+ URL after the hostname and port, and before the query string (e.g. "/app1/index.html").
+ This is the (%-decoded) <a href="directive-dict.html#Syntax">URL-path</a>.</p></li>
- <p>In <code class="directive"><a href="../mod/core.html#directory">Directory</a></code> and htaccess context,
- the <em>Pattern</em> will initially be matched against the
- <em>filesystem</em> path, after removing the prefix that led the server
- to the current <code class="directive">RewriteRule</code> (e.g. "app1/index.html"
- or "index.html" depending on where the directives are defined).</p>
+ <li><p>In per-directory context (<code class="directive"><a href="../mod/core.html#directory">Directory</a></code> and .htaccess),
+ the <em>Pattern</em> is matched against only a partial path, for example a request
+ of "/app1/index.html" may result in comparison against "app1/index.html"
+ or "index.html" depending on where the <code class="directive">RewriteRule</code> is
+ defined.</p>
+
+ <p>The directory path where the rule is defined is stripped from the currently mapped
+ filesystem path before comparison (up to and including a trailing slash).
+ The net result of this per-directory prefix stripping is that rules in
+ this context only match against the portion of the currently mapped filesystem path
+ "below" where the rule is defined.</p>
+
+ <p>Directives such as <code class="directive">DocumentRoot</code> and <code class="directive">Alias</code>, or even the
+ result of previous <code class="directive">RewriteRule</code> substitutions, determine
+ the currently mapped filesystem path.
+ </p>
+ </li>
- <p>If you wish to match against the hostname, port, or query string, use a
+ <li><p>If you wish to match against the hostname, port, or query string, use a
<code class="directive"><a href="#rewritecond">RewriteCond</a></code> with the
<code>%{HTTP_HOST}</code>, <code>%{SERVER_PORT}</code>, or
- <code>%{QUERY_STRING}</code> variables respectively.</p>
-
- <p>In any case, remember that regular expressions are substring
- matches. That is, you don't need the regex to describe the entire
- string, just the part that you wish to match. Thus, using a regex
- of <code>.</code> is often sufficient rather than <code>.*</code>,
- and the regex <code>abc</code> is <strong>not</strong> the same as
- <code>^abc$</code>.</p>
-
+ <code>%{QUERY_STRING}</code> variables respectively.</p></li>
+</ul>
</div>
<div class="note"><h3>Per-directory Rewrites</h3>
@@ -1080,13 +1083,7 @@ administrator has disabled override of <
a user's directory, then you cannot use the rewrite engine. This
restriction is required for security reasons.</li>
-<li>When using the rewrite engine in <code>.htaccess</code> files the
-per-directory prefix (that is, the URI path that lead to the directory
-containing this <code>.htaccess</code> file)
-is automatically <em>removed</em> for the RewriteRule pattern matching
-and automatically <em>added</em> after any relative (not starting with a
-slash or protocol name) substitution encounters the end of a rule set.
-See the <code class="directive"><a href="#rewritebase">RewriteBase</a></code>
+<li>See the <code class="directive"><a href="#rewritebase">RewriteBase</a></code>
directive for more information regarding what prefix will be added back to
relative substitutions.</li>
Modified: httpd/httpd/branches/2.4.x-openssl-1.1.0-compat/docs/manual/mod/mod_rewrite.html.fr
URL: http://svn.apache.org/viewvc/httpd/httpd/branches/2.4.x-openssl-1.1.0-compat/docs/manual/mod/mod_rewrite.html.fr?rev=1769588&r1=1769587&r2=1769588&view=diff
==============================================================================
--- httpd/httpd/branches/2.4.x-openssl-1.1.0-compat/docs/manual/mod/mod_rewrite.html.fr (original)
+++ httpd/httpd/branches/2.4.x-openssl-1.1.0-compat/docs/manual/mod/mod_rewrite.html.fr Mon Nov 14 10:26:31 2016
@@ -29,8 +29,6 @@
<p><span>Langues Disponibles: </span><a href="../en/mod/mod_rewrite.html" hreflang="en" rel="alternate" title="English"> en </a> |
<a href="../fr/mod/mod_rewrite.html" title="Fran�ais"> fr </a></p>
</div>
-<div class="outofdate">Cette traduction peut �tre p�rim�e. V�rifiez la version
- anglaise pour les changements r�cents.</div>
<table class="module"><tr><th><a href="module-dict.html#Description">Description:</a></th><td>Ce module fournit un moteur de r��criture � base de
r�gles permettant de r��crire les URLs des requ�tes
� la vol�e</td></tr>
@@ -142,8 +140,9 @@ r�pertoire</td></tr>
r�pertoire (htaccess), sauf si au moins une de ces conditions est
v�rifi�e :</p>
<ul>
- <li>La requ�te initiale, ainsi que la substitution, sont dans
- la <code class="directive"><a href="../mod/core.html#documentroot">DocumentRoot</a></code> (c'est �
+ <li>La requ�te initiale, ainsi que la substitution, se
+ situent par raport � la valeur de la directive
+ <code class="directive"><a href="../mod/core.html#documentroot">DocumentRoot</a></code> (c'est �
dire que pour y acc�der, il n'est pas n�cessaire d'utiliser
une directive telle qu'<code class="directive"><a href="../mod/mod_alias.html#alias">Alias</a></code>).</li>
<li>Le chemin du syst�me de fichiers vers le r�pertoire
@@ -151,8 +150,9 @@ r�pertoire</td></tr>
la substitution relative est aussi valide en tant qu'URL sur
le serveur (ce qui est rare).</li>
<li>A partir de la version 2.4.16 du serveur HTTP Apache,
- cette directive peut �tre omise lorsque la requ�te est
- transform�e via une directive <code class="directive"><a href="../mod/mod_alias.html#alias">Alias</a></code> ou le module
+ cette directive peut �tre omise lorsque la requ�te est mise en
+ correspondance avec le syst�me de fichiers via la directive
+ <code class="directive"><a href="../mod/mod_alias.html#alias">Alias</a></code> ou le module
<code class="module"><a href="../mod/mod_userdir.html">mod_userdir</a></code>.</li>
</ul>
@@ -181,7 +181,7 @@ AliasMatch "^/myapp" "/opt/myapp-1.2.3"
la r��criture soit effectu�e
</td></tr>
<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code> RewriteCond
- <em>cha�ne_de_test</em> <em>expression_de_comparaison</em></code></td></tr>
+ <em>cha�ne_de_test</em> <em>expression_de_comparaison</em> [<em>drapeaux</em>]</code></td></tr>
<tr><th><a href="directive-dict.html#Context">Contexte:</a></th><td>configuration du serveur, serveur virtuel, r�pertoire, .htaccess</td></tr>
<tr><th><a href="directive-dict.html#Override">AllowOverride:</a></th><td>FileInfo</td></tr>
<tr><th><a href="directive-dict.html#Status">Statut:</a></th><td>Extension</td></tr>
@@ -395,13 +395,12 @@ la r��criture soit effectu�e
en-t�te ajout� par le navigateur. Cette
valeur n'a pas �t� d�s�chapp�e (d�cod�e), � la
diff�rence de la plupart des variables suivantes.</dd>
-
</dl>
</li>
</ul>
- <p>Si <em>cha�ne_de_test</em> contient la valeur sp�ciale
+ <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>. Si des en-t�tes HTTP sont
r�f�renc�s dans l'expression rationnelle, et si le drapeau
@@ -519,12 +518,13 @@ la r��criture soit effectu�e
<ol>
<li>Vous pouvez pr�fixer l'expression avec un caract�re
'<code>!</code>' (point d'exclamation) pour inverser le r�sultat
- de la condition, quelle que soit l'<em>expression_de_comparaison</em> utilis�e.</li>
+ de la condition, quelle que soit l'<em>expression de
+ comparaison</em> utilis�e.</li>
<li>Vous pouvez effectuer des comparaisons lexicographiques de
cha�nes :
- <dl>
+ <dl>
<dt><strong><expression</strong></dt>
<dd>inf�rieur au sens lexicographique<br />
Traite l'<em>expression</em> comme une cha�ne de
@@ -553,7 +553,7 @@ la r��criture soit effectu�e
<em>cha�ne_de_test</em> est compar�e � la
cha�ne vide.</dd>
- <dt><strong><=expression_de_comparaison</strong></dt>
+ <dt><strong><=expression de comparaison</strong></dt>
<dd>inf�rieur ou �gal � au sens lexicographique<br />
Consid�re l'<em>expression_de_comparaison</em> comme une
cha�ne de caract�res et la compare au sens lexicographique �
@@ -562,7 +562,7 @@ la r��criture soit effectu�e
�gale � <em>expression_de_comparaison</em> (les deux cha�nes
sont identiques, caract�re pour caract�re).</dd>
- <dt><strong>>=expression_de_comparaison</strong></dt>
+ <dt><strong>>=expression de comparaison</strong></dt>
<dd>sup�rieur ou �gal � au sens lexicographique<br />
Consid�re l'<em>expression_de_comparaison</em> comme une
cha�ne de caract�res et la compare au sens lexicographique �
@@ -570,7 +570,8 @@ la r��criture soit effectu�e
suit lexicographiquement <em>expression_de_comparaison</em>, ou est
�gale � <em>expression_de_comparaison</em> (les deux cha�nes
sont identiques, caract�re pour caract�re).</dd>
- </dl></li>
+ </dl>
+ </li>
<li>
Vous pouvez effectuer des comparaisons d'entiers :
@@ -579,28 +580,31 @@ la r��criture soit effectu�e
<dt><strong>-eq</strong></dt>
<dd>est num�riquement �gal �<br />
La <em>cha�ne_de_test</em> est consid�r�e comme un entier,
- et est compar�e num�riquement � l'<em>expression_de_comparaison</em>. Vrai si les deux expressions sont
+ et est compar�e num�riquement � l'<em>expression de
+ comparaison</em>. Vrai si les deux expressions sont
num�riquement �gales.</dd>
<dt><strong>-ge</strong></dt>
<dd>est num�riquement sup�rieur ou �gal �<br />
La <em>cha�ne_de_test</em> est consid�r�e comme un entier,
- et est compar�e num�riquement � l'<em>expression_de_comparaison</em>. Vrai si <em>cha�ne_de_test</em> est
- num�riquement
- sup�rieure ou �gale �
+ et est compar�e num�riquement � l'<em>expression de
+ comparaison</em>. Vrai si <em>cha�ne_de_test</em> est
+ num�riquement sup�rieure ou �gale �
<em>expression_de_comparaison</em>.</dd>
<dt><strong>-gt</strong></dt>
<dd>est num�riquement sup�rieur �<br />
La <em>cha�ne_de_test</em> est consid�r�e comme un entier,
- et est compar�e num�riquement � l'<em>expression_de_comparaison</em>. Vrai si <em>cha�ne_de_test</em> est
+ et est compar�e num�riquement � l'<em>expression de
+ comparaison</em>. Vrai si <em>cha�ne_de_test</em> est
num�riquement
sup�rieure � <em>expression_de_comparaison</em>.</dd>
<dt><strong>-le</strong></dt>
<dd>est num�riquement inf�rieur ou �gal �<br />
La <em>cha�ne_de_test</em> est consid�r�e comme un entier,
- et est compar�e num�riquement � l'<em>expression_de_comparaison</em>. Vrai si <em>cha�ne_de_test</em> est
+ et est compar�e num�riquement � l'<em>expression de
+ comparaison</em>. Vrai si <em>cha�ne_de_test</em> est
num�riquement
inf�rieure ou �gale � <em>expression_de_comparaison</em>.
Attention � la confusion avec le drapeau <strong>-l</strong>
@@ -610,7 +614,8 @@ la r��criture soit effectu�e
<dt><strong>-lt</strong></dt>
<dd>est num�riquement inf�rieur �<br />
La <em>cha�ne_de_test</em> est consid�r�e comme un entier,
- et est compar�e num�riquement � l'<em>expression_de_comparaison</em>. Vrai si <em>cha�ne_de_test</em> est
+ et est compar�e num�riquement � l'<em>expression de
+ comparaison</em>. Vrai si <em>cha�ne_de_test</em> est
num�riquement
inf�rieure � <em>expression_de_comparaison</em>.
Attention � la confusion avec le drapeau <strong>-l</strong>
@@ -632,7 +637,7 @@ la r��criture soit effectu�e
<dl>
<dt><strong>-d</strong></dt>
- <dd>est un r�pertoire (<strong>d</strong>irectory)<br />
+ <dd>est un <strong>r</strong>�pertoire<br />
Traite <em>cha�ne_de_test</em> comme un chemin et v�rifie
s'il existe ou pas, et s'il s'agit d'un r�pertoire.</dd>
@@ -655,7 +660,7 @@ la r��criture soit effectu�e
Voir <strong>-l</strong>.</dd>
<dt><strong>-l</strong></dt>
- <dd>est un lien symbolique<br />
+ <dd>est un <strong>l</strong>ien symbolique<br />
Consid�re la <em>cha�ne_de_test</em> comme un chemin et
v�rifie son existence et si elle est un lien symbolique. On
peut aussi utiliser la convention bash <strong>-L</strong>
@@ -673,7 +678,8 @@ la r��criture soit effectu�e
d'une taille sup�rieure � z�ro.</dd>
<dt><strong>-U</strong></dt>
- <dd><p>test de l'existence d'une URL via une sous-requ�te<br />
+ <dd><p>test de l'existence d'une
+ URL via une sous-requ�te<br />
V�rifie si <em>cha�ne_de_test</em> est une URL valide,
accessible � travers tous les contr�les d'acc�s du serveur
actuellement configur�s pour ce chemin. C'est une
@@ -706,7 +712,7 @@ RewriteRule ^(.+) /other/archive/$1 [R]<
<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
+ <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>
@@ -720,13 +726,14 @@ RewriteRule ^(.+) /other/archive/$1 [R]<
RewriteRule "^/images" "-" [F]</pre>
</li>
+ </ol>
- <li>Vous pouvez aussi d�finir certains drapeaux pour
+ <p>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>
comme troisi�me argument de la directive
<code>RewriteCond</code>, o� <em>drapeaux</em> est un
- sous-ensemble s�par� par des virgules des drapeaux suivants :
+ sous-ensemble s�par� par des virgules des drapeaux suivants :</p>
<ul>
<li>'<strong><code>nocase|NC</code></strong>'
@@ -767,8 +774,7 @@ RewriteRule ...r�gles concernant tous c
fonctionnement de l'en-t�te Vary.
</li>
</ul>
- </li>
- </ol>
+
<p><strong>Exemple :</strong></p>
@@ -777,17 +783,18 @@ RewriteRule ...r�gles concernant tous c
pouvez utiliser ce qui suit : </p>
<pre class="prettyprint lang-config">RewriteCond "%{HTTP_USER_AGENT}" "(iPhone|Blackberry|Android)"
-RewriteRule "^/$" "/homepage.mobile.html" [L]
+RewriteRule "^/$" "/homepage.mobile.html" [L]
-RewriteRule "^/$" "/homepage.std.html" [L]</pre>
+RewriteRule "^/$" "/homepage.std.html" [L]</pre>
<p>Explications : si vous utilisez un navigateur
- qui s'identifie comme un navigateur de mobile (notez que cet
- exemple est incomplet car il existe de nombreuses autres
- plateformes mobiles), c'est la version mobile de la page
- d'accueil qui sera servie. Dans le cas contraire, vous verrez
- s'afficher la page d'accueil standard.</p>
+ qui s'identifie comme un
+ navigateur de plateforme mobile (notez que l'exemple est
+ incomplet car il existe de nombreuses autres plateformes
+ mobiles), c'est la version pour mobile de la page d'accueil qui
+ sera renvoy�e. Dans le cas contraire, ce sera la page d'accueil
+ standard.</p>
</div>
@@ -847,8 +854,7 @@ recherche de mots-cl�s</td></tr>
La source utilis�e pour cette recherche peut �tre de plusieurs
types.</p>
- <p><a id="mapfunc" name="mapfunc"><em>MapName</em></a>
- est le nom de la table de correspondance
+ <p><a id="mapfunc" name="mapfunc"><em>MapName</em></a> est le nom de la table de correspondance
et servira � sp�cifier une fonction de mise en correspondance
pour les cha�nes de substitution d'une r�gle de r��criture selon
une des constructions suivantes :</p>
@@ -875,7 +881,7 @@ recherche de mots-cl�s</td></tr>
<p>Par exemple, vous pouvez d�finir une directive
<code class="directive">RewriteMap</code> comme suit </p>
- <pre class="prettyprint lang-config">RewriteMap "map-exemple" "txt:/chemin/vers/fichier/map.txt"</pre>
+ <pre class="prettyprint lang-config">RewriteMap map-exemple "txt:/chemin/vers/fichier/map.txt"</pre>
<p>Vous pourrez ensuite utiliser cette table dans une
@@ -885,7 +891,7 @@ recherche de mots-cl�s</td></tr>
<p>Les combinaisons suivantes pour <em>type de correspondance</em>
- et <em>source de la correspondance</em>
+ et <em>MapSource</em>
peuvent �tre utilis�es :</p>
<dl>
@@ -969,8 +975,7 @@ pour le moteur de r��criture</td></tr>
les r�gles sp�cifi�es dans le niveau parent s'appliquent
<strong>avant</strong> les r�gles sp�cifi�es dans le niveau
enfant.<br />
- Disponible depuis la version 2.3.10 du serveur HTTP
- Apache.</p>
+ Disponible depuis la version 2.3.10 du serveur HTTP Apache.</p>
</dd>
<dt><code>InheritDown</code></dt>
@@ -1007,7 +1012,7 @@ pour le moteur de r��criture</td></tr>
Cette option est disponible � partir
de la version 2.4.8 du serveur HTTP Apache.</p>
</dd>
-
+
<dt><code>AllowNoSlash</code></dt>
<dd>
<p>Par d�faut, <code class="module"><a href="../mod/mod_rewrite.html">mod_rewrite</a></code> ignore les URLs qui
@@ -1055,21 +1060,23 @@ pour le moteur de r��criture</td></tr>
de l'URI r��crite, comme indiqu� dans les liens ci-dessus.</p>
</div>
</dd>
+
<dt><code>MergeBase</code></dt>
<dd>
- <p>Avec cette option, la valeur de la directive <code class="directive"><a href="#rewritebase">RewriteBase</a></code> est copi�e depuis le
- r�pertoire o� elle est explicitement d�finie dans tout
- sous-r�pertoire qui ne d�finit pas sa propre directive <code class="directive"><a href="#rewritebase">RewriteBase</a></code>. C'�tait le
- comportement par d�faut de la version 2.4.0 � la version 2.4.3, et
- cette option permet de le r�tablir � partir de la version 2.4.4 du
- serveur HTTP Apache.</p>
+ <p>Avec cette option, la valeur de la directive <code class="directive"><a href="#rewritebase">RewriteBase</a></code> est recopi�e depuis
+ une valeur explicitement d�finie dans tout sous-r�pertoire qui ne
+ d�finit pas sa propre directive <code class="directive"><a href="#rewritebase">RewriteBase</a></code>. Il s'agissait du
+ comportement par d�faut avec les versions 2.4.0 � 2.4.3, et ce
+ drapeau qui permet de retrouver ce comportement est disponible
+ depuis la version 2.4.4 du serveur HTTP Apache.</p>
</dd>
-
+
<dt><code>IgnoreContextInfo</code></dt>
<dd>
- <p>Lors d'une substitution relative dans un contexte de r�pertoire (htaccess),
+ <p>Lors d'une
+ substitution relative dans un contexte de r�pertoire (htaccess),
et si la directive <code class="directive"><a href="#rewritebase">RewriteBase</a></code> n'a pas �t� d�finie,
ce module utilise des informations en provenance d'une extension
d'URL et du contexte du syst�me de fichiers pour transformer la
@@ -1103,45 +1110,44 @@ pour le moteur de r��criture</td></tr>
<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 (%-decoded)
- <a href="./directive-dict.html#Syntax">chemin de l'URL</a> de la
- requ�te, ou, dans un contexte de r�pertoire (voir
- ci-dessous), au chemin de l'URL relativement � ce contexte de
- r�pertoire.
- Les expressions suivantes sont compar�es � la sortie de
- la derni�re r�gle de r��criture qui
- correspondait.</p>
+ compatible perl. Ce avec quoi ce mod�le est compar� d�pend de l'endroit o�
+ la directive <code class="directive">RewriteRule</code> est d�finie.</p>
<div class="note"><h3><a id="what_is_matched" name="what_is_matched">Qu'est-ce qui est compar� ?</a></h3>
- <p>Dans un contexte de serveur virtuel <code class="directive"><a href="../mod/core.html#virtualhost">VirtualHost</a></code>, le <em>mod�le</em> est tout
+<ul>
+ <li><p>Dans un contexte de serveur virtuel <code class="directive"><a href="../mod/core.html#virtualhost">VirtualHost</a></code>, 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>
+ exemple "/app1/index.html"). Il s'agit du <a href="directive-dict.html#Syntax">URL-path</a> d�cod� de sa valeur "%xx".</p></li>
- <p>Dans les contextes de r�pertoire <code class="directive"><a href="../mod/core.html#directory">Directory</a></code> 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 le serveur vers la r�gle <code class="directive">RewriteRule</code> (par
- exemple "app1/index.html" ou
- "index.html" selon l'endroit o� les directives sont d�finies).</p>
+ <li><p>Dans un contexte de r�pertoire (sections <code class="directive"><a href="../mod/core.html#directory">Directory</a></code> et fichiers .htaccess), le
+ <em>Mod�le</em> est compar� avec une partie de chemin ; par exemple une
+ requ�te pour "/app1/index.html" entra�nera une comparaison avec
+ "app1/index.html" ou "index.html" selon l'endroit o� la directive
+ <code class="directive">RewriteRule</code> est d�finie.</p>
+
+ <p>Le chemin o� la r�gle est d�fini est supprim� du chemin correspondant
+ du syst�me de fichiers avant comparaison (jusqu'au slash final compris).
+ En cons�quence de cette suppression, les r�gles d�finies dans
+ ce contexte n'effectuent des comparaisons qu'avec la portion du chemin
+ du syst�me de fichiers "en dessous" de l'endroit o� la r�gle est d�finie.</p>
+
+ <p>Le chemin correspondant actuel du syst�me de fichiers est d�termin� par
+ des directives telles que <code class="directive">DocumentRoot</code> et
+ <code class="directive">Alias</code>, ou m�me le r�sultat de substitutions dans
+ des r�gles <code class="directive">RewriteRule</code> pr�c�dentes.
+ </p>
+ </li>
- <p>Si vous souhaitez faire une comparaison sur le nom
+ <li><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 <code class="directive"><a href="#rewritecond">RewriteCond</a></code>
comportant respectivement les variables
<code>%{HTTP_HOST}</code>, <code>%{SERVER_PORT}</code>, ou
- <code>%{QUERY_STRING}</code>.</p>
-
- <p>Dans tous les cas, il faut garder � l'esprit que les expressions
- rationnelles permettent de rechercher des correspondances de sous-cha�nes.
- En d'autres termes, l'expression rationnelle n'a pas besoin de correspondre �
- l'ensemble de la cha�ne, mais seulement � la partie que vous souhaitez
- voir correspondre. Ainsi, l'utilisation de l'expression <code>.</code> est
- souvent suffisante et pr�f�rable � <code>.*</code>, et l'expression
- <code>abc</code> <strong>n'est pas</strong> identique � l'expression
- <code>^abc$</code>.</p>
+ <code>%{QUERY_STRING}</code>.</p></li>
+</ul>
+
</div>
<div class="note"><h3>R��critures dans un contexte de r�pertoire</h3>
@@ -1159,16 +1165,9 @@ niveau du r�pertoire d'un utilisateur,
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
-<code class="directive"><a href="#rewritebase">RewriteBase</a></code> pour plus de
-d�tails � propos de l'ajout du pr�fixe apr�s les substitutions
-relatives.</li>
+<li>Voir la directive
+<code class="directive"><a href="#rewritebase">RewriteBase</a></code> 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
@@ -1271,7 +1270,7 @@ substitution !
</dl>
- <p>En plus du texte, la cha�ne <em>Substition</em> peut
+ <p>En plus du texte, la cha�ne <em>Substitution</em> peut
comporter :</p>
<ol>
@@ -1293,7 +1292,7 @@ substitution !
<code>$</code><strong>N</strong> (<strong>N</strong>=0..9), qui
seront remplac�s par le contenu du <strong>N</strong>�me groupe
du <em>Mod�le</em> qui correspondait. Les variables du serveur
- sont les m�mes que dans la <em>Cha�ne de test</em> d'une
+ sont les m�mes que dans la <em>Cha�ne_de_test</em> d'une
directive <code class="directive"><a href="#rewritecond">RewriteCond</a></code>. Les
fonctions de comparaison sont issues de la directive <code class="directive"><a href="#rewritemap">RewriteMap</a></code> dans la
section de laquelle elles sont d�crites. Ces trois types de
@@ -1341,19 +1340,20 @@ substitution !
</tr>
<tr>
<td>B</td>
- <td>Echappe les caract�res non-alphanum�riques dans les
- r�f�rences arri�res <em>avant</em> d'appliquer la transformation. <em><a href="../rewrite/flags.html#flag_b">d�tails ...</a></em></td>
+ <td>Echappe les caract�res non-alphanum�riques
+ dans les r�f�rences arri�res <em>avant</em>
+ d'appliquer la transformation. <em><a href="../rewrite/flags.html#flag_b">d�tails ...</a></em></td>
</tr>
<tr class="odd">
<td>backrefnoplus|BNP</td>
- <td>Avec ce drapeau, si les r�f�rences arri�res sont �chapp�es,
+ <td>Avec ce drapeau, si les r�f�rences arri�res sont �chapp�es,
les espaces seront �chapp�s en %20 au lieu de +. Ceci s'av�re
utile lorsqu'une r�f�rence arri�re est utilis�e dans la partie
chemin, et non dans la cha�ne de param�tres de la requ�te ;
- pour plus de d�tails, voir <em><a href="../rewrite/flags.html#flag_bnp">ici.</a></em></td>
+ pour plus de d�tails, voir <em><a href="../rewrite/flags.html#flag_bnp">ici.</a></em></td>
</tr>
-<tr>
- <td>chain|C</td>
+<tr>
+ <td>chain|C</td>
<td>La r�gle est cha�n�e avec la r�gle suivante. Si la r�gle
�choue, la ou les r�gles avec lesquelles elle est est cha�n�e
seront saut�es. <em><a href="../rewrite/flags.html#flag_c">d�tails ...</a></em></td>
Modified: httpd/httpd/branches/2.4.x-openssl-1.1.0-compat/docs/manual/mod/mod_rewrite.xml
URL: http://svn.apache.org/viewvc/httpd/httpd/branches/2.4.x-openssl-1.1.0-compat/docs/manual/mod/mod_rewrite.xml?rev=1769588&r1=1769587&r2=1769588&view=diff
==============================================================================
--- httpd/httpd/branches/2.4.x-openssl-1.1.0-compat/docs/manual/mod/mod_rewrite.xml (original)
+++ httpd/httpd/branches/2.4.x-openssl-1.1.0-compat/docs/manual/mod/mod_rewrite.xml Mon Nov 14 10:26:31 2016
@@ -381,7 +381,7 @@ RewriteRule "^/ex/(.*)" "${examplemap:$1
<directive module="mod_rewrite">RewriteRule</directive> directives that
substitute a relative path.</p>
<p> This directive is <em>required</em> when you use a relative path
- in a substitution in per-directory (htaccess) context unless either
+ in a substitution in per-directory (htaccess) context unless any
of the following conditions are true:</p>
<ul>
<li> The original request, and the substitution, are underneath the
@@ -423,7 +423,7 @@ AliasMatch "^/myapp" "/opt/myapp-1.2.3"
<description>Defines a condition under which rewriting will take place
</description>
<syntax> RewriteCond
- <em>TestString</em> <em>CondPattern</em></syntax>
+ <em>TestString</em> <em>CondPattern</em> [<em>flags</em>]</syntax>
<contextlist><context>server config</context><context>virtual host</context>
<context>directory</context><context>.htaccess</context></contextlist>
<override>FileInfo</override>
@@ -951,14 +951,14 @@ RewriteCond expr "! %{HTTP_REFERER} -str
RewriteRule "^/images" "-" [F]
</highlight>
</li>
+ </ol>
- <li>You can also set special flags for
- <em>CondPattern</em> by appending
+ <p>You can also set special flags for <em>CondPattern</em> by appending
<strong><code>[</code><em>flags</em><code>]</code></strong>
as the third argument to the <code>RewriteCond</code>
directive, where <em>flags</em> is a comma-separated list of any of the
- following flags:
-
+ following flags:</p>
+
<ul>
<li>'<strong><code>nocase|NC</code></strong>'
(<strong>n</strong>o <strong>c</strong>ase)<br />
@@ -996,8 +996,6 @@ RewriteRule ...some special stuff for an
is well understood.
</li>
</ul>
- </li>
- </ol>
<p><strong>Example:</strong></p>
@@ -1040,35 +1038,41 @@ RewriteRule "^/$" "/hom
<p><a id="patterns" name="patterns"><em>Pattern</em></a> is
a perl compatible <a id="regexp" name="regexp">regular
- expression</a>. On the first RewriteRule, it is matched against
- the (%-decoded) <a href="directive-dict.html#Syntax">URL-path</a>
- of the request, or, in per-directory context (see below), the URL
- path relative to that per-directory context. Subsequent patterns
- are matched against the output of the last matching RewriteRule.</p>
+ expression</a>. What this pattern is compared against varies depending
+ on where the <directive>RewriteRule</directive> directive is defined. </p>
<note><title><a id="what_is_matched" name="what_is_matched">What is matched?</a></title>
- <p>In <directive module="core">VirtualHost</directive> context,
+
+<ul>
+ <li><p>In <directive module="core">VirtualHost</directive> context,
The <em>Pattern</em> will initially be matched against the part of the
- URL after the hostname and port, and before the query string (e.g. "/app1/index.html").</p>
+ URL after the hostname and port, and before the query string (e.g. "/app1/index.html").
+ This is the (%-decoded) <a href="directive-dict.html#Syntax">URL-path</a>.</p></li>
- <p>In <directive module="core">Directory</directive> and htaccess context,
- the <em>Pattern</em> will initially be matched against the
- <em>filesystem</em> path, after removing the prefix that led the server
- to the current <directive>RewriteRule</directive> (e.g. "app1/index.html"
- or "index.html" depending on where the directives are defined).</p>
+ <li><p>In per-directory context (<directive module="core">Directory</directive> and .htaccess),
+ the <em>Pattern</em> is matched against only a partial path, for example a request
+ of "/app1/index.html" may result in comparison against "app1/index.html"
+ or "index.html" depending on where the <directive>RewriteRule</directive> is
+ defined.</p>
+
+ <p>The directory path where the rule is defined is stripped from the currently mapped
+ filesystem path before comparison (up to and including a trailing slash).
+ The net result of this per-directory prefix stripping is that rules in
+ this context only match against the portion of the currently mapped filesystem path
+ "below" where the rule is defined.</p>
+
+ <p>Directives such as <directive
+ >DocumentRoot</directive> and <directive>Alias</directive>, or even the
+ result of previous <directive>RewriteRule</directive> substitutions, determine
+ the currently mapped filesystem path.
+ </p>
+ </li>
- <p>If you wish to match against the hostname, port, or query string, use a
+ <li><p>If you wish to match against the hostname, port, or query string, use a
<directive module="mod_rewrite">RewriteCond</directive> with the
<code>%{HTTP_HOST}</code>, <code>%{SERVER_PORT}</code>, or
- <code>%{QUERY_STRING}</code> variables respectively.</p>
-
- <p>In any case, remember that regular expressions are substring
- matches. That is, you don't need the regex to describe the entire
- string, just the part that you wish to match. Thus, using a regex
- of <code>.</code> is often sufficient rather than <code>.*</code>,
- and the regex <code>abc</code> is <strong>not</strong> the same as
- <code>^abc$</code>.</p>
-
+ <code>%{QUERY_STRING}</code> variables respectively.</p></li>
+</ul>
</note>
<note><title>Per-directory Rewrites</title>
@@ -1085,13 +1089,7 @@ administrator has disabled override of <
a user's directory, then you cannot use the rewrite engine. This
restriction is required for security reasons.</li>
-<li>When using the rewrite engine in <code>.htaccess</code> files the
-per-directory prefix (that is, the URI path that lead to the directory
-containing this <code>.htaccess</code> file)
-is automatically <em>removed</em> for the RewriteRule pattern matching
-and automatically <em>added</em> after any relative (not starting with a
-slash or protocol name) substitution encounters the end of a rule set.
-See the <directive module="mod_rewrite">RewriteBase</directive>
+<li>See the <directive module="mod_rewrite">RewriteBase</directive>
directive for more information regarding what prefix will be added back to
relative substitutions.</li>