PHP-FPM(8)

📦
version 8.5.9 · 2 versions
, in ubuntu stonking

💅 PHP-FPM(8) — the manual page, but make it cute

okay bestie, welcome to the php-fpm page — that's section 8 of the manual, the "system administration" girlies. she's giving daemon energy and honestly? iconic.

✨ NAME ✨

php-fpm — the PHP FastCGI Process Manager, aka 'PHP-FPM' 💖

🦋 SYNOPSIS 🦋

php-fpm [options]

that's it. that's the whole vibe. flags only, no positional arguments, she doesn't need them. 👑

🌸 DESCRIPTION 🌸

so. PHP is a widely-used, general-purpose scripting language that is especially suited for Web development and can be embedded into HTML. periodt. 💅

This is a variant of PHP that runs in the background as a daemon, just chilling there, listening for CGI requests. and where do all her thoughts go? output is logged to /var/log/php-fpm.log. lowercase queen. 📝

most of her settings don't live in flags at all, bestie — they live in the configuration file, which is /etc/php-fpm.conf. 🎀

by default, php-fpm responds to CGI requests by listening on localhost http port 9000. which means she expects your webserver to forward every single request for '.php' files on over to port 9000 — so you should go edit your webserver configuration file appropriately. she's not coming to you, you're coming to her. ✨

💅 OPTIONS 💅

every single one, no skips, we don't do that here:

  • -C — do not chdir to the script's directory. stay put. 🫶
  • --php-ini path|file, -c path|file — go look for the php.ini file in the directory path, or just use the file you pointed at.
  • --no-php-ini, -n — no php.ini file will be used at all. nothing. zero. unbothered. 🙈
  • --define foo[=bar], -d foo[=bar] — define the INI entry foo with the value bar. you're literally just making up rules now, slay.
  • -e — generate extended information for debugger/profiler. 🔍
  • --help, -h — this help. hi, hello, that's me. 👋
  • --info, -i — PHP information and configuration. the lore. 📚
  • --modules, -m — show compiled in modules. look at all her little friends. 🧚
  • --version, -v — version number. ⭐
  • --prefix path, -p — specify an alternative prefix path (the default is /usr).
  • --pid file, -g — specify the PID file location.
  • --fpm-config file, -y — specify an 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. and get this — if you call it twice (-tt), the configuration is dumped before exiting. double tap for the receipts 💖
  • --daemonize, -D — force her to run in the background and ignore the daemonize option from the configuration file. overruling the config, we love a decisive queen.
  • --nodaemonize, -F — force her to stay in the foreground and ignore the daemonize option from the configuration file. she stays. right here.
  • --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). disabled by default for a reason, bestie — read that twice before you flex it. 👑

🎀 FILES 🎀

  • php-fpm.conf — the configuration file for the php-fpm daemon. her diary. 📔
  • php.ini — the standard php configuration file. 📓

🌈 SIGNAL 🌈

once she's started, php-fpm responds to several POSIX signals. here's the cheat sheet, memorize it, it will come up:

  • SIGINT,SIGTERM — immediate termination. no warning, no goodbye, we're done here.
  • SIGQUIT — graceful stop. the soft launch of shutdowns.
  • SIGUSR1 — re-open log file. fresh notebook, same girl. 📝✨
  • SIGUSR2,SIGHUP — graceful reload of all workers + reload of

fpm conf/binary

okay yes the original text really does break across the lines like that, so there you go — graceful reload of all workers + reload of fpm conf/binary. 🔁

🫶 SEE ALSO 🫶

for a more or less complete description of PHP-FPM, look here: https://www.php.net/fpm — the lore drops, go read them. 📖

🐛 BUGS 🐛

you can view the list of known bugs, or report any new bug you found, at: https://github.com/php/php-src/issues. not me finding a bug at 3am 🙈

👑 AUTHORS 👑

PHP-FPM SAPI was written by Andrei Nigmatulin. and the mailing lists are highload-php-en (English) and highload-php-ru (Russian) — multilingual legend behavior. 🌍

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 — go give them their flowers. 💐

and last but not least, PHP was developed with the help of a huge amount of contributors all around the world. a truly global group chat 🌈

⭐ VERSION INFORMATION ⭐

this manpage describes php-fpm, version 8.5.9.

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. 🎀

and that's the whole page, bestie — no notes, no cap, every flag accounted for. 💅

okay bye, this was the The PHP Group's php-fpm manpage, dated 2024, and you read the whole entire thing — that's the section 8 manual, mwah, obsessed with you, go restart your pools 🦋✨

📦 where this page comes from