Модуль 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>

Также можно принудительно обрабатывать запрос как запрос обратного прокси-сервера, создав подходящий обработчик pass-through. Приведённая ниже конфигурация будет передавать все запросы к 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, существует ряд переменных окружения, которые управляют поставщиком протокола FastCGI:

proxy-fcgi-pathinfo

При настройке через ProxyPass или ProxyPassMatch, mod_proxy_fcgi не устанавливает переменную окружения PATH_INFO. Это позволяет серверу FastCGI на стороне приложения правильно определить SCRIPT_NAME и Script-URI и соответствовать разделу 3.3 RFC 3875. Если вместо этого требуется, чтобы mod_proxy_fcgi генерировал «наиболее вероятное» значение PATH_INFO, задайте эту переменную окружения. Это обходной путь для ошибки в некоторых реализациях FastCGI. Этой переменной можно задать несколько значений, чтобы изменить способ выбора наиболее вероятного значения (только в версии 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