Download the PHP package sitesoft/laravel-apis without Composer
On this page you can find all versions of the php package sitesoft/laravel-apis. It is possible to download/install these versions without Composer. Possible dependencies are resolved automatically.
Download sitesoft/laravel-apis
More information about sitesoft/laravel-apis
Files in sitesoft/laravel-apis
Package laravel-apis
Short Description Init swagger and connect to Sitesoft APIS
License
Informations about the package laravel-apis
Установка
1 . Установить через composer
2 . В файле config/app.php
добавить в providers
3 . Чтобы разрешить CORS для всех api запросов, добавьте HandleCors
middleware в $middlewareGroups
в файле app/Http/Kernel.php
:
(См. раздел "Поддержка Cross-Origin Resource Sharing (CORS)")
4 . Опубликовать файл настроек apis.php
из пакета:
Использование
Добавление нового проекта на Sitesoft APIS
где
<name>
- имя нового проекта (можно использовать кириллицу)<version>
- версия апи (только цифры)<url>
- базовый url к апи (должен начинаться сhttp
илиhttps
, напримерhttp://test.com/api
)<path>
- путь к api директории относительно папкиapp/Http/Controllers/
(не обязательно, по умолчаниюApi
)
например, если файлы вашего api находятся в папке app/Http/Controllers/Api/v1
то команда будет следующей:
эта команда сделает следующее:
- сгенерирует токен и запишет в файл
config/apis.php
- добавит
SwaggerController.php
вapp/Http/Controllers/Api/v1/
- добавит маршрут для swagger'а в файл
routes/api.php
- сделает запрос к Sitesoft APIS на добавление нового проекта
- добавит в файл настроек
apis.php
путь для генерацииswagger.json
Генерация swagger.json
Данный файл генерируется из ваших doc-блоков библиотекой swagger-php отдельно для каждой версии api.
Папки для генерации задаются в файле настроек config/apis.php
в параметре paths
.
Swagger просканирует эти папки и создаст в каждой свой swagger.json
.
Каждый такой файл должен быть доступен из вне, для этого при apis:create-project
и apis:add-version
по пути указанному в <path>
создается файл SwaggerController.php
Поддержка Cross-Origin Resource Sharing (CORS)
Ваши api методы должны возвращать заговолок Access-Control-Allow-Origin
для того, чтобы иметь возможность просмотреть ответ прямо на Sitesoft APIS.
Для поддержки CORS используется barryvdh/laravel-cors, для его работы достаточно выполнить пункт 3 из раздела Установка. Или вы можете включить CORS только для некоторых маршрутов:
или так
У модуля laravel-cors также есть возможность настройки https://github.com/barryvdh/laravel-cors#configuration
Добавление новой версии на Sitesoft APIS
где
<version>
- версия апи (только цифры)<url>
- базовый url к апи (должен начинаться сhttp
илиhttps
, напримерhttp://test.com/api/v2
)<path>
- путь к api директории относительно папкиapp/Http/Controllers/
(не обязательно, по умолчаниюApi_v<version>
)
например, если ваши файлы с новой версией api находятся в папке app/Http/Controllers/Api/v2
(относительно корня проекта) то команда будет следующей:
эта команда сделает следующее:
- добавит
SwaggerController.php
вapp/Http/Controllers/Api/v2/
- добавит маршрут для swagger'а в файл
routes/api.php
- сделает запрос к Sitesoft APIS на добавление новой версии проекта
- добавит в файл настроек
apis.php
путь для генерацииswagger.json
All versions of laravel-apis with dependencies
zircote/swagger-php Version ^3.0
barryvdh/laravel-cors Version *
sitesoft/laravel-config-writer Version *