1PHP-FPM(8)                    Scripting Language                    PHP-FPM(8)
2
3
4

NAME

6       php-fpm - PHP FastCGI Process Manager 'PHP-FPM'
7

SYNOPSIS

9       php-fpm [options]
10

DESCRIPTION

12       PHP  is  a widely-used general-purpose scripting language that is espe‐
13       cially suited for Web development and can be embedded into  HTML.  This
14       is  a  variant of PHP that will run in the background as a daemon, lis‐
15       tening for CGI requests. Output is logged to /var/log/php-fpm.log.
16
17       Most options are set in the configuration file. The configuration  file
18       is  /etc/php-fpm.conf. By default, php-fpm will respond to CGI requests
19       listening on localhost http port 9000. Therefore php-fpm  expects  your
20       webserver to forward all requests for '.php' files to port 9000 and you
21       should edit your webserver configuration file appropriately.
22

OPTIONS

24       -C             Do not chdir to the script's directory
25
26       --php-ini path|file
27       -c path|file   Look for php.ini file in the directory path or  use  the
28                      specified file
29
30       --no-php-ini
31       -n             No php.ini file will be used
32
33       --define foo[=bar]
34       -d foo[=bar]   Define INI entry foo with value bar
35
36       -e             Generate extended information for debugger/profiler
37
38       --help
39       -h             This help
40
41       --info
42       -i             PHP information and configuration
43
44       --modules
45       -m             Show compiled in modules
46
47       --version
48       -v             Version number
49
50       --prefix path
51       -p             Specify alternative prefix path (the default is /usr)
52
53       --pid file
54       -g             Specify the PID file location.
55
56       --fpm-config file
57       -y             Specify alternative path to FastCGI process manager con‐
58                      figuration file (the default is /etc/php-fpm.conf)
59
60       --test
61       -t             Test FPM configuration file and  exit  If  called  twice
62                      (-tt), the configuration is dumped before exiting.
63
64       --daemonize
65       -D             Force  to  run in background and ignore daemonize option
66                      from configuration file.
67
68       --nodaemonize
69       -F             Force to stay in foreground and ignore daemonize  option
70                      from configuration file.
71
72       --force-stderr
73       -O             Force  output to stderr in nodaemonize even if stderr is
74                      not a TTY.
75
76       --allow-to-run-as-root
77       -R             Allow pool to run as root (disabled by default)
78

FILES

80       php-fpm.conf   The configuration file for the php-fpm daemon.
81
82       php.ini        The standard php configuration file.
83

EXAMPLES

85       For any unix systems which use init.d for their main  process  manager,
86       you  should  use the init script provided to start and stop the php-fpm
87       daemon.
88
89              sudo /etc/init.d/php-fpm start
90
91       For any unix systems which use systemd for their main process  manager,
92       you  should  use  the  unit file provided to start and stop the php-fpm
93       daemon.
94
95              sudo systemctl start php-fpm.service
96
97       If your installation has no appropriate  init  script,  launch  php-fpm
98       with  no  arguments. It will launch as a daemon (background process) by
99       default. The file /var/run/php-fpm.pid determines  whether  php-fpm  is
100       already  up and running. Once started, php-fpm then responds to several
101       POSIX signals:
102
103              SIGINT,SIGTERM      immediate termination
104              SIGQUIT             graceful stop
105              SIGUSR1             re-open log file
106              SIGUSR2             graceful reload of all workers +  reload  of
107              fpm conf/binary
108

TIPS

110       The PHP-FPM CGI daemon will work well with most popular webservers, in‐
111       cluding Apache2, lighttpd and nginx.
112

SEE ALSO

114       The PHP-FPM website:
115       http://php-fpm.org
116
117       For a more or less complete description of PHP look here:
118       http://www.php.net/manual/
119
120       A nice introduction to PHP by Stig Bakken can be found here:
121       http://www.zend.com/zend/art/intro.php
122

BUGS

124       You can view the list of known bugs or report any new bug you found at:
125       https://github.com/php/php-src/issues
126

AUTHORS

128       PHP-FPM SAPI was written by Andrei Nigmatulin.  The  mailing-lists  are
129       highload-php-en (English) and highload-php-ru (Russian).
130
131       The PHP Group: Thies C. Arntzen, Stig Bakken, Andi Gutmans, Rasmus Ler‐
132       dorf, Sam Ruby, Sascha Schumann, Zeev  Suraski,  Jim  Winstead,  Andrei
133       Zmievski.
134
135       A List of active developers can be found here:
136       http://www.php.net/credits.php
137
138       And last but not least PHP was developed with the help of a huge amount
139       of contributors all around the world.
140

VERSION INFORMATION

142       This manpage describes php-fpm, version 8.2.13.
143

COPYRIGHT

145       Copyright © The PHP Group
146       Copyright (c) 2007-2009, Andrei Nigmatulin
147
148       This source file is subject to version 3.01 of the PHP license, that is
149       bundled with this package in the file LICENSE, and is available through
150       the world-wide-web at the following url:
151       https://www.php.net/license/3_01.txt
152
153       If you did not receive a copy of the PHP license and are unable to  ob‐
154       tain  it  through  the  world-wide-web,  please  send  a  note  to  li‐
155       cense@php.net so we can mail you a copy immediately.
156
157
158
159The PHP Group                        2022                           PHP-FPM(8)