From: Rich Bowen <rbowen@apache.org>
Date: Sun, 3 May 2026 16:11:04 +0000 (+0000)
Subject: core, mod_rewrite, expr: Clarify that REQUEST_URI server variable differs from CGI... 
X-Git-Url: http://git.ipfire.org/gitweb.cgi?a=commitdiff_plain;h=cdfade825351dcb3363b397075d85fe3eeddc90c;p=thirdparty%2Fapache%2Fhttpd.git

core, mod_rewrite, expr: Clarify that REQUEST_URI server variable differs from CGI env var of same name (Bug 62663)

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

diff --git a/docs/manual/expr.xml b/docs/manual/expr.xml
index 3005ff6e98..0479098542 100644
--- a/docs/manual/expr.xml
+++ b/docs/manual/expr.xml
@@ -238,7 +238,10 @@ DIGIT       ::= &lt;any US-ASCII digit "0".."9"&gt;
     <tr><td><code>REQUEST_SCHEME</code></td>
         <td>The scheme part of the request's URI</td></tr>
     <tr><td><code>REQUEST_URI</code></td>
-        <td>The path part of the request's URI</td></tr>
+        <td>The path part of the request's URI, excluding the query
+            string.  Note that this differs from the CGI environment
+            variable of the same name, which includes the query string.
+            </td></tr>
     <tr><td><code>DOCUMENT_URI</code></td>
         <td>Same as <code>REQUEST_URI</code></td></tr>
     <tr><td><code>REQUEST_FILENAME</code></td>
diff --git a/docs/manual/mod/core.xml b/docs/manual/mod/core.xml
index 52ecc770d0..a61df7359d 100644
--- a/docs/manual/mod/core.xml
+++ b/docs/manual/mod/core.xml
@@ -678,6 +678,13 @@ variables</description>
     which may be different than the original request from the client
     due to internal redirects or subrequests.</dd>
   </dl>
+
+  <note><title>Note</title>
+  <p>The CGI environment variable <code>REQUEST_URI</code> contains the
+      full original URI from the request line, including the query string.
+      This differs from the server variable <code>%{REQUEST_URI}</code>
+      used in <module>mod_rewrite</module> and <a href="../expr.html">
+      ap_expr</a>, which contains only the path component.</p></note>
 </usage>
 </directivesynopsis>
 
diff --git a/docs/manual/mod/mod_rewrite.xml b/docs/manual/mod/mod_rewrite.xml
index e4ce9c1e5b..970e2c27bd 100644
--- a/docs/manual/mod/mod_rewrite.xml
+++ b/docs/manual/mod/mod_rewrite.xml
@@ -670,6 +670,12 @@ AliasMatch "^/myapp" "/opt/myapp-1.2.3"
                   <code>REQUEST_URI</code> 
                   has already been %-decoded, to re-encode it pass it through
                   the "escape" <a href="#mapfunc">mapping-function</a>.
+                  Note that this server variable differs from the CGI
+                  environment variable of the same name: in a CGI context,
+                  <code>REQUEST_URI</code> contains the full original URI
+                  from the request line, including the query string. See
+                  the <directive module="core">CGIVar</directive>
+                  directive for details.
                   </dd>
 
                   <dt><code>THE_REQUEST</code></dt>