]> granicus.if.org Git - apache/commitdiff
Add examples using <If>.
authorRich Bowen <rbowen@apache.org>
Wed, 5 Jan 2011 16:22:39 +0000 (16:22 +0000)
committerRich Bowen <rbowen@apache.org>
Wed, 5 Jan 2011 16:22:39 +0000 (16:22 +0000)
git-svn-id: https://svn.apache.org/repos/asf/httpd/httpd/trunk@1055506 13f79535-47bb-0310-9956-ffa450edef68

docs/manual/rewrite/remapping.html.en
docs/manual/rewrite/remapping.xml

index 67ab7584a2e92baafca7224396df6f6bb54d6253..753810c9694dacf84206e7ee20de37f4f8653445 100644 (file)
@@ -284,11 +284,32 @@ hostname(s).</p>
 &lt;/VirtualHost&gt;
 </pre></div>
 
-<p>However, there are situations where you'll need to use mod_rewrite -
-primarily when you don't have access to the main server configuration
-file, or if you wish to do this dynamically for a larger number of
-hostnames. For these situations, you might use one of the recipes
-below.</p>
+<p>You can alternatively accomplis this using the 
+<code class="directive"><a href="../mod/core.html#if">&lt;If&gt;</a></code>
+directive:</p>
+
+<div class="example"><p><code>
+&lt;If "%{HTTP_HOST} != 'www.example.com'"&gt;<br />
+<span class="indent">
+Redirect / http://www.example.com/
+</span>
+&lt;/If&gt;
+</code></p></div>
+
+<p>Or, for example, to redirect a portion of your site to HTTPS, you
+might do the following:</p>
+
+<div class="example"><p><code>
+&lt;If "%{SERVER_PROTOCOL} != 'HTTPS'"&gt;<br />
+<span class="indent">
+Redirect /admin/ https://www.example.com/admin/
+</span>
+&lt;/If&gt;
+</code></p></div>
+
+<p>If, for whatever reason, you still want to use <code>mod_rewrite</code>
+- if, for example, you need this to work with a larger set of RewriteRules - 
+you might use one of the recipes below.</p>
 
 <p>For sites running on a port other than 80:</p>
 <div class="example"><pre>
index adebef2748df9e4d37a53890c8043af0375625fe..39ee76eea7bfcd671f2f79f858ef1aeb3fa41c3f 100644 (file)
@@ -286,11 +286,32 @@ hostname(s).</p>
 &lt;/VirtualHost&gt;
 </pre></example>
 
-<p>However, there are situations where you'll need to use mod_rewrite -
-primarily when you don't have access to the main server configuration
-file, or if you wish to do this dynamically for a larger number of
-hostnames. For these situations, you might use one of the recipes
-below.</p>
+<p>You can alternatively accomplis this using the 
+<directive module="core" type="section">If</directive>
+directive:</p>
+
+<example>
+&lt;If "%{HTTP_HOST} != 'www.example.com'"&gt;<br />
+<indent>
+Redirect / http://www.example.com/
+</indent>
+&lt;/If&gt;
+</example>
+
+<p>Or, for example, to redirect a portion of your site to HTTPS, you
+might do the following:</p>
+
+<example>
+&lt;If "%{SERVER_PROTOCOL} != 'HTTPS'"&gt;<br />
+<indent>
+Redirect /admin/ https://www.example.com/admin/
+</indent>
+&lt;/If&gt;
+</example>
+
+<p>If, for whatever reason, you still want to use <code>mod_rewrite</code>
+- if, for example, you need this to work with a larger set of RewriteRules - 
+you might use one of the recipes below.</p>
 
 <p>For sites running on a port other than 80:</p>
 <example><pre>