Reference

Reference: runtime type php

tenants[].applications[].routes[].runtime<php>.fastcgi

Syntaxfastcgi: <string>
Defaultnone
Contexttenants[].applications[].routes[].runtime (type: php)
Reloadapplies on reload

External pool: unix:/path.sock or tcp:host:port. Mutually exclusive with fpm.

tenants[].applications[].routes[].runtime<php>.fpm

Syntaxfpm: {...}
Defaultnone
Contexttenants[].applications[].routes[].runtime (type: php)
Reloadapplies on reload

Managed PHP-FPM pool settings (workers, ini values); not used with fastcgi.

tenants[].applications[].routes[].runtime<php>.fpm.binary

Syntaxbinary: <string>
Defaultnone
Contexttenants[].applications[].routes[].runtime<php>.fpm
Reloadapplies on reload

PHP-FPM binary; default: php-fpm on PATH, else the newest versioned one (php-fpm8.4, Alpine’s php-fpm84).

tenants[].applications[].routes[].runtime<php>.fpm.env

Syntaxenv: {<key>: <string>, ...}
Defaultempty
Contexttenants[].applications[].routes[].runtime<php>.fpm
Reloadapplies on reload

Environment passed to PHP (env[...]).

tenants[].applications[].routes[].runtime<php>.fpm.ini

Syntaxini: {<key>: <string>, ...}
Defaultempty
Contexttenants[].applications[].routes[].runtime<php>.fpm
Reloadapplies on reload

php_admin_value[...] settings, e.g. memory_limit: 256M.

tenants[].applications[].routes[].runtime<php>.fpm.max_requests

Syntaxmax_requests: <integer>
Default500
Contexttenants[].applications[].routes[].runtime<php>.fpm
Reloadapplies on reload

pm.max_requests; 0 disables recycling.

tenants[].applications[].routes[].runtime<php>.fpm.workers

Syntaxworkers: {...}
Defaultnone
Contexttenants[].applications[].routes[].runtime<php>.fpm
Reloadapplies on reload

min = pm.start_servers/pm.min_spare_servers, max = pm.max_children.

tenants[].applications[].routes[].runtime<php>.fpm.workers.autoscale

Syntaxautoscale: off | auto | recommend
Defaultrecommend
Contexttenants[].applications[].routes[].runtime<php>.fpm.workers
Reloadapplies on reload

off, recommend (default) or auto (ADR-0014).

tenants[].applications[].routes[].runtime<php>.fpm.workers.max

Syntaxmax: <integer>
Defaultrequired
Contexttenants[].applications[].routes[].runtime<php>.fpm.workers
Reloadapplies on reload

Upper bound when the pool is scaled.

tenants[].applications[].routes[].runtime<php>.fpm.workers.min

Syntaxmin: <integer>
Defaultrequired
Contexttenants[].applications[].routes[].runtime<php>.fpm.workers
Reloadapplies on reload

Processes started at the beginning and kept at least.

tenants[].applications[].routes[].runtime<php>.fpm.workers.target_concurrency

Syntaxtarget_concurrency: <integer>
Defaultnone
Contexttenants[].applications[].routes[].runtime<php>.fpm.workers
Reloadapplies on reload

Concurrent requests one worker is expected to handle well (utilisation basis).

tenants[].applications[].routes[].runtime<php>.front_controller

Syntaxfront_controller: <string>
Defaultnone
Contexttenants[].applications[].routes[].runtime (type: php)
Reloadapplies on reload

Script that handles requests for paths that do not exist, e.g. /index.php.

tenants[].applications[].routes[].runtime<php>.index

Syntaxindex: [<string>, ...]
Default["index.php","index.html"]
Contexttenants[].applications[].routes[].runtime (type: php)
Reloadapplies on reload

Index files for directory requests, tried in order.

tenants[].applications[].routes[].runtime<php>.response_timeout

Syntaxresponse_timeout: <duration> (e.g. 30s)
Default60s
Contexttenants[].applications[].routes[].runtime (type: php)
Reloadapplies on reload

Time to wait for PHP-FPM’s response headers.

tenants[].applications[].routes[].runtime<php>.root

Syntaxroot: <string>
Defaultnone
Contexttenants[].applications[].routes[].runtime (type: php)
Reloadapplies on reload

Document root; defaults to the application root.

tenants[].applications[].routes[].runtime<php>.startup_timeout

Syntaxstartup_timeout: <duration> (e.g. 30s)
Default30s
Contexttenants[].applications[].routes[].runtime (type: php)
Reloadapplies on reload

Time the managed PHP-FPM pool gets to become ready.

tenants[].applications[].routes[].runtime<php>.stop_timeout

Syntaxstop_timeout: <duration> (e.g. 30s)
Default10s
Contexttenants[].applications[].routes[].runtime (type: php)
Reloadapplies on reload

Time the managed pool gets to exit before it is killed.

tenants[].applications[].runtime<php>.fastcgi

Syntaxfastcgi: <string>
Defaultnone
Contexttenants[].applications[].runtime (type: php)
Reloadapplies on reload

External pool: unix:/path.sock or tcp:host:port. Mutually exclusive with fpm.

tenants[].applications[].runtime<php>.fpm

Syntaxfpm: {...}
Defaultnone
Contexttenants[].applications[].runtime (type: php)
Reloadapplies on reload

Managed PHP-FPM pool settings (workers, ini values); not used with fastcgi.

tenants[].applications[].runtime<php>.fpm.binary

Syntaxbinary: <string>
Defaultnone
Contexttenants[].applications[].runtime<php>.fpm
Reloadapplies on reload

PHP-FPM binary; default: php-fpm on PATH, else the newest versioned one (php-fpm8.4, Alpine’s php-fpm84).

tenants[].applications[].runtime<php>.fpm.env

Syntaxenv: {<key>: <string>, ...}
Defaultempty
Contexttenants[].applications[].runtime<php>.fpm
Reloadapplies on reload

Environment passed to PHP (env[...]).

tenants[].applications[].runtime<php>.fpm.ini

Syntaxini: {<key>: <string>, ...}
Defaultempty
Contexttenants[].applications[].runtime<php>.fpm
Reloadapplies on reload

php_admin_value[...] settings, e.g. memory_limit: 256M.

tenants[].applications[].runtime<php>.fpm.max_requests

Syntaxmax_requests: <integer>
Default500
Contexttenants[].applications[].runtime<php>.fpm
Reloadapplies on reload

pm.max_requests; 0 disables recycling.

tenants[].applications[].runtime<php>.fpm.workers

Syntaxworkers: {...}
Defaultnone
Contexttenants[].applications[].runtime<php>.fpm
Reloadapplies on reload

min = pm.start_servers/pm.min_spare_servers, max = pm.max_children.

tenants[].applications[].runtime<php>.fpm.workers.autoscale

Syntaxautoscale: off | auto | recommend
Defaultrecommend
Contexttenants[].applications[].runtime<php>.fpm.workers
Reloadapplies on reload

off, recommend (default) or auto (ADR-0014).

tenants[].applications[].runtime<php>.fpm.workers.max

Syntaxmax: <integer>
Defaultrequired
Contexttenants[].applications[].runtime<php>.fpm.workers
Reloadapplies on reload

Upper bound when the pool is scaled.

tenants[].applications[].runtime<php>.fpm.workers.min

Syntaxmin: <integer>
Defaultrequired
Contexttenants[].applications[].runtime<php>.fpm.workers
Reloadapplies on reload

Processes started at the beginning and kept at least.

tenants[].applications[].runtime<php>.fpm.workers.target_concurrency

Syntaxtarget_concurrency: <integer>
Defaultnone
Contexttenants[].applications[].runtime<php>.fpm.workers
Reloadapplies on reload

Concurrent requests one worker is expected to handle well (utilisation basis).

tenants[].applications[].runtime<php>.front_controller

Syntaxfront_controller: <string>
Defaultnone
Contexttenants[].applications[].runtime (type: php)
Reloadapplies on reload

Script that handles requests for paths that do not exist, e.g. /index.php.

tenants[].applications[].runtime<php>.index

Syntaxindex: [<string>, ...]
Default["index.php","index.html"]
Contexttenants[].applications[].runtime (type: php)
Reloadapplies on reload

Index files for directory requests, tried in order.

tenants[].applications[].runtime<php>.response_timeout

Syntaxresponse_timeout: <duration> (e.g. 30s)
Default60s
Contexttenants[].applications[].runtime (type: php)
Reloadapplies on reload

Time to wait for PHP-FPM’s response headers.

tenants[].applications[].runtime<php>.root

Syntaxroot: <string>
Defaultnone
Contexttenants[].applications[].runtime (type: php)
Reloadapplies on reload

Document root; defaults to the application root.

tenants[].applications[].runtime<php>.startup_timeout

Syntaxstartup_timeout: <duration> (e.g. 30s)
Default30s
Contexttenants[].applications[].runtime (type: php)
Reloadapplies on reload

Time the managed PHP-FPM pool gets to become ready.

tenants[].applications[].runtime<php>.stop_timeout

Syntaxstop_timeout: <duration> (e.g. 30s)
Default10s
Contexttenants[].applications[].runtime (type: php)
Reloadapplies on reload

Time the managed pool gets to exit before it is killed.