建立第一个 Yii 应用

在命令行运行 yiic，如下所示：

% cd WebRoot
% php YiiRoot/framework/yiic.php webapp testdrive

这将在 WebRoot/testdrive 目录下建立一个最基本的 Yii 应用。这个应用拥有了大多数 Yii 应用所需要的目录结构。

不用写一行代码，我们可以在浏览器中访问如下 URL 来看看我们第一个 Yii 应用：

正如我们看到的，这个应用包含三个页面：首页、联系页、登录页。首页展示一些关于应用和用户登录状态的信息，联系页显示一个联系表单以便用户填写并提交他们的咨询，登录页允许用户先通过认证然后访问已授权的内容。查看下列截图了解更多：

首页

联系页

输入错误的联系页

提交成功的联系页

登录页

下面的树图描述了我们这个应用的目录结构。请查看约定以获取该结构的详细解释。

return array(
    ......
    'components'=>array(
        ......
        'db'=>array(
            'connectionString'=>'sqlite:protected/data/source.db',
        ),
    ),
);

上面的代码告诉 Yii 应用在需要时将连接到 SQLite 数据库 WebRoot/testdrive/protected/data/testdrive.db 。注意这个SQLite 数据库已经包含在我们创建的应用框架中。数据库只包含一个名为 tbl_user 的表：

CREATE TABLE tbl_user (
    id INTEGER NOT NULL PRIMARY KEY AUTOINCREMENT,
    username VARCHAR(128) NOT NULL,
    password VARCHAR(128) NOT NULL,
    email VARCHAR(128) NOT NULL
);

若你想要换成一个 MySQL 数据库，你需要导入文件 WebRoot/testdrive/protected/data/schema.mysql.sql 来建立数据库。

2. 实现 CRUD 操作

激动人心的时刻来了。我们想要为刚才建立的 tbl_user 表实现 CRUD (create, read, update 和 delete) 操作，这也是实际应用中最常见的操作。我们无需麻烦地编写实际代码，这里我们将使用 Gii —— 一个强大的基于Web 的代码生成器。

为了使用 Gii，首先需要编辑文件 WebRoot/testdrive/protected/main.php，这是已知的应用配置文件：

然后，访问 URL 。这里我们需要输入密码，它是在我们在上面的配置中指定的。

登陆后，点击链接 Model Generator。它将显示下面的模型生成页面，

Model Generator

在 Table Name 输入框中，输入 tbl_user。在 Model Class 输入框中，输入 User。然后点击 Preview 按钮。这里将展示将要生成的新文件。现在点击 Generate 按钮。一个名为将生成到 protected/models 目录中。如我们稍后描述的， User 模型类允许我们以面向对象的方式来访问数据表 tbl_user 。

在创建模型类之后，我们将生成执行 CRUD 操作的代码。我们选择 Gii 中的 Crud Generator，如下所示，

CRUD Generator

让我们看看成果，访问如下 URL：

http://hostname/testdrive/index.php?r=user

这会显示一个 tbl_user 表中记录的列表。

点击页面上的 Create User 链接，如果没有登录的话我们将被带到登录页。登录后，我们看到一个可供我们添加新用户的表单。完成表单并点击按钮，如果有任何输入错误的话，一个友好的错误提示将会显示并阻止我们保存。回到用户列表页，我们应该能看到刚才添加的用户显示在列表中。

重复上述步骤以添加更多用户。注意，如果一页显示的用户条目太多，列表页会自动分页。

如果我们使用 admin/admin 作为管理员登录，我们可以在如下 URL 查看用户管理页：

这会显示一个包含用户条目的漂亮表格。我们可以点击表头的单元格来对相应的列进行排序，而且它和列表页一样会自动分页。

实现所有这些功能不要我们编写一行代码！

用户管理页

新增用户页

创建第一个 Yii 应用

建立第一个 Yii 应用

2. 实现 CRUD 操作