mirror of https://gitee.com/hyperf/hyperf.git synced 2024-12-01 03:08:06 +08:00

* Update CHANGELOG-2.0.md

* Update

* Update doc and translate

Co-authored-by: huangzhhui <huangzhwork@gmail.com>

2020-09-21 10:25:38 +08:00

96 KiB

Raw Blame History

版本更新記錄

v2.0.12 - 2020-09-21

Added

#2512 為 hyperf/database 組件方法 MySqlGrammar::compileColumnListing 新增返回字段 column_type。

Fixed

#2490 修復 hyperf/grpc-client 組件中，流式客户端無法正常工作的問題。
#2509 修復 hyperf/database 組件中，使用小駝峯模式後，訪問器無法正常工作的問題。
#2535 修復 hyperf/database 組件中，使用 gen:model 後，通過訪問器生成的註釋 @property 會被 morphTo 覆蓋的問題。
#2546 修復 hyperf/db-connection 組件中，使用 left join 等複雜查詢後，MySQL 連接無法正常釋放的問題。

Optimized

#2490 優化 hyperf/grpc-client 組件中的異常和單元測試。

v2.0.11 - 2020-09-14

新增

#2455 為 hyperf/socketio-server 組件新增方法 Socket::getRequest 用於獲取 Psr7 規範的 Request。
#2459 為 hyperf/async-queue 組件新增監聽器 ReloadChannelListener 用於自動將超時隊列裏的消息移動到等待執行隊列中。
#2463 為 hyperf/database 組件新增可選的 ModelRewriteGetterSetterVisitor 用於為模型生成對應的 Getter 和 Setter。
#2475 為 hyperf/retry 組件的 Fallback 回調，默認增加 throwable 參數。

修復

#2464 修復 hyperf/database 組件中，小駝峯模式模型的 fill 方法無法正常使用的問題。
#2478 修復 hyperf/websocket-server 組件中，Sender::check 無法檢測非 WebSocket 的 fd 值。
#2488 修復 hyperf/database 組件中，當 pdo 實例化失敗後 beginTransaction 調用失敗的問題。

優化

#2461 優化 hyperf/reactive-x 組件 HTTP 路由監聽器，可以監聽任意端口路由。
#2465 優化 hyperf/retry 組件 FallbackRetryPolicy 中 fallback 除了可以填寫被 is_callable 識別的代碼外，還可以填寫形如 class@method 的格式，框架會從 Container 中拿到對應的 class，然後執行其 method 方法。

變更

#2492 調整 hyperf/socketio-server 組件中的事件收集順序，確保 sid 早於自定義 onConnect 被添加到房間中。

v2.0.10 - 2020-09-07

新增

#2411 為 hyperf/database 組件新增 Hyperf\Database\Query\Builder::forPageBeforeId 方法。
#2420 #2426 為 hyperf/command 組件新增默認選項 enable-event-dispatcher 用於初始化事件觸發器。
#2433 為 hyperf/grpc-server 組件路由新增匿名函數支持。
#2441 為 hyperf/socketio-server 組件中 SocketIO 新增了一些 setters。

修復

#2427 修復事件觸發器在使用 Pivot 或 MorphPivot 不生效的問題。
#2443 修復使用 hyperf/Guzzle 組件的 Coroutine Handler 時，無法正確獲取和傳遞 traceid 和 spanid 的問題。
#2449 修復發佈 hyperf/config-apollo 組件的配置文件時，配置文件名稱錯誤的問題。

優化

#2429 優化使用 @Inject 並且沒有設置 @var 時的錯誤信息，方便定位問題，改善編程體驗。
#2438 優化當使用 hyperf/model-cache 組件與數據庫事務搭配使用時，在事務中刪除或修改模型數據會在事務提交後即時再刪除緩存，而不再是在刪除或修改模型數據時刪除緩存數據。

v2.0.9 - 2020-08-31

新增

#2331 hyperf/nacos 組件增加授權接口。
#2331 hyperf/nacos 組件增加 nacos.enable 配置，用於控制是否啟用 Nacos 服務。
#2331 hyperf/nacos 組件增加配置合併類型，默認使用全量覆蓋。
#2377 為 gRPC 客户端的 request 增加 ts 請求頭，以兼容 Node.js gRPC server 等。
#2384 新增助手函數 optional()，以創建 Hyperf\Utils\Optional 對象或更方便 Optional 的使用。

修改

#2331 修復 hyperf/nacos 組件，服務或配置不存在時，會拋出異常的問題。
#2356 #2368 修復 pid_file 被用户修改後，命令行 server:start 啟動失敗的問題。
#2358 修復驗證器規則 digits 不支持 int 類型的問題。

優化

#2359 優化自定義進程，在協程風格服務下，可以更加友好的停止。
#2363 優化 hyperf/di 組件，使其不需要依賴 hyperf/config 組件。
#2373 優化 hyperf/validation 組件的異常捕獲器，使其返回 Response 時，自動添加 content-type 頭。

v2.0.8 - 2020-08-24

新增

#2334 新增更加友好的數組遞歸合併方法 Arr::merge。
#2335 新增 Hyperf/Utils/Optional，它可以接受任意參數，並允許訪問該對象上的屬性或調用其方法，即使給定的對象為 null，也不會引發錯誤。
#2336 新增 RedisNsqAdapter，它通過 NSQ 發佈消息，使用 Redis 記錄房間信息。

修復

#2338 修復文件系統使用 S3 適配器時，文件是否存在的邏輯與預期不符的 BUG。
#2340 修復 __FUNCTION__ 和 __METHOD__ 魔術方法無法在被 AOP 重寫的方法里正常工作的 BUG。

優化

#2319 優化 ResolverDispatcher ，使項目發生循環依賴時，可以提供更加友好的錯誤提示。

v2.0.7 - 2020-08-17

新增

#2307 #2312 hyperf/nsq 組件，新增 NSQD 的 HTTP 客户端。

修復

#2275 修復配置中心，拉取配置進程會出現阻塞的 BUG。
#2276 修復 Apollo 配置中心，當配置沒有變更時，會清除所有本地配置項的 BUG。
#2280 修復 Interface 的方法會被 AOP 重寫，導致啟動報錯的 BUG。
#2281 當使用 Task 組件，且沒有啟動協程時，Signal 組件會導致啟動報錯的 BUG。
#2304 修復當使用 SocketIOServer 的內存適配器，刪除 sid 時，會導致死循環的 BUG。
#2309 修復 JsonRpcHttpTransporter 無法設置自定義超時時間的 BUG。

v2.0.6 - 2020-08-10

新增

#2125 新增 hyperf/jet 組件。Jet 是一個統一模型的 RPC 客户端，內置 JSONRPC 協議的適配，該組件可適用於所有的 PHP (>= 7.2) 環境，包括 PHP-FPM 和 Swoole 或 Hyperf。

修復

#2236 修復 Nacos 使用負載均衡器選擇節點失敗的 BUG。
#2242 修復 watcher 組件會重複收集多次註解的 BUG。

v2.0.5 - 2020-08-03

新增

#2001 新增參數 $signature，用於簡化命令行的初始化工作。
#2204 為方法 parallel 增加 $concurrent 參數，用於快速設置併發量。

修復

#2210 修復 WebSocket 握手成功後，不會立馬觸發 OnOpen 事件的 BUG。
#2214 修復 WebSocket 主動關閉連接時，不會觸發 OnClose 事件的 BUG。
#2218 修復在 協程 Server 下，Sender::disconnect 報錯的 BUG。
#2227 修復在 協程 Server 下，建立 keepalive 連接後，上下文數據無法在請求結束後銷燬的 BUG。

優化

#2193 優化 Hyperf\Watcher\Driver\FindDriver，使其掃描有變動的文件更加精確。
#2232 優化 model-cache 的預加載功能，使其支持 In 和 InRaw。

v2.0.4 - 2020-07-27

新增

#2144 數據庫查詢事件 Hyperf\Database\Events\QueryExecuted 添加 $result 字段。
#2158 路由 Hyperf\HttpServer\Router\Handler 中，添加 $options 字段。
#2162 熱更新組件添加 Hyperf\Watcher\Driver\FindDriver。
#2169 Session 組件新增配置 session.options.domain，用於替換 Request 中獲取的 domain。
#2174 模型生成器添加 ModelRewriteTimestampsVisitor，用於根據數據庫字段 created_at 和 updated_at，重寫模型字段 $timestamps。
#2175 模型生成器添加 ModelRewriteSoftDeletesVisitor，用於根據數據庫字段 deleted_at，添加或者移除 SoftDeletes。
#2176 模型生成器添加 ModelRewriteKeyInfoVisitor，用於根據數據庫主鍵，重寫模型字段 $incrementing $primaryKey 和 $keyType。

修復

#2149 修復自定義進程運行過程中無法從 Nacos 正常更新配置的 BUG。
#2159 修復使用 gen:migration 時，由於文件已經存在導致的 FATAL 異常。

優化

#2043 當 SCAN 目錄都不存在時，拋出更加友好的異常。
#2182 當使用 WebSocket 和 Http 服務且 Http 接口被訪問時，不會記錄 WebSocket 關閉連接的日誌。

v2.0.3 - 2020-07-20

新增

#1554 新增 hyperf/nacos 組件。
#2082 監聽器 Hyperf\Signal\Handler\WorkerStopHandler 添加信號 SIGINT 監聽。
#2097 hyperf/filesystem 新增 TencentCloud COS 支持.
#2122 添加 Trait \Hyperf\Snowflake\Concern\HasSnowflake 為模型自動生成雪花算法的主鍵。

修復

#2017 修復 Prometheus 使用 redis 打點時，改變 label 會導致收集報錯的 BUG。
#2117 修復使用 server:watch 時，註解 @Inject 有時會失效的 BUG。
#2123 修復 tracer 會記錄兩次 Redis 指令 的 BUG。
#2139 修復 ValidationMiddleware 在 WebSocket 服務下使用會報錯的 BUG。
#2140 修復請求拋出異常時，Session 無法保存的 BUG。

優化

#2080 方法 Hyperf\Database\Model\Builder::paginate 中參數 $perPage 的類型從 int 更改為 ?int。
#2110 在使用 hyperf/watcher 時，會先檢查進程是否存在，如果不存在，才會發送 SIGTERM 信號。
#2116 優化組件 hyperf/di 的依賴。
#2121 在使用 gen:model 時，如果用户自定義了與數據庫字段一致的字段時，則會替換對應的 @property。
#2129 當 Response Json 格式化失敗時，會拋出更加友好的錯誤提示。

v2.0.2 - 2020-07-13

修復

#1898 修復定時器規則 $min-$max 解析有誤的 BUG。
#2037 修復 TCP 服務，連接後共用一個協程，導致 DB 等連接池無法正常回收連接的 BUG。
#2051 修復 CoroutineServer 不會生成 hyperf.pid 的 BUG。
#2055 修復 Guzzle 在傳輸大數據包時會自動添加頭 Expect: 100-Continue，導致請求失敗的 BUG。
#2059 修復 SocketIOServer 中 Redis 重連失敗的 BUG。
#2067 修復 hyperf/watcher 組件 Syntax 錯誤會導致進程異常。
#2085 修復註解 RetryFalsy 會導致獲得正確的結果後，再次重試。
#2089 修復使用 gen:command 後，腳本必須要進行修改，才能被加載到的 BUG。
#2093 修復腳本 vendor:publish 沒有返回碼導致報錯的 BUG。

新增

#1860 為 Server 添加默認的 OnWorkerExit 回調。
#2042 為熱更新組件，添加文件掃描驅動。
#2054 為模型緩存添加 Eager Load 功能。

優化

#2049 優化熱更新組件的 Stdout 輸出。
#2090 為 hyperf/session 組件適配非 Hyperf 的 Response。

變更

#2031 常量組件的錯誤碼只支持 int 和 string。
#2065 WebSocket 消息發送器 Hyperf\WebSocketServer\Sender 支持 push 和 disconnect。
#2100 組件 hyperf/utils 更新依賴 doctrine/inflector 版本到 ^2.0。

移除

#2065 移除 Hyperf\WebSocketServer\Sender 對方法 send sendto 和 close 的支持，請使用 push 和 disconnect。

v2.0.1 - 2020-07-02

新增

#1934 增加腳本 gen:constant 用於創建常量類。
#1982 添加熱更新組件，文件修改後自動收集註解，自動重啟。

修復

#1952 修復數據庫遷移類存在時，也會生成同類名類，導致類名衝突的 BUG。
#1960 修復 Hyperf\HttpServer\ResponseEmitter::isMethodsExists() 判斷錯誤的 BUG。
#1961 修復因文件 config/autoload/aspects.php 不存在導致服務無法啟動的 BUG。
#1964 修復接口請求時，數據體為空會導致 500 錯誤的 BUG。
#1965 修復 initRequestAndResponse 失敗後，會導致請求狀態碼與實際不符的 BUG。
#1968 修復當修改 aspects.php 文件後，Aspect 無法安裝修改後的結果運行的 BUG。
#1985 修復註解全局配置不全為小寫時，會導致 global_imports 失敗的 BUG。
#1990 修復當父類存在與子類一樣的成員變量時， @Inject 無法正常使用的 BUG。
#2019 修復腳本 gen:model 因為使用了 morphTo 或 where 導致生成對應的 @property 失敗的 BUG。
#2026 修復當使用了魔術方法時，LazyLoad 代理生成有誤的 BUG。

變更

#1986 當沒有設置正確的 swoole.use_shortname 變更腳本 exit_code 為 SIGTERM。

優化

#1959 優化類 ClassLoader 可以更容易被用户繼承並修改。
#2002 當 PHP 版本大於等於 7.3 時，支持 AOP 切入 Trait。

v2.0 - 2020-06-22

主要功能

重構 hyperf/di 組件，特別是對 AOP 和註解的優化，在 2.0 版本，該組件使用了一個全新的加載機制來提供 AOP 功能的支持。
1. 對比 1.x 版本來説最顯著的一個功能就是現在你可以通過 AOP 功能切入任何方式實例化的一個類了，比如説，在 1.x 版本，你只能切入由 DI 容器創建的類，你無法切入一個由 new 關鍵詞實例化的類，但在 2.0 版本都可以生效了。不過仍有一些例外的情況，您仍無法切入那些在啟動階段用來提供 AOP 功能的類；
2. 在 1.x 版本，AOP 只能作用於普通的類，無法支持 Final 類，但在 2.0 版本您可以這麼做了；
3. 在 1.x 版本，您無法在當前類的構造函數中使用 @Inject 或 @Value 註解標記的類成員屬性的值，但在 2.0 版本里，您可以這麼做了；
4. 在 1.x 版本，只有通過 DI 容器創建的對象才能使 @Inject 和 @Value 註解的功能生效，通過 new 關鍵詞創建的對象無法生效，但在 2.0 版本，都可以生效了；
5. 在 1.x 版本，在使用註解時，您必須定義註解的命名空間來指定使用的註解類，但在 2.0 版本下，您可以為任一註解提供一個別名，這樣在使用這個註解時可以直接使用別名而無需引入註解類的命名空間。比如您可以直接在任意類屬性上標記 @Inject 註解而無需編寫 use Hyperf\Di\Annotation\Inject;；
6. 在 1.x 版本，創建的代理類是一個目標類的子類，這樣的實現機制會導致一些魔術常量獲得的值返回的是代理類子類的信息，而不是目標類的信息，但在 2.0 版本，代理類會與目標類保持一樣的類名和代碼結構；
7. 在 1.x 版本，當代理類緩存存在時則不會重新生成緩存，就算源代碼發生了變化，這樣的機制有助於掃描耗時的提升，但與此同時，這也會導致開發階段的一些不便利，但在 2.0 版本，代理類緩存會根據源代碼的變化而自動變化，這一改變會減少很多在開發階段的心智負擔；
8. 為 Aspect 類增加了 priority 優先級屬性，現在您可以組織多個 Aspect 之間的順序了；
9. 在 1.x 版本，您只能通過 @Aspect 註解類定義一個 Aspect 類，但在 2.0 版本，您還可以通過配置文件、ConfigProvider 來定義 Aspect 類；
10. 在 1.x 版本，您在使用到依賴懶加載功能時，必須註冊一個 Hyperf\Di\Listener\LazyLoaderBootApplicationListener 監聽器，但在 2.0 版本，您可以直接使用該功能而無需做任何的註冊動作；
11. 增加了 annotations.scan.class_map 配置項，通過該配置您可以將任意類替換成您自己的類，而使用時無需做任何的改變；

依賴庫更新

將 ext-swoole 升級到了 >=4.5;
將 psr/event-dispatcher 升級到了 ^1.0;
將 monolog/monolog 升級到了 ^2.0;
將 phpstan/phpstan 升級到了 ^0.12.18;
將 vlucas/phpdotenv 升級到了 ^4.0;
將 symfony/finder 升級到了 ^5.0;
將 symfony/event-dispatcher 升級到了 ^5.0;
將 symfony/console 升級到了 ^5.0;
將 symfony/property-access 升級到了 ^5.0;
將 symfony/serializer 升級到了 ^5.0;
將 elasticsearch/elasticsearch 升級到了 ^7.0;

類和方法的變更

移除了 Hyperf\Di\Aop\AstCollector；
移除了 Hyperf\Di\Aop\ProxyClassNameVisitor；
移除了 Hyperf\Di\Listener\LazyLoaderBootApplicationListener；
移除了 Hyperf\Dispatcher\AbstractDispatcher 類的 dispatch(...$params) 方法；
移除了 hyperf/utils 組件中 ConfigProvider 中的 Hyperf\Contract\NormalizerInterface => Hyperf\Utils\Serializer\SymfonyNormalizer 關係；
移除了 Hyperf\Contract\OnOpenInterface、Hyperf\Contract\OnCloseInterface、Hyperf\Contract\OnMessageInterface、Hyperf\Contract\OnReceiveInterface 接口中的 $server 參數的強類型聲明；

新增

#992 新增 hyperf/reactive-x 組件；
#1245 為 ExceptionHandler 新增了註解的定義方式；
#1245 ExceptionHandler 新增了 priority 優先級屬性，通過配置文件或註解方式均可定義優先級；
#1819 新增 hyperf/signal 組件；
#1844 為 hyperf/model-cache 組件中的 ttl 屬性增加了 \DateInterval 類型的支持；
#1855 連接池新增了 ConstantFrequency 恆定頻率策略來釋放限制的連接；
#1871 為 Guzzle 增加 sink 選項支持；
#1805 新增 Coroutine Server 協程服務支持；
- 變更了 Hyperf\Contract\ProcessInterface 中的 bind(Server $server) 方法聲明為 bind($server)；
- 變更了 Hyperf\Contract\ProcessInterface 中的 isEnable() 方法聲明為 isEnable($server)；
- 配置中心、Crontab、服務監控、消息隊列消費者現在可以通過協程模式來運行，且在使用協程服務模式時，也必須以協程模式來運行；
- Hyperf\AsyncQueue\Environment 的作用域改為當前協程內，而不是整個進程；
- 協程模式下不再支持 Task 機制；
#1877 在 PHP 8 下使用 @Inject 註解時支持通過成員屬性強類型聲明來替代 @var 聲明，如下所示：

class Example {
    /**
    * @Inject
    */
    private ExampleService $exampleService;
}

#1890 新增 Hyperf\HttpServer\ResponseEmitter 類來響應任意符合 PSR-7 標準的 Response 對象，同時抽象了 Hyperf\Contract\ResponseEmitterInterface 契約；
#1890 為 Hyperf\HttpMessage\Server\Response 類新增了 getTrailers() 和 getTrailer(string $key) 和 withTrailer(string $key, $value) 方法；
#1920 新增方法 Hyperf\WebSocketServer\Sender::close(int $fd, bool $reset = null).

修復

#1825 修復了 StartServer::execute 的 TypeError；
#1854 修復了在 filesystem 中使用 Runtime::enableCoroutine() 時，is_resource 不能工作的問題；
#1900 修復了 Model 中的 asDecimal 方法類型有可能錯誤的問題；
#1917 修復了 Request::isXmlHttpRequest 方法無法正常工作的問題；

變更

#705 統一了 HTTP 異常的處理方式，現在統一拋出一個 Hyperf\HttpMessage\Exception\HttpException 依賴類來替代在 Dispatcher 中直接響應的方式，同時提供了 Hyperf\HttpServer\Exception\Handler\HttpExceptionHandler 異常處理器來處理該類異常；
#1846 當您 require 了 symfony/serializer 庫，不再自動映射 Hyperf\Contract\NormalizerInterface 的實現類，您需要手動添加該映射關係，如下：

use Hyperf\Utils\Serializer\SerializerFactory;
use Hyperf\Utils\Serializer\Serializer;

return [
    Hyperf\Contract\NormalizerInterface::class => new SerializerFactory(Serializer::class),
];

#1924 重命名 Hyperf\GrpcClient\BaseClient 內 simpleRequest, getGrpcClient, clientStreamRequest 方法名為 _simpleRequest, _getGrpcClient, _clientStreamRequest；

移除

#1890 Removed Hyperf\Contract\Sendable interface and all implementations of it.
#1905 Removed config config/server.php, you can merge it into config/config.php.

優化

#1793 Socket.io 服務現在只在 onOpen and onClose 中觸發 connect/disconnect 事件，同時將一些類方法從 private 級別調整到了 protected 級別，以便用户可以方便的重寫這些方法；
#1848 當 RPC 客户端對應的 Contract 發生變更時，自動重寫生成對應的動態代理客户端類；
#1863 為 async-queue 組件提供更加安全的停止機制；
#1896 當在 constants 組件中使用了同樣的 code 時，keys 會被合併起來；

v1.1.32 - 2020-05-21

修復

#1734 修復模型多態查詢，關聯關係為空時，也會查詢 SQL 的問題；
#1739 修復 hyperf/filesystem 組件 OSS HOOK 位運算錯誤，導致 resource 判斷不準確的問題；
#1743 修復 grafana.json 中錯誤的refId 字段值；
#1748 修復 hyperf/amqp 組件在使用其他連接池時，對應的 concurrent.limit 配置不生效的問題；
#1750 修復連接池組件，在連接關閉失敗時會導致計數有誤的問題；
#1754 修復 BASE Server 服務，啟動提示沒有考慮 UDP 服務的情況；
#1764 修復當時間值為 null 時，datatime 驗證器執行失敗的 BUG；
#1769 修復 hyperf/socketio-server 組件中，客户端初始化斷開連接操作時會報 Notice 的錯誤的問題；

新增

#1724 新增模型方法 Model::orWhereHasMorph ,Model::whereDoesntHaveMorph and Model::orWhereDoesntHaveMorph；
#1741 新增 Hyperf\Command\Command::choiceMultiple(): array 方法，因為 choice 方法的返回類型為 string，所以就算設置了 $multiple` 參數也無法處理多個選擇的情況；
#1742 新增模型自定義類型轉換器功能；
- 新增 interface Castable, CastsAttributes 和 CastsInboundAttributes；
- 新增方法 Model\Builder::withCasts；
- 新增方法 Model::loadMorph, Model::loadMorphCount 和 Model::syncAttributes；

v1.1.31 - 2020-05-14

新增

#1723 異常處理器集成了 filp/whoops 。
#1730 為命令 gen:model 可選項 --refresh-fillable 添加簡寫 -R。

修復

#1696 修復方法 Context::copy 傳入字段 keys 後無法正常使用的 BUG。
#1708 #1718 修復 hyperf/socketio-server 組件內存溢出等 BUG。

優化

#1710 MAC 系統下不再使用 cli_set_process_title 方法設置進程名。

v1.1.30 - 2020-05-07

新增

#1616 新增 ORM 方法 morphWith 和 whereHasMorph。
#1651 新增 socket.io-server 組件。
#1666 #1669 新增 AMQP RPC 客户端。

修復

#1682 修復 RpcPoolTransporter 的連接池配置不生效的 BUG。
#1683 修復 RpcConnection 連接失敗後，相同協程內無法正常重置連接的 BUG。

優化

#1670 優化掉 Cache 組件 一條無意義的刪除指令。

v1.1.28 - 2020-04-30

新增

#1645 匿名函數路由支持參數注入。
#1647 為 model-cache 組件添加 RedisStringHandler。
#1654 新增 RenderException 統一捕獲 view 組件拋出的異常。

修復

#1639 修復 rpc-client 會從 consul 中獲取到不健康節點的 BUG。
#1641 修復 rpc-client 獲取到的結果為 null 時，會拋出 RequestException 的 BUG。
#1641 修復 rpc-server 中 jsonrpc-tcp-length-check 協議，無法在 consul 中添加心跳檢查的 BUG。
#1650 修復腳本 describe:routes 列表展示有誤的 BUG。
#1655 修復 MysqlProcessor::processColumns 無法在 MySQL Server 8.0 版本中正常工作的 BUG。

優化

#1636 優化 co-phpunit 腳本，當出現 case 驗證失敗後，協程也可以正常結束。

v1.1.27 - 2020-04-23

新增

#1575 為腳本 gen:model 生成的模型，自動添加 relation scope 和 attributes 的變量註釋。
#1586 添加 symfony/event-dispatcher 組件小於 4.3 時的 conflict 配置。用於解決用户使用了 4.3 以下版本時，導致 SymfonyDispatcher 實現衝突的 BUG。
#1597 為 AMQP 消費者，添加最大消費次數 maxConsumption。
#1603 為 WebSocket 服務添加基於 fd 存儲的 Context。

修復

#1553 修復 jsonrpc 服務，發佈了相同名字不同協議到 consul 後，客户端無法正常工作的 BUG。
#1589 修復了文件鎖在協程下可能會造成死鎖的 BUG。
#1607 修復了重寫後的 go 方法，返回值與 swoole 原生方法不符的 BUG。
#1624 修復當路由 Handler 是匿名函數時，腳本 describe:routes 執行失敗的 BUG。

v1.1.26 - 2020-04-16

新增

#1578 UploadedFile 支持 getStream 方法。

修復

#1563 修復服務關停後，定時器的 onOneServer 配置不會被重置。
#1565 當 DB 組件重連 Mysql 時，重置事務等級為 0。
#1572 修復 Hyperf\GrpcServer\CoreMiddleware 中，自定義類的父類找不到時報錯的 BUG。
#1577 修復 describe:routes 腳本 server 配置不生效的 BUG。
#1579 修復 migrate:refresh 腳本 step 參數不為 int 時會報錯的 BUG。

變更

#1560 修改 hyperf/cache 組件文件緩存引擎中原生的文件操作為 Filesystem。
#1568 修改 hyperf/async-queue 組件 Redis 引擎中的 \Redis 為 RedisProxy。

v1.1.25 - 2020-04-09

修復

#1532 修復 'Symfony\Component\EventDispatcher\EventDispatcherInterface' 在 --no-dev 條件下安裝會出現找不到接口的問題；

v1.1.24 - 2020-04-09

新增

#1501 添加 Symfony 命令行事件觸發器，使之可以與 hyperf/event 組件結合使用；
#1502 為註解 Hyperf\AsyncQueue\Annotation\AsyncQueueMessage 添加 maxAttempts 參數，用於控制消息失敗時重複消費的次數；
#1510 添加 Hyperf/Utils/CoordinatorManager，用於提供更優雅的啟動和停止服務，服務啟動前不響應請求，服務停止前，保證某些循環邏輯能夠正常結束；
#1517 為依賴注入容器的懶加載功能添加了對接口繼承和抽象方法繼承的支持；
#1529 處理 response cookies 中的 SameSite 屬性；

修復

#1494 修復單獨使用 Redis 組件時，註釋 @mixin 會被當成註解的 BUG；
#1499 修復引入 hyperf/translation 組件後，hyperf/constants 組件的動態參數不生效的 BUG；
#1504 修復 RPC 代理客户端無法正常處理返回值為 nullable 類型的方法；
#1507 修復 hyperf/consul 組件的 catalog 註冊方法調用會失敗的 BUG；

v1.1.23 - 2020-04-02

新增

#1467 為 filesystem 組件添加默認配置；
#1469 為 Hyperf/Guzzle/HandlerStackFactory 添加 getHandler() 方法，並儘可能的使用 make() 創建 handler；
#1480 RPC client 現在會自動代理父接口的方法定義；

變更

#1481 異步隊列創建消息時，使用 make 方法創建；

修復

#1471 修復 NSQ 組件，數據量超過 max-output-buffer-size 接收數據失敗的 BUG；
#1472 修復 NSQ 組件，在消費者中發佈消息時，會導致消費者無法正常消費的 BUG；
#1474 修復 NSQ 組件，requeue 消息時，消費者會意外重啟的 BUG；
#1477 修復使用 Hyperf\Testing\Client::flushContext 時，會引發 Fixed Invalid argument supplied 異常的 BUG；

v1.1.22 - 2020-03-26

新增

#1440 為 NSQ 的每個連接新增 enable 配置項來控制連接下的所有消費者的自啟功能；
#1451 新增 Filesystem 組件；
#1459 模型 Collection 新增 macroable 支持；
#1463 為 Guzzle Handler 增加 on_stats 選項的功能支持；

變更

#1452 在注入 Redis 客户端時，推薦使用 \Hyperf\Redis\Redis 來替代 \Redis，原因在 #938；

修復

#1445 修復命令 describe:routes 缺失了帶參數的路由；
#1449 修復了高基數請求路徑的內存溢出的問題；
#1454 修復 Collection 的 flatten() 方法因為 INF 參數值為 float 類型導致無法使用的問題；
#1458 修復了 Guzzle 不支持 Elasticsearch 版本大於 7.0 的問題；

v1.1.21 - 2020-03-19

新增

#1393 為 Hyperf\HttpMessage\Stream\SwooleStream 實現更多的方法；
#1419 允許 ConfigFetcher 通過一個協程啟動而無需額外啟動一個進程；
#1424 允許用户通過配置文件的形式修改 session_name 配置；
#1435 為模型緩存增加 use_default_value 屬性來自動修正緩存數據與數據庫數據之間的差異；
#1436 為 NSQ 消費者增加 isEnable() 方法來控制消費者進程是否啟用自啟功能；

v1.1.20 - 2020-03-12

新增

#1402 增加 Hyperf\DbConnection\Annotation\Transactional 註解來自動開啟一個事務；
#1412 增加 Hyperf\View\RenderInterface::getContents() 方法來直接獲取 View Render 的渲染內容；
#1416 增加 Swoole 事件常量 ON_WORKER_ERROR.

修復

#1405 修復當模型存在 hidden 屬性時，模型緩存功能緩存的字段數據不正確的問題；
#1410 修復 Tracer 無法追蹤由 Hyperf\Redis\RedisFactory 創建的連接的調用鏈；
#1415 修復阿里 ACM 客户端在當 SecurityToken Header 為空時 sts token 會解密失敗的問題；

v1.1.19 - 2020-03-05

新增

#1339 #1394 新增 describe:routes 命令來顯示路由的細節信息；
#1354 為 config-aliyun-acm 組件新增 ecs ram authorization；
#1362 為 Hyperf\Pool\SimplePool\PoolFactory 增加 getPoolNames() 來獲取連接池的名稱；
#1371 新增 Hyperf\DB\DB::connection() 方法來指定要使用的連接；
#1384 為 gen:model 命令新增 property-case 選項來設定成員屬性的命名風格；

修復

#1386 修復異步消息投遞註解當用在存在可變參數的方法上失效的問題；

v1.1.18 - 2020-02-27

新增

#1305 為 hyperf\metric 組件添加預製的 Grafana 面板；
#1328 添加 ModelRewriteInheritanceVisitor 來重寫 model 類繼承的 gen:model 命令；
#1331 添加 Hyperf\LoadBalancer\LoadBalancerInterface::getNodes()；
#1335 為 command 添加 AfterExecute 事件；
#1361 logger 組件添加 processors 配置；

修復

#1330 修復當使用 (new Parallel())->add($callback, $key) 並且參數 $key 並非 string 類型, 返回結果將會從 0 開始排序 $key；
#1338 修復當從 server 設置自己的設置時, 主 server 的配置不生效的 bug；
#1344 修復隊列在沒有設置最大消息數時每次都需要校驗長度的 bug；

變更

#1324 hyperf/async-queue 組件不再提供默認啟用 Hyperf\AsyncQueue\Listener\QueueLengthListener；

優化

#1305 優化 hyperf\metric 中的邊界條件；
#1322 HTTP Server 自動處理 HEAD 請求並且不會在 HEAD 請求時返回 Response body；

刪除

#1303 刪除 Hyperf\RpcServer\Router\Router 中無用的 $httpMethod；

v1.1.17 - 2020-01-24

新增

#1220 為 Apollo 組件增加 BootProcessListener 來實現在服務啟動時從 Apollo 拉取配置的功能；
#1292 為 Hyperf\Database\Schema\Blueprint::foreign() 方法的返回類型增加了 Hyperf\Database\Schema\ForeignKeyDefinition 類型；
#1313 為 hyperf\crontab 組件增加了 Command 模式支持；
#1321 增加 hyperf/nsq 組件，NSQ 是一個實時的分佈式消息平台；

修復

#1291 修復 hyperf/super-globals 組件的 $_SERVER 存在小寫鍵值與 PHP-FPM 不統一的問題；
#1308 修復 hyperf/validation 組件缺失的一些翻譯內容, 包括 gt, gte, ipv4, ipv6, lt, lte, mimetypes, not_regex, starts_with, uuid；
#1310 修復服務註冊在當服務同名不同協議的情況下會被覆蓋的問題；
#1315 修復 Hyperf\AsyncQueue\Process\ConsumerProcess 類缺失的 $config 變量；

v1.1.16 - 2020-01-16

新增

#1263 為 async-queue 組件增加 QueueLength 事件；
#1276 為 Consul 客户端增加 ACL token 支持；
#1277 為 hyperf/metric 組件增加 NoOp 驅動，用來臨時關閉 metric 功能；

修復

#1262 修復 keepaliveIO 功能下 socket 會被消耗光的問題；
#1266 修復當自定義進程存在 Timer 的情況下會無法重啟的問題；
#1272 修復 JSONRPC 下當 Request ID 為 null 時檢查會失敗的問題；

優化

#1273 優化 gRPC 客户端：
- 優化使 gRPC 客户端在當連接與 Server 斷開時會自動重連；
- 優化使當 gRPC 客户端被垃圾回收時，已建立的連接會自動關閉；
- 修復關閉了的客户端依舊會持有 HTTP2 連接的問題；
- 修復 gRPC 客户端的 channel pool 可能會存在非空 channel 的問題；
- 優化使 gRPC 客户端會自動初始化，所以現在可以在構造函數和容器注入下使用；

刪除

#1286 從 require-dev 中移除 phpstan/phpstan 包的依賴。

v1.1.15 - 2020-01-10

修復

#1258 修復 AMQP 發送心跳失敗，會導致子進程 Socket 通信不可用的問題；
#1260 修復 JSONRPC 在同一協程內，連接會混淆複用的問題；

v1.1.14 - 2020-01-10

新增

#1166 為 AMQP 增加 KeepaliveIO 功能；
#1208 為 JSON-RPC 的響應增加了 error.data.code 值來傳遞 Exception Code；
#1208 為 Hyperf\Rpc\Contract\TransporterInterface 增加了 recv 方法；
#1215 新增 hyperf/super-globals 組件，用來適配一些不支持 PSR-7 的第三方包；
#1219 為 AMQP 消費者增加 enable 屬性，通過該屬性來控制該消費者是否跟隨 Server 一同啟動；

修復

#1208 修復 Exception 和 error 在 JSON-RPC TCP Server 下無法被正確處理的問題；
#1208 修復 JSON-RPC 沒有檢查 Request ID 和 Response ID 是否一致的問題；
#1223 修復 ConfigProvider 掃描器不會掃描 composer.json 內 require-dev 的配置；
#1254 修復執行 init-proxy.sh 命令在某些環境如 Alpine 下會報 bash 不存在的問題；

優化

#1208 優化了 JSON-RPC 組件的部分邏輯；
#1174 調整了 Hyperf\Utils\Parallel 在輸出異常時的格式，現在會一同打印 Trace 信息；
#1224 允許 Aliyun ACM 配置中心的配置獲取進程解析 UTF-8 字符，同時在 Worker 啟動後會自動獲取一次配置，以及拉取的配置現在會傳遞到自定義進程了；
#1235 在 AMQP 生產者執行 declare 後釋放對應的連接；

修改

#1227 升級 jcchavezs/zipkin-php-opentracing 依賴至 0.1.4 版本；

v1.1.13 - 2020-01-03

新增

#1137 constants 組件增加國際化支持；
#1165 Hyperf\HttpServer\Contract\RequestInterface 新增 route 方法；
#1195 註解 Cacheable 和 CachePut 增加最大超時時間偏移量配置；
#1204 database 組件增加了 insertOrIgnore 方法；
#1216 RenderInterface::render() 方法的 $data 參數，添加了默認值；
#1221 swoole-tracker 組件添加了 traceId 和 spanId；

修復

#1175 修復 Hyperf\Utils\Collection::random 當傳入 null 時，無法正常工作的 BUG；
#1199 修復使用 Task 註解時，參數無法使用動態變量的 BUG；
#1200 修復 metric 組件，請求路徑會攜帶參數的 BUG；
#1210 修復驗證器規則 size 無法作用於 integer 的 BUG；

優化

#1211 自動將項目名轉化為 prometheus 的規範命名；

修改

#1217 將 zendframework/zend-mime 替換為 laminas/laminas-mine；

v1.1.12 - 2019-12-26

新增

#1177 為 jsonrpc 組件增加了新的協議 jsonrpc-tcp-length-check，並對部分代碼進行了優化；

修復

#1175 修復 Hyperf\Utils\Collection::random 方法不支持傳入 null；
#1178 修復 Hyperf\Database\Query\Builder::chunkById 方法不支持元素是 array 的情況；
#1189 修復 Hyperf\Utils\Collection::operatorForWhere 方法，operator 只能傳入 string 的 BUG；

優化

#1186 日誌配置中，只填寫 formatter.class 的情況下，可以使用默認的 formatter.constructor 配置；

v1.1.11 - 2019-12-19

新增

#849 為 hyperf/tracer 組件增加 span tag 配置功能；

修復

#1142 修復 Register::resolveConnection 會返回 null 的問題；
#1144 修復配置文件形式下服務限流會失效的問題；
#1145 修復 CoroutineMemoryDriver::delKey 方法的返回值錯誤的問題；
#1153 修復驗證器的 alpha_num 規則無法按預期運行的問題；

v1.1.10 - 2019-12-12

修復

#1104 修復了 Guzzle 客户端的重試中間件的狀態碼識別範圍為 2xx；
#1105 修復了 Retry 組件在重試嘗試前不還原管道堆棧的問題；
#1106 修復了數據庫在開啟 sticky 模式時連接回歸連接池時沒有重置狀態的問題；
#1119 修復 TCP 協議下的 JSONRPC Server 在解析 JSON 失敗時無法正確的返回預期的 Error Response 的問題；
#1124 修復 Session 中間件在儲存當前的 URL 時，當 URL 以 / 結尾時會忽略斜槓的問題；

變更

#1108 重命名 Hyperf\Tracer\Middleware\TraceMiddeware 為 Hyperf\Tracer\Middleware\TraceMiddleware；
#1108 升級 Hyperf\ServiceGovernance\Listener\ServiceRegisterListener 類的成員屬性和方法的等級為 protected，以便更好的重寫相關方法；

v1.1.9 - 2019-12-05

新增

#948 為 DI Container 增加懶加載功能；
#1044 為 AMQP Consumer 增加 basic_qos 配置；
#1056 #1081 DI Container 增加 define() 和 set() 方法，同時增加 Hyperf\Contract\ContainerInterface；
#1059 job.stub 模板增加構造函數；
#1084 支持 PHP 7.4，TrvisCI 增加 PHP 7.4 運行支持；

修復

#1007 修復 vendor:: publish 的命令返回值；
#1049 修復 Hyperf\Cache\Driver\RedisDriver::clear 會有可能刪除所有緩存失敗的問題；
#1055 修復 Image 驗證時後綴大小寫的問題；
#1085 #1091 Fixed @Retry 註解使用時會找不到容器的問題；

v1.1.8 - 2019-11-28

新增

#965 新增 Redis Lua 模塊，用於管理 Lua 腳本；
#1023 hyperf/metric 組件的 Prometheus 驅動新增 CUSTOM_MODE 模式；

修復

#1013 修復 JsonRpcPoolTransporter 配置合併失敗的問題；
#1006 修復 gen:model 命令生成的屬性的順序；

變更

#1021 WebSocket 客户端新增默認端口支持，根據協議默認為 80 和 443；
#1034 去掉了 Hyperf\Amqp\Builder\Builder 的 arguments 參數的 array 類型限制，允許接受其他類型如 AmqpTable；

優化

#1014 優化 Command::execute 的返回值類型；
#1022 提供更清晰友好的連接池報錯信息；
#1039 在 CoreMiddleware 中自動設置最新的 ServerRequest 對象到 Context；

v1.1.7 - 2019-11-21

新增

#860 新增 hyperf/retry 組件；
#952 新增 ThinkTemplate 視圖引擎支持；
#973 新增 JSON RPC 在 TCP 協議下的連接池支持，通過 Hyperf\JsonRpc\JsonRpcPoolTransporter 來使用連接池版本；
#976 為 hyperf/amqp 組件新增 close_on_destruct 選項參數，用來控制代碼在執行析構函數時是否主動去關閉連接；

變更

#944 將組件內所有使用 @Listener 和 @Process 註解來註冊的改成通過 ConfigProvider來註冊；
#977 調整 init-proxy.sh 命令的行為，改成只刪除 runtime/container 目錄；

修復

#955 修復 hyperf/db 組件的 port 和 charset 參數無效的問題；
#956 修復模型緩存中使用到RedisHandler::incr 在集羣模式下會失敗的問題；
#966 修復當在非 Worker 進程環境下使用分頁器會報錯的問題；
#968 修復當 classes 和 annotations 兩種 Aspect 切入模式同時存在於一個類時，其中一個可能會失效的問題；
#980 修復 Session 組件內 migrate, save 核 has 方法無法使用的問題；
#982 修復 Hyperf\GrpcClient\GrpcClient::yield 在獲取 Channel Pool 時沒有通過正確的獲取方式去獲取的問題；
#987 修復通過 gen:command 命令生成的命令類缺少調用 parent::configure() 方法的問題；

優化

#991 優化 Hyperf\DbConnection\ConnectionResolver::connection的異常情況處理；

v1.1.6 - 2019-11-14

新增

#827 新增了極簡的高性能的 DB 組件；
#905 視圖組件增加了 twig 模板引擎；
#911 定時任務支持多實例情況下，只運行單一實例的定時任務；
#913 增加監聽器 Hyperf\ExceptionHandler\Listener\ErrorExceptionHandler；
#921 新增 Session 組件；
#931 阿波羅配置中心增加 strict_mode，自動將配置轉化成對應數據類型；
#933 視圖組件增加了 plates 模板引擎；
#937 Nats 組件添加消費者消費和訂閲事件；
#941 新增 Zookeeper 配置中心；

變更

#934 修改 WaitGroup 繼承 \Swoole\Coroutine\WaitGroup；

修復

#897 修復 Nats 消費者，pool 配置無效的 BUG；
#901 修復 GraphQL 組件，Factory 註解無法正常使用的 BUG；
#903 修復添加 hyperf/rpc-client 依賴後，init-proxy 腳本無法正常停止的 BUG；
#904 修復監聽器監聽 Hyperf\Framework\Event\BeforeMainServerStart 事件時，無法使用 IO 操作的 BUG；
#906 修復 Hyperf\HttpMessage\Server\Request 端口獲取有誤的 BUG；
#907 修復 Nats 組件 requestSync 方法，超時時間不準確的 BUG；
#909 修復 Parallel 內邏輯拋錯後，無法正常停止的 BUG；
#925 修復因 Socket 無法正常建立，導致進程頻繁重啟的 BUG；
#932 修復 Translator::setLocale 在協程環境下，數據混淆的 BUG；
#940 修復 WebSocketClient::push 方法 finish 參數類型錯誤；

優化

#907 優化 Nats 消費者頻繁重啟；
#928 Hyperf\ModelCache\Cacheable::query 批量修改數據時，可以刪除對應緩存；
#936 優化調用模型緩存 increment 時，可能因併發情況導致的數據有錯；

v1.1.5 - 2019-11-07

新增

#812 新增計劃任務在集羣下僅執行一次的支持；
#820 新增 hyperf/nats 組件；
#832 新增 Hyperf\Utils\Codec\Json；
#833 新增 Hyperf\Utils\Backoff；
#852 為 Hyperf\Utils\Parallel 新增 clear() 方法來清理所有已添加的回調；
#854 新增 Hyperf\GraphQL\GraphQLMiddleware 用於解析 GraphQL 請求；
#859 新增 Consul 集羣的支持，現在可以從 Consul 集羣中拉取服務提供者的節點信息；
#873 新增 Redis 集羣的客户端支持；

修復

#831 修復 Redis 客户端連接在 Redis Server 重啟後不會自動重連的問題；
#835 修復 Request::inputs 方法的默認值參數與預期效果不一致的問題；
#841 修復數據庫遷移在多數據庫的情況下連接無效的問題；
#844 修復 Composer 閲讀器不支持根命名空間的用法的問題；
#846 修復 Redis 客户端的 scan, hScan, zScan, sScan 無法使用的問題；
#850 修復 Logger group 在 name 一樣時不生效的問題；

優化

#832 優化了 Response 對象在轉 JSON 格式時的異常處理邏輯；
#840 使用 \Swoole\Timer::* 來替代 swoole_timer_* 函數；
#859 優化了 RPC 客户端去 Consul 獲取健康的節點信息的邏輯；

v1.1.4 - 2019-10-31

新增

#778 Hyperf\Testing\Client 新增 PUT 和 DELETE方法；
#784 新增服務監控組件；
#795 AbstractProcess 增加 restartInterval 參數，允許子進程異常或正常退出後，延遲重啟；
#804 Command 增加事件 BeforeHandle AfterHandle 和 FailToHandle；

變更

#793 Pool::getConnectionsInChannel 方法由 protected 改為 public.
#811 命令 di:init-proxy 不再主動清理代理緩存，如果想清理緩存請使用命令 vendor/bin/init-proxy.sh；

修復

#779 修復 JPG 文件驗證不通過的問題；
#787 修復 db:seed 參數 --class 多餘，導致報錯的問題；
#795 修復自定義進程在異常拋出後，無法正常重啟的 BUG；
#796 修復 etcd 配置中心 enable 即時設為 false，在項目啟動時，依然會拉取配置的 BUG；

優化

#781 可以根據國際化組件配置發佈驗證器語言包到規定位置；
#796 優化 ETCD 客户端，不會多次創建 HandlerStack；
#797 優化子進程重啟

v1.1.3 - 2019-10-24

新增

#745 為 gen:model 命令增加 with-comments 選項，以標記是否生成字段註釋；
#747 為 AMQP 消費者增加 AfterConsume, BeforeConsume, FailToConsume 事件；
#762 為 Parallel 特性增加協程控制功能；

變更

#767 重命名 AbstractProcess 的 running 屬性名為 listening；

修復

#741 修復執行 db:seed 命令缺少文件名報錯的問題；
#748 修復 SymfonyNormalizer 不處理 array 類型數據的問題；
#769 修復當 JSON RPC 響應的結果的 result 和 error 屬性為 null 時會拋出一個無效請求的問題；

v1.1.2 - 2019-10-17

新增

#722 為 AMQP Consumer 新增 concurrent.limit 配置來對協程消費進行速率限制；

變更

#678 為 gen:model 命令增加 ignore-tables 參數，同時默認屏蔽 migrations 表，即 migrations 表對應的模型在執行 gen:model 命令時不會生成；

修復

#694 修復 Hyperf\Validation\Request\FormRequest 的 validationData 方法不包含上傳的文件的問題；
#700 修復 Hyperf\HttpServer\Contract\ResponseInterface 的 download 方法不能按預期運行的問題；
#701 修復自定義進程在出現未捕獲的異常時不會自動重啟的問題；
#704 修復 Hyperf\Validation\Middleware\ValidationMiddleware 在 action 參數沒有定義參數類型時會報錯的問題；
#713 修復當開啟了註解緩存功能是，ignoreAnnotations 不能按預期工作的問題；
#717 修復 getValidatorInstance 方法會重複創建驗證器對象的問題；
#724 修復 db:seed 命令在沒有傳 database 參數時會報錯的問題；
#729 修正組件配置項 db:model 為 gen:model；
#737 修復非 Worker 進程下無法使用 Tracer 組件來追蹤調用鏈的問題；

v1.1.1 - 2019-10-08

Fixed

#664 調整通過 gen:request 命令生成 FormRequest 時 authorize 方法的默認返回值；
#665 修復啟動時永遠會自動生成代理類的問題；
#667 修復當訪問一個不存在的路由時 Hyperf\Validation\Middleware\ValidationMiddleware 會拋出異常的問題；
#672 修復當 Action 方法上的參數類型為非對象類型時 Hyperf\Validation\Middleware\ValidationMiddleware 會拋出一個未捕獲的異常的問題；
#674 修復使用 gen:model 命令從數據庫生成模型時模型表名錯誤的問題；

v1.1.0 - 2019-10-08

新增

#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 來達到同樣的目的；
#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 值到代理類的方法參數時，方法仍然會獲取方法默認值的問題；

v1.0.16 - 2019-09-20

新增

#565 增加對 Redis 客户端的 options 配置參數支持；
#580 增加協程併發控制特性，通過 Hyperf\Utils\Coroutine\Concurrent 可以實現一個代碼塊內限制同時最多運行的協程數量；

變更

#583 當 BaseClient::start 失敗時會拋出 Hyperf\GrpcClient\Exception\GrpcClientException 異常；
#585 當投遞到 TaskWorker 執行的 Task 失敗時，會回傳異常到 Worker 進程中；

修復

#564 修復某些情況下 Coroutine\Http2\Client->send 返回值不正確的問題；
#567 修復當 JSON RPC 消費者配置 name 不是接口時，無法生成代理類的問題；
#571 修復 ExceptionHandler 的 stopPropagation 的協程變量污染的問題；
#579 動態初始化 snowflake 的 MetaData，主要修復當在命令模式下使用 Snowflake 時，比如 di:init-proxy 命令，會連接到 Redis 服務器至超時；

v1.0.15 - 2019-09-11

修復

#534 修復 Guzzle HTTP 客户端的 CoroutineHanlder 沒有處理狀態碼為 -3 的情況；
#541 修復 gRPC 客户端的 $client 參數設置錯誤的問題；
#542 修復 Hyperf\Grpc\Parser::parseResponse 無法支持 gRPC 標準狀態碼的問題；
#551 修復當服務端關閉了 gRPC 連接時，gRPC 客户端會殘留一個死循環的協程；
#558 修復 UDP Server 無法正確配置啟動的問題；

優化

#549 優化了 Hyperf\Amqp\Connection\SwooleIO 的 read 和 write 方法，減少不必要的重試；
#559 優化 Hyperf\HttpServer\Response::redirect() 方法，自動識別鏈接首位是否為斜槓併合理修正參數；
#560 優化 Hyperf\WebSocketServer\CoreMiddleware，移除了不必要的代碼；

移除

#545 移除了 Hyperf\Database\Model\SoftDeletes 內無用的 restoring 和 restored 靜態方法；

即將移除

#558 標記了 Hyperf\Server\ServerInterface::SERVER_TCP 常量為 棄用 狀態，該常量將於 v1.1 移除，由更合理的 Hyperf\Server\ServerInterface::SERVER_BASE 常量替代；

v1.0.14 - 2019-09-05

新增

#389 #419 #432 #524 新增 Snowflake 官方組件, Snowflake 是一個由 Twitter 提出的分佈式全局唯一 ID 生成算法，hyperf/snowflake 組件實現了該算法並設計得易於使用，同時在設計上提供了很好的可擴展性，可以很輕易的將該組件轉換成其它基於 Snowflake 算法的變體算法；
#525 為 Hyperf\HttpServer\Contract\ResponseInterface 增加一個 download() 方法，提供便捷的下載響應返回；

變更

#482 生成模型文件時，當設置了 refresh-fillable 選項時重新生成模型的 fillable 屬性，同時該命令的默認情況下將不會再覆蓋生成 fillable 屬性；
#501 當 Mapping 註解的 path 屬性為一個空字符串時，那麼該路由則為 /prefix；
#513 如果項目設置了 app_name 屬性，則進程名稱會自動帶上該名稱；
#508 #526 當在非協程環境下執行 Hyperf\Utils\Coroutine::parentId() 方法時會返回一個 null 值；

修復

#479 修復了當 Elasticsearch client 的 host 屬性設置有誤時，返回類型錯誤的問題；
#514 修復當 Redis 密碼配置為空字符串時鑑權失敗的問題；
#527 修復 Translator 無法重複翻譯的問題；

v1.0.13 - 2019-08-28

新增

#449 新增一個獨立組件 hyperf/translation，衍生於 illuminate/translation；
#449 為 GRPC-Server 增加標準錯誤碼；
#450 為 Hyperf\Database\Schema\Schema 類的魔術方法增加對應的靜態方法註釋，為 IDE 提供代碼提醒的支持；

變更

#451 在使用 @AutoController 註解時不再會自動為魔術方法生成對應的路由；
#468 讓 GRPC-Server 和 HTTP-Server 提供的異常處理器處理所有的異常，而不只是 ServerException；

修復

#466 修復分頁時數據不足時返回類型錯誤的問題；
#466 優化了 vendor:publish 命令，當要生成的目標文件夾存在時，不再重複生成；

v1.0.12 - 2019-08-21

新增

#405 增加 Hyperf\Utils\Context::override() 方法，現在你可以通過 override 方法獲取某些協程上下文的值並修改覆蓋它；
#415 對 Logger 的配置文件增加多個 Handler 的配置支持；

變更

#431 移除了 Hyperf\GrpcClient\GrpcClient::openStream() 的第 3 個參數，這個參數不會影響實際使用；

修復

#414 修復 Hyperf\WebSockerServer\Exception\Handler\WebSocketExceptionHandler 內的變量名稱錯誤的問題；
#424 修復 Guzzle 在使用 Hyperf\Guzzle\CoroutineHandler 時配置 proxy 參數時不支持數組傳值的問題；
#430 修復 Hyperf\HttpServer\Request::file() 當以一個 Name 上傳多個文件時，返回格式不正確的問題；
#431 修復 GRPC Client 的 Request 對象在發送 Force-Close 請求時缺少參數的問題；

v1.0.11 - 2019-08-15

新增

#366 增加 Hyperf\Server\Listener\InitProcessTitleListener 監聽者來設置進程名稱，同時增加了 Hyperf\Framework\Event\OnStart 和 Hyperf\Framework\Event\OnManagerStart 事件；

修復

#361 修復 db:model命令在 MySQL 8 下不能正常運行；
#369 修復實現 \Serializable 接口的自定義異常類不能正確的序列化和反序列化問題；
#384 修復用户自定義的 ExceptionHandler 在 JSON RPC Server 下無法正常工作的問題，因為框架默認自動處理了對應的異常；
#370 修復了 Hyperf\GrpcClient\BaseClient 的 $client 屬性在流式傳輸的時候設置了錯誤的類型的值的問題, 同時增加了默認的 content-type 為 application/grpc+proto，以及允許用户通過自定義 Request 對象來重寫 buildRequest() 方法；

變更

#356 #390 優化 aysnc-queue 組件當生成 Job 時，如果 Job 實現了 Hyperf\Contract\CompressInterface，那麼 Job 對象會被壓縮為一個更小的對象；
#358 只有當 $enableCache 為 true 時才生成註解緩存文件；
#359 #390 為 Collection 和 Model 增加壓縮能力，當類實現 Hyperf\Contract\CompressInterface 可通過 compress 方法生成一個更小的對象；

v1.0.10 - 2019-08-09

新增

#321 為 HTTP Server 的 Controller/RequestHandler 參數增加自定義對象類型的數組支持，特別適用於 JSON RPC 下，現在你可以通過在方法上定義 @var Object[] 來獲得框架自動反序列化對應對象的支持；
#324 增加一個實現於 Hyperf\Contract\IdGeneratorInterface 的 ID 生成器 NodeRequestIdGenerator；
#336 增加動態代理的 RPC 客户端功能；
#346 #348 為 hyperf/cache 緩存組件增加文件驅動；

變更

#330 當掃描的 $paths 為空時，不輸出掃描信息；
#328 根據 Composer 的 PSR-4 定義的規則加載業務項目；
#329 優化 JSON RPC 服務端和客户端的異常消息處理；
#340 為 make 函數增加索引數組的傳參方式；
#349 重命名下列類，修正由於拼寫錯誤導致的命名錯誤；

原類名	修改後的類名
Hyperf\Database\Commands\Ast\ModelUpdateVistor	Hyperf\Database\Commands\Ast\ModelUpdateVisitor
Hyperf\Di\Aop\ProxyClassNameVistor	Hyperf\Di\Aop\ProxyClassNameVisitor
Hyperf\Di\Aop\ProxyCallVistor	Hyperf\Di\Aop\ProxyCallVisitor

修復

#325 優化 RPC 服務註冊時會多次調用 Consul Services 的問題；
#332 修復 Hyperf\Tracer\Middleware\TraceMiddeware 在新版的 openzipkin/zipkin 下的類型約束錯誤；
#333 修復 Redis::delete() 方法在 5.0 版不存在的問題；
#334 修復向阿里雲 ACM 配置中心拉取配置時，部分情況下部分配置無法更新的問題；
#337 修復當 Header 的 key 為非字符串類型時，會返回 500 響應的問題；
#338 修復 ProviderConfig::load 在遇到重複 key 時會導致在深度合併時將字符串轉換成數組的問題；

v1.0.9 - 2019-08-03

新增

#317 增加 composer-json-fixer 來優化 composer.json 文件的內容；
#320 DI 定義 Definition 時，允許 value 為一個匿名函數；

修復

#300 讓 AsyncQueue 的消息於子協程內來進行處理，修復 attempts 參數與實際重試次數不一致的問題；
#305 修復 Hyperf\Utils\Arr::set 方法的 $key 參數不支持 int 個 null 的問題；
#312 修復 Hyperf\Amqp\BeforeMainServerStartListener 監聽器的優先級錯誤的問題；
#315 修復 ETCD 配置中心在 Worker 進程重啟後或在自定義進程內無法使用問題；
#318 修復服務會持續註冊到服務中心的問題；

變更

#323 強制轉換 Cacheable 和 CachePut 註解的 $ttl 屬性為 int 類型；

v1.0.8 - 2019-07-31

新增

#276 AMQP 消費者支持配置及綁定多個 routing_key；
#277 增加 ETCD 客户端組件及 ETCD 配置中心組件；

變更

#297 如果服務註冊失敗，會於 10 秒後重試註冊，且屏蔽了連接不上服務中心(Consul)而拋出的異常；
#298 #301 適配 openzipkin/zipkin v1.3.3+ 版本；

修復

#271 修復了 AOP 在 classes 只會策略下配置同一個類的多個方法只會實現第一個方法的代理方法的問題；
#285 修復了 AOP 在匿名類下生成節點存在丟失的問題；
#286 自動 rollback 沒有 commit 或 rollback 的 MySQL 連接；
#292 修復了 Request::header 方法的 $default 參數無效的問題；
#293 修復了 Arr::get 方法的 $key 參數不支持 int and null 傳值的問題；

v1.0.7 - 2019-07-26

修復

#266 修復投遞 AMQP 消息時的超時邏輯；
#273 修復當有一個服務註冊到服務中心的時候所有服務會被移除的問題；
#274 修復視圖響應的 Content-Type ；

v1.0.6 - 2019-07-24

新增

#203 #236 #247 #252 增加視圖組件，支持 Blade 引擎和 Smarty 引擎；
#203 增加 Task 組件，適配 Swoole Task 機制；
#245 增加 TaskWorkerStrategy 和 WorkerStrategy 兩種定時任務調度策略.
#251 增加用協程上下文作為儲存的緩存驅動；
#254 增加 RequestMapping::$methods 對數組傳值的支持, 現在可以通過 @RequestMapping(methods={"GET"}) 和 @RequestMapping(methods={RequestMapping::GET}) 兩種新的方式定義方法；
#255 控制器返回 Hyperf\Utils\Contracts\Arrayable 會自動轉換為 Response 對象, 同時對返回字符串的響應對象增加 text/plain Content-Type;
#256 如果 Hyperf\Contract\IdGeneratorInterface 存在容器綁定關係, 那麼 json-rpc 客户端會根據該類自動生成一個請求 ID 並儲存在 Request attribute 裏，同時完善了 JSON RPC 在 TCP 協議下的服務註冊及健康檢查；

變更

#247 使用 WorkerStrategy 作為默認的計劃任務調度策略；
#256 優化 JSON RPC 的錯誤處理，現在當方法不存在時也會返回一個標準的 JSON RPC 錯誤對象；

修復

#235 為 grpc-server 增加了默認的錯誤處理器，防止錯誤拋出.
#240 優化了 OnPipeMessage 事件的觸發，修復會被多個監聽器獲取錯誤數據的問題；
#257 修復了在某些環境下無法獲得內網 IP 的問題；

v1.0.5 - 2019-07-17

新增

#185 響應(Response) 增加 xml 格式支持；
#202 在協程內拋出未捕獲的異常時，默認輸出異常的 trace 信息；
#138 #197 增加秒級定時任務組件；

變更

#195 變更 retry() 函數的 $times 參數的行為意義, 表示重試的次數而不是執行的次數；
#198 優化 Hyperf\Di\Container 的 has() 方法, 當傳遞一個不可實例化的示例（如接口）至 $container->has($interface) 方法時，會返回 false；
#199 當生產 AMQP 消息失敗時，會自動重試一次；
#200 通過 Git 打包項目的部署包時，不再包含 tests 文件夾；

修復

#176 修復 LengthAwarePaginator::nextPageUrl() 方法返回值的類型約束；
#188 修復 Guzzle Client 的代理設置不生效的問題；
#211 修復 RPC Client 存在多個時會被最後一個覆蓋的問題；
#212 修復 Guzzle Client 的 ssl_key 和 cert 配置項不能正常工作的問題；

v1.0.4 - 2019-07-08

新增

#140 支持 Swoole v4.4.0.
#152 數據庫連接在低使用率時連接池會自動釋放連接
#163 constants 組件的AbstractConstants::__callStatic 支持自定義參數

變更

#124 DriverInterface::push 增加 $delay 參數用於設置延遲時間, 同時 DriverInterface::delay 將標記為棄用的，將於 1.1 版本移除
#125 更改 config() 函數的 $default 參數的默認值為 null.

修復

#110 #111 修復 Redis::select 無法正常切換數據庫的問題
#131 修復 middlewares 配置在 Router::addGroup 下無法正常設置的問題
#132 修復 request->hasFile 判斷條件錯誤的問題
#135 修復 response->redirect 在調整外鏈時無法正確生成鏈接的問題
#139 修復 ConsulAgent 的 URI 無法自定義設置的問題
#148 修復當 migrates 文件夾不存在時無法生成遷移模板的問題
#169 修復處理請求時沒法正確處理數組類型的參數
#170 修復當路由不存在時 WebSocket Server 無法正確捕獲異常的問題

移除

#131 移除 Router options 裏的 server 參數

v1.0.3 - 2019-07-02

新增

#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 註解時會報錯的問題

v1.0.2 - 2019-06-25

新增

接入 Travis CI，目前 Hyperf 共存在 426 個單測，1124 個斷言； #25
完善了對 Redis::connect 方法的參數支持； #29

修復

修復了 HTTP Server 會被 WebSocket Server 影響的問題（WebSocket Server 尚未發佈）；
修復了代理類部分註解沒有生成的問題；
修復了數據庫連接池在單測環境下會無法獲取連接的問題；
修復了 co-phpunit 在某些情況下不能按預期運行的問題；
修復了模型事件 creating, updating ... 運行與預期不一致的問題；
修復了 flushContext 方法在單測環境下不能按預期運行的問題；

96 KiB Raw Blame History Unescape Escape

版本更新記錄

v2.0.12 - 2020-09-21

Added

Fixed

Optimized

v2.0.11 - 2020-09-14

新增

修復

優化

變更

v2.0.10 - 2020-09-07

新增

修復

優化

v2.0.9 - 2020-08-31

新增

修改

優化

v2.0.8 - 2020-08-24

新增

修復

優化

v2.0.7 - 2020-08-17

新增

修復

v2.0.6 - 2020-08-10

新增

修復

v2.0.5 - 2020-08-03

新增

修復

優化

v2.0.4 - 2020-07-27

新增

修復

優化

v2.0.3 - 2020-07-20

新增

修復

優化

v2.0.2 - 2020-07-13

修復

新增

優化

變更

移除

v2.0.1 - 2020-07-02

新增

修復

變更

優化

v2.0 - 2020-06-22

主要功能

依賴庫更新

類和方法的變更

新增

修復

變更

移除

優化

v1.1.32 - 2020-05-21

修復

新增

v1.1.31 - 2020-05-14

新增

修復

優化

v1.1.30 - 2020-05-07

新增

修復

優化

v1.1.28 - 2020-04-30

新增

修復

優化

v1.1.27 - 2020-04-23

新增

修復

v1.1.26 - 2020-04-16

96 KiB

Raw Blame History