PHP-FPM(8)

📦
version 8.1.2 · 3 versions
, in ubuntu jammy

💖 NAME 💖

php-fpm — the PHP FastCGI Process Manager, aka "PHP-FPM" 🎀 (this page lives in the Scripting Language part of the manual, section 8, and yes it's the same PHP you know and love, just in daemon form)

✨ SYNOPSIS ✨

php-fpm [options]

🦋 DESCRIPTION 🦋

Okay so, bestie, real talk: PHP is a widely-used general-purpose scripting language that's especially suited to Web development and can be embedded right into HTML. Iconic. Legendary. No notes. 💅

This particular variant of PHP runs in the background as a daemon, just sitting there listening for CGI requests like the main character it is. Its output gets logged to /var/log/php-fpm.log. 🌸

Most options are set in the configuration file, and that configuration file is /etc/php-fpm.conf. By default, php-fpm will respond to CGI requests listening on localhost http port 9000. So what that means for you is: php-fpm expects your webserver to forward all requests for .php files to port 9000, and you should go edit your webserver configuration file appropriately. Do it. It's giving setup. ✨

👑 OPTIONS 👑

One bullet per option, bestie, no skips:

  • -C — Do not chdir to the script's directory.
  • --php-ini path|file, -c path|file — Look for the php.ini file in the directory path, or just use the specified file.
  • --no-php-ini, -n — No php.ini file will be used at all. Bold. Iconic.
  • --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).
  • --pid file, -g — Specify the PID file location.
  • --fpm-config file, -y — Specify alternative path to the FastCGI process manager configuration file (the default is /etc/php-fpm.conf).
  • --test, -t — Test the FPM configuration file and exit. If it's called twice (-tt), the configuration is dumped before exiting. 🫶
  • --daemonize, -D — Force it to run in the background and ignore the daemonize option from the configuration file.
  • --nodaemonize, -F — Force it to stay in the foreground and ignore the daemonize option from the 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 the 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.

💀 SIGNAL 💀

Once it's started, php-fpm responds to several POSIX signals. Learn them, they're your besties now:

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

🧚 SEE ALSO 🧚

The PHP-FPM website: http://php-fpm.org

For a more or less complete description of PHP look here: http://www.php.net/manual/

A nice introduction to PHP by Stig Bakken can be found here: http://www.zend.com/zend/art/intro.php

🙈 BUGS 🙈

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

(Not me manifesting a bug report… but fr fr, that's the place. 💜)

🌸 AUTHORS 🌸

PHP-FPM SAPI was written by Andrei Nigmatulin. The mailing-lists are highload-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: http://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.1.2-1ubuntu2.28.

Copyright © 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.

okay that's the whole page bestie, hope it slayed 🎀 this one's from The PHP Group, dated 2021, and it's the PHP-FPM(8) page — go start that daemon, you got this, mwah 💖✨

📦 where this page comes from