quillphp/versioning

API Versioning middleware for the Quill PHP framework

dev-main 2026-04-06 09:38 UTC

Requires

• php: ^8.3
• quillphp/quill: ^0.0.2

Requires (Dev)

• phpunit/phpunit: ^11.0

MIT

README

API Versioning middleware for the Quill PHP Framework.

Installation

composer require quillphp/versioning

Usage

use Quill\Versioning\Versioning;

$app->use(Versioning::new([
    'header' => 'X-API-Version',
    'default' => 'v1',
]));

With this middleware, a request to GET /users with the header X-API-Version: 1 will be internally rewritten to GET /v1/users for the router to match.

Configuration

Option	Default	Description
`header`	`'X-API-Version'`	The HTTP header containing the version.
`query`	`'v'`	The URL query parameter containing the version.
`prefix`	`'v'`	The prefix for the router path (e.g. `v` + `1` = `/v1/...`).
`default`	`null`	Optional: Default version to use if none is provided.

License

MIT