Yii 简明学习教程

Yii是一个基于组件的高性能PHP框架，用于快速开发Web应用程序（下面内容基于Yii 1.1）

1. 典型的工作流

用户向入口脚本index.php发起请求
入口脚本加载应用配置config.php并创建一个应用主体
应用主体通过请求组件Request解析请求的路由
根据解析结果去创建控制器实例去处理请求

——————————————————————————————————————
控制器创建一个动作实例并针对操作执行过滤器
若任一过滤器返回失败，则动作取消
若所有过滤器返回成功，则动作执行
动作加载一个数据模型，可能会从数据库中读取数据
动作将渲染的视图，并加载的数据模型作为属性传递给它
渲染结果返回给响应组件Response
响应组件发送渲染结果给用户浏览器

2. 入口脚本`index.php`

<?php

    /// 定义全局变量，在生产环境中请删除此行

    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();

?>

3. 应用配置`config.php`

应用主体的相关配置，可以内部属性可以通过Yii::app()->attributeName访问

<?php

$config = [

    'id' => 'basic',  //应用主体ID

    'basePath' => dirname(__DIR__), //应用的根路径

    'language' => 'zh-CN',  //网页语言

    'defaultRoute' => 'post/index',  //默认路由

    'components' => [   //注册组件

        'db'=>array(

            'class' => 'system.db.CDbConnection',

            'connectionString' => 'mysql:host=mysql56.rdsm1whs0okm6y4.rds.bj.baidubce.com;dbname=crowd_test',

            'emulatePrepare' => true,

            'username' => 'crowdtest',

            'password' => 'unittest_sdcqa',

            'charset' => 'utf8',

        ),

        'fixture' => array(

            'class' => 'crowdtest.tests.test.CDbFixtureManager',

            'basePath' => dirname(__FILE__) . '/../fixtures/',

        ),

    ]

];

return $config;

?>

4. 模型`Model`

模型是MVC架构中的M，由CModel或其子类（如CActiveRecord、CFormModel)继承而来，是表现业务数据、规则和逻辑的对象,表单模型(CFormModel)用于保持从用户的输入获取的数据, 这些数据经常被获取，使用，然后丢弃。Active Record (AR) 是一种用于通过面向对象的风格抽象化数据库访问的设计模式。

<?php

    class ContactForm extends CFormModel

    {

        //【业务数据】

        public $name;

        public $email;

        public $verifyCode;

        //【业务规则】

        // array('AttributeList', 'Validator', 'on'=>'ScenarioList', ...附加选项)

        // Validator: required,email,length,captcha,url,boolean等等

        public function rules(){

            return array(

                    array('name,email','required'),

                    array('email','email'),

                    array('name', 'length', 'min'=>3, 'max'=>12),

                    array('verifyCode','captcha'),

                );

            ];

        }

        //属性在页面中的显示内容

        public function attributeLabels()

        {

            return array(

                'name' => '姓名'

            );

        }

        //【业务逻辑】

        public function contact($email){

        }

    }

?>

5. 数据库操作(DAO/ActiveRecord)

数据访问对象（DAO）对访问存储在不同数据库管理系统（DBMS）中的数据提供了一个通用的API。

    $connection=Yii::app()->db;//CDbConection实例，代表一个数据库连接

    $command=$connection->createCommand($sql)  //CDbCommand实例，代表Sql指令

    $command->bindValue();  //绑定变量

    $command->query();  //执行查询

    $command->queryRow(); //执行查询并返回结果中的第一行

    $command->execute(); //执行操作，删除、新增等

Active Record(AR)是一个流行的对象-关系映射(ORM)技术,通过面向对象的方式来操纵数据库，大大提高了代码的可维护性，每个 AR类代表一个数据表，数据表的列在 AR 类中体现为类的属性，一个 AR 实例则表示表中的一行。

<?php

    class User extends CActiveRecord

    {

        //Required，返回一个此类可调用的实例

        public static function model($className=__CLASS__)

        {

            return parent::model($className);

        }

        //设置数据库中对应的数据表

        public function tableName()

        {

            return 'tbl_post';

        }

        //不同表之间的关联关系

        //BELONGS_TO 属于 1：n

        //HAS_MANY  有多个  m:1

        //HAS_ONE   有一个  1:1

        //MANY_MANY 多对多  m:n

        public function relations(){

            return array(

                'article'=>array(self::HAS_MANY, 'Article', 'user_id'),

            );

        }

        public function myfunc(){

            //CURD

        }

    }

?>

增加(Create)

<?php

    $model = new User();

    $model->name = "Lee";

    $model->age = "18";

    //save中会自动执行rules中的规则检查，根据检查结果返回true或者false

    if($model->save()){

          #code

    }

?>

查询(research)

<?php

    // 查找满足指定条件的结果中的第一行

    $user=User::model()->find($condition,$params);

    $user = User::model()->find("name=:name",array(':name'=>$name));

    // 查找具有指定主键值的那一行

    $user=User::model()->findByPk($userID,$condition,$params);

    // 查找具有指定属性值的行

    $user=User::model()->findByAttributes($attributes,$condition,$params);

    // 通过指定的 SQL 语句查找结果中的第一行

    $user=User::model()->findBySql($sql,$params);

    //通过构建CDbCriteria实例完成更复杂的操作

    $criteria=new CDbCriteria;

    $criteria->select='email';  // 只选择 'email' 列

    $criteria->condition='user_id=:user_id';

    $criteria->params=array(':user_id'=>$id);

    $user=User::model()->find($criteria); // $params 不需要了

?>

更新(update)

<?php

    $user=User::model()->findByPk(3);

    $user->username='newName';

    $user->save(); // 将更改保存到数据库

?>

删除(Delete)

<?php

    $user=User::model()->findByPk(10); // 假设有一个用户，其 ID 为 10

    $user->delete(); // 从数据表中删除此行

    User::model()->deleteAll("type='test'");

?>

关联查询

<?php

    //懒加载,使用该属性再取回

    $user=User::model()->findByPk(1);

    $user->article;

    //渴求加载，一次性取回

    $user=User::model()->with('article')->findAll();

?>

6. 控制器`Controller`

控制器是MVC中的C，由CController继承而来，负责处理请求以及生成响应，一个控制器的声明周期如下：

st=>start: 创建Controller实例

e=>end: 结束

op0=>operation: 执行CController:init()方法

op1=>operation: 确定操作ID创建操作(默认操作/独立操作/内联操作/异常)

op2=>operation: 依次调用应用主体、模块、控制器的beforeAction()方法

op3=>operation: 控制器执行操作(请求数据解析和填入到操作参数)

op4=>operation: 依次调用应用主体、模块、控制器的afterAction()方法

op5=>operation: 应用主体获取操作结果并赋值给响应

st->op0->op1->op2->op3->op4->op5->e

一个简单的控制器文件如下所示，主要由执行过滤和一系列动作组成。

<?php

    Class SiteController extend CController{

        //执行过滤

        public function filters(){...}

        //指定一些通用的action

        public function actions(){...}

        public function actionIndex(){...}

        public function actionLogin(){...}

        public function actionContact()

        {

            //设置对应layout布局，不需要时将该值设为false，默认view/layouts/main.php

            $this->layout = 'newLayout';

            //构建模型实例

            $model = new ContactForm();

            //根据POST的内容渲染视图

            if ($model->load(Yii::app()->request->post()) && $model->contact(Yii::app()->params['adminEmail'])) {

                Yii::$app->session->setFlash('contactFormSubmitted');

                return $this->refresh();

            }

            return $this->render('contact', [

                'model' => $model,

            ]);

        }

    }

?>

7. 视图`View`

视图是MVC架构中的V，用于展示从数据到终端用户的代码

视图方面推荐Smarty3，比原生View要简洁高效很多，相关教程后续加上。

Reference:

http://www.yiiframework.com/doc/guide/1.1/zh_cn/index

http://www.yiichina.com/doc/api/1.1

博文作者：vicfeel

博文出处：http://www.cnblogs.com/vicfeel

本文版权归作者和博客园共有，欢迎转载，但须保留此段声明，并给出原文链接，谢谢合作！

如果阅读了本文章，觉得有帮助，您可以为我的博文点击“推荐一下”！