Nginx+PHP-fpmの10倍の同時リクエストを処理できるPHPサーバー
A PHP server that can handle 10x as many concurrent requests as Nginx+PHP-fpm (github.com)
要約
このGitHubリポジトリは、NginxとPHP-FPMの組み合わせと比較して、最大10倍の同時リクエストを処理できると主張するPHPベースのWebサーバーについて説明しています。詳細な技術仕様やベンチマーク結果は提供されていませんが、パフォーマンス向上に関心のある開発者向けに、代替ソリューションの可能性を示唆しています。
全文翻訳
README.md
⚡ Qbix Server v2
https://qbixserver.comは、すべてを処理してくれるオールインワンサーバーです。ファイルをフォルダにドロップするだけで、数百万ユーザーを処理できるリアルタイムアプリケーションが手に入ります。Linux、Mac、Windows、そしてiOSとAndroidでも動作するスタンドアロンバイナリを生成・配布できます。Qbix Server v2を使えば、オフラインでも、WiFiやBluetooth経由でも動作する安全な分散型アプリケーションを構築できます。
数百万人にサービスを提供する際には、安全性は非常に重要になります。なぜサーバーがPHPで書かれているのかをご覧ください。今日のPHPエコシステムは、OwnCloud、WordPress、Magento、Drupal、Symfony、Laravelなど、数千もの有用なWebフレームワークも生み出しています。Qbix Serverはそれらをすべて、変更なしで実行できます。また、すべてのアプリ、ドメイン、証明書などを一元管理するためのダッシュボードとビジュアルコントロールパネルも提供します。
置き換えるもの
| nginx + php-fpm | Qbix Server | |
|---|---|---|
| 💾 ワーカーあたりのメモリ | 30–60MB (重複) | 約120KB (COW、測定値) |
| 👥 同時PHP実行 (1GB) | 約24ワーカー | 約5,000 (典型値) |
| 🔒 分離性 | リクエスト間でスタティック変数が漏洩 | OS強制: リクエストごとに個別のアドレス空間 |
| 🚀 スループット (I/O、同RAM) | 78 req/s (fpm/Swoole 4w) | 1,060 req/s (100w) |
| 🌐 WebSocket | 別途サーバーが必要 | 内蔵、同じポート |
| 🖼️ 画像リサイズ | image_filterモジュール + 設定が必要 | 任意の画像URLに?w=300、自動AVIF/WebP対応 |
| 🔗 P2P | 不可能 | BLE + Wi-Fi経由の暗号化メッシュ |
| 📱 モバイル | 不可能 | バックグラウンド永続化対応のiOS + Android |
| 🔄 データ同期 | 不可能 | ピア間でのブルームフィルタ + prollyツリー |
| ⚙️ セットアップ | nginx + fpmプール + ソケット | php qbixserver.php |
完全な方法論についてはBENCHMARKS.mdを、リクエスト間で復元されるものについてはreset.mdを参照してください。
「リアルタイムPHPアプリ」に以前必要だったもの
リバースプロキシと静的ファイルにはnginx。PHP実行にはphp-fpm。Socket.IOサーバーにはNode.js。fpmとNode間のPub/SubにはRedis。すべてを稼働させるにはsupervisor。デプロイ可能にするにはDocker。6つのプロセス、3つの言語、2つのランタイム。
Qbix Serverはこれらすべてを1つのプロセスに置き換えます。HTTP、WebSocket (Socket.IOプロトコル付き)、SSE、セッション、アップロード、静的ファイル、画像リサイズ、.htaccess — 同じポート、同じファイル。Redis不要、Node不要、Pub/Subのグルー不要。
v2.0では、同じサーバーがBluetoothとWi-Fi経由で近くのデバイスを発見し、ECDH暗号化セッションを確立し、マルチホップメッシュ経由でメッセージをルーティングし、ブルームフィルタとprollyツリーを使用してピアツーピアでデータを同期します。Linux、macOS、Windowsに加えて、iOSとAndroidでも動作します。インターネットも中央サーバーもなしで、同じPHPアプリを実行している電話の教室がデータを同期 — たった1つのphp qbixserver.phpで。
アプリ全体(コード、アセット、SQLiteデータベース)を単一のバイナリにパッケージ化して、単一ファイルとして配布することもできます。Windowsではダブルクリック、MacやLinuxでは./myapp --open、ブラウザが開きアプリが表示されます。PHPのインストール不要、Webサーバーの設定不要、データベースの設定不要。仕組みはこちら →
📑 目次
- ドキュメント
- クイックスタート
- 既存のコードベースで使用する
- パフォーマンス
- vs FrankenPHPおよびSwoole
- 機能
- サーバーヘッダー
- PHP開発者向け
- 設定
- プラットフォームサポート
- 3つの実行方法
- ビルド
- 例
- 他のサーバーからの移行
- シングルバイナリ配布
- メッシュネットワーキング
- モバイル
- Qbix Platformと連携
- アーキテクチャ
- HTTP/2サポート
- なぜPHPか
- ライセンス
ドキュメント
| トピック | 内容 | |
|---|---|---|
| 🏎️ | なぜphp-fpmではないのか? | COWメモリモデル、SwooleおよびFrankenPHPとの比較 |
| 🔒 | サーバーヘッダー | Cache-Control、X-Cache-Tree、X-Accel-Redirect、ETag |
| 🗂️ | 静的ファイル | ETag/304、圧縮、事前圧縮キャッシュ |
| 🖼️ | 画像処理 | ?w=でのリサイズ、AVIF/WebPネゴシエーション、Save-Data、ディスクキャッシュ、制限 |
| 🌐 | HTTP | Fork-per-requestモード、リクエストライフサイクル |
| 🔌 | WebSocket & Rooms | プロセスごとの接続、ルーム、Socket.IO、SSE、チャット例 |
| 🛤️ | ルーティング | クリーンURL、.htaccess、DirectoryIndex |
| 📂 | PHPフレームワーク | マイクロフレームワーク: ハンドラ、イベント、Qクラス |
| ⚙️ | 設定 | JSON設定、CLIオプション、プリセット |
| 📦 | 実行とビルド | ソース、phar、バイナリ。静的バイナリのビルド。要件 |
| 📀 | バイナリと署名 | アプリのパッケージ化、zipファイルのような管理、ECDSA M-of-N署名、Rekor、プラットフォーム署名 |
| 🏗️ | アーキテクチャ | 永続ワーカー、COW、実行モデル、メンタルモデル、ベンチマーク |
| 📊 | ダッシュボードとパネル | ライブ統計、コントロールパネルタブ |
| 🚀 | デプロイとフェデレーション | Rsyncデプロイ、クラスタレプリケーション、サーバー間信頼 |
| 🔍 | APIディスカバリ | OpenAPI、MCP、qbix.json、HTTP/2 |
| 🧩 | 互換性 | Laravel、Symfony、WordPress、Drupalの変更なしでの実行: 何が書き換えられ、なぜか |
| 🏢 | フレームワーク | サポートされている全13フレームワーク、プリセット、ブートアダプター |
| 🧬 | [ | |
| --app モードとSAPI内部](https://github.com/Qbix/webserver/blob/main/docs/app-mode.md) | SAPIエミュレーション、クラス所有権、テストスイート | |
| 🌐 | メッシュプロトコル | ID、ハンドシェイク、ルーティング、暗号化 |
| 🔄 | データ同期 | ブルームフィルタ、prollyツリー、競合解決、現在の制限 |
| 📱 | iOS & Android | 電話での実行、トランスポート、権限 |
| 📈 | ベンチマーク | 完全な方法論と数値 |
| 🔄 | 状態リセット | リクエスト間で復元されるもの |
| 🔀 | nginxからの移行 | サーバーブロック、try_files、proxy_pass、gzip |
| 🔀 | Apacheからの移行 | .htaccess変更なし、VirtualHostマッピング |
| 🔀 | Caddyからの移行 | 自動HTTPS、オンデマンドTLS → autohost |
| ✅ | テスト結果 | 140のエンドツーエンドテスト |
| 🗺️ | ロードマップ | 次は何? |
| 📄 | ライセンス | MIT |
クイックスタート
git clone https://github.com/Qbix/webserver
cd webserver
php qbixserver.php
または、自己完結型バイナリ(PHPバンドル済み、インストール不要)を入手してください:
# Linux
curl -LO https://github.com/Qbix/webserver/releases/latest/download/qbixserver-linux-x86_64
chmod +x qbixserver-linux-x86_64
./qbixserver-linux-x86_64
# macOS (Apple Silicon)
curl -LO https://github.com/Qbix/webserver/releases/latest/download/qbixserver-macos-arm64
chmod +x qbixserver-macos-arm64
./qbixserver-macos-arm64
# Windows
curl -LO https://github.com/Qbix/webserver/releases/latest/download/qbixserver-windows-x64.exe
qbixserver-windows-x64.exe
またはPHAR(単一ファイル、コンパイル不要な拡張機能)を使用してください:
php bin/qbixserver.phar --root=./public --port=8080
既存のコードベースで使用する
すでにnginx + php-fpmでPHPアプリを実行している場合、切り替えは1コマンドです。サーバーは.htaccessを読み込み、URLをフロントコントローラーにリライトし、リクエスト間でスタティック変数、セッション、ヘッダーが正しく機能するように27の関数をシム(shim)してコードを実行します。
Laravel:
cd my-laravel-app
php /path/to/qbixserver.php --root=public --preset=laravel --port=8080
Symfony:
cd my-symfony-app
php /path/to/qbixserver.php --root=public --preset=symfony --port=8080
WordPress:
cd my-wordpress-site
php /path/to/qbixserver.php --root=. --preset=wordpress --port=8080
Drupal:
cd my-drupal-site
php /path/to/qbixserver.php --root=web --preset=drupal --port=8080
フロントコントローラーを持つ任意のPHPアプリ:
php /path/to/qbixserver.php --root=public --port=8080
ルートディレクトリにindex.phpがある場合、すべてのクリーンURLは自動的にそこにルーティングされます(nginxのtry_files $uri $uri/ /index.phpと同じ動作)。.htaccessがある場合、そのRewriteRuleとRewriteCondディレクティブが適用されます。
--presetの機能
各プリセットは、フレームワークに適したデフォルト設定(フロントコントローラーパス、アップロード制限、メモリ制限、セッションGC設定)を行います。これらはJSON設定ファイルでオーバーライドできます。プリセットは便宜のためのものです — それがなくても、.htaccessがルーティングを処理する場合、サーバーは機能します。
シムされるもの
サーバーは、インクルード時にソース変換を通じて27のPHP関数(header(), session_start(), setcookie(), ini_set()など)をインターセプトします。あなたのコードはheader()を呼び出し、それは機能します — サーバーがそれをキャプチャします。リクエスト間では、すべてのスタティックプロパティが0.03msでスナップショットから復元されます。完全なリストについては互換性を参照してください。
サポートされているフレームワーク
Qbix Serverは13のフレームワーク用のプリセットとブートアダプターを提供しています。すべてのフレームワークは変更なしで実行されます — プラグインやコードの変更は不要です。
| フレームワーク | プリセット | php-builtinとの速度向上 |
|---|---|---|
| Laravel | --preset=laravel | 3.4倍 |
| Symfony | --preset=symfony | — |
| WordPress | --preset=wordpress | — |
| Drupal | --preset=drupal | 4.0倍 |
| CakePHP | --preset=cakephp | 2.0倍 |
| CodeIgniter | --preset=codeigniter | — |
| Yii | --preset=yii | — |
| Mezzio | --preset=mezzio | 1.5倍 |
| Slim | --preset=slim | — |
| Joomla | --preset=joomla | — |
| Magento | --preset=magento | — |
| Nextcloud | --preset=nextcloud | — |
| ownCloud | --preset=owncloud | — |
「—」= ベンチマークされていないか、CPUバウンドな「hello world」で顕著な速度向上なし。実際のI/Oバウンドワークロードでは、COWメモリモデルによるはるかに大きな利点があります(ベンチマーク参照)。
完全な詳細、プリセットリファレンス、ブートアダプターのドキュメントについてはFRAMEWORKS.mdを参照してください。完全なベンチマーク方法論とフレームワークごとの数値についてはBENCHMARKS.mdを参照してください。
注意点
ほとんどのアプリはすぐに動作します。注意すべき点がいくつかあります:
define()定数は、永続ワーカーのリクエスト間で保持されます。プラグインが条件付きで定数を定義する場合、2回目のリクエストではすでに定義されていると認識されます。実際にはまれです。stream_wrapper_register()は保持されます。テストフレームワーク外では一般的ではありません。- 長時間実行スクリプト(マイグレーション、インポート)は
--workers=1を使用するか、直接CLIで実行する必要があります。 - Cレベルの状態を保存する拡張機能(例: 一部のカスタムPECLモジュール)は、リクエスト間でリセットされません。標準拡張機能(PDO、curl、mbstring)は問題ありません。
📊 パフォーマンス
同じシングルコアコンテナ、PHP 8.3、Ubuntu 24でnginxと比較ベンチマーク。13KBの静的ファイル、3回の実行で最良の結果、キャッシュウォームアップ済み。
| シナリオ | nginx | Qbix Server | 比率 |
|---|---|---|---|
| シーケンシャル (c=1) | 10,154 req/s | 6,376 req/s | 63% |
| 同時 (c=10) | 12,300 req/s | 6,876 req/s | 56% |
| 高同時 (c=50) | 12,919 req/s | 7,253 req/s | 56% |
| キープアライブ (c=10) | 26,858 req/s | 19,700 req/s | 73% |
| キープアライブ (c=50) | 30,158 req/s | 20,369 req/s | 67% |
同時実行数50での50,000以上のリクエストで、失敗したリクエストはゼロでした。サーバーはクラッシュしませんでした。
参考: 20K req/sは、サーバーが1秒あたり1,000の同時ページロード(ページあたり約20の静的アセットを想定)を処理できることを意味します。すべて単一のPHPプロセスから。
PHPアプリケーションワークロードの場合、話は逆転します — メモリとブートストラップの節約は、静的ファイルのスループットよりも重要です:
- nginx + php-fpm: 0.1ms 静的ファイル + 30ms PHPブートストラップ + 5ms 実際の処理 = 35ms
- Qbix Server: 0.15ms 静的ファイル + 0ms ブートストラップ + 5ms 実際の処理 = 5ms
完全な方法論についてはBENCHMARKS.mdを、フレームワークごとの数値についてはフレームワークベンチマークを参照してください。
💡 より高速なHTTPSとエッジキャッシングのために、常にnginx、リバースプロキシ、またはCDN(Cloudflare、CloudFront)をこれの前に配置できます。Qbix Serverは、その背後でPHP実行、アクセス制御、インテリジェントキャッシングを処理します。
⚖️ vs FrankenPHPおよびSwoole
php-fpmの先を見ているなら、FrankenPHPとSwooleを目にしたことがあるでしょう。それらの比較は以下の通りです:
| FrankenPHP | Swoole | Qbix Server | |
|---|---|---|---|
| 言語 | Go + C (PHPを埋め込み) | PHP用のC拡張機能 | 純粋なPHP |
| インストール | GoバイナリまたはDockerをダウンロード | pecl install swoole (Cをコンパイル) | php qbixserver.php — インストール不要 |
| アーキテクチャ | ワーカーモード (永続) | コルーチンベース (永続) | 事前ロード後のフォークによる共有なし |
| 状態の漏洩 | ⚠️ 可能性あり — ワーカーはリクエスト間で永続する | ⚠️ 可能性あり — グローバル変数を注意深く管理する必要がある | ✅ 不可能 — 各リクエストはクリーンなフォークを取得する |
| PHP互換性 | ほとんどのコードが動作、一部エッジケースあり | 多くの拡張機能が非互換、ブロッキングI/Oはコルーチンを壊す | ✅ 100% — 標準PHP、異常なものなし |
| メモリ安全性 | Goランタイム + PHP = 複雑な相互作用 | C拡張機能 = セグフォールトのリスク | PHPのみ = デフォルトでメモリセーフ |
| アクセス制御 | X-Accel-Redirect相当なし | 手動実装 | ✅ 内蔵X-Accel-Redirect |
| コンポーネントキャッシュ | なし | なし | ✅ X-Cache-Tree — サブページ無効化 |
| 早期ヒント / 103 | ✅ あり | なし | amphp経由 |
| HTTP/2 | ✅ 内蔵 (Caddy) | ✅ 内蔵 | ✅ amphp経由 |
| WebSocket | Mercure経由 | ✅ 内蔵 | ✅ 内蔵 |
共有なしの利点
FrankenPHPとSwooleは、PHPワーカーをリクエスト間で稼働させ続けます。これは高速ですが、グローバル状態、スタティック変数、データベース接続、インメモリキャッシュが無関係なリクエスト間で永続することを意味します。これは微妙なバグを引き起こします:
// これはFrankenPHP/Swooleでリクエスト間で漏洩します:
class UserService {
private static ?User $cached = null;
public static function current(): User {
if (!self::$cached) {
self::$cached = User::fromSession();
}
return self::$cached; // 前のユーザーのデータを返します!
}
}
スタティック変数、シングルトン、グローバル状態を使用するすべてのPHPフレームワーク、ライブラリ、スニペットは、潜在的なセキュリティホールになります。すべてを監査する必要があります。
Qbix Serverはこれを完全に回避します。ワーカーは事前ロードされた親からフォークするため、ロードされたクラスと解析された設定(読み取り専用、コピーオンライトで共有)を継承します。しかし、各リクエストは独自のプロセスで実行されます — リクエストが完了すると、すべてが消去されます。状態の漏洩はありません。監査は不要です。既存のPHPコードはphp-fpmと同じように機能します。
「PHPだけ」の利点
FrankenPHPはビルドにGoツールを必要とするか、Caddyをバンドルした事前ビルド済みバイナリが必要です。SwooleはC拡張機能のコンパイルを必要とし、これは他の拡張機能と競合する可能性があり、すべてのホスティング環境で動作するわけではありません。
Qbix ServerはPHPファイルです。php -vを実行できれば、サーバーを実行できます。これは、ほとんどのシステムにプリインストールされている標準PHP拡張機能(sockets, pcntl)を使用します。コンパイルステップ、外部ランタイム、バイナリ互換性の問題はありません。
# FrankenPHP
docker pull dunglas/frankenphp # 150MB以上のイメージ、またはGoソースからビルド
# Swoole
pecl install swoole # Cをコンパイル、一部システムで失敗する可能性あり
# 次にphp.iniを編集、phpを再起動...
# Qbix Server
php qbixserver.php --port=8080 # 完了
いつ何を選ぶか
FrankenPHPを選択 — Caddyのエコシステム(自動HTTPS、HTTP/3)を望み、Goを依存関係として気にしない場合。Octaneを既に利用しているLaravelプロジェクトに適しています。
Swooleを選択 — 高同時I/O(数千の同時HTTPクライアントリクエスト、データベースクエリ)のためにコルーチンが必要な場合。非同期重視のマイクロサービスに適しています。
Qbix Serverを選択 — 共有なしの安全性、ゼロインストールデプロイメント、アクセス制御されたファイル提供、コンポーネントレベルのキャッシュ無効化、既存PHPコードとの完全な互換性を望む場合。ページ(APIだけでなく)を提供するアプリ、細かいキャッシュが必要で、可能な限りシンプルなデプロイメントを望む場合に適しています。
✨ 機能
| カテゴリ | 内容 |
|---|---|
| 静的ファイル | ETag、304 Not Modified、Last-Modified、MIMEタイプ検出、インメモリレスポンスキャッシュ |
| キープアライブ | HTTP/1.0および1.1、TCP_NODELAY、設定可能な制限 |
| HTTP/2 | amphp経由 — マルチプレックスストリーム、ヘッダー圧縮、TLS(オプション) |
| PHP実行 | ドキュメントルート内の.phpファイルはインプロセスまたはプリフォークワーカープールで実行 |
| 圧縮 | オンザフライgzip/brotli + 事前圧縮された.gz/.brの兄弟ファイル |
| WebSocket | 任意のパスでのRFC 6455アップグレード |
| ダッシュボード | /Q/dashboardでのライブ統計 — リクエストレート、メモリ、ステータスコード |
| ヘルスチェック | /Q/healthでのJSON — ロードバランサーと監視用 |
| コントロールパネル | /Q/panelでのパスワード保護 — アプリとスクリプトを管理 |
| レート制限 | 設定可能なウィンドウとバースト制限付きのIPごと |
| セキュリティ | パストラバーサルブロック、ドットファイルブロック、ヘッダー過大時の431、不正なリクエスト時の400 |
| 正常終了 | SIGTERM/SIGINTでインフライトリクエストをドレインしてからクローズ |
| TLS | 自動certbotまたは手動証明書によるオプションのHTTPS |
| ロギング | カラフルなターミナル出力 + ファイルベースのアクセスログ |
| アクセス制御 | X-Accel-Redirectサポート — PHPがアクセスを強制し、サーバーがファイルをサービスする |
| コンポーネントキャッシュ | X-Cache-Treeヘッダー — ページ全体ではなく、ページの一部を無効化 |
| 画像処理 | ?w=でのリサイズ、自動AVIF/WebPネゴシエーション、ディスクキャッシュ |
| フレームワークプリセット | 13フレームワーク用の組み込みプリセット — Laravel、Symfony、WordPress、Drupalなど |
| メッシュネットワーキング | BLE + Wi-Fi経由の暗号化P2P、マルチホップルーティング |
| データ同期 | ピア間のブルームフィルタ + prollyツリー同期 |
🔒 サーバーヘッダー — PHPから送信できるもの
Qbix Serverは、PHPスクリプトからの特別なレスポンスヘッダーを理解します。これらはnginxが理解するもの(X-Accel-Redirectなど)と同じで、コンポーネントレベルのキャッシングのための新しいヘッダーも含まれます。PHPはheader()でこれらを送信し、サーバーがそれに対応します。
クイックリファレンス
| ヘッダー | 機能 |
|---|---|
Cache-Control | サーバーがレスポンスをキャッシュし、PHPを実行せずにサービスする |
X-Accel-Redirect | PHPがアクセスを確認した後、サーバーがファイルをストリームする |
X-Cache-Tree | ページコンポーネントをコンテンツハッシュで登録する |
X-Cache-Deps | コンポーネントをデータ依存キーにマッピングする |
X-Cache-Invalidate | 依存キーを古いものとしてマークする |
X-Cache-Stale | 特定のコンポーネントを再レンダリングが必要なものとしてマークする |
これらはすべて標準的なPHP header()呼び出しです。SDKやフレームワークは不要です。サーバーはクライアントにレスポンスを送信する前にこれらを削除します。
アクセス制御された静的ファイル
典型的なサーバーでは、アップロードされたファイルは公開URLに配置されます。リンクを持つ人なら誰でもアクセスでき、リンクを他の人と共有できます。通常の回避策は「推測不可能な」URLですが、これは単なる隠蔽によるセキュリティです。
X-Accel-Redirectを使用すると、PHPがアクセスを確認してから、サーバーにファイルを直接サービスするように指示できます — 高速、ストリーミング、公開URLは公開されません:
<?php
// web/download.php — アクセス制御されたファイル提供
session_start();
$fileId = $_GET['id'] ?? '';
$userId = $_SESSION['user_id'] ?? null;
// あなたのアクセス制御ロジック
if (!$userId || !userCanAccess($userId, $fileId)) {
http_response_code(403);
echo 'Access denied';
exit;
}
// サーバーにファイルを直接サービスするように指示します。
// クライアントは実際のパスを見ません。
header("X-Accel-Redirect: /uploads/private/{$fileId}");
header("Content-Disposition: attachment; filename=\"document.pdf\"");
// ここからサーバーが引き継ぎます — ファイルをストリームします
// 正しいContent-Type、ETag、圧縮などを使用します。
// あなたのPHPプロセスはすでに完了しています。
ファイルに対する公開URLはありません。ユーザーがブックマークできるリダイレクトもありません。PHPがアクセスを確認して終了した後、サーバーはファイルをストリームします。
コンポーネントレベルのキャッシュ無効化
ほとんどのキャッシュシステムはページ全体をキャッシュします。何かが変更されると、ページ全体を破棄してすべてを再レンダリングします。Qbix Serverは個々のコンポーネントをキャッシュし、変更されたものだけを再レンダリングできます。
ステップ1: ページレンダリング時にコンポーネントを登録する
<?php
// web/community.php — 3つのコンポーネントを持つページ
$feedHtml = renderFeed($communityId);
$sidebarHtml = renderSidebar($communityId);
$membersHtml = renderMembers($communityId);
// サーバーにコンポーネントツリーと各コンポーネントが依存するデータについて通知します
header('X-Cache-Tree: ' . json_encode([
'l' => [
'feed' => md5($feedHtml),
'sidebar' => md5($sidebarHtml),
'members' => md5($membersHtml),
]
]));
header('X-Cache-Deps: ' . json_encode([
'feed' => ["community/{$communityId}/feed"],
'sidebar' => ["community/{$communityId}/about"],
'members' => ["community/{$communityId}/participants"],
]));
header('Cache-Control: public, max-age=300');
echo $feedHtml . $sidebarHtml . $membersHtml;
ステップ2: データ変更時に無効化する
<?php
// web/post.php — ユーザーがフィードに投稿
saveNewPost($communityId, $content);
// サーバーに変更があった依存キーを通知します
header('X-Cache-Invalidate: ' . json_encode([
"community/{$communityId}/feed"
]));
// サーバーは依存関係グラフを辿ります:
// community/123/feed → ページ /community/123 のコンポーネント 'feed'
// 'feed' のみが古い状態です。サイドバー、メンバーはキャッシュされたままです。
// 次のリクエストではフィードコンポーネントのみが再レンダリングされます。
echo json_encode(['ok' => true]);
サーバーはコンポーネントハッシュのメルケルツリーを維持します。依存キーが無効化されると、ツリーを辿ってどのページ上のどのコンポーネントが影響を受けるかを正確に特定します。それ以外はインメモリキャッシュから提供されます。
📂 PHP開発者向け — マイクロフレームワーク
Qbix Serverは、単なるPHP搭載の静的ファイルサーバーではありません。これは、慣習的なディレクトリにファイルをドロップするだけで機能するマイクロフレームワークです — クラスはオートロードされ、イベントはハンドラをトリガーし、ビューはテンプレートをレンダリングします。基本的な設定は不要です。
プロジェクトレイアウト
myproject/
├── qbixserver.php ← サーバーのエントリーポイント (PHARも使用可能)
├── config/
│ └── server.json ← サーバー + アプリ設定
├── web/ ← ドキュメントルート (公開アクセス可能)
│ ├── index.html ← 直接サービスされる静的ファイル
│ ├── style.css
│ ├── api.php ← リクエスト時に実行されるPHPスクリプト
│ └── uploads/
├── classes/ ← あなたのPHPクラス (最初に使われたときにオートロードされる)
│ ├── MyApp/
│ │ ├── User.php ← MyApp\User または MyApp_User
│ │ ├── Feed.php
│ │ └── Auth.php
│ └── vendor/
│ └── autoload.php ← Composerオートローダー (オプション)
├── handlers/ ← イベントハンドラ (オンデマンドでロードされる)
│ └── MyApp/
│ └── feed/
│ ├── post.php ← "MyApp/feed/post" イベントを処理
│ └── validate.php ← "MyApp/feed/validate" イベントを処理
└── views/ ← Q::view()用のPHPテンプレート
└── MyApp/
└── feed/
├── page.php
└── item.php
HTTP経由でアクセスできるのはweb/のみです。それ以外はすべてサーバーサイド専用です。
あなたのPHPスクリプトは、何もrequireまたはincludeする必要はありません。 サーバーは、スクリプトが実行される前に、Qクラス、オートローダー、イベントシステムをすでにロードしています。classes/からのクラス、Q::event()経由のイベント、Q::view()経由のビュー — すべて即座に利用可能です:
<?php
// web/api.php — requireもincludeもブートストラップも不要
use MyApp\User;
$user = User::find($_GET['id']);
$feed = Q::event('MyApp/feed/get', ['userId' => $user->id]);
header('Content-Type: application/json');
echo json_encode($feed);
すべてのスクリプトで利用可能なQクラス
| メソッド | 機能 |
|---|---|
Q::event($name, $params) | イベントをトリガー — handlers/からハンドラを実行 |
Q::canHandle($name) | イベントのハンドラが存在するかどうかを確認 |
Q::view($name, $params) | views/からPHPテンプレートをレンダリング |
Q::ifset($arr, 'key1', 'key2', $default) | issetチェーンなしでの安全なネストされた配列/オブジェクトアクセス |
Q::getObject($data, ['path', 'to', 'key'], $default) | ネストされた配列/オブジェクトへのディープアクセス |
Q::setObject(['path', 'to', 'key'], $value, $data) | ネストされた配列へのディープセット、中間体の作成 |
Q::json_encode($value) | スラッシュをエスケープしないjson_encode |
Q::json_decode($json, true) | json_decodeラッパー |
Q_Config::get('section', 'key', $default) | config/server.jsonから読み取る |
Q_Config::set('section', 'key', $value) | ランタイムで設定値を設定する |
Q_Config::expect('section', 'key') | 設定を読み取るか、欠落している場合は例外をスローする |
ハンドラ — イベント駆動ディスパッチ
handlers/にファイルをドロップすると、イベントとして利用可能になります:
<?php
// handlers/MyApp/feed/post.php
function MyApp_feed_post(&$params, &$result) {
$title = $params['title'] ?? 'Untitled';
$userId = $params['userId'] ?? null;
$id = saveFeedPost($userId, $title);
$result = ['id' => $id, 'title' => $title, 'saved' => true];
return $result;
}
<?php
// web/api.php — どこからでもトリガー
$result = Q::event('MyApp/feed/post', [
'title' => $_POST['title'],
'userId' => $_SESSION['user_id'],
]);
header('Content-Type: application/json');
echo json_encode($result);
ハンドラファイルは、イベントが初めてトリガーされたときにincludeされ、その後関数はメモリに残ります。イベントが一度もトリガーされなければ、ファイルはロードされません。
設定経由の事前/事後フック — 検証、ロギング、アクセス制御に便利です:
{
"Q": {
"handlersBeforeEvent": {
"MyApp/feed/post": ["MyApp/feed/validate"]
},
"handlersAfterEvent": {
"MyApp/feed/post": ["MyApp/feed/notify"]
}
}
}
falseを返す事前フックはチェーンを停止します。ハンドラはURLにもなり得ます — サーバーはイベントパラメータをJSONとしてリモートエンドポイントにPOSTし、イベントシステムに組み込まれたWebhook機能を提供します。
考え方
| ロードタイミング | 保存場所 | 目的 | |
|---|---|---|---|
| クラス | スタートアップ (事前ロード) | classes/ | モデル、サービス、ユーティリティ — あなたのコアコード |
| ハンドラ | 初回イベントトリガー (オンデマンド) | handlers/ | アクション、フック、Webhook — イベントに応答するコード |
| ビュー | レンダリング時 | views/ | テンプレート — PHPを含むHTML |
| スクリプト | HTTP経由のリクエスト時 | web/ | エントリーポイント — 「コントローラー」レイヤー |
| 設定 | スタートアップ | config/ | 設定、ハンドラフック、事前ロードリスト |
クラスは即時ロード。ハンドラは遅延ロード。スクリプトはリクエストごと。ビューはオンデマンド。これにより、各コードの種類に適切なロード戦略を考えずに適用できます — ファイルを適切なディレクトリに置くだけです。
プロジェクトがマイクロフレームワークの範囲を超え、ユーザーアカウント、リアルタイムストリーム、アクセス制御、支払い、またはプラグインシステムが必要になった場合、--appモードに切り替えると、あなたが書いたすべてが引き続き動作します。--app モードとSAPI内部を参照してください。
⚙️ 設定
config/server.jsonをweb/ディレクトリの隣に作成するか、--config=path/to/config.jsonを渡してください:
{
"Q": {
"webserver": {
"keepAlive": {
"max": 100,
"timeout": 15
},
"maxConnections": 1024,
"fileCache": {
"maxSize": 67108864,
"maxFile": 1048576,
"checkInterval": 1
},
"rateLimit": {
"enabled": true,
"requests": 100,
"window": 60
}
}
}
}
| キー | デフォルト | 機能 |
|---|---|---|
keepAlive.max | 100 | キープアライブ接続あたりの最大リクエスト数 |
keepAlive.timeout | 15 | アイドル接続を閉じるまでの秒数 |
maxConnections | 1024 | 同時接続の最大数 |
fileCache.maxSize | 64MB | キャッシュされたファイルレスポンスの合計メモリ |
fileCache.maxFile | 1MB | メモリにキャッシュする最大のファイルサイズ |
fileCache.checkInterval | 1 | ファイル変更チェック間の秒数 |
rateLimit.enabled | false | IPごとのレート制限を有効にする |
rateLimit.requests | 100 | ウィンドウあたりのリクエスト数 |
rateLimit.window | 60 | ウィンドウ(秒) |
完全なリファレンスについては設定を参照してください。
プラットフォームサポート
| プラットフォーム | ワーカー | COW | トランスポート |
|---|---|---|---|
| Linux x86_64, aarch64 | pcntl_fork | はい — ワーカーあたり120KB | TCP, mDNS |
| macOS Intel, Apple Silicon | pcntl_fork | はい | TCP, mDNS |
| FreeBSD / OpenBSD / NetBSD | pcntl_fork | はい | TCP, mDNS |
| Windows x64 | qbix_fork.dll (FFI) または php-cgi | はい (FFI) / いいえ (php-cgi) | TCP |
| iOS arm64 | NativePHP / php-ios | — | TCP, MultipeerConnectivity, BLE GATT |
| Android arm64 | Phphone / NativePHP | — | TCP, BLE GATT, NSD |
Linux、macOS、BSDでは、サーバーは数千のCOWフォークワーカーをワーカーあたり約120KBで実行します。Windowsでは、サーバーはqbix_fork.dllを同梱しており、これはPHPのFFI拡張機能を通じてRtlCloneUserProcessを使用し、POSIXプラットフォームと同じメモリ効率で完全なCOWフォークセマンティクスを提供します。FFIまたはDLLが利用できない場合、サーバーはphp-cgiサブプロセスにフォールバックします(COWなし、ワーカーあたりのメモリ使用量が多いが、完全に機能します)。iOSとAndroidでは、PHPランタイムはネイティブアプリシェルに埋め込まれており、TransportManagerがピア検出とトランスポートネゴシエーションを自動的に処理します。
PHP 8.6+ (epoll/kqueue): サーバーはPHP 8.6のネイティブIoPoll APIを自動検出して使用し、Linuxではepoll、macOSではkqueueをイベント通知に使用します — PECL拡張機能は不要です。古いPHPバージョンでは、サーバーはstream_selectを使用します(これは問題なく動作しますが、ティックあたりO(n)ではなくO(1)です)。Revoltもインストールされていればサポートされます。
GitHub Actions CIは、Linux x86_64、Linux aarch64、macOS arm64、Windows x64、FreeBSD 14、および実験的なAndroidとiOSターゲットでビルドおよびテストを行います。464テスト、0失敗。
要件
Linux / macOS (推奨):
- PHP 8.1以降
- 拡張機能:
sockets,pcntl(シグナル+ワーカー用),openssl(HTTPS用)
# 確認
php -m | grep -E 'sockets|pcntl|openssl'
# Ubuntu/Debianでのインストール
sudo apt install php-cli php-sockets
静的バイナリの場合: 不要です。PHPランタイムが含まれています。
Windows: サーバーは、qbix_fork.dll + FFIが利用可能な場合を除き、シングルスレッドモード(--workers=0のみ)で実行されます。静的ファイル、PHPスクリプト、WebSocket、キャッシング、圧縮、アクセス制御 — すべて機能します。pcntlなしでは、フォークごとのリクエスト分離とシグナルベースの正常終了を失います。開発には適していますが、本番環境ではLinuxまたはmacOS(またはWSL)を使用してください。
📦 3つの実行方法
1. ソースから (PHP 8.1+ が必要)
php qbixserver.php --root=./web --port=8080
2. PHAR — 単一ファイル (PHPが必要)
php bin/qbixserver.phar --root=./web --port=8080
# または実行可能にする
chmod +x bin/qbixserver.phar
./bin/qbixserver.phar --port=8080
3. 静的バイナリ — PHP不要
# GitHub Releasesからダウンロード
chmod +x qbixserver-linux-x86_64
./qbixserver-linux-x86_64 --root=./web --port=8080
このバイナリは、PHP 8.3 + 拡張機能を約15MBの単一実行ファイルにバンドルしています。任意のLinuxまたはmacOSマシンにコピーして実行できます。依存関係はありません。
🔨 ビルド
PHARのビルド
php -d phar.readonly=0 build-phar.php
# 出力: bin/qbixserver.phar
静的バイナリのビルド
# Dockerを使用 (最も簡単):
./build-binary.sh --docker
# ローカルにstatic-php-cliをインストールしてビルド:
./build-binary.sh
# 出力: bin/qbixserver (~15MB)
バイナリはstatic-php-cliを使用してビルドされ、PHP + 拡張機能を静的リンクされたバイナリにコンパイルします。
GitHub Actionsは、タグ付きリリースごとにLinux x86_64、Linux ARM64、macOS x86_64、およびmacOS Apple Silicon用のバイナリを自動的にビルドします。
例
6つのサンプルアプリがexamples/に含まれています:
| アプリ | 内容 |
|---|---|
| todo | SQLite CRUD、REST API、静的HTML |
| counter | SQLite永続化、GET/POST |
| chat | WebSocketルーム、Socket.IO、8つのハンドラファイル |
| stream | Server-Sent Events、AIトークンストリーミング |
| swarm | Q::event()ディスパッチ、クラスタレプリケーション |
| collab | コラボレーティブ編集 |
php qbixserver.php --root=examples/todo/web --port=8080
他のサーバーからの移行
すでにnginx、Apache、またはCaddyを実行していますか?これらのガイドは設定マッピングを示しています:
- nginxからの移行 — サーバーブロック、try_files、proxy_pass、gzip
- Apacheからの移行 — .htaccessは変更なしで動作、VirtualHost → ドメイン設定
- Caddyからの移行 — 自動HTTPS、オンデマンドTLS → autohost
シングルバイナリ配布
アプリを1つの実行可能ファイルにパッケージ化します — PHPランタイム、Webサーバー、そしてあなたのすべてのコード。バイナリにはSQLiteの自動プロビジョニングが含まれています:アプリが.sqliteファイルをバンドルしている場合、サーバーは初回実行時にデータディレクトリにそれをコピーし、フレームワーク設定をそれにポイントするように書き込みます。外部データベースは不要です。
Qbix (プラグインを検出し、各プラグインのプレフィックスを持つlocal/app.jsonを書き込みます)、Laravel (.env)、Symfony (.env)、WordPress (wp-config.php + wp-sqlite-db)、Craft CMS、Drupalで標準でサポートされています。
バイナリにECDSA P-256キー(M-of-N閾値)で署名し、Sigstore Rekorに公開して独立した検証を行い、バイナリをzipファイルとして編集してカスタマイズできます。
- バイナリのビルドと配布 — パッケージ化、署名、検証、カスタマイズ、プラットフォームコード署名
メッシュネットワーキング
すべてのQbix Serverインスタンスは暗号学的ID(ECDSA P-256、Ethereumと同じセキュリティモデル)を持っています。2つのサーバーが発見されると — Bluetooth、Wi-Fi、またはTCP経由で — ECDHハンドシェイクを実行し、AES-256-GCM暗号化セッションを確立します。すべてのトラフィックはエンドツーエンドで暗号化され、リレーノードを経由しても同様です。
// 近くのサーバーと通信 (トランスポートは自動)
$response = Q::handleUsingRemote('qbix-peer://' . $peerId . '/api/data');
// ピアに応答
Q_WebServer_Transport::onPeerOnline(function ($peer) {
// データを同期、メッセージ交換、調整
});
マルチホップルーティングは、直接接続を超える範囲を拡張します。ルーターはHELLO/BYE/HEARTBEAT伝播、TTL制限、重複排除を備えた距離ベクトルルーティングを使用します。中間ノードは、読み取れない暗号化されたペイロードをリレーします。
データ同期はピアが接続すると自動的に実行されます:ブルームフィルタ交換で何が異なるかを特定し、その後、欠落しているレコードのみが転送されます。大規模データセット(10,000件以上のレコード)の場合、プロトコルはprollyツリー比較に切り替わります — 完全に同一なサブツリーはスキップされる決定論的なコンテンツアドレス指定ツリーです。
完全なプロトコル仕様、エッジケース、セキュリティ分析についてはdocs/Mesh.mdを参照してください。
モバイル
Qbix Serverは、iOSとAndroidでネイティブアプリとして動作します。Swift (iOS) または Kotlin (Android) のシェルが埋め込みPHPサーバーを127.0.0.1で起動し、WebViewをそれにポイントし、ピアツーピアトランスポートを処理します。PHPプロセスは、デスクトップまたはVPSと同じようにQbixアプリをそのまま実行します — Cordova、Capacitor、JavaScriptブリッジは不要です。
ネイティブのTransportManagerは、利用可能なすべてのチャネルで近くのピアを発見し、最適なトランスポートを自動的に選択します:
| 優先度 | トランスポート | 帯域幅 | プラットフォーム |
|---|---|---|---|
| 1 | TCP (LAN) | 100+ Mbps | iOS + Android |
| 2 | MultipeerConnectivity | 2–25 Mbps | iOSのみ |
| 3 | BLE GATT | 約2 Mbps | iOS + Android |
Wi-Fiが切断されても、トラフィックはBLEにシームレスにフォールバックします。PHPサーバーは、トランスポートに関係なく、localhost上のHTTPとして認識します。
バックグラウンド永続化:iOSはサイレントAVAudioEngineセッションを使用します(App Storeの前例: PocketServer, BitChat)。AndroidはSTART_STICKYを持つフォアグラウンドサービスを使用します。
モバイルプロジェクトの準備
コントロールパネルでアプリを選択し、準備をクリックしてiOSまたはAndroidプラットフォームを選択します。これにより、apps/YourApp/mobile/ios/またはapps/YourApp/mobile/android/の下にネイティブプロジェクトのスケルトンが生成され、すべてのSwift/Kotlinソースファイル、マニフェスト、ビルド設定、およびPHPバイナリまたはpharを配置するServer/ (iOS) またはassets/ (Android) ディレクトリが含まれます。
iOS向けビルド
- CIリリース成果物から
qbixserver-ios-arm64マイクロバイナリを取得するか、ローカルでstatic-php-cliを使用してビルドします。シミュレーターテストの場合、qbixserver.pharをServerディレクトリに配置するだけで、PhpBridgeはmacOS上のシステムPHPにフォールバックします。 - Xcodeプロジェクトを生成します:
cd apps/YourApp/mobile/ios && xcodegen generate .xcodeprojを開き、署名チームを設定してビルドします。
配布のために、Xcodeでアーカイブし、Organizerまたはxcodebuild -exportArchive経由でApp Store Connectにアップロードします。署名、TestFlight、App Store提出を含む完全なウォークスルーについては、mobile/iOS.mdを参照してください。
Android向けビルド
- CIリリース成果物から
qbixserver-android-arm64マイクロバイナリを取得するか、Android NDKを使用してローカルでクロスコンパイルします。デバッグテストの場合、qbixserver.pharも機能します。 - バイナリ(またはphar)を
app/src/main/assets/に配置します。 - ビルドします:
cd apps/YourApp/mobile/android && ./gradlew assembleDebug(Playストアの場合はbundleRelease)。
配布のために、リリースAABに署名し、Google Play Consoleにアップロードします。キーストア設定、署名、Playストア提出を含む完全なウォークスルーについては、mobile/Android.mdを参照してください。
詳細情報
- mobile/README.md — トランスポートレイヤーアーキテクチャ、BLE GATTサービス定義、チャンキングプロトコル、プラットフォーム要件
- mobile/iOS.md — PhpBridge、xcodegen、バックグラウンド永続化、署名、TestFlight、App Store
- mobile/Android.md — PhpBridge、Gradle、フォアグラウンドサービス、署名、Playストア
🔌 Qbix Platformと連携
Qbix ServerはQbix Platformから抽出されたものです — リアルタイムストリーム、ユーザー管理、プラグインアーキテクチャを備えたソーシャルアプリ構築のためのフルスタックフレームワークです。
Qbixアプリがある場合、サーバーはフルフレームワークを使用します:
php qbixserver.php --app=/path/to/myapp --port=8080
このモードでは:
- リクエストは
Q_Dispatcher— フル Qbix イベントパイプライン — を通じてルーティングされます。 - プラグインが自動的にロードされます(Users、Streams、Assetsなど)。
- クリーンURLが機能します(
/community/123→ モジュールルーティング)。 - 静的ファイルは引き続き高速パスを使用します(フレームワークオーバーヘッドなし)。
- ダッシュボードにはQbix固有の統計情報が表示されます。
スタンドアロンモード(--appなし)は、プレーンなWebサーバーとして実行されます — フレームワークなし、プラグインなし。PHPファイルは直接実行され、静的ファイルはメモリからサービスされます。これはシンプルなサイト、API、またはフル Qbix スタックを必要としない任意のプロジェクトに使用します。
詳細については、--app モードとSAPI内部を参照してください。
🏗️ アーキテクチャ
HTTPリクエスト ────→ │ イベントループ │ stream_select (依存関係なし)
│ (シングルスレッド) │ または amphp/revolt (オプション)
└────────┬─────────┘
│
┌───────────────┼───────────────┐
│ │ │
┌────▼─────┐ ┌────▼─────┐ ┌────▼─────┐
│ 静的 │ │ PHP │ │ WebSocket │
│ ファイル │ │ ディスパッチ │ │ アップグレード │
│ │ │ │ │ │
│ インメモリ│ │ インプロセス│ │ RFC 6455 │
│ レスポンス│ │ またはフォーク│ │ フレーム │
│ キャッシュ│ │ プール │ │ │
└──────────┘ └──────────┘ └──────────┘
静的ファイルはインメモリレスポンスキャッシュからサービスされます。完全なHTTPレスポンス(ヘッダー+ボディ)は事前に構築され、単一のfwrite()呼び出しで送信されます。キャッシュは設定可能なチェック間隔でmtime検証されます。TCP_NODELAYと組み合わせることで、サブミリ秒の応答時間を提供します。
PHPスクリプトは、インプロセス(シングルスレッド、軽量APIに適しています)またはプリフォークワーカープール(--workers=N)で実行され、PHPの同時実行を可能にします。ワーカーはクラス事前ロード後にフォークされるため、コピーオンライトページを通じてベースメモリフットプリントを共有します。
nginx(55–73%)との残りのギャップは本質的なものです:nginxはsendfile()(カーネル空間のファイル→ソケットコピー)、epoll(O(1)イベント通知)、およびコンパイル済みCを使用します。PHPのstream_selectはselect(2)であり、ファイルサービスはユーザースペースを通過し、すべての操作にはインタープリタのオーバーヘッドがあります。純粋なインタープリタPHPからCパフォーマンスの55–73%に到達することは、可能な限り最良の結果です。
🌐 HTTP/2 サポート
組み込みイベントループはstream_selectを使用します — 依存関係なし、どこでも動作します。しかし、amphpをインストールすると、サーバーはコード変更なしで完全なHTTP/2サーバーにアップグレードします:
composer require amphp/http-server amphp/socket
php qbixserver.php --port=8443
| HTTP/1.1 (組み込み) | HTTP/2 (amphp) | |
|---|---|---|
| ページロードあたりの接続数 | 約6並列 | 1マルチプレックス |
| ヘッダーオーバーヘッド | リクエストごとのフルヘッダー | HPACK圧縮 |
| イベントループ | stream_select (ポータブル) | Revolt経由のepoll/kqueue |
| TLS | stream_socket_enable_crypto | amphpネイティブTLS |
| サーバープッシュ | なし | あり (ブラウザが要求する前に静的アセットをプッシュ) |
サーバーはクリーンな2層アーキテクチャを持っています。Q_WebServer::route()はすべてのリクエストロジック(静的ファイル、PHPディスパッチ、キャッシュ、アクセス制御)を処理し、[status, headers, body]配列を返します。トランスポートレイヤーはプラグイン可能 — どちらのトランスポートも同じルーティング、キャッシング、アクセス制御ロジックを使用します。
いずれの場合も: Cloudflare、CloudFront、またはnginxをリバースプロキシとして前に配置できます。CDNはHTTP/2(およびHTTP/3)を終了し、HTTP/1.1をバックエンドに転送します。
なぜPHPか
すべてのWebサーバーは、パフォーマンスと分離性のトレードオフに直面します。永続プロセスサーバー(Node、Go、Java、Python WSGI、PHP-FPM、Swoole)は、ワーカーをリクエスト間で稼働させ続けます — 高速ですが、メモリリークが蓄積し、あるリクエストのデータ(秘密情報を含む)が共有アドレス空間を通じて別のあるリクエストに到達する可能性があります。プロセスごとのリクエストサーバー(CGI)は、各リクエストにクリーンなプロセスを提供します — 安全ですが、各プロセスは30〜60MBのコストがかかり、開始にミリ秒かかります。
OSの唯一のメカニズムで、このトレードオフを排除するのがコピーオンライトfork()です:親はアプリケーションを事前ロードし、各リクエストは独自の住所空間を持つフォークされた子を取得し、カーネルはメモリページを共有します、子がそれらに書き込むまで。ワーカーあたりのコスト:約120KB。起動時間:マイクロ秒。分離性:絶対 — 子の住所空間は、終了時にOSによって回収されるため、リークは蓄積できず、秘密情報はリクエスト間で到達できません。
COWフォークは、コンパクトなヒープとリクエストごとの共有なしセマンティクスを持つインタープリタを必要とします。PHPは、これら両方の特性を持つ唯一の主要言語であり、数百万の既存のWebアプリケーションがすでに1リクエスト→終了モデルを想定しています。だからこそ、このサーバーはPHPで書かれています。OwnCloud、WordPress、Magento、Drupal、Symfony、Laravel、そしてQbixを含む数千の既存のWebアプリケーションを実行できます。
php-fpmの問題点
opcacheが有効かどうかにかかわらず、本番PHPコードの大部分はI/Oバウンドです。ワーカーはデータベース、ファイルシステム、API呼び出し、キャッシュサーバーを待ちます。その待ち時間の間に、ワーカーは何もしていませんが、30〜60MBのRAMを保持しています。それがボトルネックです。4GBサーバーでは、php-fpmはせいぜい80ワーカーしか得られません。それぞれが200msのクエリでブロックするため、約400 req/sになります。それが上限です。Qbixは純粋なPHPサーバーです。各リクエストはCOWフォークを通じて独自のプロセスで実行されます — OS強制の分離により、メモリリークが蓄積できず、秘密情報がリクエスト間で漏洩しないようになります。ワーカーあたり120KBで、50MBではなく。
Swoole、RoadRunner、FrankenPHPの問題点
これらはPHPをNode.jsのようにイベント駆動にすることで解決しようとします。Swooleのコルーチンは、単一ワーカー内でI/Oを多重化できます — ただし、コードをSwooleCoroutineMySQL、SwooleCoroutineHttpClientなどに書き換える必要があります。すべてのPDO::query()、すべてのfile_get_contents()、すべてのcurl_exec()は、WordPressプラグイン、Laravelパッケージ、Drupalモジュールで使用されるブロッキングI/Oです。これはyieldしません。Swooleは協力しないコードを助けることはできません。RoadRunnerとFrankenPHPはコルーチンを試みさえしません — それらはfpmと同じワーカー数制限モデルを使用します。
Qbixが解決する方法
各ワーカーがより多くのことをするのではなく、Qbixはより多くのワーカーを実行します。サーバーは親プロセスにフレームワーク全体をロードし、次にpcntl_fork()を呼び出します。カーネルはすべてのページをコピーオンライトとしてマークします。各ワーカーは親のロード済みクラスを共有し、実際に書き込むページのみをコピーオンライトで負担します。WordPressのようなリクエストは30ページを汚染します = 120KB。したがって、同じ4GBはfpmに80ワーカーを与えるのに対し、Qbixには数千のワーカーを与えます。
コードは2つのモードで変更なしで実行されます:
永続ワーカー (デフォルト) — ワーカーはリクエスト間で存続します。各リクエスト間では、Reflectionベースのスナップショットが0.03msで全てのスタティックプロパティを復元します。27のPHP関数(header(), session_start(), ini_set(), set_error_handler()など)は、正しくリセットされるようにソース変換を通じてシムされています。これにより、CPUバウンドな作業で2,294 req/s、I/O下で1,060 req/sを実現できます。
フォークごとのリクエスト — 永続モードがコードに適合しない場合(内部スタティック変数を持つ関数、シムが追跡できない方法でグローバル状態を登録するプラグイン)、forkPerRequest: trueを設定します。各リクエストは新しいフォークを取得します。これは永続モードよりも遅いですが、フォークされたワーカーは依然として50MBではなく120KBしかコストがかからないため、同じハードウェアでfpmよりも100倍多く実行できます。これがすべてです — 十分なワーカーがあればブロッキングI/Oは問題ではなくなり、COWは「十分なワーカー」をほぼ無料にします。
なぜこれが速度よりも重要なのか
フォークモデルは、永続プロセスサーバーが提供できないものを提供します:ハードウェアで強制されるリクエスト間の分離。
メモリリークは蓄積できません。 Swoole、RoadRunner、またはその他の永続プロセスサーバー(Node、Go、Python WSGI)では、リクエスト処理中のメモリリークはリクエストごとに増加し、ワーカーがリサイクルされるまで続きます。Laravelコントローラーがunsetを忘れた配列を割り当てた場合、そのメモリは次のリクエスト、その次のリクエストのために割り当てられたままになります。ワーカーのリサイクルは、それが悪化するのを制限しますが、それを防ぐことはできません。Qbix Serverでは、子プロセスは1つのリクエストを処理し、exit()を呼び出します。OSはアドレス空間全体を回収します。同じプロセスで「次のリクエスト」はありません。親のメモリは変更されません — COWは、子の書き込みが決して親に伝播しないことを意味します。
秘密情報はリクエスト間で漏洩しません。 永続プロセスサーバーでは、リクエストAの変数はリクエストBと同じアドレス空間に存在します。リクエストAがクレジットカード番号を処理し、ハンドラにバグがあった場合 — 変数をクリアしない、プロパティに保存する、デバッグバッファにログを記録する — リクエストBのハンドラがそれを読み取ることができます。メモリダンプには、両方のリクエストのデータが混在しています。フォークごとのリクエストでは、リクエストAはプロセス17432で実行され、リクエストBはプロセス17433で実行されます。それらは別々のアドレス空間を持っています。BがAのメモリを読み取るメカニズム — バグ、設定ミス、競合状態 — は存在しません。なぜなら、プロセスが終了したときにAのアドレス空間はカーネルによって回収されたからです。これはChromeのサイト分離の背後にあるのと同じ分離原則であり、オペレーティングシステムが別々のユーザーに別々のアドレス空間を使用する理由です。
他のすべてのPHP実行モデルは、選択を迫ります:FastCGI/Swoole/RoadRunnerはパフォーマンスを提供しますが、分離性を犠牲にします。従来のCGIは分離性を提供しますが、パフォーマンスを犠牲にします。COWフォークトリックは、両方を提供する唯一のアーキテクチャです — 永続サーバーのパフォーマンス(事前ロードされた親、マイクロ秒フォーク、ワーカーあたり120KB)とCGIの安全性(各リクエストは終了後に終了するクリーンプロセスを取得します)。
これは、セキュリティを重視したデプロイメントにおける真の議論です。信頼できないPHPプラグイン、監査されていないサードパーティテーマを持つWordPress、レビューされていないレガシーコードを実行できます — そして、あるリクエスト処理中のバグが別のあるリクエストのデータに影響を与えることはできません。なぜなら、OSが境界を強制するからです。
📄 ライセンス
MIT — 自由に利用してください。
Qbix Platformの一部です。
私たちはPHPコアにswitch_global_context()を提案しました。それがRFCプロセスを経ていく間、サーバーは今日ユーザーランドでそれを実行します。