Apache 模块 mod_proxy_fcgi

示例

请记住，为了使以下示例正常工作，您必须启用 mod_proxy 和 mod_proxy_fcgi。

ProxyPass "/myapp/" "fcgi://localhost:4000/"

mod_proxy_fcgi 默认情况下禁用连接重用，因此在请求完成后，连接将不会由该 httpd 子进程保持打开状态，也不会被重用。如果 FastCGI 应用程序能够处理来自 httpd 的并发连接，您可以选择加入连接重用，如以下示例所示

ProxyPass "/myapp/" "fcgi://localhost:4000/" enablereuse=on

以下示例将请求 URI 作为文件系统路径传递给 PHP-FPM 守护进程运行。请求 URL 会隐式添加到第二个参数中。fcgi:// 后的主机名和端口是 PHP-FPM 监听的位置。连接池/重用已启用。

ProxyPassMatch "^/myapp/.*\.php(/.*)?$" "fcgi://localhost:9000/var/www/" enablereuse=on

以下示例将请求 URI 作为文件系统路径传递给 PHP-FPM 守护进程运行。在这种情况下，PHP-FPM 监听的是一个 Unix 域套接字 (UDS)。需要 2.4.9 或更高版本。使用此语法，fcgi:// 后的主机名和可选端口将被忽略。

ProxyPassMatch "^/(.*\.php(/.*)?)$" "unix:/var/run/php5-fpm.sock|fcgi://localhost/var/www/"

平衡网关需要 mod_proxy_balancer 以及至少一个负载均衡器算法模块，例如 mod_lbmethod_byrequests，以及上面列出的代理模块。 mod_lbmethod_byrequests 是默认值，将在本示例配置中使用。

ProxyPass "/myapp/" "balancer://myappcluster/"
<Proxy "balancer://myappcluster/">
    BalancerMember "fcgi://localhost:4000"
    BalancerMember "fcgi://localhost:4001"
</Proxy>

您还可以通过创建合适的处理程序直通来强制请求作为反向代理请求处理。以下示例配置将使用反向代理将所有对 PHP 脚本的请求传递给指定的 FastCGI 服务器。此功能在 Apache HTTP Server 2.4.10 及更高版本中可用。出于性能原因，您需要定义一个 worker，它代表相同的 fcgi:// 后端。这种形式的好处是它允许在服务器中进行正常的 URI 到文件名的映射，并将本地文件系统结果传递给后端。当 FastCGI 以这种方式配置时，服务器可以计算最准确的 PATH_INFO。

<FilesMatch "\.php$">
    # Note: The only part that varies is /path/to/app.sock
    SetHandler  "proxy:unix:/path/to/app.sock|fcgi://localhost/"
</FilesMatch>

# Define a matching worker.
# The part that is matched to the SetHandler is the part that
# follows the pipe. If you need to distinguish, "localhost; can
# be anything unique.
<Proxy "fcgi://localhost/" enablereuse=on max=10>
</Proxy>

<FilesMatch ...>
    SetHandler  "proxy:fcgi://localhost:9000"
</FilesMatch>

<FilesMatch ...>
    SetHandler  "proxy:balancer://myappcluster/"
</FilesMatch>

环境变量

除了控制 mod_proxy 行为的配置指令外，还有许多 环境变量 控制 FCGI 协议提供程序

proxy-fcgi-pathinfo

通过 ProxyPass 或 ProxyPassMatch 配置时，mod_proxy_fcgi 不会设置 PATH_INFO 环境变量。这允许后端 FCGI 服务器正确确定 SCRIPT_NAME 和 Script-URI 并符合 RFC 3875 第 3.3 节。如果您需要 mod_proxy_fcgi 为 PATH_INFO 生成“最佳猜测”，请设置此 env-var。这是针对某些 FCGI 实现中错误的解决方法。此变量可以设置为多个值，以调整如何选择最佳猜测（仅在 2.4.11 及更高版本中）

first-dot

PATH_INFO 从 URL 中第一个“.”之后的斜杠处分割。

last-dot

PATH_INFO 从 URL 中最后一个“.”之后的斜杠处分割。

full

PATH_INFO 通过尝试将 URL 映射到本地文件系统来计算。

unescape

PATH_INFO 是 URL 的路径组件，未转义/解码。

任何其他值

PATH_INFO 与 URL 的路径组件相同。最初，这是唯一的 proxy-fcgi-pathinfo 选项。