所有控制器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); } }