Skip to content

[stable34] docs: expand PHP-FPM tuning section with real guidance#14994

Merged
skjnldsv merged 3 commits into
stable34from
backport/14923/stable34
May 21, 2026
Merged

[stable34] docs: expand PHP-FPM tuning section with real guidance#14994
skjnldsv merged 3 commits into
stable34from
backport/14923/stable34

Conversation

@backportbot
Copy link
Copy Markdown

@backportbot backportbot Bot commented May 21, 2026

Backport of PR #14923

skjnldsv and others added 3 commits May 21, 2026 10:33
Replace the two-sentence stub with real content covering:
- pm modes (dynamic/static/ondemand) with trade-offs and Nextcloud
  guidance (ondemand not recommended; sync clients cause repeated
  cold starts)
- Key parameters: pm.max_children, start/min/max spare servers,
  pm.max_requests, pm.process_idle_timeout — with the RAM-based
  sizing formula and how to measure actual worker RSS
- Example dynamic config for 2 GB PHP RAM
- Slow log setup (slowlog + request_slowlog_timeout)
- Troubleshooting section: 502, 504, memory growth, cold-start lag
- Cross-reference to source_installation.rst for pool/env-var detail

Fixes #11591

Signed-off-by: skjnldsv <skjnldsv@protonmail.com>
The list-table with widths 15/85 caused horizontal overflow in the
rendered HTML. Definition list avoids the issue and is more idiomatic
RST for key-value mode descriptions.

Signed-off-by: John Molakvoæ (skjnldsv) <skjnldsv@protonmail.com>
Co-authored-by: John Molakvoæ <skjnldsv@users.noreply.github.com>
Signed-off-by: John Molakvoæ <skjnldsv@users.noreply.github.com>
@github-actions
Copy link
Copy Markdown
Contributor

📖 Documentation Preview

🔍 Open preview →

📄 1 changed documentation page

Last updated: Thu, 21 May 2026 11:09:51 GMT

@skjnldsv skjnldsv enabled auto-merge May 21, 2026 11:16
@skjnldsv skjnldsv disabled auto-merge May 21, 2026 11:16
@skjnldsv skjnldsv merged commit 1a3914a into stable34 May 21, 2026
26 of 27 checks passed
@skjnldsv skjnldsv deleted the backport/14923/stable34 branch May 21, 2026 11:16
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant