Hyperf v1.1 發佈，一個全新的里程碑，企業級的 PHP 微服務雲原生協程框架

過去的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__,
        ],
        'collectors' => [],
    ],
],

增加了一層 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