Release v3.1.46 (#7162)

CHANGELOG-3.1.md

@@ -1,4 +1,6 @@
-# v3.1.46 - TBD
+# v3.1.47 - TBD
+
+# v3.1.46 - 2024-11-21
 
 ## Added
 

docs/en/changelog/3.1.md

@@ -1,5 +1,14 @@
 # Changelogs
 
+# v3.1.46 - 2024-11-21
+
+## Added
+
+- [#7148](https://github.com/hyperf/hyperf/pull/7148) Added `exclude` rules for `hyperf/validation`.
+- [#7150](https://github.com/hyperf/hyperf/pull/7150) Added missing methods (`accepted_if`, `ascii`, `date_equals`...) to validation messages.
+- [#7151](https://github.com/hyperf/hyperf/pull/7151) Added hooks `beforeTestInCoroutine` and `afterTestInCoroutine` for `Hyperf\Testing\Concerns\RunTestsInCoroutine::runTestsInCoroutine()`.
+- [#7156](https://github.com/hyperf/hyperf/pull/7156) Added method `Hyperf\Database\Schema\Blueprint::engine()`.
+
 # v3.1.45 - 2024-11-14
 
 ## Added

docs/zh-cn/changelog/3.1.md

@@ -1,5 +1,14 @@
 # 版本更新记录
 
+# v3.1.46 - 2024-11-21
+
+## 新增
+
+- [#7148](https://github.com/hyperf/hyperf/pull/7148) 为 `hyperf/validation` 增加 `exclude` 验证规则。
+- [#7150](https://github.com/hyperf/hyperf/pull/7150) 为 `hyperf/validation` 增加部分验证规则，例如 `accepted_if`, `ascii`, `date_equals` 等。
+- [#7151](https://github.com/hyperf/hyperf/pull/7151) 为 `Hyperf\Testing\Concerns\RunTestsInCoroutine::runTestsInCoroutine()` 增加钩子方法 `beforeTestInCoroutine` 和 `afterTestInCoroutine`。
+- [#7156](https://github.com/hyperf/hyperf/pull/7156) 新增方法 `Hyperf\Database\Schema\Blueprint::engine()`。
+
 # v3.1.45 - 2024-11-14
 
 ## 新增

docs/zh-cn/constants.md

@@ -63,7 +63,7 @@ enum ErrorCode: int
 }
 ```
 
-用户可以使用 `ErrorCode::getMessage(ErrorCode::SERVER_ERROR)` 来获取对应错误信息。
+用户可以使用 `ErrorCode::SERVER_ERROR->getMessage()` 来获取对应错误信息。
 
 ### 定义异常类
 
@@ -82,12 +82,18 @@ use Throwable;
 
 class BusinessException extends ServerException
 {
-    public function __construct(int $code = 0, string $message = null, Throwable $previous = null)
+    public function __construct(ErrorCode|int $code = 0, ?string $message = null, ?Throwable $previous = null)
     {
         if (is_null($message)) {
-            $message = ErrorCode::getMessage($code);
+            if ($code instanceof ErrorCode) {
+                $message = $code->getMessage();
+            } else {
+                $message = ErrorCode::getMessage($code);
+            }
         }
 
+        $code = $code instanceof ErrorCode ? $code->value : $code;
+
         parent::__construct($message, $code, $previous);
     }
 }
@@ -118,7 +124,7 @@ class IndexController extends AbstractController
 
 ### 可变参数
 
-在使用 `ErrorCode::getMessage(ErrorCode::SERVER_ERROR)` 来获取对应错误信息时，我们也可以传入可变参数，进行错误信息组合。比如以下情况
+在使用 `ErrorCode::SERVER_ERROR->getMessage()` 来获取对应错误信息时，我们也可以传入可变参数，进行错误信息组合。比如以下情况
 
 ```php
 <?php
@@ -137,10 +143,7 @@ enum ErrorCode: int
     case PARAMS_INVALID = 1000;
 }
 
-$message = ErrorCode::getMessage(ErrorCode::PARAMS_INVALID, ['user_id']);
-
-// 1.2 版本以下 可以使用以下方式，但会在 1.2 版本移除
-$message = ErrorCode::getMessage(ErrorCode::PARAMS_INVALID, 'user_id');
+$message = ErrorCode::PARAMS_INVALID->getMessage(['user_id']);
 ```
 
 ### 国际化
@@ -174,5 +177,5 @@ enum ErrorCode: int
     case PARAMS_INVALID = 1000;
 }
 
-$message = ErrorCode::getMessage(ErrorCode::SERVER_ERROR, ['param' => 'user_id']);
+$message = ErrorCode::SERVER_ERROR->getMessage(['param' => 'user_id']);
 ```

docs/zh-hk/changelog/3.1.md

@@ -1,5 +1,14 @@
 # 版本更新記錄
 
+# v3.1.46 - 2024-11-21
+
+## 新增
+
+- [#7148](https://github.com/hyperf/hyperf/pull/7148) 為 `hyperf/validation` 增加 `exclude` 驗證規則。
+- [#7150](https://github.com/hyperf/hyperf/pull/7150) 為 `hyperf/validation` 增加部分驗證規則，例如 `accepted_if`, `ascii`, `date_equals` 等。
+- [#7151](https://github.com/hyperf/hyperf/pull/7151) 為 `Hyperf\Testing\Concerns\RunTestsInCoroutine::runTestsInCoroutine()` 增加鈎子方法 `beforeTestInCoroutine` 和 `afterTestInCoroutine`。
+- [#7156](https://github.com/hyperf/hyperf/pull/7156) 新增方法 `Hyperf\Database\Schema\Blueprint::engine()`。
+
 # v3.1.45 - 2024-11-14
 
 ## 新增

docs/zh-hk/constants.md

@@ -63,7 +63,7 @@ enum ErrorCode: int
 }
 ```
 
-用户可以使用 `ErrorCode::getMessage(ErrorCode::SERVER_ERROR)` 來獲取對應錯誤信息。
+用户可以使用 `ErrorCode::SERVER_ERROR->getMessage()` 來獲取對應錯誤信息。
 
 ### 定義異常類
 
@@ -82,12 +82,18 @@ use Throwable;
 
 class BusinessException extends ServerException
 {
-    public function __construct(int $code = 0, string $message = null, Throwable $previous = null)
+    public function __construct(ErrorCode|int $code = 0, ?string $message = null, ?Throwable $previous = null)
     {
         if (is_null($message)) {
-            $message = ErrorCode::getMessage($code);
+            if ($code instanceof ErrorCode) {
+                $message = $code->getMessage();
+            } else {
+                $message = ErrorCode::getMessage($code);
+            }
         }
 
+        $code = $code instanceof ErrorCode ? $code->value : $code;
+
         parent::__construct($message, $code, $previous);
     }
 }
@@ -118,7 +124,7 @@ class IndexController extends AbstractController
 
 ### 可變參數
 
-在使用 `ErrorCode::getMessage(ErrorCode::SERVER_ERROR)` 來獲取對應錯誤信息時，我們也可以傳入可變參數，進行錯誤信息組合。比如以下情況
+在使用 `ErrorCode::SERVER_ERROR->getMessage()` 來獲取對應錯誤信息時，我們也可以傳入可變參數，進行錯誤信息組合。比如以下情況
 
 ```php
 <?php
@@ -137,10 +143,7 @@ enum ErrorCode: int
     case PARAMS_INVALID = 1000;
 }
 
-$message = ErrorCode::getMessage(ErrorCode::PARAMS_INVALID, ['user_id']);
-
-// 1.2 版本以下 可以使用以下方式，但會在 1.2 版本移除
-$message = ErrorCode::getMessage(ErrorCode::PARAMS_INVALID, 'user_id');
+$message = ErrorCode::PARAMS_INVALID->getMessage(['user_id']);
 ```
 
 ### 國際化
@@ -174,5 +177,5 @@ enum ErrorCode: int
     case PARAMS_INVALID = 1000;
 }
 
-$message = ErrorCode::getMessage(ErrorCode::SERVER_ERROR, ['param' => 'user_id']);
+$message = ErrorCode::SERVER_ERROR->getMessage(['param' => 'user_id']);
 ```

docs/zh-tw/changelog/3.1.md

@@ -1,5 +1,14 @@
 # 版本更新記錄
 
+# v3.1.46 - 2024-11-21
+
+## 新增
+
+- [#7148](https://github.com/hyperf/hyperf/pull/7148) 為 `hyperf/validation` 增加 `exclude` 驗證規則。
+- [#7150](https://github.com/hyperf/hyperf/pull/7150) 為 `hyperf/validation` 增加部分驗證規則，例如 `accepted_if`, `ascii`, `date_equals` 等。
+- [#7151](https://github.com/hyperf/hyperf/pull/7151) 為 `Hyperf\Testing\Concerns\RunTestsInCoroutine::runTestsInCoroutine()` 增加鉤子方法 `beforeTestInCoroutine` 和 `afterTestInCoroutine`。
+- [#7156](https://github.com/hyperf/hyperf/pull/7156) 新增方法 `Hyperf\Database\Schema\Blueprint::engine()`。
+
 # v3.1.45 - 2024-11-14
 
 ## 新增

docs/zh-tw/constants.md

@@ -63,7 +63,7 @@ enum ErrorCode: int
 }
 ```
 
-使用者可以使用 `ErrorCode::getMessage(ErrorCode::SERVER_ERROR)` 來獲取對應錯誤資訊。
+使用者可以使用 `ErrorCode::SERVER_ERROR->getMessage()` 來獲取對應錯誤資訊。
 
 ### 定義異常類
 
@@ -82,12 +82,18 @@ use Throwable;
 
 class BusinessException extends ServerException
 {
-    public function __construct(int $code = 0, string $message = null, Throwable $previous = null)
+    public function __construct(ErrorCode|int $code = 0, ?string $message = null, ?Throwable $previous = null)
     {
         if (is_null($message)) {
-            $message = ErrorCode::getMessage($code);
+            if ($code instanceof ErrorCode) {
+                $message = $code->getMessage();
+            } else {
+                $message = ErrorCode::getMessage($code);
+            }
         }
 
+        $code = $code instanceof ErrorCode ? $code->value : $code;
+
         parent::__construct($message, $code, $previous);
     }
 }
@@ -118,7 +124,7 @@ class IndexController extends AbstractController
 
 ### 可變引數
 
-在使用 `ErrorCode::getMessage(ErrorCode::SERVER_ERROR)` 來獲取對應錯誤資訊時，我們也可以傳入可變引數，進行錯誤資訊組合。比如以下情況
+在使用 `ErrorCode::SERVER_ERROR->getMessage()` 來獲取對應錯誤資訊時，我們也可以傳入可變引數，進行錯誤資訊組合。比如以下情況
 
 ```php
 <?php
@@ -137,10 +143,7 @@ enum ErrorCode: int
     case PARAMS_INVALID = 1000;
 }
 
-$message = ErrorCode::getMessage(ErrorCode::PARAMS_INVALID, ['user_id']);
-
-// 1.2 版本以下 可以使用以下方式，但會在 1.2 版本移除
-$message = ErrorCode::getMessage(ErrorCode::PARAMS_INVALID, 'user_id');
+$message = ErrorCode::PARAMS_INVALID->getMessage(['user_id']);
 ```
 
 ### 國際化
@@ -174,5 +177,5 @@ enum ErrorCode: int
     case PARAMS_INVALID = 1000;
 }
 
-$message = ErrorCode::getMessage(ErrorCode::SERVER_ERROR, ['param' => 'user_id']);
+$message = ErrorCode::SERVER_ERROR->getMessage(['param' => 'user_id']);
 ```