v4.23.0

Changelog

• Cache configuration option nelmio_api_doc.cache.item_id now automatically gets the area appended.

  nelmio_api_doc:
      cache:
          pool: app.cache
          item_id: nelmio_api_doc.docs
      areas:
          default: 
              ...
          area1:   
              ...

  Result in cache keys: nelmio_api_doc.docs.default & nelmio_api_doc.docs.area1 to be used respectively.
• Added cache configuration option per area.

  nelmio_api_doc:
      areas:
          default: # Manual cache configuration
              cache:
                  pool: app.cache
                  item_id: nelmio_api_doc.docs.default
              ...
          area1:   
              cache:
                  pool: app.cache
                  item_id: nelmio_api_doc.docs.area1
              ...

  Non-configured options will be inherited from nelmio_api_doc.cache.
• Fixed vendor extensions (x-*) from configuration not being outputted in the generated specification.

  nelmio_api_doc:
      documentation:
          info:
              title: 'My API'
              description: 'My API description'
              x-foo: 'bar'

  Now results in JSON specification:

  {
    ...
    "info": {
      "title": "API",
      "version": "1.0",
      "x-foo": "bar"
    },
    ...
  }

• Updated nullable enum handling to align with the behaviour of other object types. It now uses wraps nullable enums with oneOf instead of allOf.

What's Changed

• fix: invalid nullable enums with OAS 3.1 version by @bnowak in #2226
• Fix for using cache pools with multiple areas by @Brajk19 in #2232
• fix-2224: fix vendor extension being ignored by @DjordyKoert in #2230
• Prepare 4.23.0 by @DjordyKoert in #2238

New Contributors

• @bnowak made their first contribution in #2226

Full Changelog: v4.22.1...v4.23.0

v4.22.1

What's Changed

• update .gitattributes for new directory structure by @DjordyKoert in #2229

Full Changelog: v4.22.0...v4.22.1

v4.22.0

Changelog

• Updated bundle directory structure to recommended file structure as described in https://symfony.com/doc/7.0/bundles/best_practices.html.

  It might be necessary to reinstall the assets:

    bin/console assets:install

What's Changed

• Update bundle directory structure by @DjordyKoert in #2228

Full Changelog: v4.21.0...v4.22.0

v4.21.0

Changelog

• Added bundle configuration options cache.pool and cache.item_id.

What's Changed

• Allow cache_pool option in configuration by @Brajk19 in #2225

New Contributors

• @Brajk19 made their first contribution in #2225

Full Changelog: v4.20.0...v4.21.0

v4.20.0

Changelog

• Added Redocly as an alternative to Swagger UI. https://github.com/Redocly/redoc.
• Added support for describing dictionary types in OpenAPI 3.0.

What's Changed

• Add support for redocly by @Gabb1995 in #2066
• feat-2207: Implement property describer for dictionary by @DjordyKoert in #2208

New Contributors

• @Gabb1995 made their first contribution in #2066

Full Changelog: v4.19.3...v4.20.0

v4.19.3

What's Changed

• fix-2209: Multiple @OA\MediaType() warning with MapRequestPayload by @DjordyKoert in #2213

Full Changelog: v4.19.2...v4.19.3

v4.19.2

What's Changed

• fix: move to processor to correct dir by @DjordyKoert in #2204
• Fix incorrect url by @DjordyKoert in #2205
• Remove reference to nelm.io domain by @DjordyKoert in #2206

Full Changelog: v4.19.1...v4.19.2

v4.19.1

What's Changed

• fix-2202: Correctly describe array parameter by @DjordyKoert in #2203

Full Changelog: v4.19.0...v4.19.1

v4.19.0

What's Changed

• Support CSRF protection token of Symfony's form component by @stollr in #2132

New Contributors

• @stollr made their first contribution in #2132

Full Changelog: v4.18.3...v4.19.0

v4.18.3

What's Changed

• use hash to determine unique types by @DjordyKoert in #2201

Full Changelog: v4.18.2...v4.18.3