add rapidoc html

tw2066 · tw2066 · commit 8240991573a1 · 2025-08-19T18:07:48.000+08:00
diff --git a/README.md b/README.md
@@ -208,6 +208,7 @@ php bin/hyperf.php start
 * 访问`/swagger`可以看到swagger页面
 * 已安装[knife4j-ui](https://github.com/tw2066/knife4j-ui)，访问`/swagger/doc`可以看到knife4j页面
 * 访问`/swagger/redoc`，可以看到[redoc](https://github.com/Redocly/redoc)页面
+* 访问`/swagger/rapidoc`，可以看到[rapidoc](https://github.com/rapi-doc/RapiDoc)页面
 
 ## 注解
 
diff --git a/example/Controller/DemoController.php b/example/Controller/DemoController.php
@@ -112,19 +112,6 @@ public function fromData(#[RequestFormData] DemoFormData $formData): array
     #[ApiOperation('4:查询单条记录')]
     #[GetMapping(path: 'find/{id}/and/{in}')]
     #[ApiHeader('test2')]
-    #[ApiResponse()]
-    #[ApiResponse(PhpType::BOOL, 11)]
-    #[ApiResponse(PhpType::INT, 12)]
-    #[ApiResponse(PhpType::FLOAT, 13)]
-    #[ApiResponse(PhpType::ARRAY, 14)]
-    #[ApiResponse(PhpType::OBJECT, 15)]
-    #[ApiResponse(PhpType::STRING, 16)]
-    #[ApiResponse([PhpType::BOOL], 101)]
-    #[ApiResponse([PhpType::INT], 102)]
-    #[ApiResponse([PhpType::FLOAT], 103)]
-    #[ApiResponse([PhpType::ARRAY], 104)]
-    #[ApiResponse([PhpType::OBJECT], 105)]
-    #[ApiResponse([PhpType::STRING], 106)]
     #[ApiResponse([PhpType::BOOL])]
     #[ApiResponse(Address::class, 201)]
     #[ApiResponse(Address_1::class, 202)]
diff --git a/src/Listener/BootAppRouteListener.php b/src/Listener/BootAppRouteListener.php
@@ -74,6 +74,7 @@ public function process(object $event): void
         $httpServerRouter->addGroup($prefix, function ($route) {
             $route->get('', [SwaggerUiController::class, 'swagger']);
             $route->get('/redoc', [SwaggerUiController::class, 'redoc']);
+            $route->get('/rapidoc', [SwaggerUiController::class, 'rapidoc']);
             $route->get('/doc', [SwaggerUiController::class, 'knife4j']);
             $route->get('/swagger-resources', [SwaggerUiController::class, 'swaggerResources']);
             $route->get('/webjars/{file:.*}', [SwaggerUiController::class, 'knife4jFile']);
diff --git a/src/Swagger/SwaggerConfig.php b/src/Swagger/SwaggerConfig.php
@@ -17,7 +17,7 @@ class SwaggerConfig
 
     private string $prefix_url = '';
 
-    private string $prefix_swagger_resources = 'https://cdnjs.cloudflare.com/ajax/libs/swagger-ui/5.5.0';
+    private string $prefix_swagger_resources = 'https://cdnjs.cloudflare.com/ajax/libs/swagger-ui/5.27.1';
 
     private bool $validation_custom_attributes = false;
 
diff --git a/src/Swagger/SwaggerUiController.php b/src/Swagger/SwaggerUiController.php
@@ -39,6 +39,15 @@ public function redoc(): PsrResponseInterface
         return $this->response->withAddedHeader('content-type', 'text/html')->withBody(new SwooleStream($contents));
     }
 
+    public function rapidoc(): PsrResponseInterface
+    {
+        // https://rapidocweb.com/examples.html
+        $filePath = $this->docsWebPath . '/rapidoc.html';
+        $contents = file_get_contents($filePath);
+        $contents = str_replace('{{$url}}', BootAppRouteListener::$httpServerName . '.' . $this->swaggerConfig->getFormat(), $contents);
+        return $this->response->withAddedHeader('content-type', 'text/html')->withBody(new SwooleStream($contents));
+    }
+
     public function knife4j()
     {
         $filePath = $this->swaggerUiPath . '/doc.html';
diff --git a/src/web/rapidoc.html b/src/web/rapidoc.html
@@ -0,0 +1,12 @@
+<!doctype html> <!-- Important: must specify -->
+<html>
+<head>
+    <meta charset="utf-8"> <!-- Important: rapi-doc uses utf8 characters -->
+    <script type="module" src="https://unpkg.com/rapidoc/dist/rapidoc-min.js"></script>
+</head>
+<body>
+<rapi-doc
+        spec-url = "{{$url}}"
+> </rapi-doc>
+</body>
+</html>
