greensight/laravel-openapi-client-generator

This package is abandoned and no longer maintained. No replacement package was suggested.

0.11.1 2021-09-29 14:53 UTC

README

Deprecated, use https://github.com/ensi-platform/laravel-openapi-client-generator instead

Пакет для Laravel, который генерирует http клиенты к сервису при помощи OpenApi Generator. На данный момент есть поддержка для двух платформ: PHP и NodeJS.

Зависимости:

  1. Java 8 и выше.
  2. npm 5.2 и выше.

Установка:

  1. composer require --dev greensight/laravel-openapi-client-generator
  2. php artisan vendor:publish --provider="Greensight\LaravelOpenapiClientGenerator\OpenapiClientGeneratorServiceProvider" - копирует конфиг генератора в конфиги приложения
  3. измените, если требуется, настройки по умолчанию в конфигурационном файле

Запуск:

  1. Перед запуском убедиться, что структура описания апи соответствует этим требованиям.

  2. Настроить параметры генерации для соответствующих платформ (если дефолтные не подходят).

  3. Генерация клиента:

  4. После успешной генерации по пути <output_dir_template>-js|php для nodejs и php соответственно появится код клиента, который можно запушить в git, в корне будет лежать скрипт git_push который удобно использовать для этого. Соответствующие репозитории должны быть уже созданы в соответствующей системе контроля версий. Полное название репозитория формируется так: <git_user>/<git_repo_template>-js|php для nodejs и php соответственно.

Ограничения

Пакет на данный момент не поддерживает генерацию в Windows окружении.