ワーカーモード
01永続的な PHP プロセスが一度だけブートストラップし、数千のリクエストを処理します。スーパーグローバル、バッファ、ヘッダーはリクエスト間でソフトリセットされ、オートローダー、コンテナ、DB 接続は維持されます。
スタックが担っていたすべてを、1 つのプロセスで実現
実行モデル、HTTP 配信、共有状態、可観測性、セキュリティ — すべて組み込み済みで、デフォルトで有効、あるいは環境変数を 1 つ設定するだけです。nginx の設定も、サイドカーも、コンパイルが必要なプラグインもありません。
Run PHP
実行モデル
永続的なワーカー、協調的なファイバー、そして本物のバックグラウンドスレッド — リクエストのライフサイクルを自在に設計できます。
ファイバー多重化
02各ワーカーは PHP 8.4 の Fiber を通じて数百の並行リクエストを処理します — sleep や await はスレッドをブロックする代わりにファイバーを譲ります。
非同期 Promise
03クロージャを専用のスレッドプールにディスパッチして結果を待機できます — 並列ファンアウト向けに all、race、any のコンビネーターを備えています。
早期レスポンス
04レスポンスをクライアントに即座に送信し、その後もバックグラウンドで処理を続けられます — ジョブのキュー投入、ログの書き込み、キャッシュのウォームアップなど。
デコレーター
05PHP 8 のアトリビュートで関数やメソッドの呼び出しをインターセプトできます — 呼び出し箇所に手を加えることなく、リトライ、キャッシュ、トレース、ガードを実現します。
SSE ストリーミング
06PHP から直接、明示的なフラッシュ制御でリアルタイムの Server-Sent Events を送信できます — プロキシのバッファリングに悩まされることはありません。
Serve
HTTP と配信
これまで nginx が担っていた Web サーバー層 — ルーティング、静的ファイル、TLS、圧縮、保護 — を環境変数で設定できます。
従来のファイルマッピング、フレームワークのフロントコントローラー、SPA フォールバック — 変数 1 つで切り替えられ、ワーカーモードはそのいずれの上にも重ねられます。
静的ファイル
08メモリ内コンテンツキャッシュ、MIME タイプの自動検出、ETag および Last-Modified ヘッダー、大容量ファイルのストリーミングに対応します。
Brotli 圧縮
09テキストレスポンスを標準で圧縮します — 品質は 0〜11 で調整でき、削減バイト数はメトリクスとして公開されます。
組み込み TLS
10変数 2 つで TLS 終端を実現します — PEM 証明書と鍵を指定し、最小プロトコルバージョンは起動時に強制されます。
レート制限
11IP 単位の制限をウィンドウ設定付きで行えます。制限を超えたリクエストには 429 を返し、PHP のキューが満杯の場合は 529 でバックプレッシャーを通知します。
タイムアウト
12Slowloris 対策のヘッダー読み取りタイムアウト、リクエストタイムアウト、シャットダウン時のグレースフルなドレイン期間を備えています。
カスタムエラーページ
13ステータスコードごとに独自の HTML を用意できます — 404.html や 503.html をディレクトリに置き、変数 1 つでそこを指すだけです。
SIGTERM は終了前に処理中の接続をドレインします — リクエストを取りこぼすことなくローリングデプロイを実現します。
Observe
可観測性
メトリクス、ログ、トレース、プロファイルがサーバーに組み込まれています — エクスポーターも、サイドカーも、コード変更も不要です。
専用の内部ポートが、リクエスト、ワーカー、キュー、キャッシュ、非同期のメトリクスを公開します — Grafana ですぐに利用できます。
構造化ログ
24各行にメソッド、パス、ステータス、処理時間、リクエストID を含む JSON アクセスログを出力します — Loki や Elasticsearch がそのまま解析できます。
リクエストID
25X-Request-ID を自動的に生成またはパススルーし、PHP から利用でき、すべてのログ行に付与されます。
トレーシングと APM
26W3C Trace Context、OpenTelemetry エクスポート、PDO・cURL・Redis の自動計装、さらに PHP 向けのトレーシング SDK を備えています。
組み込みプロファイラー
27リクエストごとのプロファイルを xhprof、speedscope、pprof、FlameGraph の各形式で取得できます — ヘッダー、Cookie、サンプリングでトリガーできます。
ヘルスチェック
28Liveness と Readiness のエンドポイント、さらにライブな設定スナップショットを提供します — Kubernetes のプローブが標準で動作します。
Protect
セキュリティ
妥当な保護がデフォルトで有効になっており、レガシーな PHP アプリの危うい部分に対応する拒否リストも備えています。
ドットパスのブロック
29隠しファイルやディレクトリ — .env、.git/、.htaccess — は決して配信されません。デフォルトで有効で、設定は不要です。
信頼済みプロキシ
30Forwarded（RFC 7239）および X-Forwarded-* ヘッダーから実際のクライアント IP を取得します。CIDR ベースの信頼設定と、最も右側の非信頼アドレスによる解決に対応します。
PHP 実行の拒否リスト
31/uploads/** のような書き込み可能なパスでの .php 実行をブロックします — レガシーアプリを狙ったアップロードシェル攻撃は、ディスク I/O の前に阻止されます。
ドキュメントルートからのシンボリックリンクによる脱出は、明示的に許可リストへ登録しない限りブロックされます — Laravel の storage:link は問題なく動作します。