Yii 1.1, Yii 2, and Yii3 are separate projects with their own separate release cycles and maintenance policies.
Yii3
Yii3 consists of many packages. Each package is versioned using Semantic Versioning (SemVer) independently of the others and has its own release cycle.
-
Major version
- Released at most once per year.
- May introduce backward incompatible changes (BC breaks).
- Removes code that was previously deprecated in minor releases.
- A documented upgrade path is provided in the package
UPGRADE.mdfile.
-
Minor version
- Released when a set of features or enhancements is ready.
- May introduce new functionality and may mark existing APIs as deprecated, but does not remove them.
- Backwards compatibility is preserved.
- It is safe to upgrade within the same major version.
- May adjust requirements, including the minimum or maximum supported PHP version.
-
The supported PHP version range is stated explicitly in
composer.jsonand is extended only after compatibility has been verified.
-
Patch version
- Released when bug fixes, documentation improvements, or internal refactorings are ready.
- May fix bugs and security issues.
- Does not change platform requirements (for example, PHP version constraints remain the same).
- Does not introduce new public features or remove existing ones.
- It is safe to upgrade.
Yii 2
Yii 2 consists of the core framework and a set of official extensions. The framework and each official extension are 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
To ensure the framework works correctly across supported PHP versions, we run automated tests using PHPUnit. If a newer version of PHPUnit no longer supports an old PHP version, we may remove that PHP version from our test matrix.
This does not immediately mean Yii will stop working on that PHP version, but the lack of automated testing significantly increases the risk of regressions. Over time, new releases may no longer be compatible.
We generally do not support PHP versions that have reached their end of life. When a PHP version becomes unsupported upstream, it may be removed from our supported range in the next minor release of a package.
Therefore, we recommend using a currently supported version of PHP.
Current versions
Legend
| Active support. New features, enhancements, bug fixes, security fixes are accepted. | ||
| Feature freeze. New features are no longer accepted; only bug fixes, security fixes, and critical compatibility fixes are. | ||
| 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 |