Yii 2 is a modern framework designed to be a solid foundation for your PHP application. It is fast, secure and efficient and works right out of the box pre-configured with reasonable defaults. The framework is easy to adjust to meet your needs, because Yii has been designed to be flexible. [](https://packagist.org/packages/yiisoft/yii2) [](https://packagist.org/packages/yiisoft/yii2) [](https://github.com/yiisoft/yii2/actions) [](https://codecov.io/gh/yiisoft/yii2) [](https://scrutinizer-ci.com/g/yiisoft/yii2/) Installation ------------ - The minimum required PHP version of Yii is PHP 7.3. - It works best with PHP 8. - [Follow the Definitive Guide](https://www.yiiframework.com/doc-2.0/guide-start-installation.html) in order to get step by step instructions. Documentation ------------- - A [Definitive Guide](https://www.yiiframework.com/doc/guide/2.0) and a [Class Reference](https://www.yiiframework.com/doc/api/2.0) cover every detail of the framework. - There is a [PDF version](https://www.yiiframework.com/doc/download/yii-guide-2.0-en.pdf) of the Definitive Guide and a [Definitive Guide Mirror](http://stuff.cebe.cc/yii2docs/) which is updated every 15 minutes. - For Yii 1.1 users, there is [Upgrading from Yii 1.1](https://www.yiiframework.com/doc/guide/2.0/en/intro-upgrade-from-v1) to get an idea of what has changed in 2.0. Versions & PHP compatibility ---------------------------- | Yii2 Version | PHP version | Development status | EOL ¹ | |--------------|----------------|-----------------------------------|----------------------------------------------------------------| | <= 2.0.49.* | >= 5.4, <= 8.3 | security fixes only | 23 Nov 2026 ³ | | >= 2.0.50 | >= 7.3, <= 8.4 | bug fixes and security fixes only | bugfixes till 23 Nov 2026 ³, security fixes till 21 Nov 2027 ⁴ | | >= 2.2.0 ² | >= 8.1 | active development | | ¹ All mentioned dates may be subject to change and no rights can be derived from them. ² Note: Yii 2.1 was [skipped](https://github.com/yiisoft/yii2/discussions/19831#discussioncomment-5858046), [Yii 2.2](https://github.com/yiisoft/yii2/tree/2.2) has not yet been released. ³ [PHP 8.3 EOL date](https://www.php.net/supported-versions.php). ⁴ [Expected PHP 8.4 EOL date](https://wiki.php.net/todo/php84). Community --------- - Participate in [discussions at forums](https://www.yiiframework.com/forum/). - [Community Slack](https://join.slack.com/t/yii/shared_invite/MjIxMjMxMTk5MTU1LTE1MDE3MDAwMzMtM2VkMTMyMjY1Ng) and [Chat in IRC](https://www.yiiframework.com/chat/). - Follow us on [Facebook](https://www.facebook.com/groups/yiitalk/), [Twitter](https://twitter.com/yiiframework) and [GitHub](https://github.com/yiisoft/yii2). - Check [other communities](https://github.com/yiisoft/yii2/wiki/communities). Contributing ------------ The framework is [Open Source](LICENSE.md) powered by [an excellent community](https://github.com/yiisoft/yii2/graphs/contributors). You may join us and: - [Report an issue](docs/internals/report-an-issue.md) - [Translate documentation or messages](docs/internals/translation-workflow.md) - [Give us feedback or start a design discussion](https://www.yiiframework.com/forum/index.php/forum/42-general-discussions-for-yii-20/) - [Contribute to the core code or fix bugs](docs/internals/git-workflow.md) - [Become a sponsor](#sponsoring) ### Reporting Security issues Please refer to a [special page at the website](https://www.yiiframework.com/security/) describing proper workflow for security issue reports. ### Directory Structure ``` build/ internally used build tools docs/ documentation framework/ core framework code tests/ tests of the core framework code ``` ### Spreading the Word Acknowledging or citing Yii 2 is as important as direct contributions. **In presentations** If you are giving a presentation or talk featuring work that makes use of Yii 2 and would like to acknowledge it, we suggest using [our logo](https://www.yiiframework.com/logo/) on your title slide. **In projects** If you are using Yii 2 as part of an OpenSource project, a way to acknowledge it is to [use a special badge](https://img.shields.io/badge/Powered_by-Yii_Framework-green.svg?style=flat) in your README:  If your code is hosted at GitHub, you can place the following in your README.md file to get the badge: ``` [](https://www.yiiframework.com/) ``` ### Sponsoring Support this project by becoming a sponsor or a backer. [](https://opencollective.com/yiisoft) [](https://opencollective.com/yiisoft)