Gii生成CRUD需严格按三步顺序操作:先启用Gii模块(配置bootstrap、modules及YII_ENV)、再修正模型tableName()为实际表名、最后正确填写CRUD生成器的Model Class、Controller Class和Search Model Class参数,任一环节错误将导致403、表不存在或未知类等报错。

直接用 Gii 生成 CRUD 就能跑通增删改查,但必须按顺序做对三件事:先让 Gii 能访问、再生成正确的模型、最后生成控制器和视图——中间任何一步错,403、Table not found 或 Unknown Class 就会立刻报出来。
怎么确认 Gii 模块已启用且可访问
访问 http://localhost/index.php?r=gii 出现 404?不是密码错,是模块根本没注册。打开 config/web.php,检查是否在 if (YII_ENV_DEV) 块里写了这两行:
'bootstrap' => ['gii'],
'modules' => [
'gii' => 'yii\gii\Module',
],
同时确认入口文件(如 web/index.php)里有:defined('YII_ENV') or define('YII_ENV', 'dev');。没这句,YII_ENV_DEV 不生效,Gii 永远不会加载。
Model Generator 生成后必须手动改 tableName()
Gii 读表结构靠的是数据库连接,但如果表名带前缀(比如 tbl_user),它默认生成的 tableName() 是 {{%user}},运行时直接抛 SQLSTATE[42S02]: Base table or view not found。
生成完立刻打开 models/User.php,把:
public static function tableName()
{
return '{{%user}}';
}
改成:
public static function tableName()
{
return 'tbl_user';
}
- 别用
{{%}}语法,除非你真在db.php里配了tablePrefix - 类名大小写要和表名实际大小写一致(MySQL 默认不区分,但部署到 Linux 服务器就可能报错)
- 如果表名含下划线(如
user_profile),Gii 生成的类名是UserProfile,没问题;但路径必须是models/UserProfile.php,不能手误存成userprofile.php
CRUD Generator 填参最容易填错的三个地方
点击「CRUD Generator」后,这三个输入框错一个,生成的代码就跑不起来:
-
Model Class:必须带完整命名空间,比如app\models\UserProfile,不能只写UserProfile -
Controller Class:命名要符合 Yii 路由规则——类名是UserprofileController(驼峰,无下划线),对应 URL 是?r=userprofile;写成UserProfileController或user-profile都会触发Unknown Class -
Search Model Class:默认是app\models\UserProfileSearch,它依赖UserProfile存在;如果模型类名或路径错了,这步点「Preview」就会直接报错,不让你继续
勾选 Enable I18N 前想清楚:项目没配翻译文件(messages/ 目录下空的),运行时 Yii::t() 会不断报 warning,页面可能白屏。
生成完还打不开 ?r=userprofile?先查路由和权限
生成成功不代表能访问。常见卡点:
- URL 中的控制器名必须全小写、中划线分隔,比如
userprofile对应UserprofileController;写成UserProfile或user-profile都 404 - 开发环境默认启用了
AccessControl,看生成的控制器里有没有behaviors()方法里限制了 IP 或角色;最简单验证方式:临时注释掉整个behaviors()再试 - 如果用的是
frontend/backend多应用结构,控制器的namespace必须匹配目录,比如frontend/controllers/UserprofileController.php的 namespace 得是frontend\controllers,不是app\controllers
真正麻烦的从来不是生成动作本身,而是模型类名、命名空间、URL 路由、目录结构这四者之间那几处大小写和下划线的隐性耦合——错一个字符,整个链路就断在看不见的地方。


















