spawn-fcgi

Spawn-fcgi запуск процессов в FastCGI режиме

spawn-fcgi [ опции ] [ --  [ аргументы fcgi приложения ]]
spawn-fcgi -v
spawn-fcgi -h

spawn-fcgi используется для запуска удаленных и локальных FastCGI процессов.

Почему лучше использовать spawn-fcgi

  • Разделение привилегий без необходимости suid-исполняемого файла или запуска сервера с привилегиями root.
  • Возможность отдельного перезапуска как fastcgi приложения, так и сервера
  • Возможность запуска в изолированном окружении ( chroot ).
  • Ваше FastCGI приложение не зависит от используемого веб сервера что дает возможность, использовать различные веб серверы.

Поддерживаются следующие опции

-f <путь>
Имя файла, запускаемого fastcgi приложения. Использование данной опции не приветствуется, вместо нее рекомендуется указывать fastcgi приложение ( абсолютный путь ) и его параментры после знака --. Параметр fcgiapp ( fcgi приложение ), используется системным вызовом call(), в то время как для запуска,fastcgi приложения, файл которого получен через опцию -f, потребуется /bin/sh, который может быть не доступен в изолированном окружении ( chroot ).

Опция игнорируется, если fastcgi приложение указано после --.

-d <путь>
Сменить текущую директорию, перед запуском приложения.
-a <адрес>
IPv4/IPv6 адреса для привязки. Используется только вместе с опцией -p. По умолчанию, 0.0.0.0 ( IPv4 ).
-p <порт>
TCP порт для привязки; Данная опция не может быть использована вместе с опцией -p.
-s <путь>
Путь до файла Unix-сокета; Не может быть использована вместе с опцией -p.
-C <кол-во дочерних процессов>
Только для PHP. Количество дочерних процессов, устанавливается переменной окружения PHP_FCGI_CHILDREN. По умолчанию, не перезаписывает значение переменной окружения. PHP будет запущен без дочерних процессов, если переменная не установлена, как и с установкой значения 0.
-F <кол-во дочерних процессов>
Количество дочерних процессов для ветвления ( fork ). Данная опция не работает с опцией -n, если вам нужно управлять несколькими ветвлениями на одном сокете, смотрите multiwatch(1).
По умолчанию 1.
-P <путь>
Имя PID файла запущенных процессов ( игнорируется в режиме, no-fork ).
-n
Не выполнять никаких форков ( для daemontools ).
-M <режим>
Сменить режим доступа к файлу Unix сокета. Используется только если установлена опция -s.
-?, -h
Небольшой хелп по основным опциям программы.
-v
Информация о версии.

Следующие опции используются, только при запуске spawn-fcgi с правами root.

-c <директория>
Изолировать ( chroot ) в указанную директорию. Если опция -S не указана, файл unix сокета, будет создан в изолированном окружении.
-S
Создать Unix сокет до помещения программы в изолированное окружение ( chroot ).
-u
User ID для смены.
-g
Group ID для смены. По умолчанию, основная группа пользователя, указанного в опции -u.
-U
Изменить пользователя, владельца файла Unix сокета. По умолчанию на пользователя указанного в опции -u. Работает только с опцией -s.
-G
Изменить группу файла Unix сокета. По умолчанию будет назначена основная группа пользователя, указанного опцией -U. Если -U не указана, будет назначено значение из опции -g.
Работает только с опцией -s.