Changelog / PHP

This changelog is filtered to show only changes for PHP. Go back to full changelog.

Oct 23, 2017

Xml Schema Support Improved, Missing Features Added

We have recently revamped our support for XML schema. This includes bug fixes (array types and optional properties were not catered in some cases, issues with circular references, etc.) and addition of missing features (Union of simple types, redefinition of schema types, etc.).


Jul 12, 2017

OAuth 2.0 Authorization Support Added

Our API editor and Code Generation engine now supports OAuth 2.0 for authentication in the generated SDKs.

OAuth 2 enabled SDKs will help developers in:

  • Obtaining consent from user
  • Acquiring access token
  • Refreshing tokens when they expire
  • Making authorized API calls

You can read more about OAuth 2.0 in APIMatic editor and Code Generation engine here.


Jul 12, 2017

Setting Composer Package Name

You can now set Composer Package Name for PHP SDKs being generated.

This will affect the name generated in the composer.json file. Leaving it empty will generate the a fallback package name based on your API name.


Apr 7, 2017

Polymorphic Responses with Discriminator Field

APIMatic Code Generation engine now supports polymorphic responses with the help of a discriminator field.

  • Discriminator is a field that is used to differentiate between a parent model and models that inherit from it.
  • The response is deserialized into the parent model or one of its child classes by inspecting the discriminator field’s value in the response.
  • Using a discriminator field, you can build leaner models by not having to build unions of fields needed by a polymorphic response.

Check out the Discriminator documentation to get started.


Mar 28, 2017

Optional Model Field Deserialization Issue

There was an issue in code generation for PHP SDKs where the model classes (custom types) had fields with incorrect PHP typehints. This lead to the JsonMapper mapping responses incorrectly to models during deserialization. However, this only occurred when a model had fields that were described as optional in the API description and no default value was provided.

Re-generate your PHP SDK to get the fix.


Jan 24, 2017

PHP SDKs Are Now PSR-2 Compliant

APIMATIC’s PHP SDKs are now compliant with the PSR-2 Coding Style Guide

  • PSR-2 compliance means that the PHP code generated is guaranteed to be of high-quality.
  • PHP SDKs are written in a industry-standard code style to allow for maximum interoperability.
  • PHP SDKs can be tested for code style violation using the PHP Code Sniffer.

Re-generate your PHP SDKs now for the new changes.


Jan 5, 2017

Error Model Deserialization Issue Fixed

A bug in PHP SDKs being generated lead to custom Error Exception Models not being deserialized properly from the response when an API error occurred. This was caused by an error in the unbox() function in the custom Exception class. It has now been fixed.

If you were using custom Error Exceptions, then please re-generate your PHP SDKs to get the fix.


Jan 3, 2017

_httpContext Undefined Issue Resolved

A logical error in the PHP SDKs being generated lead to a variable, _httpContext, being undefined in some cases. This resulted in a Fatal error when an APIException was expected to be thrown.

Please regenerate your PHP SDK to get the bug fix.


Jan 3, 2017

Multiple Base URLs Now Supported

You can now use multiple base URLs in your API description using the new Server Configuration. This feature allows you to

  • Vary the Base URL between endpoints.
  • Create multiple Environments and define different Base URLs for them.
  • Templatize Base URL to allow for configuration using parameters in the client.