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 --prefix path
49
50       -p             Specify alternative prefix path (the default is /usr)
51
52       --pid file
53       -g             Specify the PID file location.
54
55       --fpm-config file
56       -y             Specify alternative path to FastCGI process manager con‐
57                      figuration file (the default is /etc/php-fpm.conf)
58
59       --test
60       -t             Test FPM configuration file and  exit  If  called  twice
61                      (-tt), the configuration is dumped before exiting.
62
63       --daemonize
64       -D             Force  to  run in background and ignore daemonize option
65                      from configuration file.
66
67       --nodaemonize
68       -F             Force to stay in foreground and ignore daemonize  option
69                      from configuration file.
70
71       --force-stderr
72       -O             Force  output to stderr in nodaemonize even if stderr is
73                      not a TTY.
74
75       --allow-to-run-as-root
76       -R             Allow pool to run as root (disabled by default)
77

FILES

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

EXAMPLES

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

TIPS

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

SEE ALSO

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

BUGS

123       You can view the list of known bugs or report any new bug you found at:
124       http://bugs.php.net
125

AUTHORS

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

VERSION INFORMATION

141       This manpage describes php-fpm, version 8.1.14.
142

COPYRIGHT

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