You are viewing a plain text version of this content. The canonical link for it is here.
Posted to docs@httpd.apache.org by bu...@apache.org on 2011/10/05 23:16:11 UTC

DO NOT REPLY [Bug 51969] New: RewriteBase documentation

https://issues.apache.org/bugzilla/show_bug.cgi?id=51969

             Bug #: 51969
           Summary: RewriteBase documentation
           Product: Apache httpd-2
           Version: 2.3-HEAD
          Platform: All
        OS/Version: Linux
            Status: NEW
          Severity: normal
          Priority: P2
         Component: Documentation
        AssignedTo: docs@httpd.apache.org
        ReportedBy: chealer@gmail.com
    Classification: Unclassified


The description of RewriteBase at
http://httpd.apache.org/docs/current/en/mod/mod_rewrite.html#rewritebase
contains:

The default setting is; RewriteBase physical-directory-path

physical-directory-path is not defined.

BTW, the following sentence is unclear ("When a substitution occurs for a new
URL, this module has to re-inject the URL into the server processing."). If I
understand it correctly, I suppose "a substitution occurs for a new URL" could
be changed to "a URL substitution occurs".
Also, towards the end, the explanation of the example contains: "In the above
example, a request to /xyz/oldstuff.html gets correctly rewritten to the
physical file /abc/def/newstuff.html.". It would clarify to explain what would
have happened without the RewriteBase directive.

-- 
Configure bugmail: https://issues.apache.org/bugzilla/userprefs.cgi?tab=email
------- You are receiving this mail because: -------
You are the assignee for the bug.

---------------------------------------------------------------------
To unsubscribe, e-mail: docs-unsubscribe@httpd.apache.org
For additional commands, e-mail: docs-help@httpd.apache.org

DO NOT REPLY [Bug 51969] RewriteBase documentation

Posted by bu...@apache.org.
https://issues.apache.org/bugzilla/show_bug.cgi?id=51969

--- Comment #4 from Filipus Klutiero <ch...@gmail.com> 2012-04-10 20:59:32 UTC ---
Thank you very much.

I suggest the following to be even clearer:

Change the description to "Sets the base URL for relative rewrites (in
per-directory context)"

Change the second paragraph to:

This directive is required when using a relative path in a substitution in
per-directory (htaccess) context, except in the following cases:

    The original and new URI-s are reached via the main document tree (as
opposed to reached by other means, such as Alias). This requires the affected
directory to be in the DocumentRoot.
    Very rarely, relative rewrite rules should redirect to a URL path formed by
the concatenation - first - of the filesystem path to the directory containing
relative rewrite rules and - second - of the substitution.

However, I'm not sure the second case should be kept. It seems so unlikely that
I can't come up with a plausible example.

-- 
Configure bugmail: https://issues.apache.org/bugzilla/userprefs.cgi?tab=email
------- You are receiving this mail because: -------
You are the assignee for the bug.

---------------------------------------------------------------------
To unsubscribe, e-mail: docs-unsubscribe@httpd.apache.org
For additional commands, e-mail: docs-help@httpd.apache.org

DO NOT REPLY [Bug 51969] RewriteBase documentation

Posted by bu...@apache.org.
https://issues.apache.org/bugzilla/show_bug.cgi?id=51969

--- Comment #1 from Rich Bowen <rb...@apache.org> 2011-10-08 22:41:40 UTC ---
I think that this has been greatly clarified in the trunk docs  - see
http://httpd.apache.org/docs/trunk/en/mod/mod_rewrite.html#rewritebase and let
me know if you disagree.

-- 
Configure bugmail: https://issues.apache.org/bugzilla/userprefs.cgi?tab=email
------- You are receiving this mail because: -------
You are the assignee for the bug.

---------------------------------------------------------------------
To unsubscribe, e-mail: docs-unsubscribe@httpd.apache.org
For additional commands, e-mail: docs-help@httpd.apache.org

DO NOT REPLY [Bug 51969] RewriteBase documentation

Posted by bu...@apache.org.
https://issues.apache.org/bugzilla/show_bug.cgi?id=51969

--- Comment #2 from Filipus Klutiero <ch...@gmail.com> 2011-10-10 05:23:15 UTC ---
I agree, that's much more clear. It would still clarify to explain what would
happen with the example if RewriteBase hadn't been used.

-- 
Configure bugmail: https://issues.apache.org/bugzilla/userprefs.cgi?tab=email
------- You are receiving this mail because: -------
You are the assignee for the bug.

---------------------------------------------------------------------
To unsubscribe, e-mail: docs-unsubscribe@httpd.apache.org
For additional commands, e-mail: docs-help@httpd.apache.org

DO NOT REPLY [Bug 51969] RewriteBase documentation

Posted by bu...@apache.org.
https://issues.apache.org/bugzilla/show_bug.cgi?id=51969

Eric Covener <co...@gmail.com> changed:

           What    |Removed                     |Added
----------------------------------------------------------------------------
             Status|NEW                         |RESOLVED
         Resolution|                            |FIXED

--- Comment #3 from Eric Covener <co...@gmail.com> 2012-04-02 13:32:58 UTC ---
I've reworked and simplified the example and demonstrated one of the results of
not using rewritebase when an outside-the-docroot-alias is followed then a
relative path is rewritten to.

http://svn.apache.org/viewvc?view=revision&revision=1308320

Backported through 2.2.x

-- 
Configure bugmail: https://issues.apache.org/bugzilla/userprefs.cgi?tab=email
------- You are receiving this mail because: -------
You are the assignee for the bug.

---------------------------------------------------------------------
To unsubscribe, e-mail: docs-unsubscribe@httpd.apache.org
For additional commands, e-mail: docs-help@httpd.apache.org