OpenAPI client generator bridge
Библиотека, которая дает возможность подключить, сгенерированный OpenAPI генератором, клиентский код к вашему проекту.
###Установка:
-
Установите openapi-generator. Для проверки выполните команду:
openapi-generator version
, в случае когда openapi-generator установлен вы увидите версию генератора. -
Установите библиотеку, для этого выполните команду
composer require rollun-com/rollun-openapi-client-bridge
-
Подготовьте openapi манифест. Детали здесь.
-
Скачайте openapi манифест. Для этого перейдите на https://app.swaggerhub.com/home?type=API, откройте нужный вам манифест и сделайте экспорт в виде yaml файла. При скачивании, рекомендуется называть документ openapi.yaml так, как такое имя используется генератором по умолчанию.
-
Для генерации кода выполните команду:
php vendor/bin/openapi-client-generate
-
Обязательно добавьте сгенерированные классы в аутолоадер композера.
"autoload": { "psr-4": { "ModuleName\\": "src/ModuleName/src/" } },
Использование
Для того чтобы отправить запрос вам достаточно:
$apiInstance = $container->get(\ModuleName\OpenAPI\Client\V1\Api\FooApi::class); // создаем $apiInstance
$result = $apiInstance->getUserById('qwerty123'); // Вызываем отправку запроса. У каждого $apiInstance есть специальные методы, которые были сгенерированы по манифесту.