From: Luca Toscano Date: Sat, 11 Feb 2017 16:42:37 +0000 (+0000) Subject: documentation rebuild X-Git-Tag: 2.5.0-alpha~669 X-Git-Url: http://git.ipfire.org/cgi-bin/gitweb.cgi?a=commitdiff_plain;h=c276f41337b872bbbdab1355e45176e6d1e26cb6;p=thirdparty%2Fapache%2Fhttpd.git documentation rebuild git-svn-id: https://svn.apache.org/repos/asf/httpd/httpd/trunk@1782621 13f79535-47bb-0310-9956-ffa450edef68 --- diff --git a/docs/manual/mod/mod_proxy_fcgi.html.en b/docs/manual/mod/mod_proxy_fcgi.html.en index 43bfafe290d..bdf1ead3676 100644 --- a/docs/manual/mod/mod_proxy_fcgi.html.en +++ b/docs/manual/mod/mod_proxy_fcgi.html.en @@ -204,7 +204,7 @@ ProxyPassMatch "^/(.*\.php(/.*)?)$" "unix:/var/run/php5-fpm.sock|fcgi://localhos

This directive allows the type of backend FastCGI application to be specified. Some FastCGI servers, such as PHP-FPM, use historical quirks of environment variables to identify the type of proxy server being used. Set -this direcive to "GENERIC" if your non PHP-FPM application has trouble +this directive to "GENERIC" if your non PHP-FPM application has trouble interpreting environment variables such as SCRIPT_FILENAME or PATH_TRANSLATED as set by the server.

@@ -223,8 +223,8 @@ scenarios.

+ [!]environment-variable-name + [value-expression] @@ -251,29 +251,53 @@ the condition expressions and value expressions.

Parameter syntax:

conditional-expression
-
Specifies an expression that controls whether the environmen variable that +
Specifies an expression that controls whether the environment variable that follows will be modified. For information on the expression syntax, see the examples that follow or the full specification at the ap_expr documentation.
environment-variable-name
Specifies the CGI environment variable to change, - such as PATH_INFO.
+ such as PATH_INFO. If preceded by an exclamation point, the variable + will be unset.
value-expression
-
Specifies the replacement value for the preceding environment variable. Backreferences, such as "$1", -can be included from regular expression captures in conditional-expression
+
Specifies the replacement value for the preceding environment variable. + Backreferences, such as "$1", can be included from regular expression + captures in conditional-expression. If omitted, the variable is + set (or overridden) to an empty string — but see the Note below.
-

-# A basic, unconditional override
-ProxyFCGISetEnvIf "true" PATH_INFO "/example"
-
-# Use an environment variable in the value
-ProxyFCGISetEnvIf "true" PATH_INFO "%{reqenv:SCRIPT_NAME}"
-
-# Use captures in the conditions and backreferences in the replacement
-ProxyFCGISetEnvIf "reqenv('PATH_TRANSLATED') =~ m#(/.*prefix)(\d+)(.*)#" PATH_TRANSLATED "$1$3"
-

+
# A basic, unconditional override
+ProxyFCGISetEnvIf "true" PATH_INFO "/example"
+
+# Use an environment variable in the value
+ProxyFCGISetEnvIf "true" PATH_INFO "%{reqenv:SCRIPT_NAME}"
+
+# Use captures in the conditions and backreferences in the replacement
+ProxyFCGISetEnvIf "reqenv('PATH_TRANSLATED') =~ m|(/.*prefix)(\d+)(.*)|" PATH_TRANSLATED "$1$3"
+
+ +

Note: Unset vs. Empty

+ The following will unset VARIABLE, preventing it from being sent + to the FastCGI server: + + 
ProxyFCGISetEnvIf true !VARIABLE
+ + + Whereas the following will erase any existing value of + VARIABLE (by setting it to the empty string), but the empty + VARIABLE will still be sent to the server: + + 
ProxyFCGISetEnvIf true VARIABLE
+ + + The CGI/1.1 specification + does not + distinguish between a variable with an empty value and a variable that + does not exist. However, many CGI and FastCGI implementations distinguish (or + allow scripts to distinguish) between the two. The choice of which to use is + dependent upon your implementation and your reason for modifying the variable. +
diff --git a/docs/manual/mod/quickreference.html.en b/docs/manual/mod/quickreference.html.en index b176e4ed9ff..c5a9c5a50e8 100644 --- a/docs/manual/mod/quickreference.html.en +++ b/docs/manual/mod/quickreference.html.en @@ -792,8 +792,8 @@ response + [!]environment-variable-name + [value-expression]
Description:Allow variables sent to FastCGI servers to be fixed up
Syntax:ProxyFCGISetEnvIf conditional-expression - environment-variable-name - value-expression
Context:server config, virtual host, directory, .htaccess
Status:Extension
Module:mod_proxy_fcgi
ProxyExpressEnable [on|off]svE
Enable the module functionality.
ProxyFCGIBackendType FPM|GENERIC FPM svdhE
Specify the type of backend FastCGI application
ProxyFCGISetEnvIf conditional-expression - environment-variable-name - value-expressionsvdhE
Allow variables sent to FastCGI servers to be fixed up
svdhE
Allow variables sent to FastCGI servers to be fixed up
ProxyFtpDirCharset character set ISO-8859-1 svdE
Define the character set for proxied FTP listings
ProxyFtpEscapeWildcards [on|off]svdE
Whether wildcards in requested filenames are escaped when sent to the FTP server
ProxyFtpListOnWildcard [on|off]svdE
Whether wildcards in requested filenames trigger a file listing