PHP的Yii框架入门使用教程

安装

Yii 的安装由如下两步组成：

从 yiiframework.com 下载 Yii 框架。将 Yii 压缩包解压至一个 Web 可访问的目录。 Tip|提示: 安装在 Web 目录不是必须的，每个 Yii 应用都有一个入口脚本，只有它才必须暴露给 Web 用户。其它 PHP 脚本（包括 Yii）应该保护起来不被 Web 访问，因为它们可能会被黑客利用。

需求

安装完 Yii 以后你也许想验证一下你的服务器是否满足使用 Yii 的要求，只需浏览器中输入如下网址来访问需求检测脚本：

http://hostname/path/to/yii/requirements/index.PHP Yii 的最低需求是你的 Web 服务器支持 PHP 5.1.0 或更高版本。Yii 在 Windows 和 Linux 系统上的 Apache HTTP 服务器中测试通过，应该在其它支持 PHP 5 的 Web 服务器和平台上也工作正常。

建立第一个 Yii 应用

为了对 Yii 有个初步认识，我们在本节讲述如何建立第一个 Yii 应用。我们将使用 yiic （命令行工具）创建一个新的 Yii 应用。Gii（强大的基于web的代码生成器）为特定的任务完成自动代码生成。假定 YiiRoot 为 Yii 的安装目录，Webroot 是服务器的文档根目录。

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

rush:bash;"> % YiiRoot/framework/yiic webapp Webroot/testdrive

Note|注意: 在 MacOS、Linux 或 Unix 系统中运行 yiic 时，你可能需要修改 yiic 文件的权限使它能够运行。此外，也可以这样运行此工具：

rush:bash;"> % cd Webroot % PHP YiiRoot/framework/yiic.PHP webapp testdrive

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

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

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

下面的树图描述了我们这个应用的目录结构。

rush:plain;"> 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/ 包含系统视图文件

连接到数据库

大多数 Web 应用由数据库驱动，我们的测试应用也不例外。要使用数据库，我们首先需要告诉应用如何连接它。修改应用的配置文件 Webroot/testdrive/protected/config/main.PHP 即可，如下所示：

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

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

rush:sql;"> 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 来建立数据库。

Note|注意: 要使用 Yii 的数据库功能，我们需要启用 PHP 的 PDO 扩展和相应的驱动扩展。对于测试应用来说，我们需要启用 PHP_pdo 和 PHP_pdo_sqlite 扩展。

实现 CRUD 操作

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

配置Gii

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

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

然后，访问 URL http://hostname/testdrive/index.PHP?r=gii。这里我们需要输入密码，它是在我们在上面的配置中指定的。

生成 User 模型

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

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