Compatibility matrix
This page mirrors the dependency contract declared by the current vavang/invoice-plugin package. The package repository remains authoritative when a new release changes constraints.
Current package constraints
| Component | Composer constraint | Release validation |
|---|---|---|
| PHP | ^8.2 |
CI currently exercises PHP 8.2 and 8.3 |
| Sylius | `~2.1.0 | |
| Sylius InvoicingPlugin | `~2.1.0 | |
| Doctrine ORM | `^2.14 | |
| Symfony components used directly | `^6.4 |
The PHP Composer constraint accepts compatible PHP 8.x versions from 8.2 upward. The current release CI, however, explicitly validates 8.2 and 8.3. Do not present an untested PHP/Sylius combination as release-validated merely because Composer can resolve it.
Supported host combinations
The current declared Sylius support is intentionally narrow:
- Sylius 2.1 + compatible Sylius InvoicingPlugin 2.1;
- Sylius 2.2 + compatible Sylius InvoicingPlugin 2.2.
A future Sylius minor/major is not supported until the package constraint, CI matrix, clean-install gate and documentation are updated together.
Before upgrading the host application
Before changing PHP, Sylius or InvoicingPlugin:
- check the target Vavang Invoice release
composer.json; - check its changelog compatibility section;
- ensure the target combination is exercised by release CI/clean-install validation;
- run Composer resolution in a branch without forcing ignored platform requirements;
- run the host application's tests plus Vavang Invoice requirement/compliance diagnostics.
Do not use --ignore-platform-reqs to manufacture a combination outside the published compatibility contract.
Compatibility changes
The supported-version matrix is part of the release contract. Widening or narrowing it requires a documented changelog compatibility change and CI coverage before publication.