yii\base\Component::__get() 触发行为属性访问时,先查getter,再通过ensureBehaviors()初始化行为并遍历behaviors数组,调用各行为的canGetProperty()判断是否支持该属性,仅public属性或对应getter有效。

yii\base\Component::__get() 怎么触发行为属性访问
当你访问一个不存在的公共属性(比如 $model->status_text),而该类继承自 yii\base\Component(绝大多数控制器、模型、小部件都如此),Yii 不会立刻报错,而是走完三步:先查 getter 方法(getStatusText()),再查绑定的行为($this->behaviors),最后才抛 UnknownPropertyException。
关键点在于:$this->ensureBehaviors() 会被自动调用,确保所有行为已初始化;之后遍历 $this->behaviors 数组,对每个行为调用 $behavior->canGetProperty('status_text') —— 这个方法默认检查行为里是否有 public 成员变量或对应 getter,**不支持 private/protected 变量直接暴露为属性**。
- 行为中必须定义 public 属性(如
public $status_text = 'draft';)或getStatusText()方法 - 若行为未显式声明
public $status_text,仅靠__get()代理是无效的 - 行为类需继承
yii\base\Behavior,否则canGetProperty()可能返回 false
为什么给 Component 子类加 public 成员变量不等于自动有属性
看起来简单:在控制器里写 public $foo = 'bar';,然后在视图里 $this->foo 就能读到 —— 但这只是“碰巧生效”,本质是 PHP 原生对象属性访问,绕过了 Yii 的属性机制。真正受控的属性必须由 __get()/__set() 触发,也就是依赖 getter/setter 或行为。
后果很实际:
- 你无法在
rules()中验证这个$foo(因为Validator依赖canGetProperty()判断是否为合法属性) -
attributes()方法不会包含它,导出 CSV 或做批量赋值时会被忽略 - 若后续把
$foo改成 protected,并加 getter,原有模板代码会静默失效(读不到值,也不报错)
拦截写入:__set() 在 Component 和 Object 中的行为差异
yii\base\Object::__set() 遇到无 setter 且非 public 成员变量时,直接抛 UnknownPropertyException;而 yii\base\Component::__set() 多了一层:尝试把写入委托给已绑定的行为。
但注意:行为必须同时满足两个条件才接受写入:
-
$behavior->canSetProperty($name)返回 true(同理,要求 public 变量或存在setXxx()) -
$behavior->hasMethod('set'.$name)或对应 public 属性真实存在
常见翻车点:
定义了一个行为,里面只有 public $title;,但在主类里执行 $this->title = 'new'; 却失败 —— 很可能是因为该行为没被正确挂载(behaviors() 方法没返回它),或者挂载时 key 名冲突覆盖了其他行为。
调试属性访问失败最有效的三个手段
当 $model->xxx 突然读不到、也不报错,优先查这三项:
- 用
var_dump(get_class_methods($model));看是否存在getXxx(),确认是否走 getter 分支 - 在模型中临时加一句
var_dump($this->behaviors);,确认目标行为确实在数组里,且 key 对应的 value 是行为实例而非配置数组 - 在行为类中加断点或日志,验证
canGetProperty('xxx')是否返回 true —— 很多时候是行为里漏写了public $xxx或拼错方法名
行为属性拦截不是黑盒魔法,它的每一步都在源码里可追踪;但正因为链路略长,一旦某环缺失(比如忘记 return parent::behaviors();),就会静默跳过整段逻辑。











