Yii安装使用教程

Yii 是一个基于组件的高性能 PHP 框架，用于快速开发大型 Web 应用。它使Web开发中的 可复用度最大化，可以显著提高你的Web应用开发速度。Yii 这个名字（读作易（Yee） 或 [ji:]）代表 简单（easy）, 高效（efficient） 和 可扩展（extensible）.

中文帮助：http://www.yiiframework.com/doc/guide/1.1/zh_cn/quickstart.what-is-yii

 

 

一、下载yiiframework，当前最新版本是1.1.6

下载地址：http://yii.googlecode.com/files/yii-1.1.6.r2877.tar.gz

 

二、解压缩，配置环境

将压缩包放在appserv的www目录下面，启动apache和mysql，在地址栏中输入：http://localhost/yii6/requirements/index.php，查看配置环境，PDO和GD库需要配置一下，打开php.ini，加入：

extension=php_pdo_mysql.dll

extension=php_mysql.dll

（当然，以上两个文件必须提前放在php的扩展文件夹中），yii框架基于php5。

 

最新的PCEL下载地址：

http://downloads.php.net/pierre/

 

三、创建第一个应用

打开cmd，切换到appserv的www目录下，输入：

D:\AppServ\www>yii6\framework\yiic webapp test

Create a Web application under 'D:\AppServ\www\test'? [Yes|No] yes

D:\AppServ\www>yii6\framework\yiic webapp test

Create a Web application under 'D:\AppServ\www\test'? [Yes|No] yes

      mkdir D:/AppServ/www/test

      mkdir D:/AppServ/www/test/assets

      mkdir D:/AppServ/www/test/css

   generate css/bg.gif

   generate css/form.css

   generate css/ie.css

   ...

   generate themes/classic/views/.htaccess

      mkdir D:/AppServ/www/test/themes/classic/views/layouts

      mkdir D:/AppServ/www/test/themes/classic/views/site

      mkdir D:/AppServ/www/test/themes/classic/views/system

Your application has been created successfully under D:\AppServ\www\test.

这样第一个应用就建立好了。

（yii6这个目录可以放在任意一个可读的目录中，不一定要放在appserv的www下，在生产中，一般将此目录放在比较安全的地方，比如：d:\，创建应用的时候，就可以：D:\yii6\framework\yiic webapp webapp d:\appserv\www\test）

(如果你使用Eclipse或者NetBeans开发工具，将YII的framework作为包含文件，这样开发起来提示就比较多了。^_^)

四、查看应用

地址栏中输入：http://localhost/test/

没写一行代码，就可以看到程序正常运行了。跟ROR差不多。

 

五、文件结构说明

六、连接数据库

YII的数据库连接配置在主配置文件config/main.php中进行配置。

如果是sqllite数据库，只需要指定正确的数据库文件位置即可；

如果是mysql数据库，或者其他数据库（pgsql/oracle），需要注释掉原来的配置。

如下：（mysql）

'db'=>array(

'connectionString' => 'sqlite:'.dirname(__FILE__).'/../data/testdrive.db',

),

// uncomment the following to use a MySQL database

/*

'db'=>array(

'connectionString' => 'mysql:host=localhost;dbname=testdrive',

'emulatePrepare' => true,

'username' => 'root',

'password' => '',

'charset' => 'utf8',

),

*/

将上面的代码修改为：

/*

'db'=>array(

'connectionString' => 'sqlite:'.dirname(__FILE__).'/../data/testdrive.db',

),

*/

// uncomment the following to use a MySQL database

 

'db'=>array(

'connectionString' => 'mysql:host=localhost;dbname=test', //test为数据库名

'emulatePrepare' => true,

'username' => 'root', //这里是数据库用户名

'password' => 'livedoor2008', //这里是你的数据库密码

'charset' => 'utf8',

),

七、创建表结构并配置CRUD（注意：YII使用的php的PDO来访问数据库的，所以在使用数据库时，务必配置好PDO）

第一步：创建表结构

CREATE TABLE tbl_user

(

id INTEGER NOT NULL PRIMARY KEY AUTO_INCREMENT,

username VARCHAR(128) NOT NULL,

password VARCHAR(128) NOT NULL,

salt VARCHAR(128) NOT NULL,

email VARCHAR(128) NOT NULL,

profile TEXT

) ENGINE=InnoDB DEFAULT CHARSET=utf8 COLLATE=utf8_unicode_ci;

等等，其他表结构查看yii6\demos\blog\protected\data下。

 

第二步：配置CRUD

YII的CRUD可以自动生成，使用GII这个工具。

要使用GII，在主配置文件中，打开GII即可，并设置密码。

// autoloading model and component classes

'import'=>array(

'application.models.*',

'application.components.*',

),

 

'modules'=>array(

// uncomment the following to enable the Gii tool

'gii'=>array(

'class'=>'system.gii.GiiModule',

'password'=>'livedoor2008',

 // If removed, Gii defaults to localhost only. Edit carefully to taste.

'ipFilters'=>array('127.0.0.1','::1'),

),

),

 

保存文件后，在地址栏中输入：

http://localhost/test/index.php?r=gii

输入设置密码，便可以使用GII了。

 

八、根据表结构生成表的模型类

第一步，使用GII生成tbl_user的模型类：

点击生成（Generate），模型类User.php就生成了，它位于protected/modules/下。

第二步，使用GII生成对tbl_user的CRUD操作类，并加入测试数据：

这里，GII帮我们生成了一个UserController.php控制器文件和user的多个视图文件。

UserController.php位于protected/controllers/下，多个视图文件位于views/user下。

九、针对表生成并实现CRUD操作

访问user控制器：http://localhost/test/index.php?r=user

如果要操作，需要用管理员admin/admin登录。

查看（Read）/添加（Create）/删除（Delete）/更新（Update），随你了。

 

十、MVC基础

M -- 模型，代表了数据（表）和具体的业务逻辑；

V -- 用户看到的内容，文本，颜色，表单等

C -- 用来管理模型和视图的通信

这样做的好处就是分离的程序和页面及业务逻辑，对于局部的修改不会影响到其他的内容。

YII的工作流分析：

http://localhost/index.php?r=post/show&id=1

假设，一个用户请求了以上的地址，YII会做如下处理：

前端控制器index.php，会创建一个web实例，并执行此实例；

1) 应用组件request会接收此请求，并交给urlManager对请求的地址进行分割，r=post/show，表示请求的是一个叫post的控制器，并执行show动作

2) Show动作对应showAction的方法，以上创建的实例会对该方法执行关联的过滤操作（过滤器，测试基准），如果容许访问，继续执行；否则访问终止；

3) showAction会找到ID=1的模型数据，并渲染一个视图；

4) 视图读取数据，并显示post模型的属性，执行完一些小物件后，渲染内容插入布局文件，最后显示给用户。

 

十一、前端控制器（入口脚本）

前端控制器是唯一一个能够直接为用户访问的脚本，一个是为了安全起见，一个是为了生成一个应用实例。

// 在生产环境中请删除此行

defined('YII_DEBUG') or define('YII_DEBUG',true);

// 包含Yii引导文件

require_once('path/to/yii/framework/yii.php');

// 创建一个应用实例并执行

$configFile='path/to/config/file.php';

Yii::createWebApplication($configFile)->run();

十二、使用组件

1) 通常，YII的组件随取随用，配置好的组件，如果不在preload中，则只有通过Yii::app()->组件ID进行访问时候，才会被应用创建。

2) 但是，Yii的核心组件（16个），即使不被访问，也会被创建。

 

十三、使用表单

十四、关于正则表达式

$str = 'dddfew4t34233fdfew we中文2323duids,';

var_dump(preg_match('/^(([\w\s,])|([^\x{00}-\x{ff}]))+$/u', $str));

\w -- 匹配字符（字母和数字）

\s -- 匹配空格 制表符和换行符

[^\x{00}-\x{ff}]))+$/u --匹配双字节

preg_match -- 使用perl风格的正则表达式

 

十五、YII的MVC结构

（一）模型 -- M

l YII的模型类均继承自CModel或者其子类；

l 模型中封装了数据库的表的数据或者用户提交的数据(通常是业务逻辑的数据)，这些数据通常会被模型中定义的rules规则进行验证；

l YII模型有2种，一种是CFormModel，一般由用户提交，并且绝大多数是临时的放在内存中，当然也可以通过AR存到数据库中；另外一种是Active Record 模型，AR是一种对数据库数据面向对象方式访问的抽象方式，它的每一个对象表示为数据表中的每一行，一个列的值就是这个对象的一个属性。

 

（二）视图 -- V

l 将模型中的数据，配合HTML标签渲染；

l 视图中一般只写一些简单的数据逻辑，如：循环或者条件。也可以写一些YII的小物件或者HTML助手；更多复杂的业务逻辑放在模型（对数据的操作）或者控制器（业务逻辑）中。

 

（三）控制器 -- C

根据用户的请求，协调模型和视图，并将结果发给用户端

控制器继承自CController或者其子类

 

十六、使用AR进行数据库操作

l 建立表的模型

通过使用GII，非常容易的建立表的模型，例如：表tbl_user

http://www.formtest.com/index.php?r=gii/model

表名为：tbl_user

模型名为：User

点预览->生成，这样就OK了。

 

l 在模型中编写针对此表的操作

假设，我们就在User模型中编写这个业务，

 

 

public function updateUser(){

$userId = '1';

$model = User::model()->find('id=:id', array(':id' => $userId));

$model->username = 'liujun';

return $model->save();

}

 

l 在控制器中调用此操作

Public function actionUpdateUser(){

$user = new User();

$user->updateUser();

}

十七、视图和控制器

十八、关于敏捷开发

单元测试：每个类及其方法测试

功能测试：整体的多个相关的类进行测试

单元测试实例：

class HelloWorldTest extends CTestCase {

    public function testActionIndex(){

        

    }

}

十九、安装xDebug

Xdebug是php调试工具，开源项目，用来调试/分析和跟踪php代码。

打开cmd：

Php.exe -i > d:\appserv\php5\logs\phpinfo.txt

打开这个文件，粘贴到浏览器（地址为：http://www.xdebug.org/find-binary.php）的输入框中，等待系统分析后，就可以下载合适版本的xdebug，并按照安装方法安装了。

 

例如：

1 Download php_xdebug-2.1.0-5.2-vc6.dll

2 Move the downloaded file to d:\AppServ\php5\ext

3 Edit C:\WINDOWS\php.ini and add the line
zend_extension_ts = d:\AppServ\php5\ext\php_xdebug-2.1.0-5.2-vc6.dll

上面这个是系统分析我的环境给出的下载版本和安装步骤。重启apache，在cmd中输入：php.exe -v

输出：

D:\AppServ\php5>php -v

PHP 5.2.6 (cli) (built: May  2 2008 18:02:07)

Copyright (c) 1997-2008 The PHP Group

Zend Engine v2.2.0, Copyright (c) 1998-2008 Zend Technologies

with Xdebug v2.1.0, Copyright (c) 2002-2010, by Derick Rethans

说明xdebug已经安装成功了。此时，通过phpinfo也可以看到。

 

二十、安装PHPUnit(http://pear.phpunit.de/)

为了进行YII的单元测试，需要安装PHPUnit。

cd d:\appserv\php5

安装pear

go-pear.bat -- 安装pear

设置pear环境

include_path = ".;D:\xampp\xampp\php\PEAR;D:\xampp\xampp\htdocs\yii6"

REGEDIT4

[HKEY_CURRENT_USER\Environment]

"PHP_PEAR_SYSCONF_DIR"="D:\\xampp\\xampp\\php"

"PHP_PEAR_INSTALL_DIR"="D:\\xampp\\xampp\\php\\pear"

"PHP_PEAR_DOC_DIR"="D:\\xampp\\xampp\\php\\docs"

"PHP_PEAR_BIN_DIR"="D:\\xampp\\xampp\\php"

"PHP_PEAR_DATA_DIR"="D:\\xampp\\xampp\\php\\data"

"PHP_PEAR_PHP_BIN"="D:\\xampp\\xampp\\php\\php.exe"

"PHP_PEAR_TEST_DIR"="D:\\xampp\\xampp\\php\\tests"

安装phpUnit

pear channel-discover pear.phpunit.de

pear install phpunit/PHPUnit

 

输出：

Did not download optional dependencies: pear/Image_GraphViz, pear/Log, symfony/Y

AML, use --alldeps to download automatically

phpunit/PHPUnit can optionally use package "pear/Image_GraphViz" (version >= 1.2

.1)

phpunit/PHPUnit can optionally use package "pear/Log"

phpunit/PHPUnit can optionally use package "symfony/YAML" (version >= 1.0.2)

downloading PHPUnit-3.4.15.tgz ...

Starting to download PHPUnit-3.4.15.tgz (255,036 bytes)

.....................................................done: 255,036 bytes

install ok: channel://pear.phpunit.de/PHPUnit-3.4.15

 

二十一、PHP功能测试

YII的功能测试，跟YII的单元测试差不多，但是扩展的不是CTextCase，而是CWebTestCase。需要把新建的类放在tests/functional下。

如何需要进行功能测试 ，需要安装 SRC（selenium-remote-control），下载安装包，并启动：

http://repo1.maven.org/maven2/org/seleniumhq/selenium/server/selenium-server/1.0.3/selenium-server-1.0.3-standalone.jar

 

启动服务：

D:\xampp\SRC>java -jar selenium-server-1.0.3-standalone.jar

测试：

打开protected/tests/WebTestCase.php

define('TEST_BASE_URL','http://www.phpunit.com/index-test.php/');

修改红色字体部分。

打开protected/tests/phpunit.xml

删除这行：<browser name="Internet Explorer" browser="*iexplore" />

 

D:\xampp\xampp\htdocs\phpunit\protected\tests>phpunit functional\SiteTest.php

PHPUnit 3.5.13 by Sebastian Bergmann.

 

...

 

Time: 21 seconds, Memory: 6.25Mb

 

OK (3 tests, 10 assertions)

二十二、进行单元测试

在MessageController中添加一个方法：

        public function actionRepeat($str){

            return $str;

        }

在protected\tests\unit:

新建一个类：MessageTest

<?php

Yii::import('application.controllers.MessageController');

class MessageTest extends CTestCase {

    public function testActionRepeat(){

        $str = "HelloWorld";

        $message = new MessageController('MessageTest');

        $result = $message->actionRepeat($str);

        $this->assertEquals($str, $result);

    }

}

?>

测试结果：