Added docs for validated-dto (#840)

Author: xuanyanwow

en/components/validated-dto.md

@@ -326,6 +326,29 @@ protected function attributes() {
 }
 ```
 
+## Customizing Validation Rules
+
+You can add DTO-specific custom rules in the `afterValidatorResolving` method, or add global custom rules through Hyperf's `ValidatorFactoryResolved` event.
+
+This depends on your code maintenance habits. If the rules are only used in a single DTO, it is recommended to add them in the `afterValidatorResolving` method. According to the `principle of proximity`, this will make the source code easier to read.
+
+```php
+
+use Hyperf\Contract\ValidatorInterface;
+use Hyperf\Validation\Validator;
+
+protected function afterValidatorResolving(ValidatorInterface $validator): void
+{
+    if (! $validator instanceof Validator) {
+        return;
+    }
+
+    $validator->addExtension('diy_rule', function ($attribute, $value, $parameters, $validator) {
+        return $value === 'diy_rule';
+    });
+}
+```
+
 ## Type Casting
 
 You can easily cast your DTO properties by defining the `casts` method in your DTO:

zh-cn/components/validated-dto.md

@@ -326,6 +326,29 @@ protected function attributes() {
 }
 ```
 
+## 自定义规则
+
+你可以在 `afterValidatorResolving` 方法中添加 DTO 专用的自定义规则，也可以通过 Hyperf 的 `ValidatorFactoryResolved` 事件添加全局自定义规则。
+
+这取决于你的代码维护习惯，如果规则仅在单一 DTO 中使用，那么建议在 `afterValidatorResolving` 方法中添加，根据 `就近原则` 将会使得源码更易读。
+
+```php
+
+use Hyperf\Contract\ValidatorInterface;
+use Hyperf\Validation\Validator;
+
+protected function afterValidatorResolving(ValidatorInterface $validator): void
+{
+    if (! $validator instanceof Validator) {
+        return;
+    }
+
+    $validator->addExtension('diy_rule', function ($attribute, $value, $parameters, $validator) {
+        return $value === 'diy_rule';
+    });
+}
+```
+
 ## 类型转换
 
 你可以通过在 `DTO` 中定义 `casts` 方法轻松转换你的 DTO 属性：

zh-hk/components/validated-dto.md

@@ -326,6 +326,29 @@ protected function attributes() {
 }
 ```
 
+## 自定義規則
+
+你可以在 `afterValidatorResolving` 方法中添加 DTO 專用的自定義規則，也可以通過 Hyperf 的 `ValidatorFactoryResolved` 事件添加全局自定義規則。
+
+這取決於你的代碼維護習慣，如果規則僅在單一 DTO 中使用，那麼建議在 `afterValidatorResolving` 方法中添加，根據 `就近原則` 將會使得源碼更易讀。
+
+```php
+
+use Hyperf\Contract\ValidatorInterface;
+use Hyperf\Validation\Validator;
+
+protected function afterValidatorResolving(ValidatorInterface $validator): void
+{
+    if (! $validator instanceof Validator) {
+        return;
+    }
+
+    $validator->addExtension('diy_rule', function ($attribute, $value, $parameters, $validator) {
+        return $value === 'diy_rule';
+    });
+}
+```
+
 ## 類型轉換
 
 你可以通過在 `DTO` 中定義 `casts` 方法輕鬆轉換你的 DTO 屬性：

zh-tw/components/validated-dto.md

@@ -326,6 +326,29 @@ protected function attributes() {
 }
 ```
 
+## 自定義規則
+
+你可以在 `afterValidatorResolving` 方法中新增 DTO 專用的自定義規則，也可以透過 Hyperf 的 `ValidatorFactoryResolved` 事件新增全域性自定義規則。
+
+這取決於你的程式碼維護習慣，如果規則僅在單一 DTO 中使用，那麼建議在 `afterValidatorResolving` 方法中新增，根據 `就近原則` 將會使得原始碼更易讀。
+
+```php
+
+use Hyperf\Contract\ValidatorInterface;
+use Hyperf\Validation\Validator;
+
+protected function afterValidatorResolving(ValidatorInterface $validator): void
+{
+    if (! $validator instanceof Validator) {
+        return;
+    }
+
+    $validator->addExtension('diy_rule', function ($attribute, $value, $parameters, $validator) {
+        return $value === 'diy_rule';
+    });
+}
+```
+
 ## 型別轉換
 
 你可以透過在 `DTO` 中定義 `casts` 方法輕鬆轉換你的 DTO 屬性：