Yii 框架 Behavior 定義與綁定全解析：靜態、動態、配置三種方式詳解

Yii Behavior 定義與綁定全解析

Behavior 是 Yii 實現橫向功能復用的核心機制。本文系統梳理 Behavior 的定義規範、三種綁定方式（靜態/動態/配置）、內部綁定流程源碼分析，以及命名與匿名行為的差異。

定義 Behavior 類

繼承 yii\base\Behavior，定義公共屬性（含 getter/setter）與方法：

namespace app\components;
use yii\base\Behavior;

class MyBehavior extends Behavior {
    public $prop1;
    private $_prop2;

    public function getProp2() { return $this->_prop2; }
    public function setProp2($value) { $this->_prop2 = $value; }
    public function foo() { /* ... */ }
}

關鍵點：

• 屬性可為 public 成員變數，或透過 getter/setter 定義（得益於 yii\base\Object 基礎）
• 內部可透過 $this->owner 存取已綁定的元件對象

靜態綁定：覆寫 behaviors() 方法

在元件類中覆寫 behaviors() 回傳行為配置陣列：

namespace app\models;
use yii\db\ActiveRecord;
use app\components\MyBehavior;

class User extends ActiveRecord {
    public function behaviors() {
        return [
            // 匿名行為：僅類名
            MyBehavior::className(),
            // 命名行為：鍵值對
            'myBehavior2' => MyBehavior::className(),
            // 匿名行為：配置陣列（可注入屬性初值）
            [
                'class' => MyBehavior::className(),
                'prop1' => 'value1',
                'prop3' => 'value3',
            ],
            // 命名行為：配置陣列
            'myBehavior4' => [
                'class' => MyBehavior::className(),
                'prop1' => 'value1',
                'prop3' => 'value3',
            ],
        ];
    }
}

配置檔綁定

在應用配置或元件配置中使用 as 前綴：

[
    'as myBehavior2' => MyBehavior::className(),
    'as myBehavior3' => [
        'class' => MyBehavior::className(),
        'prop1' => 'value1',
        'prop3' => 'value3',
    ],
]

動態綁定：attachBehavior() / attachBehaviors()

// 單個綁定
$component->attachBehavior('myBehavior1', new MyBehavior());

// 批次綁定
$component->attachBehaviors([
    'myBehavior1' => new MyBehavior(),  // 命名
    MyBehavior::className(),            // 匿名
]);

命名 vs 匿名行為

內部綁定流程源碼深度解析

核心方法鏈：

1. Component::behaviors() — 回傳行為配置陣列
2. Component::ensureBehaviors() — 確保行為已綁定（多處魔術方法調用前會呼叫）
3. Component::attachBehaviorInternal() — 內部實際綁定邏輯（private）
4. Behavior::attach() — 設定 owner、掛載事件處理器

ensureBehaviors() 關鍵邏輯：

public function ensureBehaviors() {
    if ($this->_behaviors === null) {
        $this->_behaviors = [];
        foreach ($this->behaviors() as $name => $behavior) {
            $this->attachBehaviorInternal($name, $behavior);
        }
    }
}

attachBehaviorInternal() 核心職責：

• 若傳入非 Behavior 實例（類名/配置陣列），透過 Yii::createObject() 實例化
• 匿名行為（數值索引）直接附加到 _behaviors[]
• 命名行為：若同名已存在，先 detach() 舊行為再綁定新行為（後綁定者勝出）
• 呼叫 $behavior->attach($this) 完成雙向綁定與事件掛載

Behavior::attach() 兩大動作：

public function attach($owner) {
    $this->owner = $owner;  // 1. 設定擁有者，行為可反向操作元件
    foreach ($this->events() as $event => $handler) {
        $owner->on($event, is_string($handler) ? [$this, $handler] : $handler); // 2. 掛載事件
    }
}

總結：綁定機制要點

• 綁定動作由 Component 發起
• 靜態綁定：覆寫 behaviors()；動態綁定：呼叫 attachBehaviors()；配置綁定：as 關鍵字
• 命名行為可精確管理，匿名行為僅能批次操作
• 同名行為後綁定者覆蓋先綁定者
• 綁定本質：設定 owner 反向引用 + 掛載事件處理器

理解這些底層機制，能幫你在複雜專案中精準控制 Behavior 生命週期，避免常見的重複綁定、事件洩漏等問題。