Yii 1.1, Yii 2, and Yii3 have separate release cycles and maintenance policies.
Yii3
Yii3 consists of many packages. Each package is versioned using SemVer independently.
-
Major version
- Released at most once per year.
- May introduce backward incompatible changes (BC breaks).
- Removes previously deprecated code.
- Upgrade path is documented in
UPGRADE.md.
-
Minor version
- Released when a set of features or enhancements is ready.
- May introduce new functionality and deprecate existing APIs, but does not remove them.
- Safe to upgrade within the same major version.
- May adjust requirements, including the minimum or maximum supported PHP version.
-
Patch version
- Released for bug fixes, documentation improvements, or internal refactorings.
- Does not change platform requirements (for example, PHP version constraints remain the same).
- Does not introduce new features or remove existing ones.
- Safe to upgrade.
Yii 2
Yii 2 consists of the core framework and official extensions, each versioned independently.
- Major version is receiving enhancements until it is decided to start working on next major version.
- Previous major version may receive security fixes.
Yii 1.1
Yii 1.1 is in maintenance mode. It only receives updates for:
- Support for newer PHP versions where feasible.
- Security fixes.
- Critical bug fixes that do not require breaking changes.
PHP versions support
We run automated tests using PHPUnit. If a newer PHPUnit version drops support for an old PHP version, we may remove it from our test matrix.
End-of-life PHP versions may be dropped in the next minor release. We recommend using a currently supported PHP version.
Current versions
Legend
| Active support. New features, enhancements, bug fixes, security fixes. | ||
| Feature freeze. Bug fixes, security fixes, and critical compatibility fixes only. | ||
| Mainly security and PHP compatibility fixes. | ||
| Future version. |
Pale color means forecast in case next major version is released today.
Details
| Version | PHP Version | Release (active support) | Feature freeze | Security and PHP compatibility fixes only | End of life |
|---|---|---|---|---|---|
| Yii3 | >= 8.2 | 2025-12-31 | 2030-12-31 | 2032-12-31 | 2035-12-31 |
| 2.2.x ¹ | >= 8.1 | To be announced | To be announced | Next release +2 years | Next release +5 years |
| >= 2.0.50 | >= 7.3, <= 8.4 | 2024-05-30 | 2024-05-30 | 2026-11-23 | 2027-11-23 |
| <= 2.0.49 | >= 5.4, <= 8.3 | 2014-10-12 | 2023-08-29 | 2023-10-31 | 2026-11-23 |
| 1.1 | >= 5.1 | 2010-01-10 | 2015-11-22 | 2017-01-01 | 2026-12-31 |