v2.1.1

SwaggerBake v2.1.1 is now available! See the changelog for every commit.

Fixes

• Fix association bug #370

v2.1.0

SwaggerBake v2.1.0 is now available! See the changelog for every commit.

Features / Changes

• Support @link for external documentation #353
• Improve custom exceptions #358
• Remove vendor read/write schemas #359
• Support depth > 1 for OpenApiResponse associated schema #365

v2.0.4

SwaggerBake v2.0.4 is now available! See the changelog for every commit.

Fixes

• OpenApiResponse association permanently modifies the Schema #363

v2.0.3

SwaggerBake v2.0.3 is now available! See the changelog for every commit.

Fixes

• PHP 8.1 JsonSerializable::jsonSerialize() Deprecated warnings #356

v2.0.2

SwaggerBake v2.0.2 is now available! See the changelog for every commit.

Features

• Allow changing default success schema #351

Fixes

• Fixes warning message when v1 annotations are detected.
• Allow a blank string for SchemaProperty::example. When null, the example property will be stripped from the JSON encoded OpenAPI schema.

v2.0.1

SwaggerBake v2.0.1 is now available! See the changelog for every commit.

Fixes

• Examples are defaulting to a string of "null" #346

v1.7.6

SwaggerBake v1.7.6 is now available! See the changelog for every commit.

Fixes

• Prefix routing bug #330

Misc

• Add cakephp 4.0 - 4.3 compatibility to github actions #339

v2.0.0

SwaggerBake v2.0.0 is now available! See the changelog for every commit.

PHP version 8.0 or higher and CakePHP 4.2 or higher is now required.

Features / Changes

• Adds support for PHP 8 Attributes. Read the attribute documentation for more. #268
• Improved support for showing associated data using OpenApiResponse::associations #289
• Improve schema visibility options #331
• application/json is now the default request/response mime type.
• OpenAPI Operations are now ordered based on method ordering in Controllers. To override this use OpenApiOperation::sortOrder #338
• Added new SwaggerBake.Path.created event
• Upgrade swagger to 4.0.1 #337
• Upgrade redocly to 2.0.0-rc.56 #337

Removes

• Drop support for isPut in OpenApiOperation and replace with config/swagger_bake.php option #334
• All Annotations have been removed. Using v1 annotations in v2 will generate a PHP warning, for example:

Warning (512): Use SwaggerBake\Lib\Attribute\OpenApiSchema instead of SwaggerBake\Lib\Annotation\SwagEntity in App\Model\Entity\Country

• Note: Usage of SwagSearch which will throw an exception (use OpenApiSearch)
• Note: Usage of SwagDtoQuery and SwagDtoRequestBody will not provide a warning or exception, use OpenApiDtoQuery and OpenApiDtoRequestBody respectively.

Fixes

• Fix prefix routing bug #329
• When mapping controllers to models, the controllers loaded model is now checked as a fallback to cakephp naming conventions #328

v1.7.5

SwaggerBake v1.7.5 is now available. See the changelog for every commit.

This is a maintenance release to resolve a regression from the previous release, see #287.

v1.7.4

SwaggerBake v1.7.4 is now available. See the changelog for every commit.

Features

XML, JSON-LD, and HAL+JSON schema examples for non-CRUD endpoints #277

Misc

Increased code coverage to 93% (+7%) #283, #285, & #286