PHPTS 2.0.13 版本更新:新增事件触发任务
2026年11月19日发布的 PHPTS 2.0.13,新增「事件触发任务」模块:WebSocket、TCP、MQTT、串口、定时器五类事件源统一接入内置 Rust 事件网关,由 PHP 脚本处理事件并原路应答;配合 phpts_kv 进程间共享键值存储与 Server → Client 主动推送接口,任意普通 PHP 页面都能向在线客户端、TCP 连接或串口主动推送消息。本文覆盖三分钟上手、脚本约定、主动推送闭环、定时器防重入与五个调试助手等细节。
前言
PHPTS 2.0.13 于2026年11月19日正式发布,安装包下载地址:https://down.phpts.com/phpts.zip
2.0.13 版本(2026-11-19)更新说明:
- 1、增加「PHP FastCGI(任务)」进程池管理器,一组独立于 Web 业务的 PHP 8.5 FastCGI 进程池,作为事件处理的专属引擎。当事件发生时,PHPTS 将任务直接指派给内存中待命的 PHP 进程,规避了进程冷启动开销,确保了事件处理的高效与即时;
- 2、新增「事件触发任务」网关: 以 Windows IOCP 异步非阻塞方式统一承接 WebSocket 长连接、TCP 长连接、MQTT 订阅、串口和秒级定时器等 I/O 事件,网关通过 FastCGI 将事件投递到 PHP-CGI 任务进程池,由 PHP 脚本执行具体业务,形成"Rust 网关负责高并发事件接入与调度、PHP 专注短时业务处理"的解耦架构;用你熟悉的 PHP 脚本处理每一条事件——不用自己写 socket 服务器,不用维护常驻 PHP 进程,连接管理、分帧、心跳、TLS 全部交给内置的 Rust 事件网关;
- 3、新增 phpts_kv 进程间共享键值存储 PHP 扩展,结合(Server → Client)主动推送接口,普通 Nginx + PHP 网站页面也能随时向在线的指定 WebSocket、TCP 客户端、或串口主动推送数据;
- 4、优化 CPU 使用率,去掉呼吸灯动画,采用静态指示灯,UI 无变化时,GPU进程的CPU占用降到 0%;
- 5、顶部任务栏服务状态指示灯,换成了客户端工具图标,支持鼠标长按,左右拖拽更改位置;
- 6、左侧任务列表、工具列表,支持鼠标长按,上下拖拽更改位置;
- 7、修复电子邮局第三方 IMAP 客户端链接删除邮件失败的 BUG;
- 8、修复文件传输器大文件上传中断的 BUG;
- 9、修复 MySQL 数据库 root 密码重置失败的 BUG。
本次版本最大的亮点,是全新模块「事件触发任务」:把 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 传入脚本。
二、三分钟上手
- 打开侧栏「工具」组的「事件触发任务」页(总览仪表盘也有状态卡片与入口)。页面共六个 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= 自定义身份,不带则自动分配 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 推送接口(默认 127.0.0.1:3379,可独立启停、可设权限 Token),按 URI 前缀区分投递目标:/ws/send(WebSocket text 帧)、/tcp/send(TCP 原始字节)、/serial/send(串口原始字节),三者均支持 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"
四、定时器:四种触发方式与防重入
定时器不再只有「间隔秒」一种形态:间隔 / 每天 / 每周 / 每月任选,每天/每周/每月按本地墙钟到点触发(每周可选星期、每月可选几号,2 月没有 31 号自然跳过);「防重入」逐规则可配,开启时上一轮未返回即跳过本轮,关闭则到点照常触发。脚本请求体为空、附加参数走 $_GET,输出只写网关日志,适合心跳上报、过期清理、日报生成等后台作业。旧版间隔规则升级后行为逐字不变。
五、调试助手与可靠性细节
- 五个调试助手:主动推送 / WebSocket 客户端 / TCP 客户端 / MQTT / 串口,页头右侧一键打开,「先连上、再推送」闭环验证;弹窗可最小化到顶栏任务栏,随时恢复会话。
- 事件触发网关日志按钮:实时跟随当天日志(每天一个文件),排查委托问题不用翻目录。
- 端口占用预检:启动前查监听端口占用者并点名报错(含仅 bind 未 listen 的隐蔽占用);串口启动前预检占用,先认「串口调试助手」自己人,再判其它程序。
- 配置热生效:保存后网关即时重载,改规则不用重启进程;中文规则名原样保留。
- 进程级隔离:单个子服务崩溃只标异常不团灭网关;网关与任务池启停语义独立,页面有依赖提示。
六、其它更新
- 网络存储映射 / 文件传输器大文件上传修复:本地代理 PUT 接收改为流式落盘,17GB 级上传不再撞「4GB 内存墙」中途失败;上传取消链路补回归锁,传输中取消即时生效。
- 事件委托默认超时由 30 秒调整为 300 秒,长任务脚本更从容(仍可全局 / 单规则覆盖)。
七、升级说明
官网下载 2.0.13 安装包或使用内置更新升级即可,旧配置自动兼容。「事件触发任务」当前带 beta 标识,欢迎在使用中反馈问题与建议。
评论 共 1 条