PHP-FPM(8)

📦
version 8.4.27 · 4 versions
, in debian trixie

💖 PHP-FPM(8) 💖

okay bestie, so this is the manual page for php-fpm, from the Scripting Language corner of your man pages, and honestly? she's a whole icon. let's get into it 🎀

✨ NAME ✨

php-fpm — the PHP FastCGI Process Manager, aka 'PHP-FPM'. yeah she has a whole government name AND a nickname. main character behavior fr. 👑

🌸 SYNOPSIS 🌸

php-fpm [options]

that's it. that's the whole vibe. you run her with some options and she does the thing. 💅

🦋 DESCRIPTION 🦋

so like, PHP is a widely-used general-purpose scripting language that's especially suited for Web development and can be embedded into HTML. you knew that. everyone knows that. 💁‍♀️

THIS version though — this variant of PHP — runs in the background as a daemon, just chilling, listening for CGI requests. her output gets logged to /var/log/php-fpm.log. she's not loud, she's just always there. that's her vibe. 🌙

most of the options? not set by you on the command line, bestie. they live in the configuration file. that file is /etc/php-fpm.conf. 📝

by default, php-fpm responds to CGI requests listening on localhost http port 9000. so this means your webserver needs to forward all the requests for '.php' files to port 9000, and you should go edit your webserver configuration file appropriately. like, actually go do it. she's waiting. 🙈

💅 OPTIONS 💅

okay this is the big one. every single flag, no skipping, we're doing all of them bestie. buckle up. 🫶

  • -C — does NOT chdir to the script's directory. stay put, periodt.
  • --php-ini path|file, -c path|file — look for the php.ini file in the directory path, or just use the file you specified directly. your call, queen.
  • --no-php-ini, -n — no php.ini file will be used AT ALL. zero. none. bold move honestly. 💀
  • --define foo[=bar], -d foo[=bar] — define the INI entry foo with value bar. you're literally writing config from the command line, that's so iconic.
  • -e — generate extended information for debugger/profiler. detective mode, activated. 🔍
  • --help, -h — the help. you are here. hi. 👋
  • --info, -i — PHP information and configuration. she's telling you everything about herself. emotional availability, we love to see it. 😭
  • --modules, -m — show the compiled in modules. what she's made of. ✨
  • --version, -v — version number. which era of her are we in?
  • --prefix path, -p — specify an alternative prefix path (the default is /usr). she's flexible, she can move. 🏠
  • --pid file, -g — specify the PID file location. that's her address. leave a note. 💌
  • --fpm-config file, -y — specify an alternative path to the FastCGI process manager configuration file (the default is /etc/php-fpm.conf). going somewhere fancy? 👑
  • --test, -t — test the FPM configuration file and exit. and if you call it TWICE, so -tt, the configuration is dumped before exiting. double tap for the full tea. ☕
  • --daemonize, -D — force her to run in the background and ignore the daemonize option from the configuration file. config said one thing, you said another. your word wins. 🔥
  • --nodaemonize, -F — force her to stay in the foreground and ignore the daemonize option from the configuration file. she stays. she watches. 🌈
  • --force-stderr, -O — force output to stderr in nodaemonize even if stderr is not a TTY. okay that one's specific but it's in the list so here it is. 💜
  • --allow-to-run-as-root, -R — allow the pool to run as root (disabled by default). yeah. it's off. it stays off unless you say otherwise. just so we're clear. 🚨

🎀 FILES 🎀

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

⭐ SIGNAL ⭐

once she's started, php-fpm responds to several POSIX signals. think of it like a mood ring but for processes:

  • SIGINT,SIGTERM — immediate termination. she's GONE. no goodbye. 💀
  • SIGQUIT — graceful stop. she leaves politely, closes the door behind her. 🚪
  • SIGUSR1 — re-open log file. fresh notebook, same girl. 📓
  • SIGUSR2,SIGHUP — graceful reload of all workers + reload of fpm conf/binary. glow up reload, everything gets refreshed. ✨

🌈 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

ngl if you find one, tell them. they wanna know. no cap. 🫶

👑 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. the whole squad. 🌟

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. literally worldwide. global village energy. 🌍💜

🌸 VERSION INFORMATION 🌸

this manpage describes php-fpm, version 8.4.27. 📌

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. they're nice about it, promise. 📬

okay and that's the whole page bestie 🎀 written by The PHP Group back in 2024, this was page PHP-FPM(8) and she ate every single time. love that for her. now go fix your webserver config. 💅✨

📦 where this page comes from