From: Rich Bowen <rbowen@apache.org>
Date: Fri, 22 May 2026 01:49:54 +0000 (+0000)
Subject: Clarifies what CGIVar does.
X-Git-Url: http://git.ipfire.org/gitweb.cgi?a=commitdiff_plain;h=73565fac0a76e1952a4687d4d184f26b5213192e;p=thirdparty%2Fapache%2Fhttpd.git

Clarifies what CGIVar does.


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

diff --git a/docs/manual/mod/core.xml b/docs/manual/mod/core.xml
index 6faec1dfbf..307620e709 100644
--- a/docs/manual/mod/core.xml
+++ b/docs/manual/mod/core.xml
@@ -679,26 +679,43 @@ variables</description>
 <compatibility>Available in Apache HTTP Server 2.4.21 and later</compatibility>
 
 <usage>
-  <p>This directive controls how some CGI variables are set.</p>
-
-  <p><strong>REQUEST_URI</strong> rules:</p>
+  <p>This directive controls how certain CGI environment variables are
+  set when requests are passed to CGI scripts or other handlers that
+  receive a CGI environment. Currently, the only variable supported is
+  <code>REQUEST_URI</code>.</p>
+
+  <p>By default, the CGI environment variable <code>REQUEST_URI</code>
+  is set to the original URI from the client's request line. This means
+  that even if <module>mod_rewrite</module> or an internal redirect
+  changes which resource is actually being served, the CGI script still
+  sees the original URI that the client sent.</p>
+
+  <p>With <code>CGIVar REQUEST_URI current-uri</code>, the value is
+  instead set to the current URI after any rewrites or internal
+  redirects have been applied.</p>
+
+  <p><strong>Allowed values:</strong></p>
   <dl>
     <dt><code>original-uri</code> (default)</dt>
-    <dd>The value is taken from the original request line, and will not
-    reflect internal redirects or subrequests which change the requested
-    resource.</dd>
+    <dd>Set <code>REQUEST_URI</code> to the URI from the original client
+    request, regardless of any internal redirects or rewrites.</dd>
     <dt><code>current-uri</code></dt>
-    <dd>The value reflects the resource currently being processed,
-    which may be different than the original request from the client
-    due to internal redirects or subrequests.</dd>
+    <dd>Set <code>REQUEST_URI</code> to the URI of the resource
+    currently being processed, which may differ from the original
+    request due to internal redirects or rewrites.</dd>
   </dl>
 
+  <highlight language="config">
+# Show CGI scripts the rewritten URI rather than the original
+CGIVar REQUEST_URI current-uri
+  </highlight>
+
   <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>
+  <p>The CGI environment variable <code>REQUEST_URI</code> (in either
+  mode) contains the full URI 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 (no query string).</p></note>
 </usage>
 </directivesynopsis>