Avec FPM vous pouvez exécuter plusieurs pools de processus avec des paramètres différents.
Voici les paramètres qui peuvent être ajustés par pool.
-
listen
chaîne de caractères
-
L'adresse pour accepter des requêtes FastCGI. Syntaxes valides :
'ip.add.re.ss:port', 'port', '/path/to/unix/socket'.
Cette option est obligatoire pour chaque pool.
-
listen.backlog
entier
-
Affecte listen(2) backlog.
Une valeur de -1
signifie le maximum sur les systèmes BSD.
Valeur par défaut : -1
(FreeBSD ou OpenBSD)
ou 511
(Linux et autres plateformes).
-
listen.allowed_clients
chaîne de caractères
-
Liste des adresses IPv4 ou IPv6 des clients FastCGI autorisés à se connecter.
C'est équivalent à la variable d'environnement FCGI_WEB_SERVER_ADDRS dans le
système FastCGI original de PHP (5.2.2+). N'a de sens qu'avec un socket tcp en
écoute. Chaque adresse doit être séparée par une virgule. Si cette valeur n'est
pas précisée, les connexions seront acceptées depuis toute adresse ip.
Valeur par défaut: non définie (toute adresse IP acceptée).
-
listen.owner
chaîne de caractères
-
Affecte les permissions pour le socket Unix si utilisé. Sous Linux, les permissions read/write
doivent être affectées pour autoriser des connexions depuis un serveur web. Beaucoup de systèmes
dérivés BSD autorisent les connexions quelles que soient les permissions.
Valeurs par défaut : user et group sont ceux de l'utilisateur courant, le mode est 0660.
-
listen.group
chaîne de caractères
-
Voyez listen.owner
.
-
listen.mode
chaîne de caractères
-
Voyez listen.owner
.
-
listen.acl_users
chaîne de caractères
-
Quand les listes de contrôle d'accès POSIX sont supportées, vous pouvez les définir en utilisant cette option.
Quand défini, listen.owner
et listen.group
sont ignorés.
La valeur est une liste de noms d'utilisateurs séparés par des virgules.
-
listen.acl_groups
chaîne de caractères
-
Voir listen.acl_users
.
La valeur est une liste de noms de groupes séparés par des virgules.
-
user
chaîne de caractères
-
Utilisateur Unix des processus FPM. Cette option est obligatoire.
-
group
chaîne de caractères
-
Groupe Unix des processus FPM. Si non précisé, le groupe de l'utilisateur est
utilisé.
-
pm
chaîne de caractères
-
Choisi comment le gestionnaire de processus va contrôler le nombre de processus fils.
Valeurs possibles : static
, ondemand
,
dynamic
. Option obligatoire.
static
- nombre de processus fils fixés (pm.max_children
).
ondemand
- le processus se réactive à la demande
(lorsque demandé, c'est l'opposé de dynamique où pm.start_servers
sont démarrés lorsque le service démarre).
dynamic
- nombre de processus fils dynamiques basé sur les directives suivantes:
pm.max_children
, pm.start_servers
,
pm.min_spare_servers
, pm.max_spare_servers
.
-
pm.max_children
entier
-
Nombre de processus fils à créer lorsque pm
est réglé sur
static
. Nombre maximum de processus fils à créer lorsque
pm
est réglé sur dynamic
. Option obligatoire.
Cette option affecte la limite du nombre de requêtes simultanées qui seront servies. Equivalent à
ApacheMaxClients avec mpm_prefork et à PHP_FCGI_CHILDREN dans l'implémentation originale
de FastCGI de PHP.
-
pm.start_servers
entier
-
Nombre de processus fils à créer au démarrage. Utilisé seulement si
pm
est réglé sur dynamic
.
Valeur par défaut : min_spare_servers + (max_spare_servers -
min_spare_servers) / 2.
-
pm.min_spare_servers
entier
-
Nombre minimum de processus au repos (idle) voulus. Utilisé seulement si
pm
est réglé sur dynamic
. Obligatoire dans
ce cas.
-
pm.max_spare_servers
entier
-
Nombre maximum de processus au repos (idle) voulus. Utilisé seulement si
pm
est réglé sur dynamic
. Obligatoire dans
ce cas.
-
pm.max_spawn_rate
int
-
Nombre maximum de taux de génération de processus enfants simultanés. Utilisé seulement si
pm
est défini à dynamic
.
-
pm.process_idle_timeout
mixed
-
Nombre de secondes après lesquelles un processus d'inactif sera tué.
Utilisé uniquelent quand pm
est défini à
ondemand
.
Unité disponible : s (secondes)(par défaut), m (minutes), h (heure), ou d (jourd).
Valeur par défaut : 10s.
-
pm.max_requests
entier
-
Nombre de requête que chaque processus fils devrait exécuter avant de renaitre.
Ceci peut être utile pour contourner des fuites mémoires dans des librairies tierces.
Pour un traitement sans fin des requêtes, précisez '0'. Equivalent à
PHP_FCGI_MAX_REQUESTS. Par défaut : 0.
-
pm.status_listen
string
-
L'adresse sur laquelle accepter la demande de statut FastCGI. Cela crée un nouveau pool invisible
qui peut traiter les requêtes indépendamment. Ceci est utile si le pool principal est occupé par des
requêtes de longue durée car il est toujours possible d'obtenir le statut
FPM status page tant qu'elles ne sont pas terminées.
La syntaxe est la même que pour la directive listen.
Valeur par défaut : none.
-
pm.status_path
chaîne de caractères
-
L'URI vers la page de statut de FPM.
Cette valeur doit commencer par une barre oblique (/). Si cette valeur n'est pas définie,
aucun URI ne sera reconnu en tant qu'une page d'état. Valeur par défaut : none.
-
ping.path
chaîne de caractères
-
L'URI de ping pour appeler la page de monitoring de FPM. Si aucune valeur n'est précisée,
aucune page de ping ne sera disponible. Ceci pourrait être utilisé pour tester depuis l'extérieur
si FPM est toujours disponible et prêt à répondre. Notez que la valeur doit commencer par un
slash (/).
-
ping.response
chaîne de caractères
-
Cette directive est utile pour personnaliser la réponse à une requête de ping.
La réponse est formatée comme text/plain avec un code de réponse de 200.
Valeur par défaut : pong.
-
process.priority
entier
-
Spécifiez la priorité nice(2) à appliquer au processus de travail
(uniquement s'il est défini). La valeur peut varier de -19 (priorité
la plus élevée) à 20 (priorité la plus basse). Valeur par
défaut: non définie.
-
process.dumpable
booléen
-
Défini l'indicateur de processus dumpable (PR_SET_DUMPABLE prctl) même
si l'utilisateur ou le groupe de processus est différent de
l'utilisateur du processus maître. Il permet de créer un core dump du
processus et ptrace le processus pour l'utilisateur de pool. Valeur par
défaut : no. Depuis PHP 7.0.29, 7.1.17 et 7.2.5.
-
prefix
chaîne de caractères
-
Spécifier le préfixe pour l'évaluation du chemin
-
request_terminate_timeout_track_finished
bool
-
Le timeout défini par
request_terminate_timeout n'est pas engagé
après un fastcgi_finish_request ou
lorsque l'application s'est terminée et que les fonctions internes d'arrêt sont appelées. Cette directive
permet d'appliquer la limite de temps sans condition.
Valeur par défaut : no. À partir de PHP 7.3.0.
-
request_terminate_timeout
mixed
-
Le timeout pour servir une requête après lequel le processus concerné sera
tué. Cette option devrait être utilisée lorsque l'option 'max_execution_time'
n'arrête pas l'exécution du script pour une raison quelconque.
Une valeur de '0' signifie
'Off'. Unités disponibles : s(econdes)(défaut), m(inutes), h(eures), ou d(ays).
Par défaut : 0.
-
request_slowlog_timeout
mixed
-
Le timeout pour servir une requête dans laquelle la backtrace PHP sera vidée
dans le fichier 'slowlog'. Une valeur de '0' signifie 'Off'.
Unités disponibles : s(econdes)(défaut), m(inutes), h(eures), ou d(ays).
Par défaut : 0.
-
request_slowlog_trace_depth
int
-
Le niveau de profondeur de la trace de la pile de log slowlog.
Valeur par défaut : 20. À partir de PHP 7.2.0.
-
slowlog
chaîne de caractères
-
Le journal pour les requêtes lentes, par défaut:
#INSTALL_PREFIX#/log/php-fpm.log.slow
.
-
rlimit_files
entier
-
Affecte la rlimit pour les descripteurs de fichiers ouverts des processus
enfants de ce pool. Valeur par défaut : valeur du système.
-
rlimit_core
entier
-
Affecte la taille maximale de rlimit des processus enfants de ce pool.
Valeurs possibles : 'unlimited' ou un entier plus grand ou égal à 0.
Valeur par défaut : valeur définie par le système.
-
chroot
chaîne de caractères
-
Chroot vers ce dossier au démarrage. Cette valeur doit être un chemin absolu.
Si cette valeur n'est pas définie, chroot n'est pas utilisé.
-
chdir
chaîne de caractères
-
Chdir vers ce dossier au démarrage. Cette valeur doit être un chemin absolu.
Valeur par défaut : dossier courant ou / si chroot.
-
catch_workers_output
booléen
-
Redirige stdout et stderr vers le journal d'erreur principal. Si non précisé,
stdout et stderr seront redirigés vers /dev/null selon les specifications FastCGI.
Valeur par défaut: no.
-
decorate_workers_output
booléen
-
Active la décoration de sortie pour les travailleurs de sortie quand
catch_workers_output est activé.
Valeur par défaut : yes.
Disponible à partir de PHP 7.3.0.
-
clear_env
booléen
-
Nettoie l’environnent des agents FPM.
Prévient que des variables d’environnement arbitraire puissent
atteindre les processus FPM par le nettoyage de l'environnement
de ces agents avant que les variables d’environnement spécifié
dans la configuration du pool ne soient ajoutées.
-
security.limit_extensions
chaîne de caractères
-
Limite les extensions que le script principal FPM va être autorisé à analyser.
Ceci peut prévenir les erreurs de configuration coté serveur.
Vous pouvez limiter FPM à exécuter seulement les extensions .php pour prévenir que des utilisateurs malicieux utilisent d'autres extensions pour exécuter du code.
Valeur par défaut : .php .phar
-
apparmor_hat
string
-
Si AppArmor est activé, permet de changer un hat (chapeau).
Valeur par défaut : non défini
-
access.log
chaîne de caractères
-
Le fichier journal d'accès. Valeur par défaut : non définie
-
access.format
chaîne de caractères
-
Le format du journal d'accès.
Valeur par défaut : "%R - %u %t \"%m %r\" %s"
:
Il est possible de passer des variables d'environnement additionnelles et mettre à jour les paramètres
de PHP d'un pool. Pour ce faire, vous devez ajouter les options suivantes au
fichier de configuration de la file d'attente.