From cvs-return-44020-apmail-httpd-cvs-archive=httpd.apache.org@httpd.apache.org Wed Jul 18 13:16:52 2012 Return-Path: X-Original-To: apmail-httpd-cvs-archive@www.apache.org Delivered-To: apmail-httpd-cvs-archive@www.apache.org Received: from mail.apache.org (hermes.apache.org [140.211.11.3]) by minotaur.apache.org (Postfix) with SMTP id 42ECBDD19 for ; Wed, 18 Jul 2012 13:16:52 +0000 (UTC) Received: (qmail 63880 invoked by uid 500); 18 Jul 2012 13:16:51 -0000 Delivered-To: apmail-httpd-cvs-archive@httpd.apache.org Received: (qmail 63652 invoked by uid 500); 18 Jul 2012 13:16:50 -0000 Mailing-List: contact cvs-help@httpd.apache.org; run by ezmlm Precedence: bulk Reply-To: dev@httpd.apache.org list-help: list-unsubscribe: List-Post: List-Id: Delivered-To: mailing list cvs@httpd.apache.org Received: (qmail 63613 invoked by uid 99); 18 Jul 2012 13:16:48 -0000 Received: from nike.apache.org (HELO nike.apache.org) (192.87.106.230) by apache.org (qpsmtpd/0.29) with ESMTP; Wed, 18 Jul 2012 13:16:48 +0000 X-ASF-Spam-Status: No, hits=-2000.0 required=5.0 tests=ALL_TRUSTED X-Spam-Check-By: apache.org Received: from [140.211.11.4] (HELO eris.apache.org) (140.211.11.4) by apache.org (qpsmtpd/0.29) with ESMTP; Wed, 18 Jul 2012 13:16:45 +0000 Received: from eris.apache.org (localhost [127.0.0.1]) by eris.apache.org (Postfix) with ESMTP id 78BFC23888D2; Wed, 18 Jul 2012 13:16:25 +0000 (UTC) Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit Subject: svn commit: r1362933 - in /httpd/httpd/branches/2.4.x/docs/manual/rewrite: flags.html.en flags.xml Date: Wed, 18 Jul 2012 13:16:25 -0000 To: cvs@httpd.apache.org From: gryzor@apache.org X-Mailer: svnmailer-1.0.8-patched Message-Id: <20120718131625.78BFC23888D2@eris.apache.org> Author: gryzor Date: Wed Jul 18 13:16:24 2012 New Revision: 1362933 URL: http://svn.apache.org/viewvc?rev=1362933&view=rev Log: Adding a note about proxy performance being bad when using rewrite's [P]. Advise the use of ProxyPass* instead Modified: httpd/httpd/branches/2.4.x/docs/manual/rewrite/flags.html.en httpd/httpd/branches/2.4.x/docs/manual/rewrite/flags.xml Modified: httpd/httpd/branches/2.4.x/docs/manual/rewrite/flags.html.en URL: http://svn.apache.org/viewvc/httpd/httpd/branches/2.4.x/docs/manual/rewrite/flags.html.en?rev=1362933&r1=1362932&r2=1362933&view=diff ============================================================================== --- httpd/httpd/branches/2.4.x/docs/manual/rewrite/flags.html.en (original) +++ httpd/httpd/branches/2.4.x/docs/manual/rewrite/flags.html.en Wed Jul 18 13:16:24 2012 @@ -274,7 +274,7 @@ CustomLog logs/access_log combined env=! an example, not as a recommendation.

top
-

END

+

END

Using the [END] flag terminates not only the current round of rewrite processing (like [L]) but also prevents any subsequent rewrite processing from occurring in per-directory (htaccess) context.

@@ -505,6 +505,15 @@ and hostname part of the URL is either f client undue influence.

+
+

Performance warning

+

Using this flag triggers the use of mod_proxy, without handling of persistent connections. This +means the performance of your proxy will be better if you set it up with ProxyPass or +ProxyPassMatch

+

This is because this flag triggers the use of the default worker, which does not handle connection pooling.

+

Avoid using this flag and prefer those directives, whenever you can.

+
+

Note: mod_proxy must be enabled in order to use this flag.

@@ -609,7 +618,7 @@ will be used to generate the URL sent wi Any valid HTTP response status code may be specified, using the syntax [R=305], with a 302 status code being used by default if none is specified. The status code specified need not -necessarily be a redirect (3xx) status code. However, +necessarily be a redirect (3xx) status code. However, if a status code is outside the redirect range (300-399) then the substitution string is dropped entirely, and rewriting is stopped as if the L were used.

@@ -629,11 +638,11 @@ URI in request' warnings.
top

S|skip

-

The [S] flag is used to skip rules that you don't want to run. The -syntax of the skip flag is [S=N], where N signifies -the number of rules to skip. This can be thought of as a goto -statement in your rewrite ruleset. In the following example, we only want -to run the RewriteRule if the +

The [S] flag is used to skip rules that you don't want to run. The +syntax of the skip flag is [S=N], where N signifies +the number of rules to skip. This can be thought of as a goto +statement in your rewrite ruleset. In the following example, we only want +to run the RewriteRule if the requested URI doesn't correspond with an actual file.


Modified: httpd/httpd/branches/2.4.x/docs/manual/rewrite/flags.xml
URL: http://svn.apache.org/viewvc/httpd/httpd/branches/2.4.x/docs/manual/rewrite/flags.xml?rev=1362933&r1=1362932&r2=1362933&view=diff
==============================================================================
--- httpd/httpd/branches/2.4.x/docs/manual/rewrite/flags.xml (original)
+++ httpd/httpd/branches/2.4.x/docs/manual/rewrite/flags.xml Wed Jul 18 13:16:24 2012
@@ -261,7 +261,7 @@ module="mod_setenvif">SetEnvIf
 
 
-
END 
+
END
 
Using the [END] flag terminates not only the current round of rewrite
 processing (like [L]) but also prevents any subsequent rewrite
 processing from occurring in per-directory (htaccess) context.

@@ -489,6 +489,15 @@ and hostname part of the URL is either f
 client undue influence.

 
 
+
+Performance warning
+
Using this flag triggers the use of mod_proxy, without handling of persistent connections. This
+means the performance of your proxy will be better if you set it up with ProxyPass or
+ProxyPassMatch

+
This is because this flag triggers the use of the default worker, which does not handle connection pooling.

+
Avoid using this flag and prefer those directives, whenever you can.

+
+
 
Note: mod_proxy must be enabled in order
 to use this flag.

 
@@ -597,7 +606,7 @@ will be used to generate the URL sent wi
 Any valid HTTP response  status code may be specified,
 using the syntax [R=305], with a 302 status code being used by
 default if none is specified. The status code specified need not
-necessarily be a redirect (3xx) status code. However, 
+necessarily be a redirect (3xx) status code. However,
 if a status code is outside the redirect range (300-399) then the
 substitution string is dropped entirely, and rewriting is stopped as if
 the L were used.

@@ -617,11 +626,11 @@ URI in request' warnings.
 

 
 
S|skip
-
The [S] flag is used to skip rules that you don't want to run. The 
-syntax of the skip flag is [S=N], where N signifies 
-the number of rules to skip. This can be thought of as a goto 
-statement in your rewrite ruleset. In the following example, we only want 
-to run the RewriteRule if the 
+
The [S] flag is used to skip rules that you don't want to run. The
+syntax of the skip flag is [S=N], where N signifies
+the number of rules to skip. This can be thought of as a goto
+statement in your rewrite ruleset. In the following example, we only want
+to run the RewriteRule if the
 requested URI doesn't correspond with an actual file.