CHANGELOG.md

Changelog

All notable changes to this project will be documented in this file.

The format is based on Keep a Changelog and this project adheres to Semantic Versioning.

[11.2.0] - 2026-02-19

Added

• RFC 6839 support: Content types with +json suffix (e.g., application/vnd.api+json, application/hal+json, application/problem+json) are now recognized as JSON-based formats

[11.1.3] - 2025.12.08

Fixed

• Fixed content type construction parameter generation - issue #128, fixed
  • with multiple content type values
  • with content type value received from parameters

[11.1.2] - 2025.10.28

Fixed

• Enum with invalid PHP constant value
• README.md with multiline description in operations

[11.1.1] - 2025.09.23

Fixed

• Acessing nullable enum with ?->value instead of ->value?->value

[11.1.0] - 2025.07.08

Added

• Support for array of enum elements in Schemas

[11.0.0] - 2025.04.21

Added

• Support for OpenAPI 3.1

Changed

• cebe/php-openapi dependency to devizzent/cebe-php-openapi

[10.10.1] - 2025.02.19

Fixed

• avoid having & in request body when using application/x-www-form-urlencoded

[10.10.0] - 2025.02.12

Added

• Specification::getVersion() method, which optionally might be used in a composer.json.twig "version": "{{ specification.getVersion() }}"

[10.9.1] - 2024.12.29

Fixed

• Array to string conversion in maxItems in minItems constraints

[10.9.0] - 2024.08.16

Added

• INCLUDE_TAGS and EXCLUDE_TAGS to whitelist/blacklist client generation based on operation tags

[10.8.1] - 2024.06.04

Fixed

• Enums for path parameters

[10.8.0] - 2024.05.17

Added

• Readonly properties (php 8.1)
• Enums (php 8.1)

[10.7.1] - 2024.05.07

Fixed

• Missing DateTimeInterface import for php 8.1+

[10.7.0] - 2024.02.15

Added

• Added support for php 8.1, 8.2, 8.3 constraints

[10.6.1] - 2024.02.10

Fixed

• operationId containing dashes is converted to camel case

[10.6.0] - 2024.01.10

Added

• Api key authentication strategy added
• X-WSSE authentication strategy added

[10.5.0] - 2023.12.22

Added

• oneOf schema support

[10.4.0] - 2023.12.13

Added

• Added generated code support for php 8.0

Changed

• php-cs-fixer rules not_operator_with_successor_space, phpdoc_to_comment, native_function_invocation

[10.3.0] - 2023.12.08

Added

• Added support for multiple responses

[10.2.0] - 2023.10.17

Added

• Added support for PHP 8

[10.1.5] - 2023.09.15

Fixed

• Added missing null check for optional nullable object mapping

[10.1.4] - 2023.08.25

Fixed

• Avoid new DateTimeImmutable(null) - adding support for nullable optional datetime

[10.1.3] - 2023.08.23

Fixed

• OpenAPI spec copied forcefully to destination directory

[10.1.2] - 2023.08.10

Added

• support for guzzlehttp/psr7 version 2.0 to generated composer.json

[10.1.1] - 2023.07.13

Fixed

• null verification for nullable properties before validating constraints

[10.1.0] - 2023.03.21

Added

• support for optional nullable scheme properties

[10.0.1] - 2023.01.10

Added

• docler-labs/api-client-exception v2 to generated composer.json

[10.0.0] - 2022.06.27

Changed

• Generator now fails if field in spec is nullable and optional (unsupported feature)

[9.2.0] - 2022.06.06

Added

• Nullable is now supported with allOf

[9.1.1] - 2022.05.09

Fixed

• Return type for ::toSchema cannot be nullable

[9.1.0] - 2022.05.05

Added

• Added support for non string enums (no constant for enum value is generated in this case)

[9.0.0] - 2022.02.24

Changed

• API Client Generation triggers a full regeneration of src folder.

[8.1.0] - 2021-12-15

Added

• Basic Authentication strategy added

[8.0.0] - 2021-11-19

Added

• Bearer Authentication strategy added

[7.2.3] - 2021-11-03

Fixed

• Request parameters with same name but different $ref should not override each other

[7.2.2] - 2021-10-15

Fixed

• ext- in generated clients composer.json is added according to what is actually being used

[7.2.1] - 2021-10-07

Fixed

• Changed default php-cs-fixer configuration to remove blank lines after class opening, according to PSR12 (no_blank_lines_after_class_opening)

[7.2.0] - 2021-09-24

Removed

• Remove virtual package dependency (psr/http-client-implementation)

[7.1.1] - 2021-09-09

Fixed

• Changed default php-cs-fixer configuration to add blank line after opening tag, according to PSR12 (blank_line_after_opening_tag)

[7.1.0] - 2021-08-30

Added

• Support for free-form object in response

[7.0.1] - 2021-08-29

Fixed

• Added ext-intl to composer.json. It was missing since 7.0.0.

[7.0.0] - 2021-08-27

Fixed

• Using grapheme_strlen to properly count string lengths.

[6.0.2] - 2021-08-12

Fixed

• The array of serializers in BodySerializer depends on both requests and responses content type

[6.0.1] - 2021-07-27

Fixed

• Fix preg_match pattern by adding a slash (/) as a delimiter.

[6.0.0] - 2021-06-22

Changed

• enum type are not anymore validated from generated client side.

[5.7.1] - 2021-05-31

Fixed

• nullable: true for mandatory $ref was not checking for null before trying to map

[5.7.0] - 2021-05-28

Added

• Support for application/vnd.api+json MIME type.

[5.6.1] - 2021-05-25

Fixed

• Minimum and Maximum constraints work for floats

[5.6.0] - 2021-05-10

Added

• Api Client Generator version to README generation

[5.5.0] - 2021-04-27

Added

• Support for default property on required request parameters.

[5.4.0] - 2021-04-22

Added

• Support for license info. Use it in the default composer.json tpl.

[5.3.0] - 2021-04-13

Added

• Support for mixed parameter type
• Support for anyOf mixed parameter type

Fixed

• mixed arrays rendered incorrectly
• Wrong typehint in case of nullable arrays

[5.2.0] - 2021-04-06

Added

• Support for minimum, maximum, exclusiveMinimum, exclusiveMaximum, minItems, maxItems, pattern, maxLength, minLength validations

Changed

• Example generated with 7.4

[5.1.0] - 2021-04-02

Changed

• Only content type serializers which are used are included

[5.0.0] - 2021-02-15

Changed

• By default, the PHP version used in the generated client is 7.4.

[4.2.0] - 2021-01-24

• Acceptance test to generate example from canonical pet store OpenApi specification
• Content-type argument if multiple specified for request

Fixed

• Literal type JSON response body

Changed

• Multiple content-type per request and response with the same schema allowed
• Changed non-existing successful response error to a warning

[4.1.0] - 2020-12-28

Fixed

• Nullable mandatory DateTime properties in schema now work correctly without doing new DateTimeImmutable(null)
• Proper nullable typehint and default value in properties for 7.4 schemas to avoid non initialized errors

Changed

• Changed default php-cs-fixer configuration to remove superfluous docblocks, to improve generated code readability

Added

• Makefile with standard routines to easy development / contribution (run tests, analyse code, fix code style)

[4.0.0] - 2020-11-26

Changed

• Guzzle 6/7 dependency removed altogether in favor of PSR-18 interfaces for Http Client
• Breaking change! *ClientFactory does not accept URI and Guzzle configuration anymore, but rather PSR-18 implementation
• Guzzle 6/7 CookieJar dependency removed in favor of simplified CookieJar class

[3.2.1] - 2020-11-24

Fixed

• DateTimeInterface serialization in QuerySerializer

[3.2.0] - 2020-11-10

Added

• Query parameters which implement JsonSerializable will be converted accordingly.

[3.1.0] - 2020-11-05

Fixed

• Fix collections toArray docblock

Added

• Schemas implement JsonSerializable to be easily encoded with native json_encode

[3.0.6] - 2020-10-22

Fixed

• Fix/improve Progress Bar output

[3.0.5] - 2020-10-16

Fixed

• Collection methods use property items directly, without calling toArray

[3.0.4] - 2020-10-16

Fixed

• Fix Content-type header handling.

[3.0.3] - 2020-10-15

Fixed

• Serialize items from collection manually, since json_encode won't call toArray automatically as it used to do with jsonSerialize

[3.0.2] - 2020-10-08

Fixed

• Send RequestInterface instance to Guzzle instead of ServerRequestInterface

[3.0.1] - 2020-10-08

Fixed

• Request object is immutable so must be assigned back when using with methods

[3.0.0] - 2020-09-29

Added

• Progress bar added
• PHP version dependant syntax resolution
• PHP version 7.2, 7.3 support
• Service provider generator added
• Content-type property added to the Request
• Request mapper generator added
• Specification file is copied to the client directory

Changed

• Breaking change! getResponse request renamed to sendRequest and return PSR7 ResponseInterface instead of DoclerLabs\ApiClientBase\Response\Response
• Most of the static code copied to the client instead of depending on docler-labs/api-client-base
• Headers removed from default Guzzle config
• Http client implementation abstracted behind PSR-17 interface
• Http message implementation abstracted behind PSR-7 interface
• Container implementation abstracted behind PSR-11 interface
• Source directory name is configurable
• Json and form-encoded serializers instead of built-in json
• SerializableInterface added
• ResponseMapper renamed to SchemaMapper
• Client dependencies initialization moved to service provider
• OperationId is no longer mandatory

Fixed

• CS Fixer fails on invalid generated PHP file
• Nullable fields schema mapper fix
• Naming collisions in embedded objects handled

[2.0.0] - 2020-08-31

Changed

• docler-labs/api-client-base updated to 3.0.0

Removed

• Response 'data' key handling from Response.

[1.2.0] - 2020-07-30

Changed

• docler-labs/api-client-base updated to 2.0.0

Added

• The getResponse method exposed in the generated Client class. Could be used to retrieve response headers.

[1.1.0] - 2020-07-21

Added

• README.md meta template

Changed

• Any number of allOf schemas allowed
• allOf schemas joined to one schema without inheritance
• Response mapper invocation reused in the client factory

Fixed

• Empty object handling

[1.0.1] - 2020-07-16

Fixed

• Fix for date and date-time fields parsing

[1.0.0] - 2020-07-09

Added

• Initial API client generator release