radebatz / openapi-router
OpenApi 注解的路由适配器。
2.0.0
2022-03-14 03:37 UTC
Requires
- php: >=7.2
- doctrine/annotations: ^1.13
- psr/simple-cache: ^1.0 || ^2.0
- zircote/swagger-php: ^4.2.3
Requires (Dev)
- friendsofphp/php-cs-fixer: ^2.17 || ^3.0
- nyholm/psr7: ^1.4
- nyholm/psr7-server: ^1.0
- phpunit/phpunit: >=8.0
- symfony/cache: ^5.0 || ^6.0
- symfony/psr-http-message-bridge: ^2.1
Suggests
- radebatz/openapi-verifier: Allows your PHPUnit tests to validate your controller response against the OpenAPI annotations.
- dev-master / 2.x-dev
- 2.0.0
- 1.3.0
- 1.2.0
- 1.1.1
- 1.1.0
- 1.0.0
- dev-dependabot/composer/symfony/cache-tw-7.1.4
- dev-dependabot/composer/symfony/cache-tw-7.1.3
- dev-dependabot/composer/symfony/psr-http-message-bridge-tw-7.1
- dev-dependabot/composer/psr/simple-cache-tw-3.0.0
- dev-dependabot/composer/doctrine/annotations-tw-2.0
This package is auto-updated.
Last update: 2024-08-30 17:53:05 UTC
README
简介
允许使用 Swagger-PHP 注解来配置以下框架的路由
要求
- PHP 7.2 或更高版本 - 根据框架版本而定。
安装
您可以使用 composer 或直接 下载发行版。
Composer
首选方法是通过 composer。如果您尚未安装 composer,请按照 安装说明 进行操作。
安装 composer 后,在项目根目录中执行以下命令以安装此库
composer require radebatz/openapi-router
之后,所有必要的类都应在您的项目中可用,以添加路由支持。
基本用法
以下是一个使用 Slim
框架适配器和标准 OpenApi 注解 的示例。
index.php
<?php use Radebatz\OpenApi\Routing\Adapters\SlimRoutingAdapter; use Radebatz\OpenApi\Routing\OpenApiRouter; use Slim\App; require '../vendor/autoload.php'; $app = new App(); (new OpenApiRouter([__DIR__ . '/../src/controllers'], new SlimRoutingAdapter($app))) ->registerRoutes(); $app->run();
控制器
<?php namespace MyApp\Controllers; class GetController { /** * @OA\Get( * path="/getme", * x={ * "name": "getme" * }, * @OA\Response(response="200", description="All good") * ) */ public function getme($request, $response) { return $response->write('Get me'); } }
文档
许可证
openapi-router 项目是在 MIT 许可证 下发布的。