swaggest/swagger2-schema

Swagger 2.0 规范 PHP 映射

维护者

详细信息

github.com/swaggest/php-swagger2-schema

源代码

问题

安装次数: 2,249

依赖项: 1

推荐者: 0

安全性: 0

星标: 4

关注者: 2

分支: 0

公开问题: 0

v0.2.6 2021-06-17 22:37 UTC

Requires

Requires (Dev)

MIT 41d46ba37d53dd232b196e1299b8c818c9c43e3d

  • Viacheslav Poturaev <vearutop.woop@gmail.com>

This package is auto-updated.

Last update: 2024-09-18 05:30:43 UTC

README

Build Status codecov

使用 PHP 访问和验证 OpenAPI 3.0 和 Swagger 2.0 规范。

安装

composer require swaggest/swagger2-schema

用法

OpenAPI 3.0

// Load schema
$json = json_decode(file_get_contents(__DIR__ . '/../../../spec/petstore-openapi3.json'));

// Import and validate
$schema = OpenAPI3Schema::import($json);

// Access data through PHP classes
$this->assertSame('Swagger Petstore', $schema->info->title);
$ops = $schema->paths['/pets']->getGetPutPostDeleteOptionsHeadPatchTraceValues();
$this->assertSame('List all pets', $ops['get']->summary);

$responseSchema = $ops['get']->responses[200]->content['application/json']->schema;
$this->assertSame('array', $responseSchema->type);

Swagger 2.0

// Load schema
$json = json_decode(file_get_contents(__DIR__ . '/../../spec/petstore-swagger.json'));

// Import and validate
$schema = SwaggerSchema::import($json);

// Access data through PHP classes
$this->assertSame('Swagger Petstore', $schema->info->title);