Skip site navigation (1)Skip section navigation (2)

FreeBSD Manual Pages

  
 
  

home | help 
PHP-FPM(8)		       Scripting Language		      PHP-FPM(8)

NAME
     php-fpm - PHP FastCGI Process Manager 'PHP-FPM'

SYNOPSIS
     php-fpm [options]

DESCRIPTION
     PHP  is a widely-used general-purpose scripting language that is especially
     suited for Web development and can be embedded into HTML. This is a variant
     of PHP that will run in the background as a daemon, listening for	CGI  re-
     quests. Output is logged to /var/log/php-fpm.log.

     Most  options  are set in the configuration file. The configuration file is
     /usr/local/etc/php-fpm.conf. By default, php-fpm will respond  to	CGI  re-
     quests  listening	on  localhost  http port 9000. Therefore php-fpm expects
     your webserver to forward all requests for '.php' files to  port  9000  and
     you should edit your webserver configuration file appropriately.

OPTIONS
     -C 	    Do not chdir to the script's directory

     --php-ini path|file
     -c path|file   Look for php.ini file in the directory path or use the spec-
		    ified file

     --no-php-ini
     -n 	    No php.ini file will be used

     --define foo[=bar]
     -d foo[=bar]   Define INI entry foo with value bar

     -e 	    Generate extended information for debugger/profiler

     --help
     -h 	    This help

     --info
     -i 	    PHP information and configuration

     --modules
     -m 	    Show compiled in modules

     --version
     -v 	    Version number

     --prefix path
     -p 	    Specify alternative prefix path (the default is /usr/local)

     --pid file
     -g 	    Specify the PID file location.

     --fpm-config file
     -y 	    Specify alternative path to FastCGI process manager configu-
		    ration file (the default is /usr/local/etc/php-fpm.conf)

     --test
     -t 	    Test  FPM configuration file and exit If called twice (-tt),
		    the configuration is dumped before exiting.

     --daemonize
     -D 	    Force to run in background and ignore daemonize option  from
		    configuration file.

     --nodaemonize
     -F 	    Force to stay in foreground and ignore daemonize option from
		    configuration file.

     --force-stderr
     -O 	    Force  output to stderr in nodaemonize even if stderr is not
		    a TTY.

     --allow-to-run-as-root
     -R 	    Allow pool to run as root (disabled by default)

FILES
     php-fpm.conf   The configuration file for the php-fpm daemon.

     php.ini	    The standard php configuration file.

EXAMPLES
     For any unix systems which use init.d for their main process  manager,  you
     should use the init script provided to start and stop the php-fpm daemon.

	    sudo /etc/init.d/php-fpm start

     For any unix systems which use systemd for their main process manager, you
     should use the unit file provided to start and stop the php-fpm daemon.

	    sudo systemctl start php-fpm.service

     If your installation has no appropriate init script, launch php-fpm with no
     arguments. It will launch as a daemon (background process) by default. The
     file /var/run/php-fpm.pid determines whether php-fpm is already up and run-
     ning. Once started, php-fpm then responds to several POSIX signals:

	    SIGINT,SIGTERM	immediate termination
	    SIGQUIT		graceful stop
	    SIGUSR1		re-open log file
	    SIGUSR2		graceful reload of all workers + reload of fpm
	    conf/binary

TIPS
     The PHP-FPM CGI daemon will work well with most popular webservers, includ-
     ing Apache2, lighttpd and nginx.

SEE ALSO
     For a more or less complete description of PHP-FPM look here:
     https://www.php.net/fpm

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

AUTHORS
     PHP-FPM  SAPI was written by Andrei Nigmatulin. The mailing-lists are high-
     load-php-en (English) and highload-php-ru (Russian).

     The PHP Group: Thies C. Arntzen, Stig Bakken, Andi Gutmans, Rasmus Lerdorf,
     Sam Ruby, Sascha Schumann, Zeev Suraski, Jim Winstead, Andrei Zmievski.

     A List of active developers can be found here:
     https://www.php.net/credits.php

     And last but not least PHP was developed with the help of a huge amount  of
     contributors all around the world.

VERSION INFORMATION
     This manpage describes php-fpm, version 8.5.4.

COPYRIGHT
     Copyright (C) The PHP Group
     Copyright (c) 2007-2009, Andrei Nigmatulin

     This  source  file  is  subject to version 3.01 of the PHP license, that is
     bundled with this package in the file LICENSE, and is available through the
     world-wide-web at the following url:
     https://www.php.net/license/3_01.txt

     If you did not receive a copy of the PHP license and are unable  to  obtain
     it  through the world-wide-web, please send a note to license@php.net so we
     can mail you a copy immediately.

The PHP Group			      2024			      PHP-FPM(8)

Want to link to this manual page? Use this URL:
<https://man.freebsd.org/cgi/man.cgi?query=php-fpm&manpath=FreeBSD+15.1-RELEASE+and+Ports.quarterly>

home | help