一个纯 PHP 写的 Socket Server 和 Socket Client 库,由 Workerman 改进而来,作为一个学习的项目而编写。
Choir 内部使用 PHP 原生的 Socket Server 实现了一个 TCP 和 UDP 的服务器,在此基础上实现了 HTTP、WebSocket 等协议,可以使用 Choir 来实现一个纯 CLI 环境下的 Web 应用服务。
Choir 基于部分 Workerman 的代码,功能与 Workerman 相似,但相较于底层的信号处理、包处理以及开放接口采用更加通用的 PSR 标准,便于融合其他框架。
在写了在写了。
Choir 重构了 Workerman 的 Worker 结构,采用 Server 对象对服务进行描述,同时单个 Server 可以监听不同的端口,从最开始统一了 Web Server 的概念。
对 WebSocket 协议实现来说,Workerman 仅实现了 UTF-8 明文,Choir 实现了支持二进制传输及分包传输,更支持了一些额外的 WebSocket 操作对象,例如 Frame 等。
重构协议层的接口,对协议的解析流程进行了调整。
此外,Choir 对协议的实现均统一,即 Server 和 Client 同一套解析逻辑,Client 默认异步,在开启协程后可异步转协程同步。
原生支持 Fiber 协程一键开启,使用 PHP 8.1 时自动开启纤程,且可通过传入的配置项切换使用 Swoole、Swow 协程库等。
Choir 源码的每一部分都添加了注释,你可以在查看 Choir 源码的过程中快速了解它是如何运作的。
Choir 同 Workerman 一样,默认提供了一些初始的参数显示和信号处理参数,但 Choir 可以通过传参和修改静态变量的方式进行自定义。
Choir 目前仅实现了基础的 Server 和 Client 组件,其他附带的组件暂时正在开发中。
Choir 暂无法直接整合其他 Workerman 现成组件,后期会添加适配器。
require_once 'vendor/autoload.php';
// 也可以使用 Url 模式:$server = new \Choir\Server("http://0.0.0.0:20001");
$server = new \Choir\Http\Server('0.0.0.0', 20001, false, [
'worker-num' => 8,
]);
$server->on('request', function (Choir\Protocol\HttpConnection $connection) {
$connection->end('hello world');
});
$server->start();