Yii2基础版中Gii需手动启用:设YII_ENV='dev',在main-local.php配置gii模块并限制allowedIPs,清缓存后访问/gii或?r=gii,登录admin/admin,确保数据库已配置且表名准确。

安装Yii2基础版后,Gii默认已内置但处于禁用状态,需手动配置开发环境、注册模块并限制访问权限,才能安全启用。
确认并设置开发环境
Gii只在YII_ENV = 'dev'时生效。检查入口文件web/index.php,确保开头有:
defined('YII_ENV') or define('YII_ENV', 'dev');- 若使用高级模板,还需确认
environments/dev/...目录下的环境配置已正确应用
在本地配置中启用Gii模块
推荐将Gii配置写入config/main-local.php(或environments/dev/common/config/main-local.php),避免误提交到生产环境:
- 在
return [ ... ]数组中添加'modules'键,内容为:
'gii' => [
'class' => 'yii\gii\Module',
'allowedIPs' => ['127.0.0.1', '::1'],
],
- 确保该文件被主配置加载(如
common/config/main.php末尾含ArrayHelper::merge(..., require(__DIR__.'/main-local.php'))) - 修改后务必清空
runtime/cache/目录下所有缓存文件
访问Gii界面并验证登录
根据项目结构和URL美化设置,选择对应地址访问:
- 基础模板默认路径:
http://localhost/index.php?r=gii - 启用
enablePrettyUrl后:http://localhost/gii(需确认urlManager允许gii/*路由) - 首次访问会提示登录,默认用户名和密码均为
admin - 若返回403 Forbidden,请核对
allowedIPs是否匹配当前请求IP(例如Docker容器内访问需加宿主机IP)
生成代码前的两个关键准备
Gii本身不创建数据库或表,使用前需确保:
- 数据库已连接成功,且
db组件在config/db.php中配置正确 - 目标数据表已存在,表名区分大小写(尤其在Linux环境下)
- Model Generator中填写的
Table Name须与数据库实际表名完全一致(如user_profile不能写成userprofile)


















