This feature is experimental: expect things to break and documentation to be innacurate and change inadvertantly. Use at your own risks.
PHP Official documentation
Commands
- devops php start
- Start PHP-FPM if stopped
- devops php stop
- Stop PHP-FPM if started
- devops php reload
- Reload PHP-FPM, reload the configuration and perform a graceful restart
- devops php restart
- Restart PHP-FPM, reload the configuration (but kills existing connection)
- devops php pecl_extension add
-
Add PHP PECL extensions
Options
Name Type Description Required name string Name of the PECL extension to install Required
Configuration
-
configuration:
-
php:
- cgi:
- composer: no default value
- display_errors: Off
- error_log: syslog
- error_reporting: E_ALL & ~E_DEPRECATED
- expose_php: Off
-
extensions:
-
fpm:
- emergency_restart_interval: 0
- emergency_restart_threshold: 0
- error_log: /var/log/php-fpm/php5-fpm.log
- log_level: notice
- pid: /var/run/php5-fpm.pid
- pool:
- process_control_timeout: 0
- process_max: 0
- syslog:
- log_errors: On
- max_execution_time: 60
- max_input_time: 120
- memory_limit: 128M
-
pecl_extensions:
- post_max_size: 16M
- realpath_cache_size: 256k
- realpath_cache_ttl: 3600
- safe_mode: Off
- safe_mode_gid: Off
- session:
- upload_max_filesize: 16M
-
php:
- cgi.fix_pathinfo integer
- cgi.fix_pathinfo provides *real* PATH_INFO/PATH_TRANSLATED support for CGI.
- Default:
1
- composer boolean
- Add composer support (https://getcomposer.org/) globally to the node
- display_errors string
- Define whether PHP will output errors, notices and warnings.
- Default:
Off
- error_log string
- Log errors to specified file (or syslog).
- Default:
syslog
- error_reporting string
- Define which errors, warnings and notices to report.
- Default:
E_ALL & ~E_DEPRECATED
- expose_php string
- Decides whether PHP may expose the fact that it is installed on the server.
- Default:
Off
- extensions array
- List of extra php extensions installable via the regular OS package manager
- fpm.emergency_restart_interval string
- Time within which an emergency graceful restart should be initiated (along with the threshold) - Available Units s(econds) default, m(inutes), h(ours), or d(ays)
- Default:
0
- fpm.emergency_restart_threshold integer
- If more than X processes restart with SIGSEGV or SIGBUS within the emergency restart interval, php-fpm will restart
- Default:
0
- fpm.error_log string
- Location of the error log file - can use `syslog` instead of file.
- Default:
/var/log/php-fpm/php5-fpm.log
- fpm.log_level string
- Minimum log level to capture the logs for
- Default:
notice
- fpm.pid string
- Location of the php5-fpm process PID file
- Default:
/var/run/php5-fpm.pid
- fpm.pool.bind.allowed_clients string
- List (comma separated) of ipv4 addresses of FastCGI clients which are allowed to connect.
- Default:
127.0.0.1
- fpm.pool.bind.group string
- Group owner of the unix socket (only relevant if listen is a path)
- Default:
www-data
- fpm.pool.bind.mode string
- Permission of the socket file (only relevant if listen is a path)
- Default:
0666
- fpm.pool.bind.owner string
- Owner of the unix socket (only relevant if listen is a path)
- Default:
www-data
- fpm.pool.group string
- Running unix group of the pool
- Default:
www-data
- fpm.pool.listen string
- The address on which to accept FastCGI requests (ip.add.re.ss;port, port, sock path)
- Default:
127.0.0.1:9000
- fpm.pool.name string
- Pool name
- Default:
www
- fpm.pool.ping.path string
- URL path to simple ping
- Default:
/ping
- fpm.pool.ping.response string
- Message to be sent back on ping
- Default:
pong
- fpm.pool.pm.max_children integer
- Maximum number of children (usually cpu-core * 2)
- Default:
10
- fpm.pool.pm.max_requests integer
- Maximum number of requests processed by a single process before being respawned
- Default:
0
- fpm.pool.pm.max_spare_servers integer
- Maximum number of spare servers to keep running
- Default:
6
- fpm.pool.pm.min_spare_servers integer
- Minimum number of spare servers to keep running
- Default:
2
- fpm.pool.pm.process_idle_timeout string
- Maximum time to keep a server idle running (ondemand)
- Default:
10s
- fpm.pool.pm.start_servers integer
- Number of server to start (dynamic)
- Default:
4
- fpm.pool.pm.status_path string
- URL path to access the status of the php pool
- Default:
/status
- fpm.pool.pm.type string
- Choose how the process manager will control the number of child processes. (static, dynamic, ondemand)
- Default:
static
- fpm.pool.request_slowlog_timeout string
- Time after which a backtrace is sent to the slowlogs (0; disabled); Available Units; s(econds) default, m(inutes), h(ours), or d(ays)
- Default:
0
- fpm.pool.request_terminate_timeout string
- Time after which a the process gets terminated (0; disabled); Available Units; s(econds) default, m(inutes), h(ours), or d(ays)
- Default:
0
- fpm.pool.slowlog string
- Path for the slow log file of this pool
- Default:
/var/log/php-fpm/$pool.log.slow
- fpm.pool.user string
- Running unix user of the pool
- Default:
www-data
- fpm.process_control_timeout string
- Time limit for child processes to wait for a reaction on signals from master. Available Units; s(econds) default, m(inutes), h(ours), or d(ays)
- Default:
0
- fpm.process_max integer
- The maximum number of processes FPM will fork across all the pools. 0 means no limit.
- Default:
0
- fpm.syslog.facility string
- Syslog facility to send the log to (only if error_log=syslog)
- Default:
daemon
- fpm.syslog.ident string
- String that is prepended to the syslog message
- Default:
php-fpm
- log_errors string
- Define whether PHP should log errors to locations such as a server-specific log, STDERR, or a location specified by the error_log.
- Default:
On
- max_execution_time integer
- Maximum execution time of each script, in seconds.
- Default:
60
- max_input_time integer
- Maximum amount of time each script may spend parsing request data.
- Default:
120
- memory_limit string
- Maximum amount of memory a script may consume.
- Default:
128M
- pecl_extensions array
- List of extra php extensions installable via PECL
- post_max_size string
- Maximum size of POST data that PHP will accept.
- Default:
16M
- realpath_cache_size string
- Determines the size of the realpath cache to be used.
- Default:
256k
- realpath_cache_ttl integer
- Duration of time, in seconds for which to cache realpath information for a given file or directory.
- Default:
3600
- safe_mode string
- Enable / disable php safe_mode.
- Default:
Off
- safe_mode_gid string
- Compare GID instead of UID when php safe_mode is enabled.
- Default:
Off
- session.save_handler string
- Handler used to store/retrieve session data.
- Default:
files
- session.save_path string
- Folder PATH where sessions will be stored (if save_habdler is file).
- Default:
/var/lib/php/session
- upload_max_filesize string
- Maximum allowed size for uploaded files.
- Default:
16M