更新统一使用 PHPDoc + PSR-19 标准注释

app/http/mer/validation/AuthValidator.php

@@ -9,17 +9,34 @@ use support\validation\Validator;
  */
 class AuthValidator extends Validator
 {
+    /**
+     * 校验规则
+     *
+     * @var array
+     */
     protected array $rules = [
         'merchant_no' => 'required|string|min:1|max:32',
         'password' => 'required|string|min:6|max:32',
     ];
 
+    /**
+     * 字段别名
+     *
+     * @var array
+     */
     protected array $attributes = [
         'merchant_no' => '商户号',
         'password' => '登录密码',
     ];
 
+    /**
+     * 校验场景
+     *
+     * @var array
+     */
     protected array $scenes = [
         'login' => ['merchant_no', 'password'],
     ];
 }
+
+

app/http/mer/validation/BalanceValidator.php

@@ -11,15 +11,32 @@ use support\validation\Validator;
  */
 class BalanceValidator extends Validator
 {
+    /**
+     * 校验规则
+     *
+     * @var array
+     */
     protected array $rules = [
         'merchant_no' => 'required|string|min:1|max:64',
     ];
 
+    /**
+     * 字段别名
+     *
+     * @var array
+     */
     protected array $attributes = [
         'merchant_no' => '商户号',
     ];
 
+    /**
+     * 校验场景
+     *
+     * @var array
+     */
     protected array $scenes = [
         'show' => ['merchant_no'],
     ];
 }
+
+

app/http/mer/validation/MerchantPortalValidator.php

@@ -9,6 +9,11 @@ use support\validation\Validator;
  */
 class MerchantPortalValidator extends Validator
 {
+    /**
+     * 校验规则
+     *
+     * @var array
+     */
     protected array $rules = [
         'merchant_short_name' => 'sometimes|string|max:64',
         'contact_name' => 'sometimes|string|max:64',
@@ -26,6 +31,11 @@ class MerchantPortalValidator extends Validator
         'stat_date' => 'sometimes|date',
     ];
 
+    /**
+     * 字段别名
+     *
+     * @var array
+     */
     protected array $attributes = [
         'merchant_short_name' => '商户简称',
         'contact_name' => '联系人',
@@ -43,6 +53,11 @@ class MerchantPortalValidator extends Validator
         'stat_date' => '统计日期',
     ];
 
+    /**
+     * 校验场景
+     *
+     * @var array
+     */
     protected array $scenes = [
         'profileUpdate' => [
             'merchant_short_name',
@@ -58,3 +73,5 @@ class MerchantPortalValidator extends Validator
         'routePreview' => ['pay_type_id', 'pay_amount', 'stat_date'],
     ];
 }
+
+

app/http/mer/validation/PayOrderValidator.php

@@ -11,6 +11,11 @@ use support\validation\Validator;
  */
 class PayOrderValidator extends Validator
 {
+    /**
+     * 校验规则
+     *
+     * @var array
+     */
     protected array $rules = [
         'keyword' => 'sometimes|string|max:128',
         'merchant_id' => 'sometimes|integer|min:1',
@@ -22,18 +27,29 @@ class PayOrderValidator extends Validator
         'page_size' => 'sometimes|integer|min:1|max:100',
     ];
 
+    /**
+     * 字段别名
+     *
+     * @var array
+     */
     protected array $attributes = [
         'keyword' => '关键字',
         'merchant_id' => '商户ID',
         'pay_type_id' => '支付方式',
-        'status' => '状态',
+        'status' => '支付单状态',
         'channel_mode' => '通道模式',
-        'callback_status' => '回调状态',
+        'callback_status' => '回调处理状态',
         'page' => '页码',
         'page_size' => '每页条数',
     ];
 
+    /**
+     * 校验场景
+     *
+     * @var array
+     */
     protected array $scenes = [
         'index' => ['keyword', 'merchant_id', 'pay_type_id', 'status', 'channel_mode', 'callback_status', 'page', 'page_size'],
     ];
 }
+

app/http/mer/validation/RefundActionValidator.php

@@ -11,6 +11,11 @@ use support\validation\Validator;
  */
 class RefundActionValidator extends Validator
 {
+    /**
+     * 校验规则
+     *
+     * @var array
+     */
     protected array $rules = [
         'refund_no' => 'required|string|max:64',
         'processing_at' => 'sometimes|date_format:Y-m-d H:i:s',
@@ -19,6 +24,11 @@ class RefundActionValidator extends Validator
         'channel_refund_no' => 'sometimes|string|max:64',
     ];
 
+    /**
+     * 字段别名
+     *
+     * @var array
+     */
     protected array $attributes = [
         'refund_no' => '退款单号',
         'processing_at' => '处理时间',
@@ -27,6 +37,11 @@ class RefundActionValidator extends Validator
         'channel_refund_no' => '渠道退款单号',
     ];
 
+    /**
+     * 校验场景
+     *
+     * @var array
+     */
     protected array $scenes = [
         'retry' => ['refund_no', 'processing_at'],
         'mark_fail' => ['refund_no', 'failed_at', 'last_error'],
@@ -34,3 +49,5 @@ class RefundActionValidator extends Validator
         'mark_success' => ['refund_no', 'channel_refund_no'],
     ];
 }
+
+

app/http/mer/validation/RefundOrderValidator.php

@@ -11,6 +11,11 @@ use support\validation\Validator;
  */
 class RefundOrderValidator extends Validator
 {
+    /**
+     * 校验规则
+     *
+     * @var array
+     */
     protected array $rules = [
         'keyword' => 'sometimes|string|max:128',
         'merchant_id' => 'sometimes|integer|min:1',
@@ -21,6 +26,11 @@ class RefundOrderValidator extends Validator
         'page_size' => 'sometimes|integer|min:1|max:100',
     ];
 
+    /**
+     * 字段别名
+     *
+     * @var array
+     */
     protected array $attributes = [
         'keyword' => '关键字',
         'merchant_id' => '商户ID',
@@ -31,7 +41,14 @@ class RefundOrderValidator extends Validator
         'page_size' => '每页条数',
     ];
 
+    /**
+     * 校验场景
+     *
+     * @var array
+     */
     protected array $scenes = [
         'index' => ['keyword', 'merchant_id', 'pay_type_id', 'status', 'channel_mode', 'page', 'page_size'],
     ];
 }
+
+