Конфигурација

Список на глобални php-fpm.conf directives

pid string

Патека до PID датотеката. Стандардна вредност: нема.

error_log string

Патека до датотеката со лого за грешки. Стандардна вредност: #INSTALL_PREFIX#/log/php-fpm.log. Ако е поставено на "syslog", логот се испраќа до syslogd наместо да се запишува во локална датотека.

log_level string

Ниво на лого за грешки. Можни вредности: alert, error, warning, notice, debug. Стандардна вредност: notice.

log_limit int

Ограничување на лого за запишаните редови што овозможува запишување пораки подолги од 1024 знаци без превиткување. Стандардна вредност: 1024. Достапно од PHP 7.3.0.

log_buffering bool

Експериментално запишување без дополнително баферирање. Стандардна вредност: yes. Достапно од PHP 7.3.0.

syslog.facility string

се користи за специфицирање каков тип на програма го запишува пораката. Стандардна вредност: daemon.

syslog.ident string

Додадено пред секоја порака. Ако имате повеќе FPM инстанци што работат на ист сервер, можете да ја промените стандардната вредност што мора да одговара на општите потреби. Стандардна вредност: php-fpm.

emergency_restart_threshold int

Ако овој број на детски процеси заврши со SIGSEGV или SIGBUS во временскиот интервал поставен од emergency_restart_interval, тогаш FPM ќе се рестартира. Вредност од 0 значи 'Исклучено'. Стандардна вредност: 0 (Исклучено).

emergency_restart_interval mixed

Временски интервал што го користи emergency_restart_interval за да одреди кога ќе се иницира грациозно рестартирање. Ова може да биде корисно за да се заобиколат случајни оштетувања во меморијата што се споделува од акцелератор. Достапни единици: s(екунди), m(инути), h(ора), или d(енови). Стандардна единица: секунди. Стандардна вредност: 0 (Исклучено).

process_control_timeout mixed

Временско ограничување за детските процеси да чекаат реакција на сигнали од главниот процес. Достапни единици: s(екунди), m(инути), h(ора), или d(енови) Стандардна единица: секунди. Стандардна вредност: 0.

process.max int

Максималниот број на процеси што FPM ќе ги форкира. Ова е дизајнирано за да се контролира глобалниот број на процеси кога се користи динамичен PM во многу бази. Користете го со претпазливост. Стандардна вредност: 0.

process.priority int

Специфицирајте ја приоритетната вредност nice(2) што треба да се примени на главниот процес (само ако е поставена). Вредноста може да варира од -19 (највисок приоритет) до 20 (најнизок приоритет). Стандардна вредност: не е поставено.

daemonize bool

Испрати FPM во позадина. Постави на 'no' за да го задржите FPM во преден план за дебагирање. Стандардна вредност: yes.

rlimit_files int

Поставете rlimit на отворени дескриптори на датотеки за главниот процес. Стандардна вредност: системски дефинирана вредност.

rlimit_core int

Постави го rlimit описот за отворени фајл дескриптори за главниот процес. Стандардна вредност: системски дефинирана вредност.

events.mechanism string

Постави го rlimit описот за големината на core за главниот процес. Стандардна вредност: 0.

systemd_interval int

Наведи го механизмот за настани што ќе го користи FPM. Достапни се следниве: epoll, kqueue (*BSD), port (Solaris), poll, select. Стандардна вредност: не е поставено (автоматско откривање со преферирање на epoll и kqueue).

Кога FPM е изграден со интеграција на systemd, наведи го интервалот, во секунди, помеѓу известувањата за здравјето до systemd. Постави на 0 за да се оневозможи. Стандардна вредност: 10.

Список на директиви за pool.

listen string

Со FPM можете да управувате со неколку pool-ови на процеси со различни поставки. Ова се поставки што можат да се прилагодат по pool.

listen.backlog int

Адресата на која ќе се прифаќаат FastCGI барањата. Валидни синтакса се: 'ip.add.re.ss:port', 'port', '/path/to/unix/socket'. Оваа опција е задолжителна за секој pool. -1 Постави го backlog-от на listen(2). Вредност од -1 значи максимум на BSD системи. Стандардна вредност: 511 (FreeBSD или OpenBSD) или

listen.allowed_clients string

(Linux и други платформи).

listen.owner string

Список на IPv4 или IPv6 адреси на FastCGI клиенти на кои им е дозволено да се поврзат. Еквивалентно на променливата на околината FCGI_WEB_SERVER_ADDRS во оригиналниот PHP FastCGI (5.2.2+). Има смисла само со tcp слушачки приклучок. Секоја адреса мора да биде одделена со запирка. Ако оваа вредност е оставена празна, врските ќе бидат прифатени од која било IP адреса. Стандардна вредност: не е поставено (прифатени се било кои IP адреси).

listen.group string

Константи за известување за грешки listen.owner.

listen.mode string

Константи за известување за грешки listen.owner.

listen.acl_users string

Постави ги дозволите за unix сокет, ако се користи. Во Linux, дозволите за читање/запишување мора да бидат поставени за да се дозволат врски од веб-сервер. Многу системи базирани на BSD дозволуваат врски без оглед на дозволите. Стандардни вредности: корисникот и групата се поставени како корисникот што работи, режимот е поставен на 0660. listen.owner and listen.group Кога се поддржани POSIX списоци за контрола на пристап, можете да ги поставите со оваа опција. Кога е поставено,

listen.acl_groups string

Константи за известување за грешки listen.acl_usersсе игнорираат. Вредноста е список од имиња на корисници одделени со запирки.

listen.setfib int

. Вредноста е список од имиња на групи одделени со запирки. -1Постави ја поврзаната табела за рутирање (FIB). Само FreeBSD. Стандардна вредност:

user string

. Од PHP 8.2.0.

group string

Unix корисник на FPM процесите. Оваа опција е задолжителна.

pm string

Изберете како менаџерот на процеси ќе го контролира бројот на детски процеси. Можни вредности: static, ondemand, dynamic. Оваа опција е задолжителна.

static - бројот на детски процеси е фиксен (pm.max_children).

ondemand - процесите се создаваат на барање (кога се бараат, за разлика од динамичните, каде што pm.start_servers се стартуваат кога услугата е стартувана.

dynamic - бројот на детски процеси се поставува динамички врз основа на следните директиви: pm.max_children, pm.start_servers, pm.min_spare_servers, pm.max_spare_servers.

pm.max_children int

Бројот на детски процеси што треба да се создадат кога pm е поставен на static и максималниот број на детски процеси што треба да се создадат кога pm е поставен на dynamic. Оваа опција е задолжителна.

Оваа опција ја поставува границата на бројот на истовремени барања што ќе бидат опслужени. Еквивалентно на директивата ApacheMaxClients со mpm_prefork и на PHP_FCGI_CHILDREN променливата на околината во оригиналниот PHP FastCGI.

pm.start_servers int

Бројот на детски процеси создадени при стартување. Се користи само кога pm е поставен на dynamic. Стандардна вредност: (min_spare_servers + max_spare_servers) / 2.

pm.min_spare_servers int

Посакуваниот минимален број на неактивни серверски процеси. Се користи само кога pm е поставен на dynamic. Исто така задолжително во овој случај.

pm.max_spare_servers int

Посакуваниот максимален број на неактивни серверски процеси. Се користи само кога pm е поставен на dynamic. Исто така задолжително во овој случај.

pm.max_spawn_rate int

Бројот на стапки за создавање детски процеси одеднаш. Се користи само кога pm е поставен на dynamic. Стандардна вредност: 32

pm.process_idle_timeout mixed

Бројот на секунди по кои неактивен процес ќе биде убиен. Се користи само кога pm е поставен на ondemand. Достапни единици: s(екунди)(стандардно), m(инути), h(оди), или d(енови). Стандардна вредност: 10s.

pm.max_requests int

Поставете rlimit на отворени дескриптори на датотеки за главниот процес. Стандардна вредност: системски дефинирана вредност. PHP_FCGI_MAX_REQUESTSБројот на барања што секое дете процес треба да ги изврши пред повторно да се појави. Ова може да биде корисно за да се заобиколат протекувањата на меморијата во библиотеки од трети страни. За бесконечно обработување на барањата, наведете '0'. Еквивалентно на

pm.status_listen string

Адресата на која да се прифатат барањата за статус на FastCGI. Ова создава нов невидлив пул што може да обработува барања независно. Ова е корисно ако главниот пул е зафатен со барања што долго се извршуваат бидејќи е сè уште можно да се добие FPM статус страница пред завршување на барањата што долго се извршуваат. Синтаксата е иста како и за listen директива. Стандардна вредност: none.

pm.status_path string

URI за прегледување на FPM статус страница. Оваа вредност мора да започнува со водечка коса црта (/). Ако оваа вредност не е поставена, ниту еден URI нема да биде препознаен како статус страница. Стандардна вредност: none.

ping.path string

URI за пинг за повикување на страницата за мониторинг на FPM. Ако оваа вредност не е поставена, ниту еден URI нема да биде препознаен како страница за пинг. Ова може да се користи за тестирање од надвор дека FPM е жив и реагира. Ве молиме имајте предвид дека вредноста мора да започнува со водечка коса црта (/).

ping.response string

Оваа директива може да се користи за прилагодување на одговорот на барање за пинг. Одговорот е форматиран како text/plain со код за одговор 200. Стандардна вредност: pong.

process.priority int

Наведете ја приоритетната вредност nice(2) што треба да се примени на работниот процес (само ако е поставена). Вредноста може да варира од -19 (највисок приоритет) до 20 (најнизок приоритет). Стандардна вредност: не е поставено.

process.dumpable bool

Поставете го знамето process dumpable (PR_SET_DUMPABLE prctl) дури и ако корисникот или групата на процесот се различни од корисникот на главниот процес. Ова овозможува создавање на core dump на процесот и ptrace на процесот за корисникот на пулот. Стандардна вредност: no. Од PHP 7.0.29, 7.1.17 и 7.2.5.

prefix string

Наведете префикс за евалуација на патеката

request_terminate_timeout mixed

Времето на чекање за сервисирање на едно барање по кое работниот процес ќе биде убиен. Оваа опција треба да се користи кога опцијата 'max_execution_time' во ini не го запира извршувањето на скриптата од некоја причина. Вредност од '0' значи 'Off'. Достапни единици: s(екунди)(стандардно), m(инути), h(ора), или d(енови). Стандардна вредност: 0.

request_terminate_timeout_track_finished bool

Времето на чекање поставено од request_terminate_timeout не се ангажира по fastcgi_finish_request или кога апликацијата завршила и се повикуваат внатрешни функции за исклучување. Оваа директива ќе овозможи ограничување на времето на чекање да се применува безусловно дури и во такви случаи. Стандардна вредност: no. Од PHP 7.3.0.

request_slowlog_timeout mixed

Времето на чекање за сервисирање на едно барање по кое ќе се исфрли PHP backtrace во датотеката 'slowlog'. Вредност од '0' значи 'Off'. Достапни единици: s(екунди)(стандардно), m(инути), h(ора), или d(енови). Стандардна вредност: 0.

request_slowlog_trace_depth int

Длабочината на стекот на бавниот лог. Стандардна вредност: 20. Од PHP 7.2.0.

slowlog string

Датотеката за лог за бавни барања. Стандардна вредност: #INSTALL_PREFIX#/log/php-fpm.log.slow.

rlimit_files int

Поставете rlimit на отворени дескриптори на датотеки за процесите деца во овој пул. Стандардна вредност: системски дефинирана вредност.

rlimit_core int

Поставете rlimit за максимална големина на јадрото за процесите деца во овој пул. Можни вредности: 'unlimited' или цел број поголем или еднаков на 0. Стандардна вредност: системски дефинирана вредност.

chroot string

Chroot во оваа директорија на почетокот. Оваа вредност мора да биде дефинирана како апсолутна патека. Кога оваа вредност не е поставена, chroot не се користи.

chdir string

Chdir во оваа директорија на почетокот. Оваа вредност мора да биде апсолутна патека. Стандардна вредност: тековна директорија или / кога chroot.

catch_workers_output bool

Пренасочете stdout и stderr на работникот во главниот лог за грешки. Ако не е поставено, stdout и stderr ќе бидат пренасочени во /dev/null според FastCGI спецификациите. Стандардна вредност: не.

decorate_workers_output bool

Овозможете украсување на излезот за излезот на работниците кога catch_workers_output е овозможено. Стандардна вредност: да. Достапно од PHP 7.3.0.

clear_env bool

Исчистете ја околината во FPM работниците. Спречува произволни променливи на околината да стигнат до FPM работните процеси со чистење на околината во работниците пред да се додадат променливите на околината наведени во оваа конфигурација на пул. Стандардна вредност: Да.

security.limit_extensions string

Ги ограничува екстензиите на главниот скрипт што FPM ќе дозволи да ги парсира. Ова може да спречи грешки во конфигурацијата на страната на веб-серверот. Треба само да го ограничите FPM на .php екстензии за да спречите злонамерни корисници да користат други екстензии за извршување php код. Стандардна вредност: .php .phar

apparmor_hat string

Ако AppArmor е овозможен, тој овозможува промена на капа. Стандардна вредност: не е поставено

access.log string

Датотека за лог за пристап. Стандардна вредност: не е поставено

access.format string

Формат на лог за пристап. Стандардна вредност: "%R - %u %t \"%m %r\" %s":

Валидни опции

Заменски знак	= NULL
%%	На % character
%C	%CPU искористено од барањето. Може да прифати следниве формати: %{user}C само за кориснички CPU, %{system}C само за системски CPU, %{total}C за кориснички + системски CPU (стандардно)
%d	Време потребно за сервисирање на барањето. Може да прифати следниве формати за прецизност: %{seconds}d (стандардно), %{milliseconds}d, %{microseconds}d
%{name}e	Бројот на барања што секое дете процес треба да ги изврши пред повторно да се појави. Ова може да биде корисно за заобиколување на протекување на меморија во библиотеки од трети страни. За бесконечно обработување на барања, наведете '0'. Еквивалентно на $_ENV or $_SERVERПроменлива на опкружувањето (исто како %{REQUEST_METHOD}e or %{SERVER_PROTOCOL}e). Името на променливата мора да биде наведено во загради за да се специфицира името на променливата на опкружувањето. На пример, специфични за серверот како %{HTTP_HOST}e or %{HTTP_USER_AGENT}e
%f	, HTTP заглавија како
%l	Content-Length Име на скрипта
%m	на барањето (само за HTTP POST барање)
%M	HTTP метод на барање %{bytes}M (стандардно), %{kilobytes}M %{kilo}M, %{megabytes}M, %{mega}M
%n	Врв на меморијата распределена од PHP. Може да прифати го следново формат:
%{name}o	Име на пул %{Content-Type}o, %{X-Powered-By}o, %{Transfer-Encoding}o
%p	Излезна заглавие. Името на заглавието мора да биде наведено во загради. На пример:
%P	PID на детето што го сервисираше барањето
%q	PID на родителот на детето што го сервисираше барањето
%Q	На '?' Низа за прашање %q and %rкарактер, или лепило помеѓу
%r	, ако постои низа за прашање %q and %Q
%R	URI на барањето без низата за прашање, видете
%s	IP адреса на далечинскиот управувач
%t	Статус (код на одговор) strftime(3) Време на серверот кога е примено барањето. Може да прифати а %d/%b/%Y:%H:%M:%S %z формат: strftime(3) форматот мора да биде затворен во %{<strftime_format>}t таг, на пр. за временска низа форматирана во ISO8601, користете: %{%Y-%m-%dT%H:%M:%S%z}t
%T	Време кога е запишано логот (кога барањето завршило). Може да прифати strftime(3) Време на серверот кога е примено барањето. Може да прифати а %d/%b/%Y:%H:%M:%S %z (стандардно). На strftime(3) форматот мора да биде затворен во %{<strftime_format>}T таг, на пр. за временска низа форматирана во ISO8601, користете: %{%Y-%m-%dT%H:%M:%S%z}T
%u	Корисник за автентикација со основни акредитиви, ако е специфициран во Authorization header

access.suppress_path array

Список на вредности request_uri кои треба да се филтрираат од логот за пристап. Стандардна вредност: не е поставено. Од PHP 8.2.0.

Можно е да се проследат дополнителни променливи на околината и да се ажурираат PHP поставките на одреден пул. За да го направите ова, треба да ги додадете следните опции во конфигурациската датотека на пулот.

env[HOSTNAME] = $HOSTNAME
env[PATH] = /usr/local/bin:/usr/bin:/bin
env[TMP] = /tmp
env[TMPDIR] = /tmp
env[TEMP] = /tmp

php_admin_value[sendmail_path] = /usr/sbin/sendmail -t -i -f [email protected]
php_flag[display_errors] = off
php_admin_value[error_log] = /var/log/fpm-php.www.log
php_admin_flag[log_errors] = on
php_admin_value[memory_limit] = 32M

Поставките дефинирани со php_admin_value and php_admin_flag не можат да бидат презапишани со ini_set().

PHP поставките може да се постават во конфигурацијата на веб-серверот.

set $php_value "pcre.backtrack_limit=424242";
set $php_value "$php_value \n pcre.recursion_limit=99999";
fastcgi_param  PHP_VALUE $php_value;

fastcgi_param  PHP_ADMIN_VALUE "open_basedir=/var/www/htdocs";

Забелешка: Пулс не се механизам за безбедност, бидејќи не обезбедуваат целосна одвојување; на пр. сите пулови би користеле една OPcache инстанца.