Copyright (c) 2007-2009, Andrei Nigmatulin

All rights reserved.

Redistribution and use in source and binary forms, with or without

modification, are permitted provided that the following conditions

are met:

1. Redistributions of source code must retain the above copyright

notice, this list of conditions and the following disclaimer.

2. Redistributions in binary form must reproduce the above copyright

notice, this list of conditions and the following disclaimer in the

documentation and/or other materials provided with the distribution.

THIS SOFTWARE IS PROVIDED BY AUTHOR AND CONTRIBUTORS ``AS IS'' AND

ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE

IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE

ARE DISCLAIMED. IN NO EVENT SHALL AUTHOR OR CONTRIBUTORS BE LIABLE

FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL

DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS

OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)

HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT

LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY

OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF

SUCH DAMAGE.

$(SAPI_FPM_PATH): $(PHP_GLOBAL_OBJS) $(PHP_SAPI_OBJS) $(SAPI_EXTRA_DEPS)

$(BUILD_FPM)

php_fpm_BIN=@php_fpm_bin_path@

php_fpm_CONF=@php_fpm_conf_path@

php_fpm_PID=@php_fpm_pid_path@

php_opts="--fpm-config $php_fpm_CONF"

wait_for_pid () {

try=0

while test $try -lt 35 ; do

case "$1" in

'created')

if [ -f "$2" ] ; then

try=''

break

fi

;;

'removed')

if [ ! -f "$2" ] ; then

try=''

break

fi

;;

esac

echo -n .

try=`expr $try + 1`

sleep 1

done

}

case "$1" in

start)

echo -n "Starting @php_fpm_bin@ "

$php_fpm_BIN $php_opts

if [ "$?" != 0 ] ; then

echo " failed"

exit 1

fi

wait_for_pid created $php_fpm_PID

if [ -n "$try" ] ; then

echo " failed"

exit 1

else

echo " done"

fi

;;

stop)

echo -n "Gracefully shutting down @php_fpm_bin@ "

if [ ! -r $php_fpm_PID ] ; then

echo "warning, no pid file found - php-fpm is not running ?"

exit 1

fi

kill -QUIT `cat $php_fpm_PID`

wait_for_pid removed $php_fpm_PID

if [ -n "$try" ] ; then

echo " failed. Use force-exit"

exit 1

else

echo " done"

fi

;;

force-quit)

echo -n "Terminating @php_fpm_bin@ "

if [ ! -r $php_fpm_PID ] ; then

echo "warning, no pid file found - php-fpm is not running ?"

exit 1

fi

kill -TERM `cat $php_fpm_PID`

wait_for_pid removed $php_fpm_PID

if [ -n "$try" ] ; then

echo " failed"

exit 1

else

echo " done"

fi

;;

restart)

$0 stop

$0 start

;;

reload)

echo -n "Reload service @php_fpm_bin@ "

if [ ! -r $php_fpm_PID ] ; then

echo "warning, no pid file found - @php_fpm_bin@ is not running ?"

exit 1

fi

kill -USR2 `cat $php_fpm_PID`

echo " done"

;;

*)

echo "Usage: $0 {start|stop|force-quit|restart|reload}"

exit 1

;;

# @php_fpm_bin@ - PHP FastCGI Process Manager 'PHP-FPM'

#

# nginx-site-conf.sample:

# Php Site configuration for nginx webserver

#

# 1. set $site_root /path/to/your/website;

# 2. Rename this file. Copy it to /etc/nginx/sites-available, /etc/nginx/sites-enabled

# 3. Restart nginx webserver, and @php_fpm_bin@ service.

#

server {

set $site_root /var/www/nginx-site;

server_name localhost;

listen 80;

access_log /var/log/nginx/localhost.access.log;

location / {

root $site_root;

index index.html index.htm;

}

#error_page 404 /404.html;

# redirect server error pages to the static page /50x.html

#

error_page 500 502 503 504 /50x.html;

location = /50x.html {

root /var/www/nginx-default;

}

# pass the *.php scripts to @php_fpm_bin@ listening on port 9000

#

location ~ \.php$ {

root $site_root;

fastcgi_pass 127.0.0.1:9000;

fastcgi_index index.php;

include fastcgi_params;

fastcgi_param SCRIPT_FILENAME $document_root$fastcgi_script_name;

fastcgi_param SERVER_NAME $http_host;

fastcgi_ignore_client_abort on;

}

}

<?xml version="1.0" ?>

<configuration>

All relative paths in this config are relative to php's install prefix

<section name="global_options">

Pid file

<value name="pid_file">@php_fpm_pid_path@</value>

Error log file

<value name="error_log">@php_fpm_log_path@</value>

Log level

<value name="log_level">notice</value>

When this amount of php processes exited with SIGSEGV or SIGBUS ...

<value name="emergency_restart_threshold">10</value>

... in a less than this interval of time, a graceful restart will be initiated.

Useful to work around accidental curruptions in accelerator's shared memory.

<value name="emergency_restart_interval">1m</value>

Time limit on waiting child's reaction on signals from master

<value name="process_control_timeout">5s</value>

Set to 'no' to debug fpm

<value name="daemonize">yes</value>

</section>

<workers>

<section name="pool">

Name of pool. Used in logs and stats.

<value name="name">default</value>

Address to accept fastcgi requests on.

Valid syntax is 'ip.ad.re.ss:port' or just 'port' or '/path/to/unix/socket'

<value name="listen_address">127.0.0.1:9000</value>

<value name="listen_options">

Set listen(2) backlog

<value name="backlog">-1</value>

Set permissions for unix socket, if one used.

In Linux read/write permissions must be set in order to allow connections from web server.

Many BSD-derrived systems allow connections regardless of permissions.

<value name="owner">@php_fpm_user@</value>

<value name="group">@php_fpm_group@</value>

<value name="mode">0666</value>

</value>

Additional php.ini defines, specific to this pool of workers.

These settings overwrite the values previously defined in the php.ini.

<value name="php_defines">

<!-- <value name="sendmail_path">/usr/sbin/sendmail -t -i</value> -->

<!-- <value name="display_errors">0</value> -->

<!-- <value name="error_log">/var/log/php-error.log</value> -->

<!-- <value name="log_errors">true</value> -->

</value>

Unix user of processes

<value name="user">@php_fpm_user@</value>

Unix group of processes

<value name="group">@php_fpm_group@</value>

Process manager settings

<value name="pm">

Sets style of controling worker process count.

Valid values are 'static' and 'apache-like'

<value name="style">static</value>

Sets the limit on the number of simultaneous requests that will be served.

Equivalent to Apache MaxClients directive.

Equivalent to PHP_FCGI_CHILDREN environment in original php.fcgi

Used with any pm_style.

<value name="max_children">5</value>

Settings group for 'apache-like' pm style

<value name="apache_like">

Sets the number of server processes created on startup.

Used only when 'apache-like' pm_style is selected

<value name="StartServers">20</value>

Sets the desired minimum number of idle server processes.

Used only when 'apache-like' pm_style is selected

<value name="MinSpareServers">5</value>

Sets the desired maximum number of idle server processes.

Used only when 'apache-like' pm_style is selected

<value name="MaxSpareServers">35</value>

</value>

</value>

The timeout (in seconds) for serving a single request after which the worker process will be terminated

Should be used when 'max_execution_time' ini option does not stop script execution for some reason

'0s' means 'off'

<value name="request_terminate_timeout">0s</value>

The timeout (in seconds) for serving of single request after which a php backtrace will be dumped to slow.log file

'0s' means 'off'

<value name="request_slowlog_timeout">0s</value>

The log file for slow requests

<value name="slowlog">@php_fpm_log_path@.slow</value>

Set open file desc rlimit

<value name="rlimit_files">1024</value>

Set max core size rlimit

<value name="rlimit_core">0</value>

Chroot to this directory at the start, absolute path

<value name="chroot"></value>

Chdir to this directory at the start, absolute path

<value name="chdir"></value>

Redirect workers' stdout and stderr into main error log.

If not set, they will be redirected to /dev/null, according to FastCGI specs

<value name="catch_workers_output">yes</value>

How much requests each process should execute before respawn.

Useful to work around memory leaks in 3rd party libraries.

For endless request processing please specify 0

Equivalent to PHP_FCGI_MAX_REQUESTS

<value name="max_requests">500</value>

Comma separated list of ipv4 addresses of FastCGI clients that allowed to connect.

Equivalent to FCGI_WEB_SERVER_ADDRS environment in original php.fcgi (5.2.2+)

Makes sense only with AF_INET listening socket.

<value name="allowed_clients">127.0.0.1</value>

Pass environment variables like LD_LIBRARY_PATH

All $VARIABLEs are taken from current environment

<value name="environment">

<value name="HOSTNAME">$HOSTNAME</value>

<value name="PATH">/usr/local/bin:/usr/bin:/bin</value>

<value name="TMP">/tmp</value>

<value name="TMPDIR">/tmp</value>

<value name="TEMP">/tmp</value>

<value name="OSTYPE">$OSTYPE</value>

<value name="MACHTYPE">$MACHTYPE</value>

<value name="MALLOC_CHECK_">2</value>

</value>

</section>

</workers>

</configuration>