Skip to content

7.8.0

Latest

Choose a tag to compare

@DerManoMann DerManoMann released this 18 Nov 02:33
503f9d1

7.8 brings all the OpenAPI 3.2 support to the spec attributes. A 3.2 document can use every field and value the version adds. 3.0 and 3.1 write a field in its older form where there is one, and leave it out with a warning where there is not.

Added

  • Spec: the plain 3.2 fields - self on the document, a server name, a response summary, an example's dataValue and serializedValue, a discriminator's defaultMapping, and deprecated and oauth2MetadataUrl on a security scheme (#2149)
  • Spec: the device authorization flow, and the cookie parameter style (#2408)
  • Spec: itemSchema on a media type, and encodings by position with prefixEncoding and itemEncoding (#2412)
  • Spec: the querystring parameter location, with OA\Parameter\Querystring (#2414)
  • Spec: OA\Operation\Query for the query method (#2416)
  • Spec: any HTTP method on an operation, written to additionalOperations (#2417)
  • Spec: the XML nodeType, written as attribute or wrapped before 3.2 where they say the same (#2418). A schema can take the node type alone, as xml: OA\XmlNodeType::Cdata (#2419)

Changed output

  • Spec: a 3.2 document writes an inline response's summary. Before, it was left out with a warning (#2149)
  • Spec: a 3.2 document writes an operation with a method such as COPY to additionalOperations. Before, it was left out with a warning (#2417)
  • Spec and hybrid: 3.0 and 3.1 leave out style: cookie with a warning. Before, it was written, and the document was invalid (#2408)

What's Changed

  • chore(deps-dev): update friendsofphp/php-cs-fixer requirement from 3.95.29 to 3.95.30 by @dependabot[bot] in #2411
  • chore(deps-dev): bump @redocly/cli from 2.76.0 to 2.78.0 in the npm group across 1 directory by @dependabot[bot] in #2409
  • chore(Tests): type the expected match in testMatchNested by @DerManoMann in #2413
  • chore(deps-dev): update rector/rector requirement from 2.8.3 to 2.8.4 by @dependabot[bot] in #2410
  • feat(Spec): add plain OpenAPI 3.2 fields by @DerManoMann in #2149
  • feat(Spec): add the OpenAPI 3.2 device authorization flow and cookie style by @DerManoMann in #2408
  • feat(Spec): add the OpenAPI 3.2 media type items and positional encodings by @DerManoMann in #2412
  • docs(Contributing): fix the PSR-5 draft link by @farisbasha in #2415
  • feat(Spec): add the OpenAPI 3.2 querystring parameter location by @DerManoMann in #2414
  • feat(Spec): add the OpenAPI 3.2 query operation by @DerManoMann in #2416
  • feat(Spec): write OpenAPI 3.2 additionalOperations by @DerManoMann in #2417
  • feat(Spec): add the OpenAPI 3.2 XML node type by @DerManoMann in #2418
  • feat(Spec): take an XML node type as a schema's xml by @DerManoMann in #2419

New Contributors

Full Changelog: 7.7.0...7.8.0