PHPackages                             radebatz/openapi-extras - PHPackages - PHPackages  [Skip to content](#main-content)[PHPackages](/)[Directory](/)[Categories](/categories)[Trending](/trending)[Leaderboard](/leaderboard)[Changelog](/changelog)[Analyze](/analyze)[Collections](/collections)[Log in](/login)[Sign up](/register)

1. [Directory](/)
2. /
3. [API Development](/categories/api)
4. /
5. radebatz/openapi-extras

ActiveLibrary[API Development](/categories/api)

radebatz/openapi-extras
=======================

Extra annotations for OpenApi/swagger-php.

4.0.0(3mo ago)313.4k—6.3%1MITPHPPHP >=8.1CI passing

Since Dec 22Pushed 2mo ago1 watchersCompare

[ Source](https://github.com/DerManoMann/openapi-extras)[ Packagist](https://packagist.org/packages/radebatz/openapi-extras)[ Docs](http://radebatz.net/mano/)[ RSS](/packages/radebatz-openapi-extras/feed)WikiDiscussions main Synced 1mo ago

READMEChangelog (9)Dependencies (10)Versions (12)Used By (1)

openapi-extras
==============

[](#openapi-extras)

[![Build Status](https://github.com/DerManoMann/openapi-extras/workflows/build/badge.svg)](https://github.com/DerManoMann/openapi-extras/actions)[![Coverage Status](https://camo.githubusercontent.com/405cda4c675e1766df791e238de9451cba904e56ff685b44c553b7b91bf6172a/68747470733a2f2f636f766572616c6c732e696f2f7265706f732f6769746875622f4465724d616e6f4d616e6e2f6f70656e6170692d6578747261732f62616467652e737667)](https://coveralls.io/github/DerManoMann/openapi-extras)[![License: MIT](https://camo.githubusercontent.com/fdf2982b9f5d7489dcf44570e714e3a15fce6253e0cc6b5aa61a075aac2ff71b/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f4c6963656e73652d4d49542d79656c6c6f772e737667)](https://opensource.org/licenses/MIT)

Introduction
------------

[](#introduction)

Extra attributes/annotations and other bits for [swagger-php](https://github.com/zircote/swagger-php).

Installation
------------

[](#installation)

You can use **composer** or simply **download the release**.

**Composer**

The preferred method is via [composer](https://getcomposer.org). Follow the [installation instructions](https://getcomposer.org/doc/00-intro.md) if you do not already have composer installed.

Once composer is installed, execute the following command in your project root to install this library:

```
composer require radebatz/openapi-extras
```

Registering the library
-----------------------

[](#registering-the-library)

Use of the included annotations/attributes requires registration of a custom `swagger-php` processor. Also, in the case of annotations, the registration of custom aliases / namespaces needs to be done manually.

### Using the Builder

[](#using-the-builder)

When using the `OpenApiBuilder` no additional registration code is required as the builder will always configure the required `MergeControllerDefaults` processor.

```