add customerRoute

Author: astral-data

.openapi.php

@@ -0,0 +1,12 @@
+<?php
+
+return [
+    'title' => 'API Docs',
+    'description' => 'API Docs description.',
+    'headers' => [
+
+    ],
+    'service' => [
+
+    ],
+];

src/OpenApi/OpenApi.php renamed to src/OpenApi.php

@@ -2,7 +2,7 @@
 
 declare(strict_types=1);
 
-namespace Astral\Serialize\OpenApi;
+namespace Astral\Serialize;
 
 use Astral\Serialize\OpenApi\Annotations\Headers;
 use Astral\Serialize\OpenApi\Annotations\RequestBody;
@@ -53,13 +53,17 @@ public function buildByClass(string $className): void
                 Headers::class     => null,
             ];
 
+
             foreach ($methodAttributes as $methodAttribute) {
-                $name = $methodAttribute->getName();
-                if (array_key_exists($name,$instances)) {
-                    $instances[$name] = $methodAttribute->newInstance();
+                $inst =  $methodAttribute->newInstance();
+                foreach (array_keys($instances) as $anchorClass) {
+                    if ($inst instanceof $anchorClass) {
+                        $instances[$anchorClass] = $inst;
+                    }
                 }
             }
 
+
             if ($instances[Route::class] === null || $instances[Summary::class] === null) {
                 continue;
             }

src/OpenApi/Handler/Handler.php

@@ -21,7 +21,7 @@ abstract class Handler implements HandleInterface
     public function __construct(
         protected readonly ParameterStorage $headerParameterStorages = new ParameterStorage()
     ) {
-        self::$OpenAPI ??= (new OpenAPI())->withApiInfo(new ApiInfo('API 接口',''));
+        self::$OpenAPI ??= (new OpenAPI())->withApiInfo(new ApiInfo('API Doc',''));
     }
 
     /**

src/OpenApi/Storage/OpenAPI/RequestBodyStorage.php

@@ -6,13 +6,14 @@
 
 use Astral\Serialize\OpenApi\Enum\ContentTypeEnum;
 use Astral\Serialize\OpenApi\Storage\StorageInterface;
+use stdClass;
 
 /**
  * 参数配置
  */
 class RequestBodyStorage implements StorageInterface
 {
-    public array $parameters;
+    public array|stdClass $parameters = [];
 
     public function __construct(
         public ContentTypeEnum $contentType = ContentTypeEnum::JSON,

tests/Openapi/OpenApi.php

@@ -1,6 +1,6 @@
 <?php
 
-use Astral\Serialize\OpenApi\OpenApi;
+use Astral\Serialize\OpenApi;
 use Astral\Serialize\Serialize;
 
 beforeAll(static function () {
@@ -59,7 +59,6 @@ public function one(TestOpenApiRequest $request): TestOpenApiResponse
 
     // 顶层结构断言
     expect($openApi->openapi)->toBe('3.1.1')
-        ->and($openApi->info->title)->toBe('API 接口')
         ->and($openApi->info->version)->toBe('1.0.0')
         ->and($openApi->tags[0]->name)->toBe('接口测试');
 

tests/Openapi/RouteOrewriteOpenApi.php

@@ -0,0 +1,46 @@
+<?php
+
+use Astral\Serialize\OpenApi;
+use Astral\Serialize\Serialize;
+
+beforeAll(static function () {
+
+
+    #[Attribute(Attribute::TARGET_METHOD)]
+    class CustomerRoute extends OpenApi\Annotations\Route
+    {
+
+    }
+
+    class TestCustomerRouteRequest extends Serialize
+    {
+        public string $name;
+
+        public int $id;
+    }
+
+    #[\Astral\Serialize\OpenApi\Annotations\Tag('接口测试')]
+    class TestCustomerRouteController{
+
+        #[\Astral\Serialize\OpenApi\Annotations\Summary('测试方法一')]
+        #[CustomerRoute('/test/customer-route')]
+        public function one(TestCustomerRouteRequest $request): void
+        {
+        }
+
+    }
+
+});
+
+test('OpenAPI structure is correct', function () {
+
+    $api =  new OpenApi();
+    $api->buildByClass(TestCustomerRouteController::class);
+
+    $openApi = $api::$OpenAPI;
+
+    // 路径是否存在
+    $paths = $openApi->paths;
+    expect($paths)->toHaveKey('/test/customer-route');
+
+});