From: Rich Bowen <rbowen@apache.org>
Date: Mon, 4 May 2026 16:19:24 +0000 (+0000)
Subject: mod_rewrite: Document how substitution paths are interpreted in all context/slash... 
X-Git-Url: http://git.ipfire.org/gitweb.cgi?a=commitdiff_plain;h=246bd677ee7f0561ef9380ac2eb98f5190f82519;p=thirdparty%2Fapache%2Fhttpd.git

mod_rewrite: Document how substitution paths are interpreted in all context/slash combinations. PR 70020

git-svn-id: https://svn.apache.org/repos/asf/httpd/httpd/trunk@1933815 13f79535-47bb-0310-9956-ffa450edef68
---

diff --git a/docs/manual/mod/mod_rewrite.xml b/docs/manual/mod/mod_rewrite.xml
index 970e2c27bd..ebb76dde29 100644
--- a/docs/manual/mod/mod_rewrite.xml
+++ b/docs/manual/mod/mod_rewrite.xml
@@ -1281,6 +1281,28 @@ cannot use <code>$N</code> in the substitution string!
 
       </dl>
 
+      <note><title>How path substitutions are interpreted</title>
+      <p>Whether a path substitution is treated as a file-system path
+      or a URL-path depends on the context and whether it begins with
+      a slash:</p>
+      <ul>
+        <li><strong>Starts with <code>/</code>, server/vhost context:</strong>
+        Treated as a file-system path if the first path component exists
+        on disk; otherwise treated as a URL-path.</li>
+        <li><strong>Starts with <code>/</code>, per-directory context:</strong>
+        Always treated as a URL-path. No file-system guessing occurs.</li>
+        <li><strong>Does not start with <code>/</code> (relative),
+        server/vhost context:</strong> Treated as a URL-path relative
+        to the current request URI.</li>
+        <li><strong>Does not start with <code>/</code> (relative),
+        per-directory context:</strong> Treated as a URL-path relative
+        to the directory-path for which the <directive
+        module="core">Directory</directive> or <code>.htaccess</code>
+        applies. See <directive>RewriteBase</directive> for controlling
+        the prefix added to relative substitutions.</li>
+      </ul>
+      </note>
+
       <p>In addition to plain text, the <em>Substitution</em> string can include</p>
 
       <ol>