Модуль Apache mod_proxy_fcgi

Резюме

Этот модуль требует службы mod_proxy. Он обеспечивает поддержку протокола FastCGI.

Таким образом, для получения возможности обработки протокола FastCGI, mod_proxy и mod_proxy_fcgi должны присутствовать в сервере.

В отличие от mod_fcgid и mod_fastcgi, mod_proxy_fcgi не предусматривает запуска процесса приложения; fcgistarter (на некоторых платформах) предназначен для этой цели. В качестве альтернативы, внешний запуск или управление процессами могут быть доступны в используемой инфраструктуре приложения FastCGI.

Примеры

Помните, для работы следующих примеров необходимо активировать 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 и более поздних версиях. По соображениям производительности вы захотите определить рабочий процесс, представляющий тот же бэкенд 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, установите эту переменную среды. Это обходной путь для ошибки в некоторых реализациях 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.

ProxyFCGIBackendType FPM|GENERIC

ProxyFCGIBackendType FPM

ProxyFCGISetEnvIf conditional-expression [!]environment-variable-name [value-expression]

# 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"

ProxyFCGISetEnvIf true !VARIABLE

ProxyFCGISetEnvIf true VARIABLE