Observed worker state inconsistencies under Apache mod_proxy_fcgi with connection reuse (PHP-FPM 8.5.6)
まだ誰も着手していません。
- 主要言語
- C
- スター
- 40.4k
- フォーク
- 8.1k
- 平均マージ
- 2日 13時間
- マージ済み PR(30日)
- 96
説明
Description
Environment
- PHP-FPM: 8.5.6
- Process manager:
pm = dynamic - Typical pool configuration:
pm.max_childrendefined (value respected and stable)pm.start_servers,pm.min_spare_servers,pm.max_spare_serversstandard tuningpm.max_requests = 500
- Backend: Apache HTTP Server
- FastCGI handler:
mod_proxy_fcgi - Transport: Unix socket
- Relevant proxy configuration:
<Proxy "fcgi://handler/" enablereuse=on flushpackets=on max=10>
Additional working configuration (mitigating issue)
The following configuration appears to resolve or significantly reduce the observed behavior:
<Proxy "fcgi://handler/" enablereuse=on flushpackets=auto smax=2 max=12 acquire=1000 ttl=10 timeout=60 connectiontimeout=300ms>
Observed behavior (problematic configuration)
When using the simplified proxy configuration with connection reuse enabled:
- Workers in PHP-FPM appear to remain in intermediate states such as
reading headerslonger than expected. /fpm-statusshows discrepancies in perceived worker activity (notably higher "active" states than expected based on external observation).- Idle/spare worker management appears delayed or not aligned with expected request completion cycles.
max_spare_serversbehavior appears inconsistent with expected worker availability under idle load conditions.- The issue is reproducible and deterministic under sustained use of persistent FastCGI connection reuse.
Observed behavior (tuned configuration)
With explicit tuning of Apache FastCGI proxy pooling parameters:
- Worker state transitions appear consistent and timely.
- Idle/spare worker management behaves as expected.
- No persistent
reading headersstate anomalies observed. /fpm-statusmetrics appear stable and consistent with external process observation.
Notes on reproducibility
- Issue is reproducible under Apache
mod_proxy_fcgionly with:enablereuse=on- minimal or default proxy pool tuning
- Behavior changes significantly when introducing:
ttlacquireconnectiontimeout- constrained pool size (
smax,max)
Hypothesis (not confirmed)
It is not confirmed whether this behavior is caused by:
- PHP-FPM internal worker state machine handling
- Apache
mod_proxy_fcgiconnection reuse behavior - Interaction between FastCGI persistent connections and request lifecycle completion signaling
However, the observed behavior suggests a possible desynchronization between:
- actual request completion at PHP execution level
- worker state transition to idle within PHP-FPM
- FastCGI connection reuse lifecycle on the proxy side
Relation to /fpm-status discrepancies
It is not confirmed whether this issue is directly related to known discrepancies observed in /fpm-status (e.g. inconsistencies in reported active worker counts under certain conditions).
However, both phenomena share a common dependency on:
- worker state transition timing
- FastCGI connection reuse behavior
- request lifecycle completion signaling (
reading headers/ transition states)
This suggests a possible shared underlying factor, although no direct causality is claimed.
Important clarification
This report is based on observations from an Apache + PHP-FPM setup. Equivalent behavior under Nginx has not been directly evaluated in this context, although similar FastCGI reuse patterns may be relevant.
Summary
- Reproducible worker state inconsistencies observed under Apache
mod_proxy_fcgiwith connection reuse enabled. - Behavior strongly influenced by proxy connection pooling parameters.
- Mitigation achieved via explicit tuning of reuse, TTL, and connection limits.
- Root cause not confirmed; likely interaction between FastCGI reuse lifecycle and PHP-FPM worker state transitions.
- Possible, but unconfirmed, relation to
/fpm-statusinconsistencies.
PHP Version
PHP 8.5.7 (cli) (built: Jun 10 2026 20:19:22) (NTS)
Copyright (c) The PHP Group
Zend Engine v4.5.7, Copyright (c) Zend Technologies
with Zend OPcache v8.5.7, Copyright (c), by Zend Technologies
Operating System
No response
コントリビューションガイド
はじめの一歩
- issue を最後まで読み、次にプロジェクトのコントリビューションガイドを読みます。
- 着手することを issue にコメントします — 二人が同じ作業をするのを防げます。
- リポジトリをフォークし、ブランチを切って変更します。
- issue 番号を参照したプルリクエストを送ります。
調査の方向性
まず、PHP-FPM 8.5.7、Apache mod_proxy_fcgi、Unix ソケット、およびここで説明されている最小構成とチューニング済みの 設定を使って挙動を再現します。/fpm-status の worker の状態を外部からの観測結果と比較し、相違が PHP-FPM のリクエスト遷移にあるのか、Apache の接続再利用にあるのかを明らかにします。完了条件は、原因が確認され、焦点を絞った回帰テストまたは再現可能な修正が用意されていることです。
索引モデルが issue の本文から書いたものです。
評価
- 技術スタック
- apache, php
- 領域
- backend
- issue の種類
- バグ
- 難易度
- 4/5
- 見積もり時間
- 3〜5日
- 活発さ
- 静か
- 明瞭さ
- 説明が足りない
- 初心者へのやさしさ
- 38/100