README.md 2.92 KB
Newer Older
Qiang Xue committed
1 2
Yii PHP Framework Version 2
===========================
3

Qiang Xue committed
4
Thank you for choosing Yii 2 - a modern PHP framework designed for professional Web development.
5

Qiang Xue committed
6 7 8 9 10 11 12 13 14 15 16 17 18
Yii 2 is a complete rewrite of its previous version Yii 1.1 which is one of the most popular PHP frameworks.
Yii 2 inherits the main spirit behind Yii for being simple, fast and highly extensible.
Yii 2 requires PHP 5.4 and embraces best practices and protocols found in modern Web application development.


**Yii 2 is not ready for production use yet.** We may make significant changes without prior notices.
We expect to make the first stable release of Yii 2 in early 2014.

If you mainly want to learn Yii with no real project development requirement, we highly recommend
you start with Yii 2 as it will be our main focus for the next few years.

If you have a real project with tight schedule, you should stick to [Yii 1.1](https://github.com/yiisoft/yii)
which is the latest stable release of Yii.
Qiang Xue committed
19

20

21 22
[![Latest Stable Version](https://poser.pugx.org/yiisoft/yii2/v/stable.png)](https://packagist.org/packages/yiisoft/yii2)
[![Total Downloads](https://poser.pugx.org/yiisoft/yii2/downloads.png)](https://packagist.org/packages/yiisoft/yii2)
23
[![Build Status](https://secure.travis-ci.org/yiisoft/yii2.png)](http://travis-ci.org/yiisoft/yii2)
24
[![Dependency Status](https://www.versioneye.com/php/yiisoft:yii2/dev-master/badge.png)](https://www.versioneye.com/php/yiisoft:yii2/dev-master)
resurtm committed
25

26

Qiang Xue committed
27 28
DIRECTORY STRUCTURE
-------------------
29

Qiang Xue committed
30 31 32 33
      apps/                ready-to-use application templates
          advanced/        a template suitable for building sophisticated Web applications
          basic/           a template suitable for building simple Web applications
          benchmark/       an application demonstrating the performance of Yii
Qiang Xue committed
34 35
      build/               internally used build tools
      docs/                documentation
36
      extensions/          extensions
Qiang Xue committed
37
      framework/           core framework code
Qiang Xue committed
38
      tests/               tests of the core framework code
39 40 41 42 43


REQUIREMENTS
------------

44
The minimum requirement by Yii is that your Web server supports PHP 5.4.
45 46


47 48 49
DOCUMENTATION
-------------

Qiang Xue committed
50 51
A draft of the [Definitive Guide](docs/guide/index.md) is available.

52 53 54 55
For 1.1 users, you may refer to [Upgrading from Yii 1.1](docs/guide/upgrade-from-v1.md)
to have a general idea of what has changed in 2.0.


Qiang Xue committed
56 57
HOW TO PARTICIPATE
------------------
58

59 60 61
**Your participation to Yii 2 development is very welcome!**

You may participate in the following ways:
62

Qiang Xue committed
63 64 65
* [Report issues](https://github.com/yiisoft/yii2/issues)
* [Give us feedback or start a design discussion](http://www.yiiframework.com/forum/index.php/forum/42-design-discussions-for-yii-20/)
* Fix issues, develop features, write/polish documentation
Qiang Xue committed
66
    - Before you start, please adopt an existing issue (labelled with "ready for adoption") or start a new one to avoid duplicated efforts.
Qiang Xue committed
67
    - Please submit a merge request after you finish development.
68