基本用法 ¶

打开 Gii 时，首先进入到引导页，此处可以选择一种代码生成器。

默认有以下生成器可用：

• Model Generator - 此生成器为指定的数据库表生成 ActiveRecord 类。
• CRUD Generator - 此生成器生成控制器和视图，实现指定数据模型的 CRUD（创建，读取，更新，删除）操作。
• Controller Generator - 此生成器可帮助您快速生成新的控制器类，生成一个或多个控制器操作及其对应的视图。
• Form Generator - 此生成器生成视图脚本文件，该脚本文件显示用于指定模型类的输入的表单。
• Module Generator - 此生成器可帮助您生成 Yii 模块所需的基础代码及结构。
• Extension Generator - 此生成器可帮助您生成Yii扩展所需的文件。

通过单击 "Start" 按钮选择生成器后，将看到一个表单，允许配置生成器的参数。 根据需要填写表单，然后按 "Preview" 按钮获取 Gii 将要生成的代码的预览。 根据选择的生成器以及文件是否已经存在，将得到类似于下图所示的输出：

单击文件名可以查看将为该文件生成的代码的预览。 当文件已经存在时，Gii 还提供了一个 diff 视图，它显示了存在的代码和将要生成的代码之间的区别。 在这种情况下，还可以选择应覆盖哪些文件，哪些不覆盖。

提示：在使用模型生成器在数据库更改后更新模型时，可以从 Gii 预览复制代码，并将更改与您自己的代码合并。可以使用IDE功能，如 PHPStorms compare with clipboard（与剪贴板比较），Aptana Studio 或者使用 Eclipse 通过 AnyEdit tools plugin 也允许 compare with clipboard（与剪贴板比较），这样可以合并相关的更改，并省略其他可能被自己还原的代码。

在检查代码并选择要生成的文件后，可以单击 "Generate" 按钮创建文件即可。 如果看到Gii无法生成文件的错误时，则需调整目录权限，以便的Web服务器能够写入目录并创建文件。

注意：Gii 生成的代码只是一个根据自己的需要进行调整的模板。 它可以帮助你快速创建新的代码，但它不是创建准备使用于正式项目的代码。我们经常看到人们使用 Gii 生成的 model 没有改变，只是通过扩展它们从而调整部分 model 的功能。 这不是我们编写它的初衷。 Gii 生成的代码可能不完整或不正确，必须根据自己的需要进行更改才能使用它。