Introduction to the configuration of php-fpm

This article introduces the configuration method of php-fpm in the PHP environment, and gives a detailed introduction to the configuration options and methods of php-fpm. Friends in need can refer to it.

Contents of this section: php-fpm configuration

Configure php-fpm: pid = run/php-fpm.pid pid setting, the default is var/run/php-fpm.pid in the installation directory, it is recommended to turn it on

error_log = log/php-fpm.log Error log, var/log/php-fpm.log in the installation directory by default

log_level = notice Error level. Available levels are: alert (must be processed immediately), error (error situation), warning (warning situation), notice (general important information), debug (debugging information). Default: notice.

emergency_restart_threshold = 60 emergency_restart_interval = 60s Indicates that if the number of php-cgi processes that have SIGSEGV or SIGBUS errors within the value set by emergency_restart_interval exceeds emergency_restart_threshold, php-fpm will restart gracefully. These two options Generally keep the default value.

process_control_timeout = 0 Set the timeout for the child process to accept multiplexed signals from the main process. Available units: s (seconds), m (minutes), h (hours), or d (days) Default unit: s (seconds). Default value: 0.

daemonize = yes Execute fpm in the background. The default value is yes, which can be changed to no for debugging. In FPM, it is possible to run multiple process pools with different settings. These settings can be set individually for each process pool.

listen = 127.0.0.1:9000 The fpm listening port is the address processed by PHP in nginx. Generally, the default value is sufficient. Available formats are: 'ip:port', 'port', '/path/to/unix/socket'. Each process pool needs to be set up.

listen.backlog = -1 The number of backlogs, -1 means unlimited, is determined by the operating system, just comment out this line.

listen.allowed_clients = 127.0.0.1 Allow access to the IP of the FastCGI process. Set any to unrestricted IP. If you want to set nginx on other hosts to also access this FPM process, set the listen address to a local IP that can be accessed. The default value is any. Each address is separated by commas. If not set or empty, any server requesting a connection is allowed:

listen.owner = www listen.group = www listen.mode = 0666

Unix socket setting options, if you use tcp to access, just comment here.

user = www group=www Account and group to start the process

pm = dynamic How to control the child process, the options are static and dynamic. If static is selected, a fixed number of child processes is specified by pm.max_children.

If dynamic is selected, it is determined by the opening parameters:

pm.max_children, the maximum number of child processes pm.start_servers, the number of processes at startup pm.min_spare_servers, guarantees the minimum number of idle processes. If the idle processes are less than this value, a new child process will be created. pm.max_spare_servers ensures the maximum number of idle processes. If the idle processes are greater than this value, they will be cleaned up.

For dedicated servers, pm can be set to static.

pm.max_requests = 1000 Sets the number of requests each child process will serve before respawning. Very useful for third-party modules that may have memory leaks. If set to '0' always accept requests. Equivalent to the PHP_FCGI_MAX_REQUESTS environment variable quantity. Default value: 0.

pm.status_path = /status The URL of the FPM status page. If not set, the status page cannot be accessed. Default value: none.

ping.path = /ping The ping URL of the FPM monitoring page. If it is not set, the ping page cannot be accessed. This page is used to externally detect whether the FPM is alive and can respond to requests. Note that it must start with a slash (/).

ping.response = pong Used to define the return response of the ping request. Returns text/plain formatted text as HTTP 200. Default value: pong.

request_terminate_timeout = 0 Set the timeout for a single request. This option may be useful if the 'max_execution_time' setting in php.ini does not abort the running script for some special reason. Set to '0' for 'Off'. You can try changing this option when 502 errors occur frequently.

request_slowlog_timeout = 10s When a request expires after the set timeout, the corresponding PHP call stack information will be completely written to the slow log. Set to '0' means 'Off'

slowlog = log/$pool.log.slow Slow request logging, used with request_slowlog_timeout

rlimit_files = 1024 Set the rlimit limit for file open descriptors. Default value: system defined value The system default openable handle is 1024, which can be viewed using ulimit -n and modified with ulimit -n 2048.

rlimit_core = 0 Set the core rlimit maximum limit value. Available values: 'unlimited', 0 or positive integer. Default value: system defined value.

chroot = Chroot directory at startup. The defined directory needs to be an absolute path. If not set, chroot is not used.

chdir = Set the startup directory, and it will automatically Chdir to this directory during startup. The defined directory needs to be an absolute path. Default value: current directory, or /directory (when chrooting)

catch_workers_output = yes Redirect stdout and stderr during the run to the main error log file. If not set, stdout and stderr will be redirected to /dev/null according to FastCGI's rules. Default value: empty.