首次运行yii2必须执行init初始化并验证环境，否则报错或白屏；需选开发环境生成main-local.php，检查php扩展是否启用，配置数据库后运行yii migrate创建基础表，最后通过路由访问验证功能正常。
首次运行Yii2框架时，必须完成初始化并验证环境是否达标，否则访问会直接报错或显示白屏。这一步不是可选项，而是强制前置动作，跳过会导致后续所有功能无法启动。
执行init脚本生成环境配置
在项目根目录下打开终端，运行./init（Linux/macOS）或双击init.bat（Windows）。
选择0进入开发环境模式——【选错环境会导致main-local.php不生成，数据库配置无法生效】。
确认输出中出现“Initialized successfully”字样，此时common/config/main-local.php、frontend/config/main-local.php等文件已被写入基础结构。
检查PHP扩展与环境常量
直接访问/frontend/web/index.php或/backend/web/index.php，页面顶部会自动触发环境检测。
若看到绿色对勾和“Congratulations!”提示，说明mbstring、openssl、pdo_mysql等核心扩展已启用；若出现红色叉号，需根据提示逐个开启对应PHP扩展。
注意：环境常量YII_ENV必须在入口文件中明确定义，不能依赖默认值——未定义时框架将拒绝启动。
配置数据库并运行迁移
第一步：用phpMyAdmin或命令行创建空数据库，字符集设为utf8mb4。
第二步：编辑common/config/main-local.php，填写'dsn' => 'mysql:host=localhost;dbname=your_db_name'及账号密码。
第三步：回到项目根目录，执行./yii migrate——【此命令不可逆，会直接修改数据库结构】。
看到“Total 1 new migration applied”即表示user表等基础表已创建完成。
验证路由与功能可用性
方法一：访问/index.php?r=site/about，应渲染出预置的“关于”页面。
方法二：访问/index.php?r=site/contact，提交联系表单后应跳转至成功页且无PHP错误。
方法三：在浏览器开发者工具的Network面板中，确认响应状态码为200，HTML中不含Parse error或Class not found类报错信息。
