Skip to content

Latest commit

 

History

History
46 lines (31 loc) · 1.7 KB

upgrade.md

File metadata and controls

46 lines (31 loc) · 1.7 KB

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.

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\Query which includes methods for building a query. CDbCommandBuilder is replaced by yii\db\QueryBuilder which has cleaner and more complete support of query building capabilities.