Versioning and Upgrades
Kipchak Versions
Versions and Versioning in Kipchak
Current Version
Kipchak's current version is 3.x.
3.x is a major release that adds support for PHP 8.5 while retaining PHP 8.4 compatibility. It upgrades two bundled core dependencies to new major versions — CuyZ Valinor 2.x (object mapping) and Zircote Swagger PHP 6.x (OpenAPI generation).
This means you can, in principle, upgrade from 3.0 to 3.1 or 3.20 without any code changes.
Versioning Strategy
Kipchak follows a versioning strategy similar to Kubernetes. This means we do not follow semantic versioning but simply increase the minor version on the current version if there are no breaking changes.
Breaking changes simply increment the major version.
Previous Versions
Kipchak has had 3 previous versions since its inception in 2022.
- 2.x - which was released December 2025. It introduced the modular structure with separate Driver and Middleware packages, along with interfaces for writing them.
- 1.x - which was released November 2025. It broke compatibility with 0.x due to an upgrade to Doctrine 4.x which baked into the core repository.
- 0.x - which was released in 2022.
See the Upgrade Guide for how to upgrade from previous versions.
Git repositories
Kipchak repositories were moved from GitHub to https://1x.ax in early 2025 due to Microsoft's involvement in the crimes of Israel.
Repositories were subsequently renamed and moved away from the Mamluk namespace in December 2025 to accommodate the modular structure version 2.x.
All code is now available at: