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.

Requirements

• OpenAPI >= 3.0
• PHP >= 7.0

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 yourself 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 syntax 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 any conflicts with your dependencies. Although not recommended, you can also use or build your own PSR-18 implementation, as the generated client depends on PSR interfaces only.
• 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, oneOf, anyOf OpenAPI parameters.
• Supports nullable optional scheme property.

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:

Running tests

$ composer install
$ make test

(check make for all available routines).