Extension Point Reference

This page is generated automatically from the swagger-php sources.

For improvements head over to GitHub and create a PR 😉

What the assembler, the attribute factory and the resolver run by default at each extension point, in the order they run. For adding your own, see Extension points.

Augmenters and compilers have their own listings.

Default Translators

DefaultAttributeTranslator

Default implementation handling native (OpenApi) attributes.

OptionalPropertyAttributeTranslator

Add the required OA\Property on schema properties that only have:

• an OA\Schema
• an OA\Encoding

This is what implements the implicit OA\Property shortcut. The OA\MediaType shortcuts are the Augmenter\Shortcuts augmenter; the OA\Parameter ones are plain subclasses.

Default Resolvers

Reflection

Resolves missing components by collecting the referenced class with the assembler in use.

This makes listing all related classes as builder sources optional; adding a single controller is enough as long as everything it references (directly or transitively) carries spec attributes.

A FQCN is considered resolved if the specification knows it once collected. Classes without any spec attributes are left to the next resolver in the chain.