/api-client-generator

API client generator is a console application capable of generating an API client based on OpenAPI(Swagger) specification.

Primary LanguagePHPMIT LicenseMIT

OpenAPI SDK generator - API client generator

API client generator is a console application capable of auto-generating a PSR18/PSR7 compliant API client based on OpenAPI v3 specification according to PHP best practices and your code style standards.

Build Status Coverage Status PHPStan Level

Requirements

Why using it?

  • With generated client you are always sure that your OpenAPI specification is up-to-date.
  • Work with objects instead of raw data, it is OOP friendly.
  • Saves your time. You don't need to write data mappers youself to populate those objects with the data from the response.
  • All the basic type validations in the request and the response done automatically.
  • Despite the fact the code is generated it's clear and readable, simple to debug and to reason about.
  • Highly configurable and extensible.
  • Reliable and well tested.
  • Simply, if something can be automated it should be automated. Focus on important stuff.

Features

  • Supports yaml or json specification file formats.
  • Validates your OpenAPI specification.
  • Supports multiple content types:
    • application/json
    • application/x-www-form-urlencoded
    • application/xml
  • Supports new PHP versions synthax features.
  • It is base client independent, you are free to choose any existing PSR-18 compliant client. Just choose the one which you already use, so generated client would not cause conflicts in your dependencies.
  • Applies code style rules to generated code, you can specify your own.
  • Generates README and composer.json files with possibility to use your own template.
  • Supports allOf OpenAPI parameter.

Example

Check out example directory to see the code generated by api-client-generator.

Try it out:

cd example && \
composer install && \
php test-example.php

Usage

With Docker

$ docker run -it \
-v {path-to-specification}/openapi.yaml:/openapi.yaml:ro \
-v {path-to-client}/some-api-client:/client \
-e NAMESPACE=Group\\SomeApiClient \
-e OPENAPI=/openapi.yaml \
-e OUTPUT_DIR=/client \
-e PACKAGE=group/some-api-client \
dhlabs/api-client-generator

Without Docker

Preconditions: PHP 7.4

Clone the repository and run:

OPENAPI={path-to-specification}/openapi.yaml NAMESPACE=Group\SomeApiClient PACKAGE=group/some-api-client OUTPUT_DIR={path-to-client}/generated ./bin/api-client-generator generate

Configuration

The following environment variables are available:

Variable Required Default Enum Example
NAMESPACE yes Group\SomeApiClient
PACKAGE yes group/some-api-client
OPENAPI yes /api/openapi.yaml
OUTPUT_DIR yes /client
CODE_STYLE no {path-to-repository}/.php_cs.php /client/myCodeStyle.php
SOURCE_DIR no src src
CLIENT_PHP_VERSION no 7.4 7.0, 7.1, 7.2, 7.3, 7.4 7.4
COMPOSER_JSON_TEMPLATE_DIR no {path-to-repository}/template/composer.json.twig /path/composer.json.twig
README_MD_TEMPLATE_DIR no {path-to-repository}/template/README.md.twig /path/README.md.twig
HTTP_MESSAGE no guzzle guzzle, nyholm nyholm
CONTAINER no pimple pimple pimple

Running tests

$ composer install
$ make test

(check make for all available routines).