本次更新涉及以下組件,主要新增了 WebSocket 服務端
及 WebSocket 協程客戶端
組件,以及修復了一些 Bug hyperf/constants hyperf/database hyperf/di hyperf/framework hyperf/http-server hyperf/json-rpc hyperf/model-cache hyperf/websocket-client hyperf/websocket-server
#48 增加 WebSocket 協程客戶端及服務端
#51 增加了 enableCache
餐快去控制 DefinitionSource
是否啟用註解掃描緩存
#61 通過 db:model
命令創建模型時增加屬性類型
#65 模型緩存增加 JSON 格式支持
#46 移除了 hyperf/di
, hyperf/command
and hyperf/dispatcher
組件對 hyperf/framework
組件的依賴
#45 修復當引用了 hyperf/websocket-server
組件時有可能會導致 HTTP Server 啟動失敗的問題
#55 修復方法級別的 @Middleware
註解可能會被覆蓋的問題
#73 修復 db:model
命令對短屬性處理不正確的問題
#88 修復當控制器存在多層文件夾時生成的路由可能不正確的問題
#101 修復常量不存在 @Message
註解時會報錯的問題
Hyperf 提供了對 WebSocket Server 的封裝,可基於 hyperf/websocket-server 組件快速搭建一個 WebSocket 應用。
composer require hyperf/websocket-server
修改 config/autoload/server.php
,增加以下配置。
[ [ 'name' => 'ws', 'type' => Server::SERVER_WEBSOCKET, 'host' => '0.0.0.0', 'port' => 9502, 'sock_type' => SWOOLE_SOCK_TCP, 'callbacks' => [ SwooleEvent::ON_HAND_SHAKE => [Hyperf\WebSocketServer\Server::class, 'onHandShake'], SwooleEvent::ON_MESSAGE => [Hyperf\WebSocketServer\Server::class, 'onMessage'], SwooleEvent::ON_CLOSE => [Hyperf\WebSocketServer\Server::class, 'onClose'], ], ], ],
目前暫時只支持配置文件的模式配置路由,後續會提供註解模式。
在 config/routes.php
文件內增加對應 ws
的 Server 的路由配置,這裡的 ws
值取決於您在 config/autoload/server.php
內配置的 WebSocket Server 的 name
值。
<?php Router::addServer('ws', function () { Router::get('/', 'App\Controller\WebSocketController'); });
push($frame->fd, 'Recv: ' . $frame->data); } public function onClose(Server $server, int $fd, int $reactorId): void { var_dump('closed'); } public function onOpen(Server $server, Request $request): void { $server->push($request->fd, 'Opened'); } }
接下來啟動 Server,便能看到對應啟動了一個 WebSocket Server 並監聽於 9502 埠,此時您便可以通過各種 WebSocket Client 來進行連接和進行數據傳輸了。
$ php bin/hyperf.php start [INFO] Worker#0 started. [INFO] WebSocket Server listening at 0.0.0.0:9502 [INFO] HTTP Server listening at 0.0.0.0:9501
Hyperf 提供了對 WebSocket Client 的封裝,可基於 hyperf/websocket-client 組件對 WebSocket Server 進行訪問;
composer require hyperf/websocket-client
組件提供了一個 Hyperf\WebSocketClient\ClientFactory
來創建客戶端對象 Hyperf\WebSocketClient\Client
,我們直接通過代碼來演示一下:
clientFactory->create($host); } }
默認情況下,創建出來的 Client
對象會通過 defer
自動 close
連接,如果您希望不自動 close
,可在創建 Client
對象時傳遞第二個參數 $autoClose
為 false
:
create($host, $autoClose);
Hyperf 是基於 Swoole 4.3+
實現的高性能、高靈活性的 PHP 協程框架,內置協程伺服器及大量常用的組件,性能較傳統基於 PHP-FPM
的框架有質的提升,提供超高性能的同時,也保持著極其靈活的可擴展性,標準組件均均基於 PSR 標準 實現,基於強大的依賴注入設計,保證了絕大部分組件或類都是 可替換
與 可復用
的。 框架組件庫除了常見的協程版的 MySQL 客戶端
、Redis 客戶端
,還為您準備了協程版的 Eloquent ORM
、JSON RPC 服務的及客戶端
、GRPC 服務端及客戶端
、Zipkin (OpenTracing) 客戶端
、Guzzle HTTP 客戶端
、Elasticsearch 客戶端
、Consul 客戶端
、ETCD 客戶端
、AMQP 組件
、Apollo 配置中心
、阿里雲 ACM 應用配置管理
、基於令牌桶演算法的限流器
、通用連接池
、熔斷器
、Swagger 文檔生成
等組件,省去了自己實現對應協程版本的麻煩,Hyperf 還提供了 基於 PSR-11 的依賴注入容器
、註解
、AOP 面向切面編程
、基於 PSR-15 的中間件
、自定義進程
、基於 PSR-14 的事件管理器
、Redis/RabbitMQ 消息隊列
、自動模型緩存
、基於 PSR-16 的緩存
等非常便捷的功能,滿足豐富的技術場景和業務場景,開箱即用。
儘管現在基於 PHP 語言開發的框架處於一個百花爭鳴的時代,但仍舊未能看到一個優雅的設計與超高性能的共存的完美框架,亦沒有看到一個真正為 PHP 微服務鋪路的框架,此為 Hyperf 及其團隊成員的初衷,我們將持續投入並為此付出努力,也歡迎你加入我們參與開源建設。
Hyperspeed + Flexibility = Hyperf
,從名字上我們就將 超高速
和 靈活性
作為 Hyperf 的基因。
對於超高速,我們基於 Swoole 協程並在框架設計上進行大量的優化以確保超高性能的輸出。
對於靈活性,我們基於 Hyperf 強大的依賴注入組件,組件均基於 PSR 標準 的契約和由 Hyperf 定義的契約實現,達到框架內的絕大部分的組件或類都是可替換的。
基於以上的特點,Hyperf 將存在豐富的可能性,如實現 Web 服務,網關服務,分散式中間件,微服務架構,遊戲伺服器,物聯網(IOT)等。
我們投入了大量的時間用於文檔的建設,以解決各種因為文檔缺失所帶來的問題,文檔上也提供了大量的示例,對新手同樣友好。
我們為組件進行了大量的單元測試以保證邏輯的正確,同時維護了高質量的文檔,在 Hyperf 正式對外開放(2019年6月20日)之前,便已在一家 C輪 和一家 B輪 互聯網公司上線了多個服務並以穩定的姿態完美的運行了超過半年時間,經過了嚴酷的生產環境 (如618) 的考驗,我們才正式的對外開放該項目。
[admin
]