FastCGI

Создание файла .fcgi

Сначала вам нужно создать файл сервера FastCGI. Назовем его yourapplication.fcgi.

#!/usr/bin/python
from flup.server.fcgi import WSGIServer
from yourapplication import make_app

if __name__ == '__main__':
    application = make_app()
    WSGIServer(application).run()

Этого достаточно для работы Apache, однако ngingx и более старые версии lighttpd нуждаются в сокете, который явно передаётся для связи с сервером FastCGI. Для этого вам нужно передать путь к сокету в WSGIServer.

WSGIServer(application, bindAddress='/path/to/fcgi.sock').run()

Путь должен быть абсолютно таким же, как вы определили в конфигурации сервера.

Сохраните файл yourapplication.fcgi в месте, где вы сможете его найти. Логично хранить его в /var/www/yourapplication или чем-то подобном.

Убедитесь, что на этом файле установлен исполняемый бит, чтобы серверы могли его выполнить:

# chmod +x /var/www/yourapplication/yourapplication.fcgi

Настройка lighttpd

Базовая конфигурация FastCGI для lighttpd выглядит так:

fastcgi.server = ("/yourapplication.fcgi" =>
    ((
        "socket" => "/tmp/yourapplication-fcgi.sock",
        "bin-path" => "/var/www/yourapplication/yourapplication.fcgi",
        "check-local" => "disable",
        "max-procs" -> 1
    ))
)

alias.url = (
    "/static/" => "/path/to/your/static"
)

url.rewrite-once = (
    "^(/static.*)$" => "$1",
    "^(/.*)$" => "/yourapplication.fcgi$1"

Не забудьте включить модули FastCGI, alias и rewrite. Эта конфигурация привязывает приложение к /yourapplication.

Дополнительную информацию о FastCGI и Python см. в документации Lighty по адресу FastCGI и Python.

Настройка nginx

Установка приложений FastCGI на nginx немного сложнее, поскольку по умолчанию некоторые параметры FastCGI не передаются должным образом.

Базовая конфигурация FastCGI для nginx выглядит так:

location /yourapplication/ {
    include fastcgi_params;
    if ($uri ~ ^/yourapplication/(.*)?) {
        set $path_url $1;
    }
    fastcgi_param PATH_INFO $path_url;
    fastcgi_param SCRIPT_NAME /yourapplication;
    fastcgi_pass unix:/tmp/yourapplication-fcgi.sock;
}

Эта конфигурация привязывает приложение к /yourapplication. Если вы хотите разместить его в корне URL, это немного проще, так как вам не нужно выяснять, как рассчитать PATH_INFO и SCRIPT_NAME:

location /yourapplication/ {
    include fastcgi_params;
    fastcgi_param PATH_INFO $fastcgi_script_name;
    fastcgi_param SCRIPT_NAME "";
    fastcgi_pass unix:/tmp/yourapplication-fcgi.sock;
}

Поскольку Nginx не загружает приложения FastCGI, вы должны сделать это самостоятельно. Вы можете написать скрипт init.d для этого или запустить его в сессии экрана:

$ screen
$ /var/www/yourapplication/yourapplication.fcgi

Отладка

Развертывание FastCGI часто сложно отлаживать на большинстве веб-серверов. Очень часто в журнале сервера вы увидите что-то вроде «преждевременное завершение заголовков». Для отладки приложения единственное, что действительно может дать вам идеи о причинах сбоя, — это переключение на правильного пользователя и ручная запуск приложения.

Этот пример предполагает, что ваше приложение называется application.fcgi, а пользователь вашего веб-сервера — www-data.

$ su www-data
$ cd /var/www/yourapplication
$ python application.fcgi
Traceback (most recent call last):
  File "yourapplication.fcg", line 4, in <module>
ImportError: No module named yourapplication

В этом случае ошибка, похоже, заключается в том, что «yourapplication» отсутствует в пути Python. Распространённые проблемы:

• использование относительных путей. Не полагайтесь на текущий рабочий каталог
• зависимость кода от переменных среды, которые не установлены веб-сервером.
• использование разных интерпретаторов Python.