Upgrading Instructions for Yii Framework v2
===========================================

!!!IMPORTANT!!!

The following upgrading instructions are cumulative. That is,
if you want to upgrade from version A to version C and there is
version B between A and C, you need to following the instructions
for both A and B.


General upgrade instructions
----------------------------

- Make a backup.
- Clean up your 'assets' folder.
- Replace 'framework' dir with the new one or point Git to a fresh
  release tag and checkout.
- Check if everything is OK, if not — revert to previous stable version and post
  issues to [Yii issue tracker](https://github.com/yiisoft/yii/issues).


Upgrading from v1.1.x
---------------------

- All framework classes are now namespaced, and the name prefix `C` is removed.

- The format of path alias is changed to `@yii/base/Component`.
  In 1.x, this would be `system.base.CComponent`. See guide for more details.

- The root alias `@yii` now represents the framework installation directory.
   In 1.x, this is named as `system`. We also removed `zii` root alias.

- Object serves as the base class that supports properties. And Component extends
  from Object and supports events and behaviors. Behaviors declared in
  Component::behaviors() are attached on demand.

- `CList` is renamed to `Vector`, and `CMap` is renamed to `Dictionary`.
  Other collection classes are dropped in favor of SPL classes.

- `CFormModel` is removed. Please use `yii\base\Model` instead.

- `CDbCriteria` is replaced by `yii\db\dao\Query` which includes methods for
  building a query. `CDbCommandBuilder` is replaced by `yii\db\dao\QueryBuilder`
  which has cleaner and more complete support of query building capabilities.