PHP-FPM(8)

📦 version 8.3.6, in ubuntu noble

💖 PHP-FPM(8) — the manual, but make it slay 💖

okay bestie, gather round, because we're talking about php-fpm, aka PHP FastCGI Process Manager 'PHP-FPM', from the PHP-FPM(8) manual (section 8, the sysadmin section, obviously — main character energy). Let's get into it 🫶

✨ NAME ✨

php-fpm — PHP FastCGI Process Manager 'PHP-FPM'. that's the whole name. iconic, brief, no notes 💅

🌸 SYNOPSIS 🌸

php-fpm [options]

that's it. that's the summoning ritual. you just yell php-fpm with some options and it goes ✨

🦋 DESCRIPTION 🦋

so PHP is a widely-used general-purpose scripting language that is especially suited for Web development and can be embedded into HTML — you knew that, but bestie, this is a variant of PHP. the twist?? it runs in the background as a daemon, just sitting there listening for CGI requests like a lil bouncer at the club door 🚪 Output is logged to /var/log/php-fpm.log.

most options are set in the configuration file. that configuration file is /etc/php-fpm.conf. by default, php-fpm will respond to CGI requests listening on localhost http port 9000. so php-fpm expects your webserver to forward all requests for '.php' files to port 9000, and you should edit your webserver configuration file appropriately. yes, you. it's giving "the ball is in your court" 😭

👑 OPTIONS 👑

one bullet per option, no skips, no merges, we respect the source material in this house:

  • -C — Do not chdir to the script's directory. stay put, periodt.
  • --php-ini path|file, -c path|file — Look for php.ini file in the directory path or use the specified file. pick your fighter.
  • --no-php-ini, -n — No php.ini file will be used. raw. unbothered. no config, no problem (well, some problem, but that's the vibe you chose).
  • --define foo[=bar], -d foo[=bar] — Define INI entry foo with value bar. on the fly, live, in real time 💫
  • -e — Generate extended information for debugger/profiler. detective mode 🔍
  • --help, -h — This help. when in doubt, ask for help. we love a self-aware queen.
  • --info, -i — PHP information and configuration. the whole lore dump 📜
  • --modules, -m — Show compiled in modules. roll call!! everybody say present 📣
  • --version, -v — Version number. who are you, where did you come from.
  • --prefix path, -p — Specify alternative prefix path (the default is /usr).
  • --pid file, -g — Specify the PID file location. (yes bestie, the long form is --pid and the short one is -g. that's just how it is. no, don't question it.)
  • --fpm-config file, -y — Specify alternative path to FastCGI process manager configuration file (the default is /etc/php-fpm.conf).
  • --test, -t — Test FPM configuration file and exit. and here's the tea: if called twice (-tt), the configuration is dumped before exiting. double tap for the full reveal 👀
  • --daemonize, -D — Force to run in background and ignore daemonize option from configuration file. config said one thing, you said another, you win.
  • --nodaemonize, -F — Force to stay in foreground and ignore daemonize option from configuration file. same energy, opposite direction.
  • --force-stderr, -O — Force output to stderr in nodaemonize even if stderr is not a TTY. yeah it's stubborn like that 💀
  • --allow-to-run-as-root, -R — Allow pool to run as root (disabled by default). listen. this one is off by default for a reason, so don't go flipping it unless you truly know what you're doing, fr fr 🚨

🎀 FILES 🎀

  • php-fpm.conf — The configuration file for the php-fpm daemon.
  • php.ini — The standard php configuration file.

two files, both absolutely carrying the whole operation on their backs 💪

🌈 SIGNAL 🌈

Once started, php-fpm then responds to several POSIX signals. it's very emotionally available, just in a signals way:

  • SIGINT, SIGTERM — immediate termination. no goodbye, just gone 💨
  • SIGQUIT — graceful stop. a soft exit, a polite lil curtsy 🎀
  • SIGUSR1 — re-open log file. fresh log, who dis.
  • SIGUSR2, SIGHUP — graceful reload of all workers + reload of fpm conf/binary. glow-up in progress, do not disturb ✨

🧚 SEE ALSO 🧚

🙈 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 telling you to go file a bug report... but like, do it, they literally asked 🫶

💜 AUTHORS 💜

PHP-FPM SAPI was written by Andrei Nigmatulin. The mailing-lists are highload-php-en (English) and highload-php-ru (Russian). multilingual king 👑

The PHP Group: Thies C. Arntzen, Stig Bakken, Andi Gutmans, Rasmus Lerdorf, Sam Ruby, Sascha Schumann, Zeev Suraski, Jim Winstead, Andrei Zmievski. a whole ensemble cast, the avengers of scripting languages 🦸

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. the global girlies came THROUGH 🌍💖

⭐ VERSION INFORMATION ⭐

This manpage describes php-fpm, version 8.3.6.

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.

legal bestie has entered the chat and she is very thorough 💖

and that's the whole page, babes. this manual comes to you from The PHP Group, dated 2024, and it's the PHP-FPM(8) page — no cap, you now know it top to bottom. go forth and daemonize responsibly ✨🎀🦋

📦 where this page comes from