hyperf/docs/zh-tw/changelog-v2.2.md

版本更新記錄

v2.2.33 - 2022-05-30

修復

• #4776 修復 GraphQL 事件收集失敗的問題。
• #4790 修復 RPN 元件中方法 toRPNExpression 在某些場景無法正常工作的問題。

Added

• #4763 新增驗證規則 array:key1,key2，確保陣列中除 key1 key2 以外無其他 key 鍵。
• #4781 新增配置 close-pull-request.yml，用來自動關閉只讀的倉庫。

v2.2.32 - 2022-05-16

修復

• #4745 當使用 kafka 元件的 Producer::close 方法時，修復可能丟擲空指標異常的問題。
• #4754 透過配置 monolog>=2.6.0 解決新版本的 monolog 無法正常工作的問題。

最佳化

• #4738 當使用 kafka 元件時，如果沒有設定 GroupID 則自動配置一個。

v2.2.31 - 2022-04-18

修復

• #4677 修復使用 kafka 釋出者後，會導致程序無法正常退出的問題。
• #4686 修復使用 WebSocket 服務時，因為解析 Request 失敗會導致程序崩潰的問題。

新增

• #4576 為 RPC 客戶端的節點，增加路由字首 path_prefix。
• #4683 新增容器方法 unbind() 用來從容器中解綁物件。

v2.2.30 - 2022-04-04

修復

• #4648 當使用 retry 元件中的熔斷器時，修復在 open 狀態下，無法自動呼叫 fallback 方法的問題。
• #4657 修復使用 session 中的檔案介面卡時，相同的 Session ID 在被重寫後，最後修改時間仍是上次修改時間的問題。

新增

• #4646 為 Redis 哨兵模式增加設定密碼的功能。

v2.2.29 - 2022-03-28

修復

• #4620 修復 Hyperf\Memory\LockManager::initialize() 方法中，$filename 預設值錯誤的問題。

v2.2.28 - 2022-03-14

修復

• #4588 修復 database 元件不支援 bit 型別的問題。
• #4589 修復使用 Nacos 時，無法正確的註冊臨時例項的問題。

新增

• #4580 新增方法 Hyperf\Utils\Coroutine\Concurrent::getChannel()。

最佳化

• #4602 將方法 Hyperf\ModelCache\Manager::formatModels() 更改為公共方法。

v2.2.27 - 2022-03-07

最佳化

• #4572 當負載均衡器 hyperf/load-balancer 選擇節點失敗時，使用 Hyperf\LoadBalancer\Exception\RuntimeException 代替 \RuntimeException。

v2.2.26 - 2022-02-21

修復

• #4536 修復使用 JsonRPC 時，會設定多次 content-type 的問題。

新增

• #4527 為 Hyperf\Database\Schema\Blueprint 增加了一些比較有用的方法。

最佳化

• #4514 透過使用小寫 key 獲取 HTTP 的 Header 資訊，提升一部分效能。
• #4521 在使用 Redis 的哨兵模式時，如果第一個哨兵節點連線失敗，則嘗試連線其餘哨兵節點。
• #4529 將元件 hyperf/context 從元件 hyperf/utils 中分離出來。

v2.2.25 - 2022-01-30

修復

• #4484 修復使用 Nacos v2.0.4 版本時，服務是否註冊過，判斷有誤的問題。

新增

• #4477 為 Hyperf\HttpServer\Request 新增 Macroable 支援。

最佳化

• #4254 當使用 Hyperf\Di\ScanHandlerPcntlScanHandler 時，增加 grpc.enable_fork_support 檢測。

v2.2.24 - 2022-01-24

修復

• #4474 修復使用多路複用 RPC 時，導致測試指令碼無法正常停止的問題。

最佳化

• #4451 優化了 Hyperf\Watcher\Driver\FindNewerDriver 的程式碼。

v2.2.23 - 2022-01-17

修復

• #4426 修復 view-engine 模板引擎，在併發請求下導致模板快取生成錯誤的問題。

新增

• #4449 為 Hyperf\Utils\Collection 增加多條件排序的能力。
• #4455 新增命令 gen:view-engine-cache 可以預生成模板快取，避免併發帶來的一系列問題。
• #4453 新增 Hyperf\Tracer\Aspect\ElasticserachAspect，用來記錄 elasticsearch 客戶端的呼叫記錄。
• #4458 新增 Hyperf\Di\ScanHandler\ProcScanHandler，用來支援 Windows + Swow 環境下啟動服務。

v2.2.22 - 2022-01-04

修復

• #4399 修復使用 RedisCluster 時，無法使用 scan 方法的問題。

新增

• #4409 為 session 增加資料庫支援。
• #4411 為 tracer 元件，新增 Hyperf\Tracer\Aspect\DbAspect，用於記錄 hyperf/db 元件產生的 SQL 日誌。
• #4420 為 Hyperf\Amqp\IO\SwooleIO 增加 SSL 支援。

最佳化

• #4406 刪除 Swoole PSR-0 風格程式碼，更加友好的支援 Swoole 5.0 版本。
• #4429 為 Debug::getRefCount() 方法增加型別檢測，只能用於輸出物件的 RefCount。

v2.2.21 - 2021-12-20

修復

• #4347 修復使用 AMQP 元件時，如果連線緩衝區溢位，會導致連線被繫結到多個協程從而報錯的問題。
• #4373 修復使用 Snowflake 元件時，由於 getWorkerId() 中存在 IO 操作進而導致協程切換，最終導致元資料生成重複的問題。

新增

• #4344 新增事件 Hyperf\Crontab\Event\FailToExecute，此事件會在 Crontab 任務執行失敗時觸發。
• #4348 支援使用 gen:* 命令建立檔案時，自動吊起對應的 IDE，並開啟當前檔案。

最佳化

• #4350 優化了未開啟 swoole.use_shortname 時的錯誤資訊。
• #4360 將 Hyperf\Amqp\IO\SwooleIO 進行重構，使用更加穩定和高效的 Swoole\Coroutine\Socket 而非 Swoole\Coroutine\Client。

v2.2.20 - 2021-12-13

修復

• #4338 修復使用單測客戶端時，路徑中帶有引數會導致無法正確匹配路由的問題。
• #4346 修復使用元件 php-amqplib/php-amqplib:3.1.1 時，啟動報錯的問題。

新增

• #4330 為 phar 元件支援打包 vendor/bin 目錄。
• #4331 新增方法 Hyperf\Testing\Debug::getRefCount($object)。

v2.2.19 - 2021-12-06

修復

• #4308 修復執行 server:watch 時，因為使用相對路徑導致 collector-reload 檔案找不到的問題。

最佳化

• #4317 為 Hyperf\Utils\Collection 和 Hyperf\Database\Model\Collection 增強型別提示功能。

v2.2.18 - 2021-11-29

修復

• #4283 修復當 GRPC 結果為 null 時，Hyperf\Grpc\Parser::deserializeMessage() 報錯的問題。

新增

• #4284 新增方法 Hyperf\Utils\Network::ip() 獲取本地 IP。
• #4290 為 HTTP 服務增加 chunk 功能。
• #4291 為 value() 方法增加動態引數功能。
• #4293 為 server:watch 命令增加相對路徑支援。
• #4295 為 Hyperf\Database\Schema\Blueprint::bigIncrements() 增加別名 id()。

v2.2.17 - 2021-11-22

修復

• #4243 修復使用 parallel 時，結果集的順序與入參不一致的問題。

新增

• #4109 為 hyperf/tracer 增加 PHP8 的支援。
• #4260 為 hyperf/database 增加指定索引的功能。

v2.2.16 - 2021-11-15

新增

• #4252 為 Hyperf\RpcClient\AbstractServiceClient 新增 getServiceName() 方法。

最佳化

• #4253 在掃描階段時，如果類庫找不到，則跳過且報出警告。

v2.2.15 - 2021-11-08

修復

• #4200 修復當 runtime/caches 不是目錄時，使用檔案快取失敗的問題。

新增

• #4157 為 Hyperf\Utils\Arr 增加 Macroable 支援。

v2.2.14 - 2021-11-01

新增

• #4181 #4192 為框架增加 psr/log 元件版本 v1.0、v2.0、v3.0 的支援。

修復

• #4171 修復使用 consul 元件時，開啟 ACL 驗證後，健康檢測失敗的問題。
• #4188 修復使用 composer 1.x 版本時，打包 phar 失敗的問題。

v2.2.13 - 2021-10-25

新增

• #4159 為 Macroable::mixin 方法增加引數 $replace，當其設定為 false 時，會優先判斷是否已經存在。

修復

• #4158 修復因為使用了 Union 型別，導致生成代理類失敗的問題。

最佳化

• #4159 #4166 將元件 hyperf/macroable 從 hyperf/utils 中分離出來。

v2.2.12 - 2021-10-18

新增

• #4129 新增方法 Str::stripTags() 和 Stringable::stripTags()。

修復

• #4130 修復生成模型時，因為使用了選項 --with-ide 和 scope 方法導致報錯的問題。
• #4141 修復驗證器工廠不支援其他驗證器的問題。

v2.2.11 - 2021-10-11

修復

• #4101 修復 Nacos 使用的密碼攜帶特殊字元時，密碼會被 urlencode 導致密碼錯誤的問題。

最佳化

• #4114 最佳化 WebSocket 客戶端初始化失敗時的錯誤資訊。
• #4119 最佳化單測客戶端在上傳檔案時，因為預設的上傳路徑已經存在，導致報錯的問題（只發生在最新的 Swoole 版本中）。

v2.2.10 - 2021-09-26

修復

• #4088 修復使用定時器規則時，會將空字串轉化為 0 的問題。
• #4096 修復當帶有型別的動態引數生成代理類時，會出現型別錯誤的問題。

v2.2.9 - 2021-09-22

修復

• #4061 修復 hyperf/metric 元件與最新版本的 prometheus_client_php 存在衝突的問題。
• #4068 修復命令列丟擲錯誤時，退出碼與實際不符的問題。
• #4076 修復 HTTP 服務因返回資料不是標準 HTTP 協議時，導致服務宕機的問題。

新增

• #4014 #4080 為 kafka 元件增加 sasl 和 ssl 的支援。
• #4045 #4082 為 tracer 元件新增配置 opentracing.enable.exception，用來判斷是否收集異常資訊。
• #4086 支援收集介面 Interface 的註解資訊。

最佳化

• #4084 優化了註解找不到時的錯誤資訊。

v2.2.8 - 2021-09-14

修復

• #4028 修復 grafana 面板中，請求數結果計算錯誤的問題。
• #4030 修復非同步佇列會因為解壓縮模型失敗，導致程序中斷隨後重啟的問題。
• #4042 修復因 SocketIO 服務關閉時清理過期的 fd，進而導致協程死鎖的問題。

新增

• #4013 為 Cookies 增加 sameSite=None 的支援。
• #4017 為 Hyperf\Utils\Collection 增加 Macroable。
• #4021 為 retry() 方法中 $callback 匿名函式增加 $attempts 變數。
• #4040 為 AMQP 元件新增方法 ConsumerDelayedMessageTrait::getDeadLetterExchange()，可以用來重寫 x-dead-letter-exchange 引數。

移除

• #4017 從 Hyperf\Database\Model\Collection 中移除 Macroable，因為它的基類 Hyperf\Utils\Collection 已引入了對應的 Macroable。

v2.2.7 - 2021-09-06

修復

• #3997 修復 Nats 消費者會在連線超時後崩潰的問題。
• #3998 修復 Apollo 不支援 https 協議的問題。

最佳化

• #4009 最佳化方法 MethodDefinitionCollector::getOrParse()，避免在 PHP8 環境下，觸發即將廢棄的錯誤。

新增

• #4002 #4012 為驗證器增加場景功能，允許不同場景下，使用不同的驗證規則。
• #4011 為工具類 Hyperf\Utils\Str 增加了一些新的便捷方法。

v2.2.6 - 2021-08-30

修復

• #3969 修復 PHP8 環境下使用 Hyperf\Validation\Rules\Unique::__toString() 導致型別錯誤的問題。
• #3979 修復熔斷器元件，timeout 變數無法使用的問題。
• #3986 修復檔案系統元件，開啟 SWOOLE_HOOK_NATIVE_CURL 後導致 OSS hook 失敗的問題。

新增

• #3987 AMQP 元件支援延時佇列。
• #3989 #3992 為熱更新元件新增了配置 command，可以用來定義自己的啟動指令碼，支援 nano 元件。

v2.2.5 - 2021-08-23

修復

• #3959 修復驗證器規則 date 在入參為 string 時，無法正常使用的問題。
• #3960 修復協程風格服務下，Crontab 無法平滑關閉的問題。

新增

• code-generator 新增元件 code-generator，可以用來將 Doctrine 註解轉化為 PHP8 的原生註解。

最佳化

• #3957 使用命令 gen:model 生成 getAttribute 註釋時，支援基於 @return 註釋返回對應的型別。

v2.2.4 - 2021-08-16

修復

• #3925 修復 Nacos 開啟 light beat 功能後，心跳失敗的問題。
• #3926 修復配置項 config_center.drivers.nacos.client 無法正常工作的問題。

新增

• #3924 為 Consul 服務註冊中心增加配置項 services.drivers.consul.check。
• #3932 為 AMQP 消費者增加重新入佇列的配置，允許使用者返回 NACK 後，訊息重入佇列。
• #3941 允許多路複用的 RPC 元件使用註冊中心的能力。
• #3947 新增方法 Str::mask，允許使用者對一段文字某段內容打馬賽克。

最佳化

• #3944 封裝了讀取 Aspect 元資料的方法。

v2.2.3 - 2021-08-09

修復

• #3897 修復因為 lightBeatEnabled 導致心跳失敗，進而導致 Nacos 服務註冊多次的問題。
• #3905 修復 AMQP 連線在關閉時導致空指標的問題。
• #3906 修復 AMQP 連線關閉時，因已經銷燬所有等待通道而導致失敗的問題。
• #3908 修復使用了以 CoordinatorManager 為基礎的迴圈邏輯時，自定義程序無法正常重啟的問題。

v2.2.2 - 2021-08-03

修復

• #3872 #3873 修復使用 Nacos 服務時，因為沒有使用預設的組名，導致心跳失敗的問題。
• #3877 修復 Nacos 服務，心跳會被註冊多次的問題。
• #3879 修復熱更新因為代理類被覆蓋，導致無法正常使用的問題。

最佳化

• #3877 為 Nacos 服務，增加 lightBeatEnabled 支援。

v2.2.1 - 2021-07-27

修復

• #3750 修復使用 SocketIO 時，由於觸發了一個不存在的名稱空間，而導致致命錯誤的問題。
• #3828 修復在 PHP 8.0 版本中，無法對 Hyperf\Redis\Redis 使用懶載入注入的問題。
• #3845 修復 watcher 元件無法在 v2.2 版本中正常使用的問題。
• #3848 修復 Nacos 元件無法像 v2.1 版本註冊自身到 Nacos 服務中的問題。
• #3866 修復 Nacos 例項無法正常註冊元資料的問題。

最佳化

• #3763 使 JsonResource::wrap() 和 JsonResource::withoutWrapping() 支援鏈式呼叫。
• #3843 在 Nacos 註冊服務時，根據 HTTP 響應的返回碼和資料協同判斷，以確保是否已註冊過。
• #3854 為檔案下載方法支援 RFC 5987，它允許使用 UTF-8 格式和 URL 格式化。