You are viewing a plain text version of this content. The canonical link for it is here.
Posted to cvs@httpd.apache.org by co...@apache.org on 2011/01/06 03:12:01 UTC
svn commit: r1055710 - in /httpd/httpd/trunk/docs/manual/mod:
mod_rewrite.html.en mod_rewrite.xml
Author: covener
Date: Thu Jan 6 02:12:01 2011
New Revision: 1055710
URL: http://svn.apache.org/viewvc?rev=1055710&view=rev
Log:
clarify RewriteBase as action for closed PR50546
Modified:
httpd/httpd/trunk/docs/manual/mod/mod_rewrite.html.en
httpd/httpd/trunk/docs/manual/mod/mod_rewrite.xml
Modified: httpd/httpd/trunk/docs/manual/mod/mod_rewrite.html.en
URL: http://svn.apache.org/viewvc/httpd/httpd/trunk/docs/manual/mod/mod_rewrite.html.en?rev=1055710&r1=1055709&r2=1055710&view=diff
==============================================================================
--- httpd/httpd/trunk/docs/manual/mod/mod_rewrite.html.en (original)
+++ httpd/httpd/trunk/docs/manual/mod/mod_rewrite.html.en Thu Jan 6 02:12:01 2011
@@ -113,16 +113,20 @@ URLs on the fly</td></tr>
<tr><th><a href="directive-dict.html#Module">Module:</a></th><td>mod_rewrite</td></tr>
</table>
<p>The <code class="directive">RewriteBase</code> directive explicitly
- sets the base URL-path (not filesystem directory path!) for per-directory rewrites.
+ sets the base URL-path (not filesystem directory path!) for per-directory rewrites
+ that result in the substitution of a relative path.
When you use a <code class="directive"><a href="#rewriterule">RewriteRule</a></code>
in a <code>.htaccess</code> file, <code class="module"><a href="../mod/mod_rewrite.html">mod_rewrite</a></code> strips off
the local directory prefix before processing, then rewrites the rest of
the URL. When the rewrite is completed, <code class="module"><a href="../mod/mod_rewrite.html">mod_rewrite</a></code>
- automatically adds the local directory prefix back on to the path.</p>
+ automatically adds the local directory prefix (or the
+ <code class="directive">RewriteBase</code> when set) back on to the substitution
+ before handing it back to the core of the server as if it were the original
+ URL.</p>
<p>This directive is <em>required</em> for per-directory rewrites whose context
is a directory made available via the <code class="directive"><a href="../mod/mod_alias.html#alias">Alias</a></code>
- directive.</p>
+ directive, when the substitution uses a relative path.</p>
<p>If your URL path does not exist verbatim on the filesystem,
or isn't directly under your <code class="directive"><a href="../mod/core.html#documentroot">DocumentRoot</a></code>,
@@ -896,7 +900,7 @@ later</td></tr>
<div class="note"><h3>Per-directory Rewrites</h3>
<ul>
-<li>The rewrite engine may be used in <a href="../howto/htaccess.html">.htaccess</a> files in <code class="directive"><a href="../mod/core.html#directory"><Directory></a></code> sections, with some additional
+<li>The rewrite engine may be used in <a href="../howto/htaccess.html">.htaccess</a> files and in <code class="directive"><a href="../mod/core.html#directory"><Directory></a></code> sections, with some additional
complexity.</li>
<li>To enable the rewrite engine in this context, you need to set
@@ -920,7 +924,7 @@ relative substutions.</li>
a <code class="directive">RewriteCond</code>.</li>
<li>The removed prefix always ends with a slash, meaning the matching occurs against a string which
-<em>never</em> has a leading slash. Therefore, A <em>Pattern</em> with <code>^/</code> never
+<em>never</em> has a leading slash. Therefore, a <em>Pattern</em> with <code>^/</code> never
matches in per-directory context.</li>
<li>Although rewrite rules are syntactically permitted in <code class="directive"><a href="../mod/core.html#location"><Location></a></code> and <code class="directive"><a href="../mod/core.html#files"><Files></a></code> sections, this
Modified: httpd/httpd/trunk/docs/manual/mod/mod_rewrite.xml
URL: http://svn.apache.org/viewvc/httpd/httpd/trunk/docs/manual/mod/mod_rewrite.xml?rev=1055710&r1=1055709&r2=1055710&view=diff
==============================================================================
--- httpd/httpd/trunk/docs/manual/mod/mod_rewrite.xml (original)
+++ httpd/httpd/trunk/docs/manual/mod/mod_rewrite.xml Thu Jan 6 02:12:01 2011
@@ -279,16 +279,20 @@ Apache HTTP Server 2.0.41 and later</com
<usage>
<p>The <directive>RewriteBase</directive> directive explicitly
- sets the base URL-path (not filesystem directory path!) for per-directory rewrites.
+ sets the base URL-path (not filesystem directory path!) for per-directory rewrites
+ that result in the substitution of a relative path.
When you use a <directive module="mod_rewrite">RewriteRule</directive>
in a <code>.htaccess</code> file, <module>mod_rewrite</module> strips off
the local directory prefix before processing, then rewrites the rest of
the URL. When the rewrite is completed, <module>mod_rewrite</module>
- automatically adds the local directory prefix back on to the path.</p>
+ automatically adds the local directory prefix (or the
+ <directive>RewriteBase</directive> when set) back on to the substitution
+ before handing it back to the core of the server as if it were the original
+ URL.</p>
<p>This directive is <em>required</em> for per-directory rewrites whose context
is a directory made available via the <directive module="mod_alias">Alias</directive>
- directive.</p>
+ directive, when the substitution uses a relative path.</p>
<p>If your URL path does not exist verbatim on the filesystem,
or isn't directly under your <directive module="core">DocumentRoot</directive>,