php-fpm(8)

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       --fpm-config file
53       -y             Specify alternative path to FastCGI process manager con‐
54                      figuration file (the default is /etc/php-fpm.conf)
55
56       --test
57       -t             Test FPM configuration file and  exit  If  called  twice
58                      (-tt), the configuration is dumped before exiting.
59
60       --daemonize
61       -D             Force  to  run in background and ignore daemonize option
62                      from configuration file.
63
64       --nodaemonize
65       -F             Force to stay in foreground and ignore daemonize  option
66                      from configuration file.
67
68       --zend-extension file
69       -z file        Load Zend extension file
70

FILES

72       php-fpm.conf   The configuration file for the php-fpm daemon.
73
74       php.ini        The standard php configuration file.
75

EXAMPLES

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

TIPS

102       The PHP-FPM CGI daemon will work well  with  most  popular  webservers,
103       including Apache2, lighttpd and nginx.
104

BUGS

116       You can view the list of known bugs or report any new bug you found at:
117       http://bugs.php.net
118

AUTHORS

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

VERSION INFORMATION

134       This manpage describes php-fpm, version 5.3.3.
135

COPYRIGHT

137       Copyright © 1997-2009 The PHP Group
138       Copyright (c) 2007-2009, Andrei Nigmatulin
139
140       This source file is subject to version 3.01 of the PHP license, that is
141       bundled with this package in the file LICENSE, and is available through
142       the world-wide-web at the following url:
143       http://www.php.net/license/3_01.txt
144
145       If  you  did  not  receive  a copy of the PHP license and are unable to
146       obtain  it  through  the  world-wide-web,  please  send   a   note   to
147       license@php.net so we can mail you a copy immediately.
148
149
150
151The PHP Group                        2009                           PHP-FPM(8)