Yii框架官方教學增補篇3－開始：創建第一個Yii應用

<br>

<br>

為了對 Yii 有個初步認識，我們在本節講述如何建立第一個 Yii 應用。我們將使用yiic（命令列工具）建立一個新的 Yii 應用程式。 Gii（強大的基於web的程式碼產生器）為特定的任務完成自動程式碼產生。假定YiiRoot為 Yii 的安裝目錄，WebRoot 是伺服器的文檔根目錄。 在命令列執行yiic，如下所示：

% YiiRoot/framework/yiic webapp WebRoot/testdrive

注意: 在 MacOS、Linux 或 Unix 系統中運行yiic時，你可能需要修改yiic檔案的權限使它能夠運作。而且必須在終端機命令列中能夠直接執行php命令（可在終端機中使用php -v測試），如果不能的話需要將可執行的php路徑置於系統路徑中。此外，也可以這樣執行此工具：

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

這將在 WebRoot/testdrive 目錄下建立一個最基本的 Yii 應用。這個應用程式擁有了大多數 Yii 應用程式所需的目錄結構。 不用寫一行程式碼，我們可以在瀏覽器中造訪以下 URL 來看看我們第一個 Yii 應用程式：

http://www.php.cn/

正如我們所看到的，這個應用程式包含三個頁面：首頁、聯絡頁面、登入頁。首頁展示一些關於應用程式和使用者登入狀態的信息，聯絡頁顯示一個聯絡表單以便使用者填寫並提交他們的諮詢，登入頁允許使用者先通過認證然後存取已授權的內容。 請參閱下列截圖了解更多：

下面的樹圖描述了我們這個應用的目錄結構：

testdrive/
   index.php                 Web 应用入口脚本文件
   index-test.php            功能测试使用的入口脚本文件
   assets/                   包含公开的资源文件
   css/                      包含 CSS 文件
   images/                   包含图片文件
   themes/                   包含应用主题
   protected/                包含受保护的应用文件
      yiic                   yiic 命令行脚本
      yiic.bat               Windows 下的 yiic 命令行脚本
      yiic.php               yiic 命令行 PHP 脚本
      commands/              包含自定义的 'yiic' 命令
         shell/              包含自定义的 'yiic shell' 命令
      components/            包含可重用的用户组件
         Controller.php      所有控制器类的基础类
         Identity.php        用来认证的 'Identity' 类
      config/                包含配置文件 console.php         控制台应用配置
         main.php            Web 应用配置
         test.php            功能测试使用的配置
      controllers/           包含控制器的类文件
         SiteController.php  默认控制器的类文件
      data/                  包含示例数据库 schema.mysql.sql    示例 MySQL 数据库
         schema.sqlite.sql   示例 SQLite 数据库
         testdrive.db        示例 SQLite 数据库文件
      extensions/            包含第三方扩展
      messages/              包含翻译过的消息
      models/                包含模型的类文件
         LoginForm.php       'login' 动作的表单模型
         ContactForm.php     'contact' 动作的表单模型
      runtime/               包含临时生成的文件
      tests/                 包含测试脚本
      views/                 包含控制器的视图和布局文件
         layouts/            包含布局视图文件
            main.php         所有视图的默认布局
            column1.php      使用单列页面使用的布局
            column2.php      使用双列的页面使用的布局
         site/               包含 'site' 控制器的视图文件
            pages/           包含 "静态" 页面
               about.php     "about" 页面的视图
            contact.php      'contact' 动作的视图
            error.php        'error' 动作的视图(显示外部错误)
            index.php        'index' 动作的视图
            login.php        'login' 动作的视图
         system/             包含系统视图文件

1. 連接到資料庫

Web 應用應用也不例外。要使用資料庫，我們首先需要告訴應用程式如何連接它。修改應用程式的設定檔WebRoot/testdrive/protected/config/main.php即可，如下：

<br>

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

上面的程式碼告訴Yii 應用程式在需要時將連接到testitedrive /protected/data/testdrive.db。注意這個SQLite 資料庫已經包含在我們建立的應用框架中。資料庫只包含一個名為tbl_user的表：

<br>

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. 。

注意: 要使用 Yii 的資料庫功能，我們需要啟用 PHP 的 PDO 擴充功能和對應的驅動擴充。對於測試應用程式來說，我們需要啟用php_pdo和php_pdo_sqlite擴充。

2. 實現 CRUD 操作

激動人心的時刻來了。我們想要為剛才建立的tbl_user表實作 CRUD (create, read, update 和 delete) 操作，這也是實際應用中最常見的操作。我們無需麻煩地編寫實際程式碼，這裡我們將使用Gii —— 一個強大的基於Web 的程式碼產生器。

設定Gii

為了使用Gii，首先需要編輯檔案WebRoot/testdrive/protected/main.php，這是已知的 應用程式設定 檔案：

return array(
    ......
    'import'=>array(
        'application.models.*',
        'application.components.*',
    ),

    'modules'=>array(
        'gii'=>array(
            'class'=>'system.gii.GiiModule',
            'password'=>'pick up a password here',
        ),
    ),
);

然後，造訪http://www.php.cn /。這裡我們需要輸入密碼，它是在我們在上面的設定中指定的。

產生 User 模型

登陸後，點選連結Model Generator。它將顯示下面的模型產生頁面：

在Table Name輸入框中，輸入tbl_user。在Model Class 輸入框中，輸入 User。然後點選Preview按鈕。這裡將展示將要產生的新文件。現在點選Generate按鈕。一個名為User.php將會產生到protected/models目錄中。如我們稍後描述的， User模型類別允許我們以物件導向的方式存取資料表tbl_user。

產生 CRUD 程式碼

在建立模型類別之後，我們將產生執行 CRUD 操作的程式碼。我們選擇 Gii 中的Crud Generator，如下所示：

在Model Class输入框中，输入User。在Controller ID输入框中，输入user(小写格式)。现在点击Generate按钮后的 Preview按钮。CRUD 代码生成完成了。

访问 CRUD 页面

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

http://www.php.cn/

这会显示一个tbl_user表中记录的列表。 点击页面上的Create User 链接，如果没有登录的话我们将被带到Yii框架官方教學增補篇3－開始：創建第一個Yii應用。登录后，我们看到一个可供我们添加新用户的表单。完成表单并点击Create按钮，如果有任何输入错误的话，一个友好的错误提示将会显示并阻止我们保存。回到用户列表页，我们应该能看到刚才添加的用户显示在列表中。 重复上述步骤以添加更多用户。注意，如果一页显示的用户条目太多，列表页会自动分页。 如果我们使用admin/admin作为管理员登录，我们可以在如下 URL 查看用户管理页：

http://www.php.cn/

这会显示一个包含用户条目的漂亮表格。我们可以点击表头的单元格来对相应的列进行排序，而且它和列表页一样会自动分页。 实现所有这些功能不要我们编写一行代码！

<br>

以上就是Yii框架官方教程增补篇3——开始：创建第一个Yii应用的内容，更多相关内容请关注PHP中文网（www.php.cn）！

<br>