Skip to content

php-fpm.service improvements #21743

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Open
marcosfrm wants to merge 2 commits into
base: master
Choose a base branch
from
+1 −1
Open

php-fpm.service improvements #21743

Changes from 1 commit
Commits
Show all changes
2 commits
Select commit Hold shift + click to select a range
6221c19
php-fpm.service: remove PIDFile
marcosfrm Apr 13, 2026
837c901
php-fpm.service: set KillMode=mixed
marcosfrm Apr 13, 2026
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
Prev Previous commit
php-fpm.service: set KillMode=mixed 
Currently, php-fpm.service relies on the default KillMode=control-group, which sends SIGTERM to all
processes in the cgroup simultaneously. This can interfere with php-fpm's internal process management,
where the master process is designed to handle the graceful termination of its child workers.

Setting KillMode=mixed ensures that SIGTERM is sent only to the master process, allowing it to orchestrate
a clean shutdown. If the master process fails to exit within TimeoutStopSec, systemd will send SIGKILL to
all processes in the cgroup. Additionally, if the master exits but leaves orphaned children, systemd will
clean them up via SIGKILL. This mode has been supported since systemd 209 and provides a more robust
shutdown sequence for master-worker architectures.

Closes #18655
  • Loading branch information
@marcosfrm
marcosfrm committed Apr 13, 2026
commit 837c9014b1c880338ffa1ae8d1d66674887df277
1 change: 1 addition & 0 deletions sapi/fpm/php-fpm.service.in
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -10,6 +10,7 @@ After=network.target
Type=@php_fpm_systemd@
ExecStart=@EXPANDED_SBINDIR@/php-fpm --nodaemonize --fpm-config @EXPANDED_SYSCONFDIR@/php-fpm.conf
ExecReload=/bin/kill -USR2 $MAINPID
KillMode=mixed

# Set up a new file system namespace and mounts private /tmp and /var/tmp directories
# so this service cannot access the global directories and other processes cannot
Expand Down
Loading