※ REST-API / RESTful-API サーバー開発にも正式対応
※ IPC（プロセス間通信）・カスタムコマンド作成機能にも対応
SOCKET-MANAGER Frameworkは、WebSocketやTCP/UDPといったリアルタイム通信に加え、
REST-API / RESTful-API サーバー開発にも対応したオープンソースフレームワークです。
本フレームワークは、ゼロコピー設計（Union）と後述するハイパフォーマンスモードにより、
- 100,000 同時接続をサブミリ秒帯（0.52〜0.55ms）で処理
- CPU 割当なし・メモリ 128MB のまま 6 時間耐久・エラーゼロ
- WebSocket / TCP の両方で 18,000〜21,500 rps の実効スループット
という実運用スケールの性能を確認しています。
フレームワーク本体には ビルトインのステートマシンが搭載されており、
リアルタイム通信だけでなく、Chunked Transfer・SSE・Range送信など、
REST-API で必要となる分割送信や状態遷移を伴う処理も効率的に実装できます。
さらに、IPC（プロセス間通信） や カスタムコマンド作成機能 により、
マルチサーバー構成やプロジェクト固有のスキャフォールディングにも柔軟に対応できます。
SOCKET-MANAGER Framework には、ゼロコピー設計（Union）と同期ランタイム、FFI + 独自 IO ドライバを組み合わせた ハイパフォーマンスモード（High Performance Mode） が搭載されています。
最新のスケール性能では、
- WebSocket：100,000 同時接続 / 0.55ms / 18,000〜20,000 rps
- TCP：100,000 同時接続 / 0.52ms / 19,000〜21,500 rps
- CPU ピニングなし・メモリ 128MB のまま 6 時間耐久・エラーゼロ
を達成しており、高負荷時でも安定した高スループット・低レイテンシ・軽量性・堅牢性を同時に満たしています。 また、Windows / Linux の両環境で同一コードが動作し、リアルタイム通信に必要な高性能と堅牢性を PHP で両立します。
詳細はこちら：
https://socket-manager.github.io/document/high-performance.html
SOCKET-MANAGERは、リアルタイム通信を伴うサービス（チャット、ゲーム連携、通知システムなど）に加え、
REST-API / RESTful-API を含む Web API 開発にも対応したフレームワークです。
また、実運用条件で性能検証を行っており、高負荷環境でも破綻しない堅牢性を備えています。
PSR-7準拠のHTTPメッセージ処理、イベントハンドラ、ステートマシン、IPC（プロセス間通信）を統合し、
高速・柔軟・拡張性の高いアプリケーション開発を支援します。
- WebSocket、TCP/UDPを利用したリアルタイム通信の実装テンプレート
- ハイパフォーマンスモード（ゼロコピー + 同期ランタイム + FFI IO）
- WebSocket：100,000 同時接続・0.55ms・18,000〜20,000 rps
- TCP：100,000 同時接続・0.52ms・19,000〜21,500 rps
- CPU 割当なし・メモリ 128MB のまま 6 時間耐久・エラーゼロ
- ラウンド間隔なしの連続バーストでも破綻しない堅牢性
- REST-API / RESTful-API サーバー開発環境（PSR-7準拠）
- ステートマシンを利用したChunked Transfer / SSE / Range送信などの状態遷移処理
- IPC（プロセス間通信）によるマルチサーバー連携・プロセス間メッセージング
- カスタムコマンド作成機能によるプロジェクト固有のスキャフォールディング
- 初期化クラス、UNITパラメータ、プロトコル/コマンドUNITなどの実装ガイド
- マルチサーバー構成やスケールを見据えたアーキテクチャ解説
- マインクラフトと連携するデモ環境、コマンド仕様、設定例
- PHP向けの技術ノウハウ（参照渡し、PHPDoc など）
ハイパフォーマンスモードは、ゼロコピー設計（Union）と同期ランタイム、 FFI + 独自 IO ドライバを組み合わせた高速処理基盤です。
- 100,000 同時接続を 0.52〜0.55ms（サブミリ秒帯）で処理
- 最大 40,521 ラウンド（約 4 億回の往復通信）でもエラーなし
- 10,000 接続維持でも PHP 標準の 128MB 内に収まる軽量メモリ
- Windows でも 50,000 同時接続を 0.43〜0.50ms で処理
- FFI + select互換モードの自動切替
リアルタイム通信に必要な 高性能・堅牢性・再現性 を PHP で実現するための
フレームワーク内蔵モードです。
詳細はこちら：
https://socket-manager.github.io/document/high-performance.html
SOCKET-MANAGER Framework の基盤上に WebSocket プロトコルをステートマシンを使ってビジネスロジック実装した実運用に近い構成で測定したスケール特性を公開しています。
- 100,000 同時接続（ping/pong）で平均 0.553ms
- 18,000〜20,000 rps（10,000 接続あたり 1,800〜2,000 rps）
- CPU 割当なし・メモリ 128MB のまま 6 時間耐久・エラーゼロ
- ラウンド間隔なしの連続バーストでも破綻なし
（※ WebSocket のスケール性能は、ペイロード 100 バイトの ping/pong フレームを用いた測定です）
詳細はこちら：
https://socket-manager.github.io/document/scale-test.html
SOCKET-MANAGER Framework の基盤上に TCP エコー処理をステートマシンで実装した実運用想定の構成で測定したスケール特性を公開しています。
- 100,000 同時接続（TCP echo）で平均 0.525ms
- 19,000〜21,500 rps（10,000 接続あたり 1,900〜2,150 rps）
- CPU 割当なし・メモリ 128MB のまま 6 時間耐久・エラーゼロ
- ラウンド間隔なしの連続バーストでも破綻なし
（※ TCP のスケール性能は、ペイロード 100 バイトの echo 処理を用いた測定です）
詳細はこちら：
https://socket-manager.github.io/document/pure-tcp-scale.html
SOCKET-MANAGER Framework は、REST-API / RESTful-API を構築するための
専用の開発環境（socket-manager/rest-api） を提供しています。
- PSR-7準拠のリクエスト／レスポンス
- イベントハンドラ型 / ステートマシン型の2種類の実装方式
- Chunked Transfer、SSE、Range送信などの分割送信処理
- IPC（サーバー間通信）を含む状態遷移処理
- サンプルプロジェクトによる動作確認
特にステートマシン型は、通常のPHPアプリケーションでは困難な
確実な分割送信（Chunked Transfer） や SSEの再接続処理 を自然に実装できます。
REST-API 開発環境はこちら：
https://github.com/socket-manager/rest-api/
REST-API 開発環境の詳細なドキュメントはこちら：
https://socket-manager.github.io/document/rest-api/
SOCKET-MANAGER Framework は、TCP/UDP/WebSocket などの通信方式を
同一プロセス内で共存させるアーキテクチャを採用しており、
IPC を特別扱いせず自然に実現できます。
- TCP / UDP / WebSocket を組み合わせたプロセス間通信
- Webブラウザ同士の宛先指定メッセージング
- Webブラウザ ⇔ Minecraft 統合版（Bedrock Edition）の双方向通信
- マルチサーバー構成との親和性
- Launcher による統合管理（CUEI/O の “/O” に該当）
詳細はこちら：
https://socket-manager.github.io/document/ipc.html
SOCKET-MANAGER Framework では、ビルトインコマンドに加えて
プロジェクト固有の CLI コマンドを自由に追加できる 拡張機能を提供しています。
- command.php / params.php / template.php.tpl による簡易定義
- プロジェクト固有のスキャフォールディング
- REST API / IPC / ステートマシンユニットの雛形生成
- チーム開発での共通タスク自動化
詳細はこちら：
https://socket-manager.github.io/document/custom-command.html
フルドキュメントはこちら（ホストされた参照ページ）
- フレームワーク紹介: https://socket-manager.github.io/document/
- 設計コンセプト: https://socket-manager.github.io/document/concept.html
- アーキテクチャ: https://socket-manager.github.io/document/architecture.html
- 通信抽象化（Communication）: https://socket-manager.github.io/document/communication.html
- 共有基盤（Union）: https://socket-manager.github.io/document/union.html
- イベント駆動アーキテクチャ（Event）: https://socket-manager.github.io/document/event.html
- IPC（プロセス間通信 / Inter-Process Communication）: https://socket-manager.github.io/document/ipc.html
- カスタムコマンド作成機能: https://socket-manager.github.io/document/custom-command.html
- イベントハンドラ: https://socket-manager.github.io/document/event-handler.html
- マルチサーバー: https://socket-manager.github.io/document/multi-server.html
- WebSocket環境: https://socket-manager.github.io/document/websocket.html
- マインクラフト専用環境: https://socket-manager.github.io/document/minecraft-contents/
（その他のページはサイト内のメニューを参照してください）
- 新規プロジェクトを展開: composer create-project socket-manager/new-project <展開先のディレクトリ名>
- メイン処理クラスを作成: php worker craft:main MainForTest
- サンプルプロジェクト（demo-project）を参考にローカルで動作確認
補足（WebSocketサーバー開発）
- WebSocketサーバーを開発する場合は、専用プロジェクトを利用することを推奨します。WebSocket用の開発テンプレートと設定例を用意しています。
- プロジェクトを展開: composer create-project socket-manager/websocket-project <展開先のディレクトリ名>
- ドキュメント（手順・設定）: https://socket-manager.github.io/document/websocket.html
詳しい手順はドキュメント内の以下のページを参照してください
- 新規開発環境: https://socket-manager.github.io/document/new-project.html
- メイン処理クラス: https://socket-manager.github.io/document/main.html
※ REST-API 開発の場合は以下を参照：
https://github.com/socket-manager/rest-api/
- 初期化クラス: https://socket-manager.github.io/document/init-class.html
- UNITパラメータ: https://socket-manager.github.io/document/unit-parameter.html
- プロトコルUNIT / コマンドUNIT:
https://socket-manager.github.io/document/protocol-unit.html
https://socket-manager.github.io/document/command-unit.html - メイン処理クラス: https://socket-manager.github.io/document/main.html
- 設計コンセプト: https://socket-manager.github.io/document/concept.html
- アーキテクチャ: https://socket-manager.github.io/document/architecture.html
- 通信抽象化: https://socket-manager.github.io/document/communication.html
- 共有基盤: https://socket-manager.github.io/document/union.html
- イベント駆動アーキテクチャ: https://socket-manager.github.io/document/event.html
- IPC（プロセス間通信）: https://socket-manager.github.io/document/ipc.html
- スケーラビリティとマルチサーバー設計: https://socket-manager.github.io/document/multi-server.html
- TCP/UDP 詳細: https://socket-manager.github.io/document/tcp-and-udp.html
- Laravel連携: https://socket-manager.github.io/document/laravel.html
- システム設定ファイル: https://socket-manager.github.io/document/system-setting.html
- カスタムコマンド作成機能: https://socket-manager.github.io/document/custom-command.html
- ハイパフォーマンスモード（大量接続・高速 IO ドライバ）: https://socket-manager.github.io/document/high-performance.html
- WebSocket スケール性能（CPU割当なし・10万同時接続）: https://socket-manager.github.io/document/scale-test.html
- 純粋 TCP スケール性能（CPU割当なし・10万同時接続）: https://socket-manager.github.io/document/pure-tcp-scale.html
- 技術版 ITIL としての CUEI/O: https://socket-manager.github.io/document/itil.html
- library — SOCKET-MANAGER Framework のライブラリ
https://github.com/socket-manager/library/ - demo-project — マインクラフト連携のデモサーバー
https://github.com/socket-manager/demo-project/ - websocket-project — WebSocketサーバー開発環境
https://github.com/socket-manager/websocket-project/ - new-project — 新規開発テンプレート
https://github.com/socket-manager/new-project/ - contents-project — マインクラフト専用コンテンツ環境
https://github.com/socket-manager/contents-project/ - rest-api — REST-API / RESTful-API サーバー開発環境
https://github.com/socket-manager/rest-api/
バグ報告やご要望などはこちらから受け付けております。
本ドキュメントは Creative Commons Attribution 4.0 International (CC BY 4.0) の下で提供されています。
詳細: https://creativecommons.org/licenses/by/4.0/