PHPTS 2.0.13 バージョンアップデート:イベントトリガータスクを追加
2026年11月19日にリリースされた PHPTS 2.0.13 では、「イベントトリガータスク」モジュールを新たに追加しました。WebSocket、TCP、MQTT、シリアルポート、タイマーの5種類のイベントソースを内蔵 Rust イベントゲートウェイに統合し、PHP スクリプトがイベントを処理して元の経路で応答します。さらに、プロセス間共有キーバリューストア phpts_kv と Server → Client プッシュインターフェースにより、通常の PHP ページからでもオンラインクライアント、TCP 接続、シリアルポートへ能動的にメッセージをプッシュできます。本記事では、3分で始める方法、スクリプト規約、プッシュの閉ループ、タイマーの再入防止、5つのデバッグアシスタントなどの詳細を解説します。
はじめに
PHPTS 2.0.13 は2026年11月19日に正式リリースされました。インストールパッケージのダウンロードURL:https://down.phpts.com/phpts.zip
2.0.13 バージョン(2026-11-19)更新内容:
- 1、Web 業務から独立した PHP 8.5 FastCGI プロセスプールをイベント処理専用エンジンとして提供する「PHP FastCGI(タスク)」プロセスプールマネージャーを追加。イベント発生時、PHPTS はメモリ上で待機している PHP プロセスにタスクを直接割り当て、プロセスのコールドスタートによるオーバーヘッドを回避し、イベント処理の高効率化と即時性を確保します;
- 2、「イベントトリガータスク」ゲートウェイを追加:Windows IOCP の非同期ノンブロッキング方式で、WebSocket 長接続、TCP 長接続、MQTT サブスクリプション、シリアルポート、秒単位タイマーなどの I/O イベントを一元的に受け付けます。ゲートウェイは FastCGI を介してイベントを PHP-CGI タスクプロセスプールに投入し、PHP スクリプトが具体的な業務を実行します。これにより"Rust ゲートウェイが高並列イベントの接続とスケジューリングを担当し、PHP は短時間の業務処理に専念する"という疎結合アーキテクチャを実現します;使い慣れた PHP スクリプトで各イベントを処理できます——自分で socket サーバーを書く必要はなく、常駐 PHP プロセスを維持する必要もありません。接続管理、フレーミング、ハートビート、TLS はすべて内蔵の Rust イベントゲートウェイに任せられます;
- 3、プロセス間共有キー・バリューストア PHP 拡張 phpts_kv を追加。(Server → Client)プッシュインターフェースと組み合わせることで、通常の Nginx + PHP ウェブサイトページからも、オンラインの指定 WebSocket、TCP クライアント、またはシリアルポートへいつでも能動的にデータをプッシュできます;
- 4、CPU 使用率を最適化し、呼吸ライトアニメーションを廃止して静的インジケーターライトを採用。UI に変化がない場合、GPU プロセスの CPU 使用率を 0% まで低減;
- 5、上部タスクバーのサービス状態インジケーターライトをクライアントツールアイコンに変更し、マウスの長押しと左右ドラッグによる位置変更に対応;
- 6、左側のタスクリスト、ツールリストが、マウスの長押しと上下ドラッグによる位置変更に対応;
- 7、電子メールサーバーでサードパーティ IMAP クライアント接続によるメール削除が失敗するバグを修正;
- 8、ファイルトランスファーで大きなファイルのアップロードが中断されるバグを修正;
- 9、MySQL データベースの root パスワードリセットが失敗するバグを修正。
今回のバージョン最大のハイライトは、新モジュール「イベントトリガータスク」です:WebSocket、TCP、MQTT、シリアルポート、タイマーの五種類のイベントソースを PHPTS に統合し、使い慣れた PHP スクリプトで各イベントを処理できます——自分で socket サーバーを書く必要はなく、常駐 PHP プロセスを維持する必要もありません。接続管理、フレーミング、ハートビート、TLS はすべて内蔵の Rust イベントゲートウェイに任せられます。
新版のphpts_kv プロセス間共有キー・バリューストア拡張と(Server → Client)プッシュインターフェースを組み合わせることで、通常の Nginx + PHP ウェブサイトページからも、オンラインクライアント、TCP 接続、またはシリアルポートへいつでも能動的にデータをプッシュできます。以下で機能と使い方を一度に解説します。
一、イベントトリガータスクとは
このモジュールは独立したゲートウェイプロセス phpts-event.exe によって提供されます:長接続とイベントソースはすべて Rust が保持し(WebSocket / TCP は IOCP 非同期 I/O を使用)、PHP はステートレスな論理実行ユニットにすぎません——イベントが届くたびに、ゲートウェイは FastCGI プロトコルを介してそれを「PHP FastCGI (タスク)」プロセスプールに委託し、あなたがバインドしたスクリプトを実行します。スクリプトの出力は元の経路でクライアントに書き戻されます。単一のサブサービスに異常が発生しても影響はそれ自体にとどまり、ゲートウェイ全体を停止させることはありません。
五つのイベントソースには、それぞれ独立した起動 / 停止 / 再起動ボタンがあり、PHPTS の起動に合わせて自動起動できます:
- WebSocket サーバー:ws:// と wss:// のデュアルリスニング、TLS 証明書はページからワンクリック申請(DNS 検証)または証明書ライブラリからワンクリック配備が可能;サーバー側ハートビート Ping は設定可能;「パス」に応じて異なる PHP スクリプトへルーティング。
- TCP サーバー:複数ポートを同時にリッスンし、各ポートがそれぞれのスクリプトにバインド;三種類のフレーミング方式——idle サイレントマージ(デフォルト 50ms のサイレントウィンドウ、設定可能)、line 区切り文字によるフレーム分割、none 生バイトセグメント。粘着パケットや半パケットを自分で処理する必要はありません。
- MQTT サブスクリプション:+ / # ワイルドカードトピックに対応し、内蔵 NanoMQ または外部 broker に接続可能;ルールに「応答トピック」を設定でき、スクリプト出力は自動的にそこへ発行されます。
- シリアルポート監視:RS232 / RS485 / TTL デバイスの接続、複数シリアルポートの同時監視;ボーレート、データビット、ストップビット、パリティビットをポートごとに設定可能;「応答をシリアルポートへ書き戻す」を有効にすると、スクリプト出力がそのままデバイスへ書き戻され、上位機の応答シナリオですぐに利用可能。
- タイマー:間隔 / 毎日 / 毎週 / 毎月の四種類のトリガー方式、「再入防止」スイッチ(前回の実行が完了していない場合は今回の実行をスキップ、デフォルトで有効)、追加パラメータは QUERY_STRING としてスクリプトに渡されます。
二、3分で始める
- サイドバーの「ツール」グループにある「イベントトリガータスク」ページを開きます(概要ダッシュボードにもステータスカードと入口があります)。ページには合計六つの Tab があります:「グローバル委託設定とプッシュサービス」+ 五つのサブサービス。
- 該当する Tab で「ルールを追加」をクリックします:WebSocket はパス、TCP はポート、MQTT はトピック、シリアルポートは COM ポート、タイマーはトリガー方式を入力します;「PHP スクリプト」列にはデフォルトで同梱のデモスクリプト(data/taskdemo/ 配下の五つの例)が事前入力されており、「選択…」で自分のスクリプトに差し替えるか、「編集」をクリックして直接開いて変更できます。
- 「起動」をクリックします(本ページの設定を自動保存してからサービスを起動・停止します)。ページヘッダー右側のデバッグアシスタントでクライアントに接続してメッセージを送信すると、PHP スクリプトの応答が元の経路で返ってくるのが確認できます。
スクリプト側の約束事は非常にシンプルです:php://input でイベント本文を読み、$_SERVER['PHPTS_EVENT_*'] でメタデータを取得し、echo の出力がそのまま応答になります。例(WebSocket ルーティングスクリプト):
<?php
// クライアントから送信されたメッセージ全体を読み取る(JSON とプレーンテキストの両方に対応)
$msg = file_get_contents('php://input');
$data = json_decode($msg, true);
if (json_last_error() !== JSON_ERROR_NONE) { $data = ['text' => $msg]; }
// 業務名をキーとして、現在の接続 ID を共有メモリに登録し、Web ページが後から能動的にプッシュできるようにする
if (function_exists('phpts_kv_set')) {
phpts_kv_set('user:1001', $_SERVER['PHPTS_EVENT_CLIENTID'], 3600);
}
// クライアントが終了を要求:取り決めの値を出力し、ゲートウェイがこの接続を能動的に閉じる(close 1000)
if (($data['cmd'] ?? '') === 'QUIT') { echo '__PHPTS_CLOSE__'; return; }
// 出力がそのまま応答:text フレームとして元の接続を介してクライアントへ送り返す
echo json_encode(['type' => 'reply', 'msg' => 'received']);
利用可能なメタデータ一覧:
- PHPTS_EVENT_CLIENTID:現在の接続 ID(WebSocket / TCP)。クライアントはハンドシェイク時に ?client_id= を付けてカスタム ID を指定でき、指定しない場合は ws- / tcp- プレフィックスの ID が自動割り当てされます。
- PHPTS_EVENT_CLIENTIP:クライアント IP(ポートを含まない)。アクセス制御や監査ログにそのまま利用できます。
- PHPTS_EVENT_PATH / PHPTS_EVENT_NAME:一致したルーティングパス / ルール名(ルール名は中国語に対応)。
- PHPTS_EVENT_PORT:TCP リスニングポートまたはシリアルポート名;PHPTS_EVENT_TOPIC:MQTT で実際に一致したトピック。
二つの実用的な約束事:WebSocket / TCP スクリプトの出力がちょうど __PHPTS_CLOSE__ と等しい場合、ゲートウェイは現在の接続を能動的に閉じます(認証失敗、クライアントの QUIT などのシナリオを統一的に終了処理);タイムアウトは「グローバル + 単一ルール」の二層構造で、単一ルール 0 = グローバルを継承(デフォルト 300 秒)。タスクプールの PHP 実行制限時間と連動するため、遅いスクリプトが途中で強制終了されることはありません。
三、能動的プッシュ:任意の PHP ページからオンラインクライアントへメッセージを送信
ゲートウェイは常駐の HTTP プッシュインターフェースを 1 つ提供します(デフォルト 127.0.0.1:3379、個別に起動/停止可能、権限 Token を設定可能)。URI プレフィックスで配信先を区別します:/ws/send(WebSocket text フレーム)、/tcp/send(TCP 生バイト)、/serial/send(シリアル生バイト)。3 つとも broadcast ブロードキャストとオンラインリストの照会をサポートします。ターゲット指定ではカンマ区切りの複数 ID をサポートし、さらに key= で phpts_kv キーを直接渡すこともできます。ゲートウェイは自動的にキーを照会して ID を取得し配信します。
典型的なクローズドループ:イベントスクリプト内で phpts_kv_set('user:1001', 连接ID) を登録します(phpts_kv は Windows 名前付き共有メモリベースのプロセス間キー・バリューストア拡張で、Web プールとタスクプールではデフォルトで有効です)。その後、任意の通常 PHP ページ、定期スクリプトがキーで ID を取得してプッシュできます。クライアント切断時、ゲートウェイは共有メモリ内の登録を自動削除します。スクリプトはオフライン時のクリーンアップを気にする必要はありません。
<?php
// 任意の通常の PHP ページ / 定時スクリプト:登録に基づいてプッシュ
$client = phpts_kv_get('user:1001');
if (!$client) { exit('client offline'); } // 切断済み(ゲートウェイが自動で削除)または TTL 期限切れ
$url = 'http://127.0.0.1:3379/ws/send?client=' . urlencode($client) . '&token=你的权限Token';
$ctx = stream_context_create(['http' => [
'method' => 'POST',
'header' => "Content-Type: text/plain\r\n",
'content' => json_encode(['type' => 'notify', 'msg' => 'hello']),
'timeout' => 3,
]]);
echo file_get_contents($url, false, $ctx); // {"ok":true}
コマンドラインも同様に便利です(ページ「グローバル委譲設定とプッシュサービス」Tab 内に、現在の設定に基づいてリアルタイムに組み立てられる curl 例があり、ワンクリックでコピーできます):
curl -X POST "http://127.0.0.1:3379/ws/send?client=ws-1a2b3c4d&token=你的权限Token" -d "hello" curl -X POST "http://127.0.0.1:3379/ws/broadcast?token=你的权限Token" -d "系统公告" curl -X POST "http://127.0.0.1:3379/serial/send?port=COM3" --data-binary "@frame.bin"
四、タイマー:4 種類のトリガー方式と再入防止
タイマーは「間隔秒」だけではなくなりました:間隔 / 毎日 / 毎週 / 毎月から選択でき、毎日/毎週/毎月はローカル時刻に従って時刻になるとトリガーされます(毎週は曜日、毎月は日付を選択可能。2 月に 31 日がなければ自然にスキップされます)。「再入防止」はルールごとに設定可能で、有効時は前回の実行が戻っていなければ今回をスキップし、無効時は時刻になると通常どおりトリガーします。スクリプトのリクエストボディは空で、追加パラメータは $_GET で渡し、出力はゲートウェイログにのみ書き込むため、ハートビート報告、期限切れクリーンアップ、日報生成などのバックグラウンドジョブに適しています。旧版の間隔ルールはアップグレード後も動作がそのまま変わりません。
五、デバッグアシスタントと信頼性の詳細
- 5 つのデバッグアシスタント:アクティブプッシュ / WebSocket クライアント / TCP クライアント / MQTT / シリアル。ページヘッダー右側からワンクリックで開き、「まず接続、次にプッシュ」のクローズドループ検証ができます。ダイアログは上部バーのタスクバーに最小化でき、いつでもセッションを復元できます。
- イベントトリガーのゲートウェイログボタン:当日のログをリアルタイムで追従します(1 日 1 ファイル)。委譲の問題を調査するときにディレクトリを探し回る必要はありません。
- ポート占有の事前チェック:起動前に待受ポートの占有者を確認し、名前を挙げてエラーを報告します(bind のみで listen していない隠れた占有も含む)。シリアル起動前にも占有を事前チェックし、まず「シリアルデバッグアシスタント」による占有かどうかを確認し、その後で他のプログラムかどうかを判定します。
- 設定のホットリロード:保存後、ゲートウェイは即座にリロードし、ルール変更にプロセス再起動は不要です。中国語のルール名はそのまま保持されます。
- プロセスレベルの分離:個々の子サービスがクラッシュしても異常としてマークされるだけで、ゲートウェイ全体が道連れになることはありません。ゲートウェイとタスクプールの起動/停止セマンティクスは独立しており、ページには依存関係のヒントが表示されます。
六、その他の更新
- ネットワークストレージマッピング / ファイル転送ツールの大容量ファイルアップロード修正:ローカルプロキシの PUT 受信をストリーミングでディスク書き込みする方式に変更し、17GB 級のアップロードでも「4GB メモリの壁」にぶつかって途中失敗することがなくなりました。アップロードキャンセル経路に回帰ロックを補い、転送中のキャンセルが即時反映されます。
- イベント委譲のデフォルトタイムアウトを 30 秒から 300 秒に変更し、長いタスクスクリプトでも余裕を持って実行できます(グローバル / 単一ルールで上書き可能)。
七、アップグレード説明
公式サイトから 2.0.13 インストーラーをダウンロードするか、内蔵アップデートを使用してアップグレードできます。旧設定は自動的に互換性が保たれます。「イベントトリガータスク」は現在 beta 表示付きです。使用中に問題や提案があればぜひフィードバックしてください。
インストーラーのダウンロード:https://down.phpts.com/phpts.zip
Comments 1 comments