Yii1.1升级到Yii2.0需重构控制器继承、Yii::app()调用、import语句、布局配置、表单代码及入口文件;必须修改命名空间、use声明、layout赋值方式、ActiveForm用法,并拆分配置至web.php/console.php,设置cookieValidationKey。

将Yii1.1项目升级到Yii2.0不是简单替换文件就能完成的事,框架底层结构、命名空间、对象获取方式、布局机制全部重构,直接运行会立刻报错Class 'CController' not found或Call to undefined method Yii::app()。
控制器类继承与实例调用迁移
第一步:打开所有控制器文件(如SiteController.php),把class SiteController extends CController改为class SiteController extends yii\base\Controller。
第二步:全局搜索Yii::app(),替换成Yii::$app——注意这不是字符串替换,要逐处确认上下文;比如Yii::app()->user→Yii::$app->user,Yii::app()->db→Yii::$app->db。
【必须改】如果某处写了Yii::app()->getModule('xxx'),不能只改前缀,得改成Yii::$app->getModule('xxx');旧写法会直接Fatal error,且不提示具体哪一行。
第三步:删掉控制器类顶部的import语句(如'application.models.*'),Yii2不再支持该语法;模型需用use声明,例如use app\models\User;。
布局(Layout)配置重写
方法一:单个控制器禁用布局
将$this->layout = '';或$this->layout = null;全部改为$this->layout = false;
方法二:全局统一指定布局
不要在父控制器里写public $layout = 'main';,这在Yii2中完全无效;打开config/web.php,在components数组内添加'layout' => 'main'配置项。
方法三:按控制器动态设布局
在控制器action内直接赋值:$this->layout = 'admin';,但必须在render()之前执行;若放在init()里,会被后续findLayoutFile()逻辑覆盖。
表单生成代码重写
第一步:在控制器或视图顶部添加use yii\widgets\ActiveForm;
第二步:把beginWidget('CActiveForm'); ?>整段删除,替换为。
第三步:所有$form->textField($model,'name')类调用,保持参数不变,但必须确保$model已use声明(如use app\models\LoginForm;),否则会报Class not found。
【关键前提】视图中所有ActiveForm::end()必须成对出现,缺一个会导致页面HTML结构断裂,且错误不报在PHP层,只在浏览器渲染时表现为表单消失或提交无响应。
应用入口与配置加载路径变更
① 打开原Yii1.1的index.php,删掉require_once($yii);和$application= new CWebApplication($config);两行。
② 替换为标准Yii2入口代码:
require(__DIR__.'/../vendor/autoload.php');
require(__DIR__.'/../vendor/yiisoft/yii2/Yii.php');
$config = require(__DIR__.'/../config/web.php');
(new yii\web\Application($config))->run();
③ 把原config/main.php里的内容,按模块拆分到config/web.php(Web应用)、config/console.php(控制台)中;数据库配置必须移到$db组件下,不能再写在params里。
④ 检查cookieValidationKey是否已设置:打开config/web.php,确认'security'组件中'cookieValidationKey'有真实密钥值,为空或占位符会导致CSRF验证失败,登录态无法维持。











