?Hyperf v1.1 釋出,一個全新的里程碑,企業級的 PHP 微服務雲原生協程框架
本文為 10 月 8 日釋出的文章,現為同步到掘金
過去的3個半月
從 6月20日 Hyperf 1.0 釋出以來,Hyperf 受到了非常多的關注,也獲得了非常多的建議和幫助,截止至今, Hyperf 在 Github 上已經收穫了 1330+ stars
,449+ 個 Pull Requests
,51+ Contributors
,3370+ commits
,同時也出現了不少圍繞或基於 Hyperf 的開源專案,在這段時間裡,我們通過每週為 Hyperf 迭代一個無縫相容的小版本,一共釋出了 16 個小版本,此期間在 1.0 的基礎上,增加了 Translation 國際化
,WebSocket
,Snowflake 全域性唯一 ID 生成器
Crontab 秒級計劃任務
,ETCD 配置中心
,View 檢視 (包括 Blade 和 Smarty 引擎)
,Task
,Swoole Tracker
共 8 個元件,同時也增加了 連線池根據頻率自動釋放連線、自動動態代理 JSON RPC 客戶端,Hyperf\Utils\Context::override()
便捷的上下文變更方法,為 Response 增加 xml
download
方法等主要功能。
Hyperf 1.1
在社群力量的幫助下,以及我們日以繼夜的努力,Hyperf 也在快速進化中,Hyperf 1.1 在國慶假期結束後的今天釋出了,該版本為 Hyperf 增加了許多功能,也讓 Hyperf 離理想的狀態更加的靠近了,感謝所有的 Contributors,這個版本增加 Validation 驗證器元件,Jaeger 呼叫鏈追蹤元件,同時也強化了各個元件的使用和功能,同時也增加了大量的單測,從 1.0.16 版的 661
2062
個斷言條件提升至 1120
個單測共 3369
個斷言條件,更多細節可以查閱下面的更新內容。
1.1 版本並不是一個相容升級的版本,您需要簡單的調整一下 skeleton 的部分結構,再將全部元件升級到 1.1 版本即可,我們為您準備了一個 v1.1 升級指南 供您參考,詳情可查閱官方檔案。
更新內容
新增
-
#401 新增了
Hyperf\HttpServer\Router\Dispatched
物件來儲存解析的路由資訊,在使用者中介軟體之前便解析完成以便後續的使用,同時也修復了路由裡帶參時中介軟體失效的問題; -
#402 新增
@AsyncQueueMessage
註解,通過定義此註解在方法上,表明這個方法的實際執行邏輯是投遞給 Async-Queue 佇列去消費; - #418 允許傳送 WebSocket 訊息到任意的 fd,即使當前的 Worker 程式不持有對應的 fd,框架會自動進行程式間通訊來實現傳送;
- #420 為資料庫模型增加新的事件機制,與 PSR-15 的事件排程器相配合,可以解耦的定義 Listener 來監聽模型事件;
- #429 #643 新增 Validation 表單驗證器元件,這是一個衍生於 illuminate/validation 的元件,感謝 Laravel 開發組提供如此好用的驗證器元件;
- #441 當 Redis 連線處於低使用頻率的情況下自動關閉空閒連線;
- #478 更好地適配 OpenTracing 協議,同時接入了 Jaeger,Jaeger 是一款非常優秀的開源的端對端分散式呼叫鏈追蹤系統;
-
#500 為
Hyperf\HttpServer\Contract\ResponseInterface
增加鏈式方法呼叫支援,解決呼叫了代理方法的方法後無法再呼叫原始方法的問題; -
#523 為
gen:model
命令新增了table-mapping
選項; -
#555 新增了一個全域性函式
swoole_hook_flags
來獲取由常量SWOOLE_HOOK_FLAGS
所定義的 Runtime Hook 等級,您可以在bin/hyperf.php
通過! defined('SWOOLE_HOOK_FLAGS') && define('SWOOLE_HOOK_FLAGS',SWOOLE_HOOK_ALL);
的方式來定義該常量,即 Runtime Hook 等級; -
#596 為
@Inject
註解增加了required
引數,當您定義@Inject(required=false)
註解到一個成員屬性上,那麼當該依賴項不存在時也不會丟擲Hyperf\Di\Exception\NotFoundException
異常,而是以預設值null
來注入,required
引數的預設值為true
,當在構造器注入的情況下,您可以通過對構造器的引數定義為nullable
或將預設值設定為null
來達到同樣的目的; -
#597 為 AsyncQueue 元件的消費者增加
Concurrent
來控制消費速率; - #599 為 AsyncQueue 元件的消費者增加根據當前重試次數來設定該訊息的重試等待時長的功能,可以為訊息設定階梯式的重試等待;
- #619 為 Guzzle 客戶端增加 HandlerStackFactory 類,以便更便捷地建立一個 HandlerStack;
- #620 為 AsyncQueue 元件的消費者增加自動重啟的機制;
-
#629 允許通過配置檔案的形式為 Apollo 客戶端定義
clientIp
,pullTimeout
,intervalTimeout
配置; -
#647 根據 server 的配置,自動為 TCP Response 追加
eof
; -
#648 為 AMQP Consumer 增加
nack
的返回型別,當消費邏輯返回Hyperf\Amqp\Result::NACK
時抽象消費者會以basic_nack
方法來響應訊息; - #654 增加所有 Swoole Event 的預設回撥和對應的 Hyperf 事件;
變更
-
#437
Hyperf\Testing\Client
在遇到異常時不再直接丟擲異常而是交給 ExceptionHandler 流程處理; -
#463 簡化了
container.php
檔案及優化了註解快取機制;
新的 config/container.php 檔案內容如下:
<?php
use Hyperf\Di\Container;
use Hyperf\Di\Definition\DefinitionSourceFactory;
use Hyperf\Utils\ApplicationContext;
$container = new Container((new DefinitionSourceFactory(true))());
if (! $container instanceof \Psr\Container\ContainerInterface) {
throw new RuntimeException('The dependency injection container is invalid.');
}
return ApplicationContext::setContainer($container);
複製程式碼
-
#486
Hyperf\HttpMessage\Server\Request
的getParsedBody
方法現在可以直接處理 JSON 格式的資料了; -
#523 調整
gen:model
命令生成的模型類名預設為單數,如果表名為複數,則預設生成的類名為單數; -
#614 #617 調整了 ConfigProvider 類的結構,同時將
config/dependencies.php
檔案移動到了config/autoload/dependencies.php
內,且檔案結構去除了dependencies
層,此後也意味著您也可以將dependencies
配置寫到config/config.php
檔案內;
Config Provider 內資料結構的變化: 之前:
'scan' => [
'paths' => [
__DIR__,],'collectors' => [],複製程式碼
現在:
'annotations' => [
'scan' => [
'paths' => [
__DIR__,複製程式碼
增加了一層 annotations,這樣將與配置檔案結構一致,不再特殊
-
#630 變更了
Hyperf\HttpServer\CoreMiddleware
類的例項化方式,使用make()
來替代了new
; -
#631 變更了 AMQP Consumer 的例項化方式,使用
make()
來替代了new
; -
#637 調整了
Hyperf\Contract\OnMessageInterface
和Hyperf\Contract\OnOpenInterface
的第一個引數的型別約束, 使用Swoole\WebSocket\Server
替代Swoole\Server
; -
#638 重新命名了
db:model
命令為gen:model
命令,同時增加了一個 Visitor 來優化建立的$connection
成員屬性,如果要建立的模型類的$connection
屬性的值與繼承的父類一致,那麼建立的模型類將不會包含此屬性;
移除
-
#401 移除了
Hyperf\JsonRpc\HttpServerFactory
,Hyperf\HttpServer\ServerFactory
,Hyperf\GrpcServer\ServerFactory
類; -
#402 移除了棄用的
AsyncQueue::delay
方法; -
#563 移除了棄用的
Hyperf\Server\ServerInterface::SERVER_TCP
常量,使用Hyperf\Server\ServerInterface::SERVER_BASE
來替代; -
#602 移除了
Hyperf\Utils\Coroutine\Concurrent
的timeout
引數; -
#612 移除了 RingPHP Handler 裡沒有使用到的
$url
變數; - #616 #618 移除了 Guzzle 裡一些無用的程式碼;
優化
-
#644 優化了註解掃描的流程,分開
app
和vendor
兩部分來掃描註解,大大減少了使用者的掃描耗時; -
#653 優化了 Swoole shortname 的檢測邏輯,現在的檢測邏輯更加貼合 Swoole 的實際配置場景,不只是
swoole.use_shortname = "Off"
才能通過檢測了;
修復
- #448 修復了當 HTTP Server 或 WebSocket Server 存在時,TCP Server 有可能無法啟動的問題;
-
#623 修復了當傳遞一個
null
值到代理類的方法引數時,方法仍然會獲取方法預設值的問題;
關於 Hyperf
Hyperf 是基於 Swoole 4.4+
實現的高效能、高靈活性的 PHP 協程框架,內建協程伺服器及大量常用的元件,效能較傳統基於 PHP-FPM
的框架有質的提升,提供超高效能的同時,也保持著極其靈活的可擴充套件性,標準元件均基於 PSR 標準 實現,基於強大的依賴注入設計,保證了絕大部分元件或類都是 可替換
與 可複用
的。
框架元件庫除了常見的協程版的 MySQL 客戶端
、Redis 客戶端
,還為您準備了協程版的 Eloquent ORM
、WebSocket 服務端及客戶端
、JSON RPC 服務端及客戶端
、GRPC 服務端及客戶端
、Zipkin (OpenTracing) 客戶端
、Guzzle HTTP 客戶端
、Elasticsearch 客戶端
、Consul 客戶端
、ETCD 客戶端
、AMQP 元件
、Apollo 配置中心
、阿里雲 ACM 應用配置管理
、ETCD 配置中心
、基於令牌桶演演算法的限流器
、通用連線池
、熔斷器
、Swagger 檔案生成
、Swoole Tracker
、Blade 和 Smarty 檢視引擎
、Snowflake 全域性ID生成器
等元件,省去了自己實現對應協程版本的麻煩。
Hyperf 還提供了 基於 PSR-11 的依賴注入容器
、註解
、AOP 面向切面程式設計
、基於 PSR-15 的中介軟體
、自定義程式
、基於 PSR-14 的事件管理器
、Redis/RabbitMQ 訊息佇列
、自動模型快取
、基於 PSR-16 的快取
、Crontab 秒級定時任務
、國際化
等非常便捷的功能,滿足豐富的技術場景和業務場景,開箱即用。
框架初衷
儘管現在基於 PHP 語言開發的框架處於一個百花爭鳴的時代,但仍舊未能看到一個優雅的設計與超高效能的共存的完美框架,亦沒有看到一個真正為 PHP 微服務鋪路的框架,此為 Hyperf 及其團隊成員的初衷,我們將持續投入併為此付出努力,也歡迎你加入我們參與開源建設。
設計理念
Hyperspeed + Flexibility = Hyperf
,從名字上我們就將 超高速
和 靈活性
作為 Hyperf 的基因。
- 對於超高速,我們基於 Swoole 協程並在框架設計上進行大量的優化以確保超高效能的輸出。
- 對於靈活性,我們基於 Hyperf 強大的依賴注入元件,元件均基於 PSR 標準 的契約和由 Hyperf 定義的契約實現,達到框架內的絕大部分的元件或類都是可替換的。
基於以上的特點,Hyperf 將存在豐富的可能性,如實現 單體 Web 服務,API 服務,閘道器服務,分散式中介軟體,微服務架構,遊戲伺服器,物聯網(IOT)等。
檔案齊全
我們投入了大量的時間用於檔案的建設,以解決各種因為檔案缺失所帶來的問題,檔案上也提供了大量的示例,對新手同樣友好。
Hyperf 官方開發檔案
生產可用
我們為元件進行了大量的單元測試以保證邏輯的正確,目前存在 1120
個單測共 3369
個斷言條件,同時維護了高質量的檔案,在 Hyperf 正式對外開放(2019年6月20日)之前,便已經過了嚴酷的生產環境的考驗,我們才正式的對外開放該專案,現在已有很多的大型網際網路企業都已將 Hyperf 部署到了自己的生產環境上並穩定執行。
官網及交流
Github ????? 點 Star 支援我們
Gitee 碼雲 ????? 點 Star 支援我們
Hyperf 官網
Hyperf 檔案
QQ 群: 862099724