Yii 框架

PHP框架Yii系列教程

 

1 MVC架构

1.1处理流程

一个Web请求在Yii内部的执行流程如下图所示：

1.2组件角色

组件名	角色与责任
index.PHP	入口脚本。创建Application的单例对象。
application	前端控制器。分析用户请求并将其分派到合适的控制器中以作进一步处理。它同时作为服务中心，维护应用级别的配置。
request	解析用户的请求。
urlManager	帮助application决定请求的控制器和动作。
controller	执行所请求的动作，动作通常会引入所必要的模型并渲染相应的视图，动作完成视图渲染并将其呈现给用户。
model	读取数据库或进行其他业务操作。
view	视图渲染出最终的页面。

 

1.3最佳实践

假设有这样一个包含几个子应用的Web应用，例如：

Ø  Front-end：面向外部用户的Web站点

Ø  Back-end：为管理员提供管理功能的Web站点

Ø  Console：在终端中作为定时作业执行

Ø  Web API：为第三方提供集成的API

1.3.1 Model

Ø  包含代表特定数据的属性

Ø  包含业务逻辑、验证规则

Ø  包含操纵数据的代码

Ø  不应使用$_GET，$_POST等与界面类型绑定的变量

Ø  避免嵌入HTML等展示层代码

 

有时遵从第三条“包含操纵数据的代码”会让Model层变得很胖，因此可以为不同的子应用提供不同的Model子类。例如定义一个NewsBase类包含跨子应用共享的代码，为每个子应用实现自己的Model类，只包含针对当前子应用的代码。

1.3.2 View

Ø  包含展示代码，例如HTML和简单的遍历、格式化、渲染PHP代码

Ø  避免包含显示访问数据的代码

Ø  避免直接访问$_GET，$POST等变量

 

视图层的代码重用方式：

Ø  布局：公共展示区域（如页眉、页脚）可以放在一个布局视图中

Ø  部分视图：非布局代码的代码片段可以通过部分视图重用，例如表单代码

Ø  控件：如果部分视图中包含大量逻辑，就可以提取为控件类来重用。

Ø  助手类：完成细小任务的代码可以用助手类来重用，例如格式化数据，产生HTML标签

1.3.3 Controller

Ø  可以访问$_GET，$_POST等PHP变量来获得用户请求

Ø  创建Model实例，并管理其生命周期

Ø  避免嵌入SQL语句

Ø  避免包含HTML等展示层代码

 

在设计良好的MVC应用程序中，控制器通过非常瘦，只包含几十行代码。然而模型层通常会很胖，因为它包含了不同领域的业务逻辑，满足特定的需求。

2应用组件扩展

Yii 预定义了一系列核心应用组件，提供常见Web 应用中所用的功能。像【1.1组件角色】中的urlManager，【3数据访问】中将用到的CDbConnection，以及对Memcached支持等等都是通过可扩展的应用组件的形式加入到Yii中的。

2.1内置应用组件

下面我们列出了由 CWebApplication 预定义的核心组件。

·        assetManager: CAssetManager -管理私有资源文件的发布。

·        authManager: CAuthManager -管理基于角色的访问控制(RBAC).

·        cache: CCache -提供数据缓存功能。注意，你必须指定实际的类（例如CMemCache, CDbCache）。否则，当你访问此组件时将返回NULL。

·        clientScript: CClientScript -管理客户端脚本(javascripts 和CSS).

·        coreMessages: CPhpMessageSource -提供 Yii 框架用到的核心信息的翻译。

·        db: CDbConnection -提供数据库连接。注意，使用此组件你必须配置其 connectionString 属性。

·        errorHandler: CErrorHandler -处理未捕获的 PHP 错误和异常。

·        format: CFormatter -格式化数值显示。此功能从版本1.1.0 起开始提供。

·        messages: CPhpMessageSource -提供Yii应用中使用的信息翻译。

·        request: CHttpRequest -提供关于用户请求的信息。

·        securityManager: CSecurityManager -提供安全相关的服务，例如散列，加密。

·        session: CHttpSession -提供session相关的功能。

·        statePersister: CStatePersister -提供全局状态持久方法。

·        urlManager: CUrlManager -提供 URL 解析和创建相关功能

·        user: CWebUser -提供当前用户的识别信息。

·        themeManager: CThemeManager -管理主题。

 

2.2激活应用组件

要激活应用组件，我们需要定制Application。方式一是提供一个配置文件以创建Application实例时初始化其属性值；另一种方式是继承CWebApplication。

 

我们通常采用方式一，在一个单独的PHP脚本（例如protected/config/main.php）中保存这些配置。要激活某个应用组件，我们需要在这个PHP脚本中配置Application的components属性。例如下面激活memcached组件实现缓存功能：

array(

   ......

    'components'=>array(

       ......

       'cache'=>array(

           'class'=>'CMemCache',

           'servers'=>array(

                array('host'=>'server1', 'port'=>11211, 'weight'=>60),

                array('host'=>'server2', 'port'=>11211, 'weight'=>40),

           ),

       ),

    ),

)

 

然后在入口脚本index.php中，将配置文件的名字作为参数传递给应用构造器：

$app=Yii::createWebApplication($configFile);

 

现在就可以访问应用组件了。使用Yii::app()->ComponentID，其中的ComponentID是指组件的ID（例如Yii::app()->cache）。

3数据访问方式

Yii数据访问建立在PHP的PDO扩展上，通过一个统一的接口访问不同的数据库。在此基础上，Yii提供了三种数据库编程方式。

3.1直接使用核心类

Yii DAO 主要包含如下四个类：

CDbConnection：代表一个数据库连接。

CDbCommand：代表一条通过数据库执行的SQL 语句。

CDbDataReader：代表一个只向前移动的，来自一个查询结果集中的行的流。

CDbTransaction：代表一个数据库事务。

使用方法与Java的JDBC很像，例如：

 

$connection=Yii::app()->db;   

$command=$connection->createCommand($sql);

// 查询

$dataReader=$command->query();

while(($row=$dataReader->read())!==false){ ... }

// 绑定参数

$sql="INSERT INTO tbl_user (username, email) VALUES(:username,:email)";

$command=$connection->createCommand($sql);

// 用实际的用户名替换占位符 ":username" 

$command->bindParam(":username",$username,PDO::PARAM_STR);

// 用实际的 Email 替换占位符 ":email" 

$command->bindParam(":email",$email,PDO::PARAM_STR);

$command->execute();

 

3.2查询构造器

Yii的查询构造器(Query Builder)提供了面向对象方式编写SQL语句。例如：

 

$user = Yii::app()->db->createCommand()

    ->select('id, username, profile')

    ->from('tbl_user u')

    ->join('tbl_profile p', 'u.id=p.user_id')

    ->where('id=:id', array(':id'=>$id))

    ->queryRow();

 

对于比较简单的SQL语句来说，使用这种方式编程的优点有：

Ø  提高代码可读性

Ø  参数绑定避免SQL注入攻击

Ø  在PDO基础上的进一步数据库抽象，简化数据迁移

3.3活动对象模式

虽然前两种方式已经可以处理几乎任何数据库相关的任务，但很可能我们会花费90%的时间以编写一些执行普通CRUD操作的SQL语句。而且我们代码中混杂的SQL语句也会使代码变得难以维护。要解决这些问题，我们可以使用活动对象模式(Active Record，简称AR)。

 

AR是一个流行的对象-关系映射(ORM)技术。每个AR类代表一个数据表，数据表的列在 AR 类中体现为类的属性，一个AR实例则表示表中的一行。常见的CRUD操作作为AR的方法实现。因此，我们可以以一种更加面向对象的方式访问数据。

 

classPostextendsCActiveRecord

{

    publicstaticfunctionmodel($className=__CLASS__)

    {

        returnparent::model($className);

    }

    publicfunctiontableName()

    {

        return'tbl_post';

    }

}

$post=newPost;

$post->title='sample post';

$post->content='post body content';

$post->save();

 

具体例子见【6.2模型层实例】。

4数据缓存支持

Yii 提供了不同的缓存组件，可以将缓存数据存储到不同的媒介中。例如， CMemCache 组件封装了 PHP 的 memcache 扩展并使用内存作为缓存存储媒介。 CApcCache 组件封装了 PHP APC 扩展; 而 CDbCache 组件会将缓存的数据存入数据库。下面是一个可用缓存组件的列表：

·        CMemCache:使用 PHP memcache 扩展.

·        CApcCache:使用 PHP APC 扩展.

·        CXCache:使用 PHP XCache 扩展。注意，这个是从 1.0.1 版本开始支持的。

·        CEAcceleratorCache:使用 PHP EAccelerator 扩展.

·        CDbCache:使用一个数据表存储缓存数据。默认情况下，它将创建并使用在runtime 目录下的一个SQLite3 数据库。你也可以通过设置其 connectionID 属性指定一个给它使用的数据库。

·        CZendDataCache:使用 ZendData Cache 作为后台缓存媒介。注意，这个是从1.0.4 版本开始支持的。

·        CFileCache:使用文件存储缓存数据。这个特别适合用于存储大块数据（例如页面）。注意，这个是从1.0.6 版本开始支持的。

·        CDummyCache:目前 dummy 缓存并不实现缓存功能。此组件的目的是用于简化那些需要检查缓存可用性的代码。例如，在开发阶段或者服务器尚未支持实际的缓存功能，我们可以使用此缓存组件。当启用了实际的缓存支持后，我们可以切换到使用相应的缓存组件。在这两种情况中，我们可以使用同样的代码Yii::app()->cache->get($key) 获取数据片段而不需要担心 Yii::app()->cache 可能会是 null。此组件从 1.0.5 版开始支持。

 

4代码生成工具

(TODO 介绍Yii和Gii，可以用来快速开发系统原型)

5单元测试框架

(TODO 介绍基于PHPUnit的单元测试)

6一个典型例子

在《Yii入门实例.docx》的基础上增加下面三个实例。