YiiFramework 安装使用教程及文件结构详解
Yii 的安装由如下两步组成：
先从 www.yiiframework.com 下载 Yii 框架，将 Yii 压缩包解压至一个 Web 可访问的目录。
提示: 安装在 Web 目录不是必须的，每个 Yii 应用都有一个入口脚本，只有它才必须暴露给 Web 用户。其它 PHP 脚本（包括 Yii）应该保护起来不被 Web 访问，因为它们可能会被黑客利用。
需求
安装完 Yii 以后你也许想验证一下你的服务器是否满足使用 Yii 的要求，只需浏览器中输入如下网址来访问需求检测脚本：
http://localhost/yii/requirements/index.php
Yii 的最低需求是你的 Web 服务器支持 PHP 5.1.0 或更高版本。Yii 在 Windows 和 Linux 系统上的 Apache HTTP 服务器 中测试通过，应该在其它支持 PHP 5 的 Web 服务器和平台上也工作正常。
建立第一个 Yii 应用
请添加PHP环境变量，如果未添加，输入命令时会提示：'"php.exe"' 不是内部或外部命令，也不是可运行的程序或批处理文件。
在 高级系统设置->系统属性->高级->环境变量 找到系统变量里的Path，点编辑，在变量值最后面加分号然后加PHP路径。
例如：
;D:\wamp\bin\php\php5.4.16
打开cmd，切换到yii目录下
如：D:\wamp\www\yii\framework>
输入
yiic webapp ../test
如：D:\wamp\www\yii\framework>yiic webapp ../test
输入命令将会提示在framework上级的yii目录下创建应用test，输入yes
Create a Web application under 'D:\wamp\www\yii\test'? (yes|no) [no]:yes
按回车后将会出现如下信息
mkdir D:/wamp/www/yii/test
mkdir D:/wamp/www/yii/test/assets
mkdir D:/wamp/www/yii/test/css
......
......
generate themes/classic/views/.htaccess
mkdir D:/wamp/www/yii/test/themes/classic/views/layouts
mkdir D:/wamp/www/yii/test/themes/classic/views/site
mkdir D:/wamp/www/yii/test/themes/classic/views/system
Your application has been created successfully under D:\wamp\www\yii\test.
这样第一个应用就建立好了，此时查看应用访问http://localhost/yii/test/
提示：yii这个目录可以放在任意一个可读的目录中，不一定要放在WEB服务器的www下，在实际中，一般将此目录放在比较安全的地方，如：D:\，创建应用的时候，就可以进入D:\yii\framework>目录执行：
yiic webapp D:\wamp\www\test
如：D:\yii\framework>yiic webapp D:\wamp\www\test
查看应用
地址栏中输入：http://localhost/test/
正如我们看到的，这个应用包含三个页面：首页、联系页、登录页。首页展示一些关于应用和用户登录状态的信息，联系页显示一个联系表单以便用户填写并提交他们的咨询，登录页允许用户先通过认证然后访问已授权的内容。 查看下列截图了解更多：
首页
联系页
输入错误的联系页
提交成功的联系页
登录页
文件结构
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 应用由数据库驱动，我们的测试应用也不例外。要使用数据库，我们首先需要告诉应用如何连接它。修改应用的配置文件 protected/config/main.php 即可，如下所示：
return array( ...... 'components'=>array( ...... 'db'=>array( 'connectionString'=>'sqlite:protected/data/testdrive.db', ), ), ...... );
上面的代码告诉 Yii 应用在需要时将连接到 SQLite 数据库 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 数据库，你需要建立数据库，导入文件 protected/data/schema.mysql.sql
注意: 要使用 Yii 的数据库功能，我们需要启用 PHP 的 PDO 扩展和相应的驱动扩展。对于测试应用来说，我们需要启用 php_pdo 和 php_pdo_sqlite 扩展。
换成MySQL数据库
打开protected/config/main.php找到
'db'=>array( 'connectionString' => 'sqlite:'.dirname(__FILE__).'/../data/testdrive.db', ),
这是默认连接的sqllite,将这段代码注释，然后在这行代码下面找到
/* 'db'=>array( 'connectionString' => 'mysql:host=localhost;dbname=testdrive', //dbname是你的数据库名， 'emulatePrepare' => true, 'username' => 'root', //数据库用户名 'password' => '', //数据库密码 'charset' => 'utf8', // 数据库编码 'tablePrefix'=>'tbl_',//这行是我加的，表名前缀 ), */
将这行代码的注释去掉，并创建数据库，导入文件protected/data/schema.mysql.sql
实现 CRUD 操作
我们想要为刚才建立的 tbl_user 表实现 CRUD (create, read, update 和 delete) 操作，这也是实际应用中最常见的操作。我们无需麻烦地编写实际代码，这里我们将使用 Gii —— 一个强大的基于Web 的代码生成器。
信息: Gii 自版本 1.1.2 可用。在此之前，可以使用 yiic 来实现相同的功能。更多细节，请参考 用 yiic shell实现 CRUD 操作。
配置Gii
为了使用 Gii，首先需要编辑文件 protected/main.php，这是已知的 应用配置 文件：
'modules'=>array( // uncomment the following to enable the Gii tool /* 'gii'=>array( 'class'=>'system.gii.GiiModule', 'password'=>'你的gii密码', // If removed, Gii defaults to localhost only. Edit carefully to taste. 'ipFilters'=>array('127.0.0.1','::1'), ), */ ), 将里面gii的注释去掉，并修改密码。
如果碰到这种情况
Error 403
You are not allowed to access this page.
gii是有IP限制的，如果YII是安装在Linux虚拟机里，访问时会返回403错误，提示没有权限
遇到这种情况，我们就需要配置gii的ipFilters
'ipFilters'=>array('127.0.0.1','::1','192.168.0.153'), 将IP添加进去，成功的话会提示输入密码
然后，访问 URL http://localhost/test/index.php?r=gii。这里我们需要输入密码，它是在我们在上面的配置中指定的。
生成 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://localhost/test/index.php?r=user
这会显示一个 tbl_user 表中记录的列表，如下图所示。
点击页面上的 Create User 链接，如果没有登录的话我们将被带到登录页。登录后，我们看到一个可供我们添加新用户的表单。完成表单并点击 Create 按钮，如果有任何输入错误的话，一个友好的错误提示将会显示并阻止我们保存。回到用户列表页，我们应该能看到刚才添加的用户显示在列表中。
重复上述步骤以添加更多用户。注意，如果一页显示的用户条目太多，列表页会自动分页。
点击页面上的 Manage User 链接，如果我们使用 admin/admin 作为管理员登录，我们可以在如下 URL 查看用户管理页：
http://localhost/test/index.php?r=user/admin
这会显示一个包含用户条目的漂亮表格。我们可以点击表头的单元格来对相应的列进行排序，而且它和列表页一样会自动分页。
实现所有这些功能不要我们编写一行代码！
用户管理页
新增用户页
