Skip to content

Commit

Permalink
#94010 Fixed readme
Browse files Browse the repository at this point in the history
  • Loading branch information
Evgeny Bereza committed Nov 3, 2022
1 parent 5490f88 commit 8829fc3
Showing 1 changed file with 13 additions and 7 deletions.
20 changes: 13 additions & 7 deletions README.md
Original file line number Diff line number Diff line change
@@ -1,20 +1,26 @@
# Laravel serve swagger
# Laravel Serve Stoplight

Пакет позволяет вывести Swagger UI, настроив только пути до ваших openapi3 конфигов
Пакет позволяет вывести спецификацию API, настроив только пути до ваших openapi3 конфигов

## Установка

1. `composer require ensi/laravel-serve-swagger`
2. Добавьте `Ensi\LaravelServeSwagger\ServeSwaggerServiceProvider::class` в Package Service Providers в `config/app.php`
3. Скопируйте себе `config/serve-swagger.php` и настройте путь для роутинга и массив ссылок до ваших openapi3 конфигов
1. `composer require ensi/laravel-serve-stoplight`
2. Добавьте `Ensi\LaravelServeStoplight\ServeStoplightServiceProvider::class` в Package Service Providers в `config/app.php`
3. Скопируйте себе `config/serve-stoplight.php` и настройте путь для роутинга и массив ссылок до ваших openapi3 конфигов

## Формат массива urls в конфиге

```
'urls' => [
[
'url' => 'foo.yaml', // Путь, осносительно public
'name' => 'Название 1' // Название для отображения в интерфейсе
'url' => '/api-docs/v1/index.yaml', // Путь, осносительно public c / в начале
'name' => 'API v1' // Название для отображения в интерфейсе
],
],
```

## Просмотр спецификации

По-умолчанию спецификация v1 доступна по адресу docs/swagger (аналогичный полный путь docs/swagger/v1).

Если нужно открыть спецификацию другой версии, то используйте путь docs/swagger/{version}, например, docs/swagger/v2

0 comments on commit 8829fc3

Please sign in to comment.