Yii源码阅读笔记（四）

所有控制器action的基类yii\base\Action.php

 namespace yii\base;//定义的命名空间

 use Yii //使用的命名空间

 class Action extends Component //继承了组建类
 {
          //定义属性action的id

     public $id;

     public $controller; //定义拥有该action的控制器属性

     public function __construct($id, $controller, $config = [])//构造函数，用于初始化id和controller属性
     {
         $this->id = $id;
         $this->controller = $controller;
         parent::__construct($config);
     }

       //通过调用控制器中的同名方法，
     public function getUniqueId()
     {
         return $this->controller->getUniqueId() . '/' . $this->id;
     }
 　　//用指定的参数运行此操作
     public function runWithParams($params)
     {
         if (!method_exists($this, 'run')) {//如果类中的run方法是不存在
             throw new InvalidConfigException(get_class($this) . ' must define a "run()" method.');//抛出异常
         }
         $args = $this->controller->bindActionParams($this, $params);//控制器的方法，绑定参数
         Yii::trace('Running action: ' . get_class($this) . '::run()', __METHOD__);//输出trace信息
         if (Yii::$app->requestedParams === null) {  //如果Yii::$app的属性requestedParams（操作请求的参数）为空
             Yii::$app->requestedParams = $args;//该参数的值为上面绑定参数的返回值
         }
         if ($this->beforeRun()) {//beforRun方法，默认返回true，意思为run前
             $result = call_user_func_array([$this, 'run'], $args);//把$args作为参数来调用当前控制器的run方法
             $this->afterRun();//空方法

             return $result;//返回函数的调用结果，如出错，返回false
         } else {
             return null;//否则返回空
         }
     }

     protected function beforeRun()//该方法在run之前执行，调用时重写该方法，如果返回为false，则run方法不执行，runwithparams方法返回空
     {
         return true;
     }

     //该方法在run方法后执行，用于处理后续操作
     protected function afterRun()
     {
     }
 }

component.php组件类

class Component extends Object  //继承了object类
{

    private $_events = [];//私有的events属性

    private $_behaviors;//私有的behaviors属性

public function __get($name)//__get魔术方法，用于返回组组件的属性值
    {
        $getter = 'get' . $name;//通过连字符构建该属性的get方法名
        if (method_exists($this, $getter)) {//如果该方法存在
            // read property, e.g. getName()
            return $this->$getter();//调用该方法获取属性
        } else {
            // behavior property
            $this->ensureBehaviors();//调用ensureBehaviors()方法确定该行为类中定义了该属性
            foreach ($this->_behaviors as $behavior) {
                if ($behavior->canGetProperty($name)) {//如果该行为类可以获取属性
                    return $behavior->$name;//返回该行为类的属性值
                }
            }
        }
        if (method_exists($this, 'set' . $name)) {//如果该属性名的set方法存在抛出异常
            throw new InvalidCallException('Getting write-only property: ' . get_class($this) . '::' . $name);
        } else {//否则抛出异常，未知的属性
            throw new UnknownPropertyException('Getting unknown property: ' . get_class($this) . '::' . $name);
        }
    }

component的__set方法

  public function __set($name, $value)
     {
         $setter = 'set' . $name;//在属性名前面加set构建set方法
         if (method_exists($this, $setter)) {//如果构建的方法存在
             // 调用该方法设置属性值
             $this->$setter($value);

             return;
         } elseif (strncmp($name, 'on ', 3) === 0) {//如果方法不存在，且属性名前三个字符为on+空格
             // on event: attach event handler
             $this->on(trim(substr($name, 3)), $value);//调用on方法将事件处理程序附加到事件

             return;
         } elseif (strncmp($name, 'as ', 3) === 0) {//否则，如果属性名的前三个字符为as+空格
             // as behavior: attach behavior
             $name = trim(substr($name, 3));//截取as后面的字符
             $this->attachBehavior($name, $value instanceof Behavior ? $value : Yii::createObject($value));//嗲用attachBehavior添加一个行为到组件

             return;
         } else {//否则
             // behavior property
             $this->ensureBehaviors();//调用ensureBehaviors()方法确定该行为类中定义了该属性
             foreach ($this->_behaviors as $behavior) {
                 if ($behavior->canSetProperty($name)) {//调用方法判断该属性是否口试被赋值
                     $behavior->$name = $value;//给该行为类的属性赋值

                     return;
                 }
             }
         }
         if (method_exists($this, 'get' . $name)) {//如果该属性的get方法存在，抛出异常
             throw new InvalidCallException('Setting read-only property: ' . get_class($this) . '::' . $name);
         } else {//否则抛出异常，未知的属性
             throw new UnknownPropertyException('Setting unknown property: ' . get_class($this) . '::' . $name);
         }
     }