diff options
| author | Eric Covener <covener@apache.org> | 2017-01-11 21:58:33 +0100 |
|---|---|---|
| committer | Eric Covener <covener@apache.org> | 2017-01-11 21:58:33 +0100 |
| commit | 728cb09d13b44451594803a9619619a12fc3c2ca (patch) | |
| tree | 0e267ad147ba1c5f120aa0a356b30af387aade70 /docs/manual | |
| parent | name changes re: suggestion (diff) | |
| download | apache2-728cb09d13b44451594803a9619619a12fc3c2ca.tar.xz apache2-728cb09d13b44451594803a9619619a12fc3c2ca.zip | |
PR60576: php-fpm broken w/ per-dir rewrites
Attempt to dig out of well-meaning fixes for generic fcgi backends
that negatively affected some FPM configs.
Adds ProxyFCGIBackendType
git-svn-id: https://svn.apache.org/repos/asf/httpd/httpd/trunk@1778350 13f79535-47bb-0310-9956-ffa450edef68
Diffstat (limited to 'docs/manual')
| -rw-r--r-- | docs/manual/mod/mod_proxy_fcgi.xml | 29 |
1 files changed, 29 insertions, 0 deletions
diff --git a/docs/manual/mod/mod_proxy_fcgi.xml b/docs/manual/mod/mod_proxy_fcgi.xml index 30cfb7b306..9cdeddfa8d 100644 --- a/docs/manual/mod/mod_proxy_fcgi.xml +++ b/docs/manual/mod/mod_proxy_fcgi.xml @@ -195,4 +195,33 @@ ProxyPass "/myapp/" "balancer://myappcluster/" </dl> </section> +<directivesynopsis> +<name>ProxyFCGIBackendType</name> +<description>Specify the type of backend FastCGI application</description> +<syntax>ProxyFCGIBackendType FPM|GENERIC</syntax> +<default>ProxyFCGIBackendType FPM</default> +<contextlist><context>server config</context> +<context>virtual host</context><context>directory</context> +<context>.htaccess</context></contextlist> +<compatibility>Available in version 2.5 and later</compatibility> + +<usage> +<p>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 +interpreting environment variables such as SCRIPT_FILENAME or PATH_TRANSLATED +as set by the server.</p> + +<p>One example of values that change based on the setting of this directive is +SCRIPT_FILENAME. When using <module>mod_proxy_fcgi</module> historically, +SCRIPT_FILENAME was prefixed with the string "proxy:fcgi://". This variable is +what some generic FastCGI applications would read as their script input, but +PHP-FPM would strip the prefix then remember it was talking to Apache. In +2.4.21 through 2.4.25, this prefix was automatically stripped by the server, +breaking the ability of PHP-FPM to detect and interoperate with Apache in some +scenarios.</p> +</usage> +</directivesynopsis> + </modulesynopsis> |