介绍
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的提示。