chore(release): 0.2.23

Signed-off-by: 李东云 <dongyu.li@luxcreo.ai>

.idea/HDK-Core.iml

@@ -147,8 +147,17 @@
       <excludeFolder url="file://$MODULE_DIR$/vendor/hyperf/guzzle" />
       <excludeFolder url="file://$MODULE_DIR$/vendor/symfony/http-foundation" />
       <excludeFolder url="file://$MODULE_DIR$/vendor/hyperf/collection" />
+      <excludeFolder url="file://$MODULE_DIR$/vendor/hyperf/db" />
       <excludeFolder url="file://$MODULE_DIR$/vendor/hyperf/pipeline" />
       <excludeFolder url="file://$MODULE_DIR$/vendor/hyperf/tappable" />
+      <excludeFolder url="file://$MODULE_DIR$/vendor/symfony/serializer" />
+      <excludeFolder url="file://$MODULE_DIR$/vendor/hyperf/code-parser" />
+      <excludeFolder url="file://$MODULE_DIR$/vendor/hyperf/codec" />
+      <excludeFolder url="file://$MODULE_DIR$/vendor/hyperf/conditionable" />
+      <excludeFolder url="file://$MODULE_DIR$/vendor/hyperf/coroutine" />
+      <excludeFolder url="file://$MODULE_DIR$/vendor/hyperf/serializer" />
+      <excludeFolder url="file://$MODULE_DIR$/vendor/hyperf/stringable" />
+      <excludeFolder url="file://$MODULE_DIR$/vendor/hyperf/support" />
     </content>
     <orderEntry type="inheritedJdk" />
     <orderEntry type="sourceFolder" forTests="false" />

.idea/inspectionProfiles/Project_Default.xml

@@ -1,9 +1,7 @@
 <component name="InspectionProjectProfileManager">
   <profile version="1.0">
     <option name="myName" value="Project Default" />
-    <inspection_tool class="PhpCSFixerValidationInspection" enabled="true" level="WEAK WARNING" enabled_by_default="true" />
     <inspection_tool class="PhpDocSignatureInspection" enabled="true" level="INFORMATION" enabled_by_default="true" />
     <inspection_tool class="PhpPropertyOnlyWrittenInspection" enabled="false" level="WARNING" enabled_by_default="false" />
-    <inspection_tool class="PhpStanGlobal" enabled="true" level="WEAK WARNING" enabled_by_default="true" />
   </profile>
 </component>

.idea/php.xml

@@ -137,7 +137,6 @@
       <path value="$PROJECT_DIR$/vendor/jetbrains/phpstorm-attributes" />
       <path value="$PROJECT_DIR$/vendor/lizhichao/one-sm" />
       <path value="$PROJECT_DIR$/vendor/phpoption/phpoption" />
-      <path value="$PROJECT_DIR$/vendor/ralouphie/getallheaders" />
       <path value="$PROJECT_DIR$/vendor/sebastian/comparator" />
       <path value="$PROJECT_DIR$/vendor/sebastian/global-state" />
       <path value="$PROJECT_DIR$/vendor/sebastian/object-enumerator" />
@@ -165,6 +164,17 @@
       <path value="$PROJECT_DIR$/vendor/hyperf/pipeline" />
       <path value="$PROJECT_DIR$/vendor/hyperf/collection" />
       <path value="$PROJECT_DIR$/vendor/hyperf/tappable" />
+      <path value="$PROJECT_DIR$/vendor/hyperf/db" />
+      <path value="$PROJECT_DIR$/vendor/symfony/serializer" />
+      <path value="$PROJECT_DIR$/vendor/facade/ignition-contracts" />
+      <path value="$PROJECT_DIR$/vendor/hyperf/serializer" />
+      <path value="$PROJECT_DIR$/vendor/hyperf/code-parser" />
+      <path value="$PROJECT_DIR$/vendor/hyperf/coroutine" />
+      <path value="$PROJECT_DIR$/vendor/hyperf/conditionable" />
+      <path value="$PROJECT_DIR$/vendor/hyperf/codec" />
+      <path value="$PROJECT_DIR$/vendor/hyperf/stringable" />
+      <path value="$PROJECT_DIR$/vendor/hyperf/support" />
+      <path value="$PROJECT_DIR$/vendor/ralouphie/getallheaders" />
     </include_path>
   </component>
   <component name="PhpProjectSharedConfiguration" php_language_level="8.0" />

CHANGELOG.md

@@ -1,4 +1,106 @@
 # 版本更新日志
+### [0.2.23](http://124.126.16.154:8888/singularity/HyperfDevelopmentKitCore/compare/v0.2.22...v0.2.23) (2023-07-07)
+
+
+### 🐛 Bug Fixes | Bug 修复
+
+* **i18n:** 修复获取偏好语言失败的问题 ([722d124](http://124.126.16.154:8888/singularity/HyperfDevelopmentKitCore/commit/722d124e1ed87c493dfb8841212b408717444d98))
+
+### [0.2.22](http://124.126.16.154:8888/singularity/HyperfDevelopmentKitCore/compare/v0.2.21...v0.2.22) (2023-07-06)
+
+
+### 🐛 Bug Fixes | Bug 修复
+
+* **service:** 修复 http 请求类中无效的 query ([a6ec695](http://124.126.16.154:8888/singularity/HyperfDevelopmentKitCore/commit/a6ec6951a9a68a4c5144aee97638486826d6af84))
+
+### [0.2.21](http://124.126.16.154:8888/singularity/HyperfDevelopmentKitCore/compare/v0.2.20...v0.2.21) (2023-07-05)
+
+
+### ⚡ Performance Improvements | 性能优化
+
+* 适配已弃用的命名空间 ([8616c5f](http://124.126.16.154:8888/singularity/HyperfDevelopmentKitCore/commit/8616c5f61cc8e69c9d61f42f5dc5d18e7c79fd7b))
+
+
+### 🚀 Chore | 构建/工程依赖/工具
+
+* **deprecated:** 声明弃用了 SessionMiddleware ([2b0374b](http://124.126.16.154:8888/singularity/HyperfDevelopmentKitCore/commit/2b0374bcc83a5534358a7fce34b723e3bd38dceb))
+
+### [0.2.20](http://124.126.16.154:8888/singularity/HyperfDevelopmentKitCore/compare/v0.2.19...v0.2.20) (2023-06-19)
+
+
+### ✨ Features | 新功能
+
+* **handler:** 增加了 restful 的支持 ([8974ee5](http://124.126.16.154:8888/singularity/HyperfDevelopmentKitCore/commit/8974ee595b3411bac086c3046eb24ba44087ecc7))
+
+### [0.2.19](http://124.126.16.154:8888/singularity/HyperfDevelopmentKitCore/compare/v0.2.18...v0.2.19) (2023-06-02)
+
+
+### 📦‍ Build System | 打包构建
+
+* **composer:** 更新依赖 ([648fe6c](http://124.126.16.154:8888/singularity/HyperfDevelopmentKitCore/commit/648fe6c8f32e2511f0c1a79dbafff8e889c1da7b))
+
+### [0.2.18](http://124.126.16.154:8888/singularity/HyperfDevelopmentKitCore/compare/v0.2.17...v0.2.18) (2023-06-02)
+
+
+### 🐛 Bug Fixes | Bug 修复
+
+* 修复 http 请求失效的问题 ([43ebd05](http://124.126.16.154:8888/singularity/HyperfDevelopmentKitCore/commit/43ebd0546abb25446e83522fd0c069dd0e6880c7))
+
+
+### 📦‍ Build System | 打包构建
+
+* 更新被弃用的写法 ([c748cbd](http://124.126.16.154:8888/singularity/HyperfDevelopmentKitCore/commit/c748cbd3e322b5a926996fc2ee958b2e2a911d7c))
+
+### [0.2.17](http://124.126.16.154:8888/singularity/HyperfDevelopmentKitCore/compare/v0.2.16...v0.2.17) (2023-05-06)
+
+
+### 📦‍ Build System | 打包构建
+
+* **composer:** 更新依赖 ([d22bd3e](http://124.126.16.154:8888/singularity/HyperfDevelopmentKitCore/commit/d22bd3ee587f7799b33a28015c148e50afe79107))
+
+
+### ✨ Features | 新功能
+
+* **xml:** 实现了解析xml的方法 ([be818b7](http://124.126.16.154:8888/singularity/HyperfDevelopmentKitCore/commit/be818b708011bb05a65752380248c8307938d110))
+
+### [0.2.16](http://124.126.16.154:8888/singularity/HyperfDevelopmentKitCore/compare/v0.2.15...v0.2.16) (2023-04-25)
+
+
+### 🐛 Bug Fixes | Bug 修复
+
+* **extend:** 修复未传入 extends 不存在缺省值的问题 ([77f3141](http://124.126.16.154:8888/singularity/HyperfDevelopmentKitCore/commit/77f3141c56a09905e0c357c1b183c1c8831c9acd))
+
+
+### ✨ Features | 新功能
+
+* **handler:** 补全了各种错误的状态码 ([0247dd4](http://124.126.16.154:8888/singularity/HyperfDevelopmentKitCore/commit/0247dd415c2a62c21b5a6fbb15ab1e6ce3d1a316))
+
+### [0.2.15](http://124.126.16.154:8888/singularity/HyperfDevelopmentKitCore/compare/v0.2.14...v0.2.15) (2023-04-13)
+
+
+### 🐛 Bug Fixes | Bug 修复
+
+* **coreMiddleware:** 修复restful 无法分页的问题 ([a6b71db](http://124.126.16.154:8888/singularity/HyperfDevelopmentKitCore/commit/a6b71dbb037624ac69eddc1e5b1d671ab45b06ae))
+
+
+### ✨ Features | 新功能
+
+* 默认绑定 CoreMiddleware 的映射关系 ([5e5792b](http://124.126.16.154:8888/singularity/HyperfDevelopmentKitCore/commit/5e5792b28ca13cc8833280ba3d26ec588c445350))
+
+### [0.2.14](http://124.126.16.154:8888/singularity/HyperfDevelopmentKitCore/compare/v0.2.13...v0.2.14) (2023-04-12)
+
+
+### ✨ Features | 新功能
+
+* **handler:** 补充 restful 响应的状态码 ([e69c149](http://124.126.16.154:8888/singularity/HyperfDevelopmentKitCore/commit/e69c1494c3ec0a8d26341f1891d7d067511e8baf))
+
+### [0.2.13](http://124.126.16.154:8888/singularity/HyperfDevelopmentKitCore/compare/v0.2.12...v0.2.13) (2023-04-11)
+
+
+### ✨ Features | 新功能
+
+* **xml:** 增加了 xml 生成的方法及测试用例 ([90a521f](http://124.126.16.154:8888/singularity/HyperfDevelopmentKitCore/commit/90a521f90acee7fd6efe6f0a554e749c16fadc1c))
+
 ### [0.2.12](http://124.126.16.154:8888/singularity/HyperfDevelopmentKitCore/compare/v0.2.11...v0.2.12) (2023-04-10)
 
 

VERSION_TRACKER.txt

@@ -1 +1 @@
-0.2.12
+0.2.23

composer.json

@@ -20,33 +20,36 @@
     "ext-swoole": "*",
     "composer/composer": ">=2.0",
     "ergebnis/http-method": "^2.2",
-    "hyperf/config": "^3.0.0",
-    "hyperf/constants": "^3.0.0",
-    "hyperf/context": "^3.0.0",
-    "hyperf/di": "^3.0.0",
-    "hyperf/framework": "^3.0.0",
-    "hyperf/http-server": "3.0.*",
-    "hyperf/logger": "^3.0.0",
-    "hyperf/redis": "^3.0.0",
-    "hyperf/resource": "^3.0.0",
-    "hyperf/translation": "^3.0.0",
+    "hyperf/config": "^3.0.18",
+    "hyperf/constants": "^3.0.18",
+    "hyperf/context": "^3.0.18",
+    "hyperf/di": "^3.0.18",
+    "hyperf/framework": "^3.0.18",
+    "hyperf/logger": "^3.0.18",
+    "hyperf/redis": "^3.0.18",
+    "hyperf/resource": "^3.0.18",
+    "hyperf/translation": "^3.0.18",
     "jetbrains/phpstorm-attributes": "^1.0",
     "lmc/http-constants": "^1.2",
     "myclabs/php-enum": "^1.8",
     "roave/dont": "^1.5",
     "symfony/http-foundation": "^6.0",
     "symfony/polyfill-php81": "^1.26",
-    "teapot/status-code": "^1.1"
+    "teapot/status-code": "^1.1",
+    "ext-libxml": "*",
+    "ext-dom": "*"
   },
   "require-dev": {
     "alibabacloud/dysmsapi-20170525": "^2.0",
     "firebase/php-jwt": "^6.1",
     "friendsofphp/php-cs-fixer": "^3.13",
     "guzzlehttp/guzzle": "^7.5",
-    "hyperf/crontab": "^3.0.0",
-    "hyperf/guzzle": "^3.0.0",
-    "hyperf/session": "^3.0.0",
-    "hyperf/validation": "^3.0.0",
+    "hyperf/crontab": "^3.0.18",
+    "hyperf/database": "^3.0.18",
+    "hyperf/db": "^3.0.18",
+    "hyperf/guzzle": "^3.0.18",
+    "hyperf/session": "^3.0.18",
+    "hyperf/validation": "^3.0.18",
     "pestphp/pest": "^1.22",
     "phpstan/phpstan": "^1.9",
     "phpunit/phpunit": "^9.5",
@@ -54,14 +57,16 @@
     "spatie/pest-plugin-test-time": "^1.1",
     "swoole/ide-helper": "*",
     "symfony/mailer": "^6.0",
-    "hyperf/database": "^3.0.0",
-    "hyperf/db": "^3.0.0"
+    "symfony/serializer": "^6.0"
   },
   "suggest": {
     "firebase/php-jwt": "JWT 鉴权必需",
-    "hyperf/session": "^3.0.0",
+    "hyperf/session": "^3.0.18",
     "symfony/mailer": "用于发送电子邮件",
-    "hyperf/guzzle": "^3.0.0",
+    "symfony/serializer": "处理 XML 必需",
+    "ext-dom": "处理 XML 必需",
+    "ext-libxml": "处理 XML 必需",
+    "hyperf/guzzle": "^3.0.18",
     "alibabacloud/dysmsapi-20170525": "阿里云短信服务必需"
   },
   "config": {
@@ -103,8 +108,8 @@
     },
     "packagist": {
       "type": "composer",
-      "url": "https://mirrors.cloud.tencent.com/composer/"
+      "url": "https://mirrors.aliyun.com/composer/"
     }
   },
-  "version": "0.2.12"
+  "version": "0.2.23"
 }

publish/common.php

@@ -9,6 +9,8 @@
 
 declare(strict_types=1);
 
+use function Hyperf\Support\env;
+
 return [
     // 响应
     'response' => [

src/ConfigProvider.php

@@ -14,8 +14,10 @@ namespace Singularity\HDK\Core;
 
 use Hyperf\Contract\StdoutLoggerInterface;
 use Hyperf\Framework\Logger\StdoutLogger;
+use Hyperf\HttpServer\Contract\CoreMiddlewareInterface;
 use Singularity\HDK\Core\Listener\EmailWillSentListener;
 use Singularity\HDK\Core\Listener\SmsWillSentListener;
+use Singularity\HDK\Core\Middleware\CommonCoreMiddleware;
 
 class ConfigProvider
 {
@@ -27,6 +29,7 @@ class ConfigProvider
             // 合并到  config/autoload/dependencies.php 文件
             'dependencies' => [
                 StdoutLoggerInterface::class => StdoutLogger::class,
+                CoreMiddlewareInterface::class => CommonCoreMiddleware::class
             ],
             // 合并到  config/autoload/annotations.php 文件
             'annotations' => [

src/Exceptions/Forbidden.php

@@ -7,6 +7,8 @@ use Singularity\HDK\Core\Constants\CommonErrorCode;
 use Teapot\StatusCode\RFC\RFC7231;
 use Throwable;
 
+use function Hyperf\Config\config;
+
 /**
  * 用户无权访问
  */

src/Exceptions/Handler/CommonHandler.php

@@ -12,6 +12,8 @@ declare(strict_types=1);
 
 namespace Singularity\HDK\Core\Exceptions\Handler;
 
+use Carbon\Carbon;
+use Hyperf\Codec\Json;
 use Hyperf\Database\Exception\QueryException;
 use Hyperf\Database\Model\ModelNotFoundException;
 use Hyperf\Di\Annotation\Inject;
@@ -23,17 +25,21 @@ use Hyperf\HttpMessage\Exception\MethodNotAllowedHttpException;
 use Hyperf\HttpMessage\Exception\NotFoundHttpException;
 use Hyperf\HttpMessage\Stream\SwooleStream;
 use Hyperf\HttpServer\Contract\RequestInterface;
-use Hyperf\Utils\Codec\Json;
 use Hyperf\Validation\ValidationException;
 use Lmc\HttpConstants\Header;
 use Psr\Http\Message\ResponseInterface;
 use RedisException;
 use Singularity\HDK\Core\Constants\CommonErrorCode;
 use Singularity\HDK\Core\Exceptions\ValidateException;
+use Singularity\HDK\Core\Service\ApiStyleService;
 use Symfony\Component\Mailer\Exception\TransportException;
+use Teapot\StatusCode\RFC\RFC4918;
 use Teapot\StatusCode\RFC\RFC7231;
 use Throwable;
 
+use function Hyperf\Config\config;
+use function Hyperf\Translation\__;
+
 /**
  * 通用异常处理
  * Singularity\HDK\Utils\Exceptions\Handler\CommonHandler@hyperf-development-kit
@@ -44,17 +50,15 @@ use Throwable;
  */
 class CommonHandler extends ExceptionHandler
 {
-    /**
-     *
-     * @var RequestInterface|null
-     */
     #[Inject(required: false)]
     private ?RequestInterface $request;
-    /**
-     * @var StdoutLogger
-     */
+
     #[Inject]
     private StdoutLogger $logger;
+
+    #[Inject]
+    private ApiStyleService $apiStyleService;
+
     /**
      * {@inheritDoc}
      */
@@ -62,14 +66,18 @@ class CommonHandler extends ExceptionHandler
     {
         // 阻止异常冒泡
         $this->stopPropagation();
-        $restful = config('common.response.restful');
+        $restful = $this->apiStyleService->get();
+        // $restful = config('common.response.restful');
         $code_name = config('common.response.code_name');
         $message_name = config('common.response.message_name');
         $is_testing = config('app_status') === true;
         $this->request?->url();
-        $is_debug = $this->request?->hasHeader('Postman-Token') || str_starts_with($this->request?->header('User-Agent', ''), 'apifox');
+        $is_debug = $this->request?->hasHeader('Postman-Token') || str_starts_with(
+                $this->request?->header('User-Agent', ''),
+                'apifox'
+            );
         $error_type = $throwable::class;
-        $request_time = date('Y-m-d H:i:s');
+        $request_time = Carbon::now()->toDateTimeString();
         $request_data = Json::encode($this->request?->getParsedBody());
         $request_headers = Json::encode($this->request?->getHeaders());
         // 901 程序语法错误
@@ -79,7 +87,10 @@ class CommonHandler extends ExceptionHandler
                 '42S22' => CommonErrorCode::PROGRAM_SQL_COLUMN_NOT_FOUND,
                 default => CommonErrorCode::PROGRAM_SQL_ERROR,
             };
-            $data = [$code_name => $code, $message_name => CommonErrorCode::getMessage($is_testing ? $code : CommonErrorCode::PROGRAM_SQL_ERROR)];
+            $data = [
+                $code_name => $code,
+                $message_name => CommonErrorCode::getMessage($is_testing ? $code : CommonErrorCode::PROGRAM_SQL_ERROR),
+            ];
             if ($is_testing) {
                 $data['details'] = ['sql' => $throwable->getSql(), 'error' => $throwable->getMessage()];
             }
@@ -89,24 +100,48 @@ class CommonHandler extends ExceptionHandler
             $message = explode(': ', $throwable->getMessage());
             $allow_method = explode(', ', $message[1]);
             $code = CommonErrorCode::REQUEST_METHOD_ERROR;
-            $data = [$code_name => $code, $message_name => CommonErrorCode::getMessage($code, ['methods' => join(', ', $allow_method)]), 'currentMethod' => $this->request?->getMethod(), 'allowedMethod' => $allow_method];
+            $data = [
+                $code_name => $code,
+                $message_name => CommonErrorCode::getMessage($code, ['methods' => join(', ', $allow_method)]),
+                'currentMethod' => $this->request?->getMethod(),
+                'allowedMethod' => $allow_method,
+            ];
+            $status_code = RFC7231::METHOD_NOT_ALLOWED;
         }
         // 验证失败
         if ($throwable instanceof BadRequestHttpException) {
-            $data = [$code_name => CommonErrorCode::REQUEST_PARAMS_ERROR, $message_name => $is_testing ? $throwable->getMessage() : CommonErrorCode::getMessage(CommonErrorCode::SERVER_ERROR)];
+            $data = [
+                $code_name => CommonErrorCode::REQUEST_PARAMS_ERROR,
+                $message_name => $is_testing ? $throwable->getMessage() : CommonErrorCode::getMessage(
+                    CommonErrorCode::SERVER_ERROR
+                ),
+            ];
+            $status_code = RFC4918::UNPROCESSABLE_ENTITY;
         }
         if ($throwable instanceof ValidationException) {
             $data = $throwable->validator->errors()->first();
             if (is_numeric($data)) {
-                $code = (int) $data;
+                $code = (int)$data;
                 $data = CommonErrorCode::getMessage($code);
             }
             $data = [$code_name => $code ?? CommonErrorCode::REQUEST_PARAMS_ERROR, $message_name => $data];
+            $status_code = RFC4918::UNPROCESSABLE_ENTITY;
         }
         if ($throwable instanceof ValidateException) {
+            $status_code = RFC4918::UNPROCESSABLE_ENTITY;
             $code = $throwable->getCode();
             $message = $throwable->getMessage();
-            $data = [$code_name => $code, $message_name => empty($message) ? CommonErrorCode::getMessage($code, ['param' => $throwable->getFieldName()]) : $message];
+            $data = [
+                $code_name => $code,
+                $message_name => empty($message)
+                    ? CommonErrorCode::getMessage(
+                        $code,
+                        [
+                            'param' => $throwable->getFieldName(),
+                        ]
+                    )
+                    : $message,
+            ];
             if ($is_debug) {
                 $data['currentValue'] = $throwable->getCurrentValue();
                 $data['availableValue'] = $throwable->getAvailableValue();
@@ -116,14 +151,15 @@ class CommonHandler extends ExceptionHandler
         if ($throwable instanceof NotFoundHttpException) {
             $code = CommonErrorCode::ROUTE_NOT_FOUND;
             $data = [$code_name => $code, $message_name => CommonErrorCode::getMessage($code)];
-            $status_code = 404;
+            $status_code = RFC7231::NOT_FOUND;
         }
         // 模型不存在
         if ($throwable instanceof ModelNotFoundException) {
             $code = empty($throwable->getCode()) ? CommonErrorCode::MODEL_NOT_FOUND : $throwable->getCode();
-            $message = empty($throwable->getCode()) ? CommonErrorCode::getMessage($code, ['resource' => '资源']) : $throwable->getMessage();
+            $message = empty($throwable->getCode()) ? CommonErrorCode::getMessage($code, ['resource' => '资源']
+            ) : $throwable->getMessage();
             $data = [$code_name => $code, $message_name => $message];
-            $status_code = 404;
+            $status_code = RFC7231::NOT_FOUND;
         }
         // 300 服务出错
         // 303 缓存异常
@@ -132,7 +168,12 @@ class CommonHandler extends ExceptionHandler
             if ($throwable->getMessage() === 'Connection refused') {
                 $code = CommonErrorCode::SERVER_CACHE_REDIS_REFUSED_ERROR;
             }
-            $data = [$code_name => $code, $message_name => CommonErrorCode::getMessage($is_testing ? $code : CommonErrorCode::SERVER_CACHE_REDIS_ERROR)];
+            $data = [
+                $code_name => $code,
+                $message_name => CommonErrorCode::getMessage(
+                    $is_testing ? $code : CommonErrorCode::SERVER_CACHE_REDIS_ERROR
+                ),
+            ];
         }
         // 306 消息异常
         // 30601 邮箱发件异常
@@ -141,14 +182,29 @@ class CommonHandler extends ExceptionHandler
             if (strpos($throwable->getMessage(), '500 Error: bad syntax')) {
                 $code = CommonErrorCode::SERVER_MESSAGE_EMAIL_NOT_FOUND;
             }
-            $data = [$code_name => $code, $message_name => CommonErrorCode::getMessage($is_testing ? $code : CommonErrorCode::SERVER_MESSAGE_EMAIL_ERROR)];
+            $data = [
+                $code_name => $code,
+                $message_name => CommonErrorCode::getMessage(
+                    $is_testing ? $code : CommonErrorCode::SERVER_MESSAGE_EMAIL_ERROR
+                ),
+            ];
         }
         if (empty($data)) {
             // 其他情况
-            $data = [$code_name => $is_testing ? $throwable->getCode() == 0 ? CommonErrorCode::SERVER_ERROR : $throwable->getCode() : CommonErrorCode::SERVER_ERROR, $message_name => $is_testing ? $throwable->getMessage() : __(CommonErrorCode::getMessage(CommonErrorCode::SERVER_ERROR))];
+            $data = [
+                $code_name => $is_testing ? $throwable->getCode(
+                ) == 0 ? CommonErrorCode::SERVER_ERROR : $throwable->getCode() : CommonErrorCode::SERVER_ERROR,
+                $message_name => $is_testing ? $throwable->getMessage() : __(
+                    CommonErrorCode::getMessage(CommonErrorCode::SERVER_ERROR)
+                ),
+            ];
             // 其他错误
             if ($throwable instanceof HttpException) {
-                $data = [$code_name => $throwable->getCode() ?: $throwable->getStatusCode(), $message_name => $throwable->getMessage()];
+                $data = [
+                    $code_name => $throwable->getCode() ?: $throwable->getStatusCode(),
+                    $message_name => $throwable->getMessage(),
+                ];
+                $status_code = $throwable->getStatusCode();
             }
         }
         $response = $response->withHeader(Header::CONTENT_TYPE, 'application/json; charset=utf-8');
@@ -159,7 +215,7 @@ class CommonHandler extends ExceptionHandler
         $this->logger->error(
             <<<ERROR_LOG
 TYPE: {$error_type}
-[{$data[$code_name]}] {$data[$message_name]}
+[$data[$code_name]] $data[$message_name]
 {$throwable->getMessage()}
 -------------------------------
 REQUEST_TIME: {$request_time}
@@ -189,11 +245,14 @@ TRACE:
 ERROR_LOG
         );
         $data = Json::encode($data);
-        if ($restful) {
-            $response = $response->withStatus($status_code ?? $throwable->status ?? $throwable->statusCode ?? RFC7231::INTERNAL_SERVER_ERROR);
+        if ($restful === ApiStyleService::RESTFUL) {
+            $response = $response->withStatus(
+                $status_code ?? $throwable->status ?? $throwable->statusCode ?? RFC7231::INTERNAL_SERVER_ERROR
+            );
         }
         return $response->withBody(new SwooleStream($data));
     }
+
     /**
      * 判断该异常处理器是否要对该异常进行处理.
      */

src/Middleware/ClassicCoreMiddleware.php

@@ -10,18 +10,20 @@
 
 namespace Singularity\HDK\Core\Middleware;
 
+use Hyperf\Codec\Json;
 use Hyperf\Contract\Arrayable;
 use Hyperf\Contract\Jsonable;
 use Hyperf\Contract\LengthAwarePaginatorInterface;
 use Hyperf\Di\Annotation\Inject;
 use Hyperf\HttpMessage\Stream\SwooleStream;
 use Hyperf\HttpServer\CoreMiddleware;
-use Hyperf\Utils\Codec\Json;
 use Lmc\HttpConstants\Header;
 use Psr\Http\Message\ResponseInterface;
 use Psr\Http\Message\ServerRequestInterface;
 use Singularity\HDK\Core\Service\UtilsService;
 
+use function Hyperf\Config\config;
+
 /**
  * Singularity\HDK\Utils\Middleware\ClassicCoreMiddleware@hyperf-development-kit
  *

src/Middleware/CommonCoreMiddleware.php

@@ -10,19 +10,21 @@
 
 namespace Singularity\HDK\Core\Middleware;
 
+use Hyperf\Codec\Json;
 use Hyperf\Contract\Arrayable;
 use Hyperf\Contract\Jsonable;
 use Hyperf\Contract\LengthAwarePaginatorInterface;
 use Hyperf\Di\Annotation\Inject;
 use Hyperf\HttpMessage\Stream\SwooleStream;
 use Hyperf\HttpServer\CoreMiddleware;
-use Hyperf\Utils\Codec\Json;
 use Lmc\HttpConstants\Header;
 use Psr\Http\Message\ResponseInterface;
 use Psr\Http\Message\ServerRequestInterface;
 use Singularity\HDK\Core\Service\ApiStyleService;
 use Singularity\HDK\Core\Service\UtilsService;
 
+use function Hyperf\Config\config;
+
 /**
  * Singularity\HDK\Core\Middleware\CommonCoreMiddleware@HDK-Core
  *
@@ -73,11 +75,12 @@ class CommonCoreMiddleware extends CoreMiddleware
                 'last'
             );
             $fact_response = $this->utilsService->extendLinkToHeader($fact_response, $response->url(1), 'first');
-            return $this->utilsService->extendLinkToHeader(
+            $fact_response = $this->utilsService->extendLinkToHeader(
                 $fact_response,
                 $response->previousPageUrl(),
                 'prev'
             );
+            return $fact_response->withBody(new SwooleStream(Json::encode($response->items())));
         }
 
         return parent::transferToResponse($response, $request);

src/Middleware/InternationalizationMiddleware.php

@@ -14,6 +14,8 @@ use Psr\Http\Server\MiddlewareInterface;
 use Psr\Http\Server\RequestHandlerInterface;
 use Symfony\Component\HttpFoundation\Request;
 
+use function Hyperf\Config\config;
+
 /**
  * Singularity\HDK\Utils\Middleware\InternationalizationMiddleware@HDK
  *
@@ -37,7 +39,7 @@ class InternationalizationMiddleware implements MiddlewareInterface
         $req = (new Request());
         $req->headers->set(Header::ACCEPT_LANGUAGE, $request->getHeaderLine(Header::ACCEPT_LANGUAGE));
 
-        $language = $req->getPreferredLanguage([config('translation.locale')]);
+        $language = $req->getPreferredLanguage();
         if (!empty($language)) {
             $language = match (strtolower($language)) {
                 'en', 'en_us', 'en-us', 'en-uk', 'en_uk' => 'en',

src/Middleware/SessionMiddleware.php

@@ -15,8 +15,11 @@ use Hyperf\Contract\SessionInterface;
 use Hyperf\HttpMessage\Cookie\Cookie;
 use Hyperf\HttpMessage\Server\Response;
 use Hyperf\Session\SessionManager;
+use Psr\Http\Message\RequestInterface;
 use Psr\Http\Message\ResponseInterface;
 use Psr\Http\Message\ServerRequestInterface;
+use Psr\Http\Server\MiddlewareInterface;
+use Psr\Http\Server\RequestHandlerInterface;
 
 /**
  * Singularity\HDK\Core\Middleware\SessionMiddleware@HDK-Core
@@ -24,12 +27,70 @@ use Psr\Http\Message\ServerRequestInterface;
  * @author 李东云 <Dongyun.Li@LuxCreo.Ai>
  * Powered by PhpStorm
  * Created on 2023/3/8
+ *
+ * @deprecated since 0.2.21, use \Singularity\HDK\Auth\Middleware\SessionMiddleware instead.
  */
-class SessionMiddleware extends \Hyperf\Session\Middleware\SessionMiddleware
+class SessionMiddleware implements MiddlewareInterface
 {
     public function __construct(private SessionManager $sessionManager, private ConfigInterface $config)
     {
-        parent::__construct($this->sessionManager, $this->config);
+    }
+
+    /**
+     * Process an incoming server request.
+     * Processes an incoming server request in order to produce a response.
+     * If unable to produce the response itself, it may delegate to the provided
+     * request handler to do so.
+     */
+    public function process(ServerRequestInterface $request, RequestHandlerInterface $handler): ResponseInterface
+    {
+        if (!$this->isSessionAvailable()) {
+            return $handler->handle($request);
+        }
+
+        $session = $this->sessionManager->start($request);
+
+        try {
+            $response = $handler->handle($request);
+        } finally {
+            $this->storeCurrentUrl($request, $session);
+            $session = $this->sessionManager->getSession();
+
+            /*
+             * 现在的机制，但凡写入 Redis 的数据，
+             * 过期时间就是固定的 gc_maxlifetime
+             *
+             * 而 RedisHandler 只会被依赖注入时加载一次，
+             * 后续无法临时修改 gc_maxlifetime
+             *
+             * 又因为现在没有其他情况用到 session
+             * 只有登录之后才会记下用户信息
+             *
+             * 所以一个妥协的方案，就是只有登录了再写入 Redis
+             *
+             * （除非重写整套 RedisHandler/RedisHandlerFactory/...）
+             */
+            if (!$this->auth($session)) {
+                $this->sessionManager->end($session);
+            }
+        }
+
+        return $this->addCookieToResponse($request, $response, $session);
+    }
+
+    private function isSessionAvailable(): bool
+    {
+        return $this->config->has('session.handler');
+    }
+
+    /**
+     * Store the current URL for the request if necessary.
+     */
+    private function storeCurrentUrl(RequestInterface $request, SessionInterface $session)
+    {
+        if ($request->getMethod() === 'GET') {
+            $session->setPreviousUrl($this->fullUrl($request));
+        }
     }
 
     /**
@@ -43,10 +104,13 @@ class SessionMiddleware extends \Hyperf\Session\Middleware\SessionMiddleware
         $cookie = new Cookie(
             name: $session->getName(),
             value: $session->getId(),
-            expire: $this->getCookieExpirationDate(),
+            expire: $this->getCookieExpirationDate($session),
             path: $this->config->get('session.options.path', '/'),
             domain: $this->config->get('session.options.domain', $request->getUri()->getHost()),
-            secure: $this->config->get('session.options.secure', strtolower($request->getUri()->getScheme()) === 'https'),
+            secure: $this->config->get(
+                'session.options.secure',
+                strtolower($request->getUri()->getScheme()) === 'https'
+            ),
             httpOnly: true,
             sameSite: $this->config->get('session.options.samesite', Cookie::SAMESITE_LAX)
         );
@@ -57,12 +121,24 @@ class SessionMiddleware extends \Hyperf\Session\Middleware\SessionMiddleware
         return $response->withCookie($cookie);
     }
 
+    /**
+     * Get the full URL for the request.
+     */
+    private function fullUrl(RequestInterface $request): string
+    {
+        $uri = $request->getUri();
+        $query = $uri->getQuery();
+        $question = $uri->getHost() . $uri->getPath() == '/' ? '/?' : '?';
+        return $query ? $this->url($request) . $question . $query : $this->url($request);
+    }
+
     /**
      * Get the session lifetime in seconds.
      */
-    private function getCookieExpirationDate(): int
+    private function getCookieExpirationDate(SessionInterface $session): int
     {
-        if ($this->config->get('session.options.expire_on_close')) {
+        // if ($this->config->get('session.options.expire_on_close')) {
+        if (!$this->auth($session)) {
             $expirationDate = 0;
         } else {
             $expireSeconds = $this->config->get('session.options.cookie_lifetime', 5 * 60 * 60);
@@ -70,4 +146,17 @@ class SessionMiddleware extends \Hyperf\Session\Middleware\SessionMiddleware
         }
         return $expirationDate;
     }
+
+    /**
+     * Get the URL (no query string) for the request.
+     */
+    private function url(RequestInterface $request): string
+    {
+        return rtrim(preg_replace('/\?.*/', '', (string)$request->getUri()));
+    }
+
+    private function auth(SessionInterface $session)
+    {
+        return $session->has('userInfo');
+    }
 }

src/Service/ApiStyleService.php

@@ -11,6 +11,8 @@ namespace Singularity\HDK\Core\Service;
 
 use Hyperf\Context\Context;
 
+use function Hyperf\Config\config;
+
 class ApiStyleService
 {
     public const RESTFUL = 'restful';

src/Service/EmailService.php

@@ -18,6 +18,8 @@ use Symfony\Component\Mailer\Transport;
 use Symfony\Component\Mime\Address;
 use Symfony\Component\Mime\Email;
 
+use function Hyperf\Config\config;
+
 /**
  * 邮箱验证码
  */

src/Service/ExtendService.php

@@ -24,13 +24,10 @@ class ExtendService
         array|string|null $params = null
     ): array {
         $params ??= $request?->getQueryParams();
-        $extends = $params['extends'] ?? null;
-        if (!empty($extends)) {
-            $extends = explode(',', $extends);
-            return Context::set(self::class, array_map('trim', $extends));
-        }
+        $extends = explode(',', $params['extends'] ?? '');
+        $extends = array_map('trim', $extends);
 
-        return [];
+        return Context::set(self::class, array_filter($extends));
     }
 
 
@@ -57,6 +54,6 @@ class ExtendService
      */
     public function hasExtend(string $field): bool
     {
-        return $this->utils->inArray($field, Context::get(self::class));
+        return $this->utils->inArray($field, Context::get(self::class) ?? []);
     }
 }

src/Service/HttpRequestService.php

@@ -6,16 +6,12 @@ namespace Singularity\HDK\Core\Service;
 
 use Ergebnis\Http\Method;
 use GuzzleHttp\Client;
-use GuzzleHttp\Exception\BadResponseException;
 use GuzzleHttp\Exception\GuzzleException;
-use GuzzleHttp\Exception\ServerException;
 use GuzzleHttp\Psr7\Request;
 use GuzzleHttp\Psr7\Utils;
+use Hyperf\Codec\Json;
 use Hyperf\Di\Annotation\Inject;
 use Hyperf\Guzzle\ClientFactory;
-use Hyperf\Utils\Codec\Json;
-use Psr\Http\Client\ClientExceptionInterface;
-use Psr\Http\Message\RequestInterface;
 use Psr\Http\Message\ResponseInterface;
 
 /**
@@ -23,12 +19,9 @@ use Psr\Http\Message\ResponseInterface;
  */
 class HttpRequestService
 {
-    public const TIMEOUT = 20;
+    // public const TIMEOUT = 20;
 
-    /**
-     * @Inject()
-     * @var ClientFactory
-     */
+    #[Inject]
     private ClientFactory $client;
 
     /**
@@ -39,14 +32,16 @@ class HttpRequestService
     /**
      * @param string $url
      * @param array<string, string|int> $params
+     * @param array $data
      * @return ResponseInterface
      * @throws GuzzleException
      */
-    public function requestGet(string $url, array $params = []): ResponseInterface
+    public function requestGet(string $url, array $params = [], array $data = []): ResponseInterface
     {
         $request = new Request(Method\Rfc\Rfc7231::GET, $url);
         return $this->getClient()->send($request, [
-            'params' => $params,
+            'query' => $params,
+            'json' => $data,
         ]);
     }
 
@@ -62,12 +57,17 @@ class HttpRequestService
      * @return ResponseInterface
      * @throws GuzzleException
      */
-    public function requestPost(string $url, array $data = [], array $params = []): ResponseInterface
+    public function requestPost(string $url, array $params = [], array $data = []): ResponseInterface
     {
         $data = Json::encode($data);
-        $request = new Request('post', $url, ['Content-Type' => 'application/json'], Utils::streamFor($data));
+        $request = new Request(
+            'post',
+            $url,
+            ['Content-Type' => 'application/json'],
+            Utils::streamFor($data),
+        );
         return $this->getClient()->send($request, [
-            'params' => $params,
+            'query' => $params,
         ]);
     }
 
@@ -79,18 +79,13 @@ class HttpRequestService
      * @return ResponseInterface
      * @throws GuzzleException
      */
-    public function requestPut(string $url, array $data = [], array $params = []): ResponseInterface
+    public function requestPut(string $url, array $params = [], array $data = []): ResponseInterface
     {
         $data = Json::encode($data);
         $request = new Request('put', $url, ['Content-Type' => 'application/json'], Utils::streamFor($data));
-        $result = $this->getClient()->send($request, [
-            'params' => $params,
+        return $this->getClient()->send($request, [
+            'query' => $params,
         ]);
-        $json = Json::decode($result->getBody()->getContents());
-        if ($json['code'] !== 200) {
-            throw new ServerException($json['message'], $request, $result);
-        }
-        return $result;
     }
 
     /**
@@ -103,20 +98,4 @@ class HttpRequestService
         $this->options = array_replace_recursive($this->options, $options);
         return $this;
     }
-
-    /**
-     * @param ResponseInterface $response
-     * @param RequestInterface $request
-     * @return ResponseInterface
-     */
-    private function parseResponse(
-        ResponseInterface $response,
-        RequestInterface $request
-    ): ResponseInterface {
-        if ($response->getStatusCode() >= 200 && $response->getStatusCode() < 300) {
-            return $response;
-        } else {
-            throw new BadResponseException($response->getReasonPhrase(), $request, $response);
-        }
-    }
 }

src/Service/OssService.php

@@ -9,7 +9,9 @@
 
 namespace Singularity\HDK\Core\Service;
 
-use Hyperf\Utils\Codec\Json;
+use Hyperf\Codec\Json;
+
+use function Hyperf\Config\config;
 
 class OssService
 {

src/Service/SmsService.php

@@ -6,12 +6,14 @@ use AlibabaCloud\SDK\Dysmsapi\V20170525\Dysmsapi;
 use AlibabaCloud\SDK\Dysmsapi\V20170525\Models\SendSmsRequest;
 use AlibabaCloud\Tea\Exception\TeaError;
 use Darabonba\OpenApi\Models\Config;
+use Hyperf\Codec\Json;
 use Hyperf\HttpMessage\Exception\ServerErrorHttpException;
-use Hyperf\Utils\Codec\Json;
 use Singularity\HDK\Core\Constants\CommonErrorCode;
 use Singularity\HDK\Core\Exceptions\ValidateException;
 use UnexpectedValueException;
 
+use function Hyperf\Config\config;
+
 /**
  * 短信服务
  */

src/Service/XmlService.php

@@ -0,0 +1,86 @@
+<?php
+/**
+ * XmlService.php@LuxOP
+ *
+ * @author 李东云 <Dongyun.Li@LuxCreo.Ai>
+ * Powered by PhpStorm
+ * Created on 2023/4/10
+ */
+
+namespace Singularity\HDK\Core\Service;
+
+use Symfony\Component\Serializer\Encoder\XmlEncoder;
+
+class XmlService
+{
+    private XmlEncoder $service;
+
+    public function __construct(XmlEncoder $encoder)
+    {
+        $this->service = $encoder;
+    }
+
+    /**
+     * @param object|array<string, mixed> $data
+     * @param string $xmlRootNodeName
+     * @param bool $xmlFormatOutput 是否格式化
+     * @param string $xmlVersion
+     * @param string $xmlEncoding
+     * @param bool $xmlStandalone 是否添加声明规范的标签到xml
+     * @param int[] $encoderIgnoredNodeTypes
+     * @param bool $removeEmptyTags
+     * @return false|string
+     * @see https://symfony.com/doc/current/components/serializer.html#the-xmlencoder
+     */
+    public function encode(
+        object|array $data,
+        string $xmlRootNodeName = 'root',
+        bool $xmlFormatOutput = true,
+        string $xmlVersion = '1.0',
+        string $xmlEncoding = 'utf-8',
+        bool $xmlStandalone = false,
+        array $encoderIgnoredNodeTypes = [],
+        bool $removeEmptyTags = false,
+    ): false|string {
+        return $this->service->encode(
+            $data,
+            XmlEncoder::FORMAT,
+            [
+                XmlEncoder::ENCODER_IGNORED_NODE_TYPES => $encoderIgnoredNodeTypes,
+                XmlEncoder::ROOT_NODE_NAME => $xmlRootNodeName,
+                XmlEncoder::FORMAT_OUTPUT => $xmlFormatOutput,
+                XmlEncoder::VERSION => $xmlVersion,
+                XmlEncoder::ENCODING => $xmlEncoding,
+                XmlEncoder::STANDALONE => $xmlStandalone,
+                XmlEncoder::REMOVE_EMPTY_TAGS => $removeEmptyTags,
+            ]
+        );
+    }
+
+    /**
+     * @param string $xml
+     * @param bool $xmlTypeCastAttributes 是否自动转换类型
+     * @param bool $asCollection 是否全部使用数组
+     * @param int[] $decoderIgnoredNodeTypes
+     * @param int $loadOptions
+     * @return array<string, mixed>
+     */
+    public function decode(
+        string $xml,
+        bool $xmlTypeCastAttributes = true,
+        bool $asCollection = false,
+        array $decoderIgnoredNodeTypes = [XML_PI_NODE, XML_COMMENT_NODE],
+        int $loadOptions = LIBXML_NONET | LIBXML_NOBLANKS,
+    ): array {
+        return $this->service->decode(
+            $xml,
+            XmlEncoder::FORMAT,
+            [
+                XmlEncoder::LOAD_OPTIONS => $loadOptions,
+                XmlEncoder::DECODER_IGNORED_NODE_TYPES => $decoderIgnoredNodeTypes,
+                XmlEncoder::TYPE_CAST_ATTRIBUTES => $xmlTypeCastAttributes,
+                XmlEncoder::AS_COLLECTION => $asCollection,
+            ]
+        );
+    }
+}

tests/Unit/ExtendServiceTest.php

@@ -9,12 +9,10 @@
 
 namespace Singularity\HDK\Test\Core\Unit;
 
+use Hyperf\Context\Context;
 use Singularity\HDK\Core\Service\ExtendService;
 use Singularity\HDK\Core\Service\UtilsService;
 
-$service = new ExtendService(new UtilsService());
-
-
 /** @var ExtendService $service */
 $service = make(ExtendService::class, ['utils' => new UtilsService()]);
 it('asserts no parameters can be parsed.', function (ExtendService $service, $params) {
@@ -23,7 +21,7 @@ it('asserts no parameters can be parsed.', function (ExtendService $service, $pa
         $params
     );
     $result = $service->getExtends();
-    expect($result)->toBeArray()->toHaveCount(0)->toBe([]);
+    expect($result)->toBeArray()->toBe([])->toHaveCount(0)->toBe([]);
 })->with([
     [$service, null],
     [$service, ''],
@@ -32,6 +30,11 @@ it('asserts no parameters can be parsed.', function (ExtendService $service, $pa
     [$service, ['extends' => null]],
 ]);
 
+it('asserts has no specify extend', function () use ($service) {
+    Context::destroy(ExtendService::class);
+    expect($service->hasExtend('a'))->toBeFalse();
+})->depends('it asserts query parameters can be parsed.');
+
 it('asserts query parameters can be parsed.', function () use ($service) {
     $result = $service->parse(
         null,
@@ -44,19 +47,21 @@ it('asserts query parameters can be parsed.', function () use ($service) {
 });
 
 it('asserts has extends', function () use ($service) {
+    Context::set(ExtendService::class, ['a', 'b']);
     expect($service->hasExtends())->toBeTrue();
 });
 
 it('asserts has specify extend', function () use ($service) {
+    Context::set(ExtendService::class, ['a', 'b']);
     expect($service->hasExtend('a'))->toBeTrue()
         ->and($service->hasExtend('b'))->toBeTrue()
         ->and($service->hasExtend('c'))->toBeFalse();
 })->depends('it asserts query parameters can be parsed.');
 
-it('asserts parsed extends', function () use ($service) {
-    $extends = $service->getExtends();
-    expect($extends)->toBeArray()->toMatchArray([
-        'a',
-        'b',
-    ]);
-})->depends('it asserts query parameters can be parsed.');
+// it('asserts parsed extends', function () use ($service) {
+//     $extends = $service->getExtends();
+//     expect($extends)->toBeArray()->toMatchArray([
+//         'a',
+//         'b',
+//     ]);
+// })->depends('it asserts query parameters can be parsed.');

tests/Unit/OssServiceTest.php

@@ -7,7 +7,7 @@
  * Created on 2023/1/9
  */
 
-use Hyperf\Utils\Codec\Json;
+use Hyperf\Codec\Json;
 use Singularity\HDK\Core\Service\OssService;
 
 use function Spatie\PestPluginTestTime\testTime;

tests/Unit/XmlServiceTest.php

@@ -0,0 +1,130 @@
+<?php
+/**
+ * XmlServiceTest.php@LuxOP
+ *
+ * @author 李东云 <Dongyun.Li@LuxCreo.Ai>
+ * Powered by PhpStorm
+ * Created on 2023/4/10
+ */
+
+namespace HyperfTest\Unit\Common;
+
+use Singularity\HDK\Core\Service\XmlService;
+use Symfony\Component\Serializer\Encoder\XmlEncoder;
+
+use function Hyperf\Support\make;
+
+/** @var XmlService $service */
+$service = make(
+    XmlService::class,
+    ['encoder' => make(XmlEncoder::class)]
+);
+
+test(
+    'assert Xml can be encoded',
+    function (array $data, string $expect, string $rootNodeName) use ($service) {
+        $result = $service->encode($data, $rootNodeName);
+
+        expect($result)->toBe($expect);
+    }
+)->with([
+    'normal' => [
+        'data' => [
+            '@version' => '1.0',
+            '@descripe' => 'Luxcreo',
+            'UserName' => 'zhm',
+            'Email' => 'haimei.zheng@luxcreo.ai',
+            'BiosId' => '420036H32020120279',
+            'validTime' => '2099/03/27',
+        ],
+        'expect' => <<<'XML'
+<?xml version="1.0" encoding="utf-8"?>
+<ClientInfo version="1.0" descripe="Luxcreo">
+  <UserName>zhm</UserName>
+  <Email>haimei.zheng@luxcreo.ai</Email>
+  <BiosId>420036H32020120279</BiosId>
+  <validTime>2099/03/27</validTime>
+</ClientInfo>
+
+XML,
+        'xmlRootNodeName' => 'ClientInfo',
+    ],
+    'normal attribute' => [
+        'data' => [
+            '@version' => '1.0',
+            '@descripe' => 'Luxcreo',
+            'UserName' => 'zhm',
+            'Email' => [
+                '@type' => 'Business',
+                '#' => 'haimei.zheng@luxcreo.ai',
+            ],
+            'BiosId' => '420036H32020120279',
+            'validTime' => '2099/03/27',
+        ],
+        'expect' => <<<'XML'
+<?xml version="1.0" encoding="utf-8"?>
+<ClientInfo version="1.0" descripe="Luxcreo">
+  <UserName>zhm</UserName>
+  <Email type="Business">haimei.zheng@luxcreo.ai</Email>
+  <BiosId>420036H32020120279</BiosId>
+  <validTime>2099/03/27</validTime>
+</ClientInfo>
+
+XML
+        ,
+        'ClientInfo',
+    ],
+    'normal comment' => [
+        'data' => [
+            '@version' => '1.0',
+            '@descripe' => 'Luxcreo',
+            'UserName' => 'zhm',
+            'Email' => [
+                '@type' => 'Business',
+                '#' => 'haimei.zheng@luxcreo.ai',
+            ],
+            'BiosId' => '420036H32020120279',
+            'validTime' => [
+                '#comment' => '到期时间',
+            ],
+        ],
+        'expect' => <<<'XML'
+<?xml version="1.0" encoding="utf-8"?>
+<ClientInfo version="1.0" descripe="Luxcreo">
+  <UserName>zhm</UserName>
+  <Email type="Business">haimei.zheng@luxcreo.ai</Email>
+  <BiosId>420036H32020120279</BiosId>
+  <validTime>
+    <!--到期时间-->
+  </validTime>
+</ClientInfo>
+
+XML
+        ,
+        'ClientInfo',
+    ],
+]);
+
+test('assert Xml can be parsed', function (string $xml, array $expected) use ($service) {
+    $data = $service->decode($xml);
+    expect($data)->toBe($expected);
+})->with([
+    'normal' => [
+        'xml' => <<<XML
+<?xml version="1.0" encoding="UTF-8"?>
+<ClientInfo version="1.0" descripe="LuxAlignAuthentication">
+    <UserName>zhm</UserName>
+    <Email>haimei.zheng@luxcreo.ai</Email>
+    <BiosId>420036H32020120279</BiosId>
+</ClientInfo>
+
+XML,
+        'expected' => [
+            '@version' => 1.0,
+            '@descripe' => 'LuxAlignAuthentication',
+            'UserName' => 'zhm',
+            'Email' => 'haimei.zheng@luxcreo.ai',
+            'BiosId' => '420036H32020120279',
+        ],
+    ],
+]);