Yii PHP Framework有用新手教程

说明：由于近期工作工作关系，须要开发一个在Linux下执行的Web Application，须要对如今比較流行的一些PHP框架做一个了解和评估，以下的这篇文章是笔者近期学习一个比較新的PHP Framework的一点经历和操作步骤，由于官方的手冊写得比較晦涩（特别是中文的），以前尝试遍读它那个手冊再动手，读了一大半发现仍无法理解，于是干脆先下手为强了，因而也就有了以下的文章。 

介绍

Yii 是一个基于组件、纯 OOP 的、用于开发大型 Web 应用的高性能 PHP 框架。它将 Web 编程中的可重用性发挥到极致，可以显著加速开发进程。 Yii 适合大流量的应用，如门户、 BBS 、 CMS 及 B2B 系统等，功能丰富，性能优异，只是它的中文文档还不完好，而且有些命令行的操作是针对非 Windows 用户的，不易理解，所以制作了这篇文档。

下载地址： http://www.yiiframework.com/download/

中文文档地址： http://www.yiiframework.com/doc/guide/zh_cn

配置

以下针对本人的机器相关软件环境及路径做下说明：

Apache2.2.4+PHP5.2.5+MySQL5.1.39

在这里须要说明的是须要在设置 Windows 环境变量，在 Path 中加入 PHP 执行环境所在的文件夹（如本人在原有配置后加上 ”;C:/PHP” ），由于使用 Yii 时须要 PHP 的执行环境。此外，在 PHP 版本号选择时建议不要选择比較高的版本号，本人是从 PHP5.3.0->PHP5.2.11->PHP5.2.5 一路降下来才执行成功的，建议尽量临时不要使用 PHP5.3.0、PHP5.2.11 ，本人在使用这两个版本号过程中常常遇到一个 ext 文件夹下的 dll 文件不能载入的情况，当然你确认自己对 PHP 的配置相当熟悉的话例外。

由于在 Yii 中须要开启 pdo 和 pdo_mysql ，所以请确保在执行环境所使用的 php.ini 中取消了 extension=php_mysql.dll 、 extension=php_pdo.dll 、 extension=php_pdo_mysql.dll 的凝视。

Apache 的站点根路径为 D:/wwwroot ，在这个根路径下创建一个名为 YiiDemo 的目录，将从网上下载到的 Yii 压缩包解压之后，拷贝进 D:/wwwroot/YiiDemo 目录，文件结构例如以下：

注：上图中 demos 、 framework 、 requirements 是 Yii 压缩包中的目录，其他文件和目录是本人使用 Eclipse 时创建的。此外，在 D:/wwwroot/YiiDemo/framework 目录下有一个 yiic.bat 文件，这个文件能够帮助我们高速生成站点架构和 MVC 相关的文件。

另外，在本实例中 MySQL 和 PHP 都是用了 utf8 编码，不建议使用 gb2312 编码，能显示的中文字符太少，而且对其他东亚语系不支持，甚至连生僻点的繁体中文都不能显示，而 utf8 能够解决问题。

创建站点初始结构

启动 Windows 命令行程序（在開始菜单上找到“执行”，然后输入“ cmd ”并回车），能够看到例如以下命令行窗体：

在命令行方式下切换到 Yii 的 framework 文件夹下用以运行 yiic 命令（实际运行的是 yiic.bat ），例如以下：

看到如上图所看到的的信息之后，就能够使用 yiic 来创建站点结构了，在本例中我们在 D:/wwwroot/YiiDemo/framework （注意 Apache 中站点根路径为 D:/wwwroot ）下创建站点，站点名字为 study ，先在 D:/wwwroot/YiiDemo/framework 下手动创建 study 这个目录，然后使用例如以下命令创建站点： yiic webapp 站点路径，例如以下图：

在输入创建站点的命令之后就会看到如上图所看到的的提示，键入 ”y” 之后就会在 D:/wwwroot/YiiDemo/study 文件夹创建站点的框架结构，例如以下图所看到的：

依照本人机器配置，如今就能够看到 Yii 框架的雏形显示了，网址是： http://localhost/YiiDemo/study/index.php 。

生成 MVC 文件

依照默认配置还不能使用数据库，要想获取与数据库的练习，须要更改配置，打开 D:/wwwroot/YiiDemo/study/protected/config 目录下的 main.php 文件，更改 components 中的配置就可以， ’db’ 这一參数被凝视掉了，将 ’db’ 參数设置例如以下：

‘db‘=>array(

                                                ‘connectionString‘=>‘mysql:host=localhost;dbname=study‘,

                                                ‘username‘=>‘root‘,

                                                ‘password‘=>‘jeri‘,

                                ),

保存之后就可以连接 MySQL 数据库了，实际使用时要依据自己的实际情况配置。

在此将继续使用 yiic 这个命令行工具，通过 cd 切换工作路径到 D:/wwwroot/YiiDemo/study 这个目录，然后在命令行中能够创建 model 和 view 文件。例如以下：

须要注意的是，如上图所看到的，由于 yiic.bat 文件在 D:/wwwroot/YiiDemo/framework 目录下，而当前命令行的工作路径是 D:/wwwroot/YiiDemo/study ，所以在执行 yiic 时建议使用全路径。

使用 yiic shell 命令就能够进入 shell 命令行，在命令行看到的输入提示变为“ >> ”，键入 model 表名就会创建相应表的 model 文件，上图以下就是使用“ model user ”成功之后就能够看到上图相应的情况。

还能够使用 crud (crud 各自是 create/read/update/delete 的缩写，表示经常使用的增删改查数据库操作 ) 表名创建相应的 coltroller 和 view 文件，例如以下图所看到的：

比方针对表 user 、 userlist 等使用 model 和 crud 命令之后，我们就能够在浏览器中查看这些文件了，如查看 userlist 表中的数据，能够在浏览器中输入 http://localhost/YiiDemo/study/index.php?r=userlist ，看到例如以下所看到的的图：

能够看到虽然 MySQL 和 PHP 都是用了 utf8 编码，可是数据库中的 RealName 字段由于是中文数据导致不能正常显示，出现这种情况是由于採用了默认的字符集连接 MySQL ，在 PHP 中直接连接 MySQL 时，假设使用了 utf8 编码，我们会在 PHP 代码中做例如以下设置： mysql_query("set names ‘utf8‘"); 可是在 Yii 中没有提供这种机会，           

我们能够在设置数据库连接字符串时指定连接数据库所使用的字符集，例如以下：

‘db‘=>array(

                                                ‘connectionString‘=>‘mysql:host=localhost;dbname=study‘,

                                                ‘username‘=>‘root‘,

                                                ‘password‘=>‘jeri‘,

                                                ‘charset‘=>‘utf8‘,//use charset as utf8

                                ),

这样就能正常显示了。当然也能够更改全局配置，那就是更改 D:/wwwroot/YiiDemo/framework/db 目录下的 CDbConnection.php 文件里的

public $charset;

改为 public $charset=‘utf8‘; 也能正常显示了，例如以下图所看到的：

好了，至此没有写一行代码，可是已经完毕了一个站点的大体框架，而且能初步实现增删改查功能了。尽管採用更改所有配置的方式也能够实现显示数据库中的中文，可是不建议採用这样的方式。在此很感谢kingheaven的提示。