ThinkPHP 視圖模型深度解析：多表關聯查詢的優雅實現

視圖模型：將多表 JOIN 封裝為單表操作

ThinkPHP ViewModel（視圖模型）允許開發者預先定義多表關聯關係（JOIN 條件、所需字段、別名、連接類型），然後像操作單表模型一樣進行查詢、分頁、排序。它將 SQL 寫死在模型定義中，業務代碼只需面向「虛擬單表」，極大簡化控制器邏輯，避免重複編寫 JOIN SQL，並自動處理字段衝突、別名映射。

核心概念與定義結構

<?php
// Lib/Model/UserViewModel.class.php
class UserViewModel extends ViewModel {
    // 視圖字段定義：核心配置
    protected $viewFields = [
        // 主表：User (別名 u，左連接)
        'User' => [
            'id', 'name', 'password', 'dept_id', 'status',
            '_as'   => 'u',           // 表別名
            '_type' => 'LEFT'         // 連接類型：LEFT/INNER/RIGHT
        ],
        // 關聯表：UserInfo (別名 ui，ON 條件關聯 u.id)
        'UserInfo' => [
            'email', 'mobile', 'address', 'gender',
            '_as' => 'ui',
            '_on' => 'ui.user_id = u.id'  // 關聯條件，引用別名
        ],
        // 關聯表：Dept (無別名，字段重名映射)
        'Dept' => [
            'name' => 'dept_name',    // 字段別名：Dept.name → dept_name（避免與 User.name 衝突）
            '_on' => 'u.dept_id = Dept.id'
        ],
    ];
}
?>

配置詳解：$viewFields 陣列結構

實戰：三表關聯查詢用戶詳情

資料庫結構（MySQL）

-- 用戶基礎表
CREATE TABLE `tp_user` (
    `id` INT UNSIGNED AUTO_INCREMENT PRIMARY KEY,
    `name` VARCHAR(20) NOT NULL,
    `password` VARCHAR(32) NOT NULL,
    `dept_id` SMALLINT UNSIGNED NOT NULL,
    `status` TINYINT UNSIGNED DEFAULT 1
);

-- 用戶詳細信息表
CREATE TABLE `tp_user_info` (
    `user_id` INT UNSIGNED NOT NULL,
    `nick_name` VARCHAR(30),
    `email` VARCHAR(100),
    `mobile` VARCHAR(20),
    `address` VARCHAR(100),
    `gender` TINYINT DEFAULT 0,
    KEY `user_id` (`user_id`)
);

-- 部門表
CREATE TABLE `tp_dept` (
    `id` SMALLINT UNSIGNED AUTO_INCREMENT PRIMARY KEY,
    `name` VARCHAR(50) NOT NULL
);

基礎模型（可選，單表操作用）

<?php
// Lib/Model/UserModel.class.php
class UserModel extends Model {}

// Lib/Model/UserInfoModel.class.php
class UserInfoModel extends Model {}

// Lib/Model/DeptModel.class.php
class DeptModel extends Model {}

控制器查詢

<?php
class IndexAction extends Action {
    public function index() {
        // 實例化視圖模型（D 方法自動識別 ViewModel 後綴）
        $dao = D('UserView');
        
        // 條件查詢（使用別名 u 避免衝突）
        $where['u.id'] = 1;
        $where['u.status'] = 1;
        
        // 查詢單條
        $user = $dao->where($where)->find();
        dump($user);
        
        // 查看生成的 SQL
        dump($dao->getLastSql());
        
        // 分頁列表
        $list = $dao->where(['u.status'=>1])->order('u.id DESC')->select();
        $this->assign('list', $list);
        $this->display();
    }
}
?>

輸出結果

array(5) {
  ["id"]      => "1"
  ["name"]    => "zzguo28"
  ["email"]   => "zzguo28@163.com"
  ["mobile"]  => "12345678901"
  ["dept_name"] => "銷售部"
}

生成 SQL

SELECT u.id AS id, u.name AS name, ui.email AS email, ui.mobile AS mobile, Dept.name AS dept_name
FROM tp_user u
LEFT JOIN tp_user_info ui ON ui.user_id = u.id
JOIN tp_dept Dept ON u.dept_id = Dept.id
WHERE ( u.id = 1 AND u.status = 1 )
LIMIT 1

進階用法

1. 支援所有連貫操作

視圖模型繼承 Model，完整支援：

$dao->where(...)->order(...)->limit(...)->page(...)->group(...)->having(...)->select();
$dao->count(); $dao->max('field'); $dao->sum('field');

2. 字段衝突自動處理

• 同名字段：使用 'field' => 'alias' 映射（如 'name' => 'dept_name'）。
• 未映射同名字段：後連接表字段會覆蓋前者（按定義順序），建議全部顯式列出所需字段並映射。

3. 動態擴展模型（ThinkPHP 3.2.3+ 推薦）

不再需要繼承 ViewModel 定義類，可在基礎模型中動態定義視圖：

<?php
// Lib/Model/UserModel.class.php
class UserModel extends Model {
    // 定義視圖關聯（public 屬性）
    public $viewFields = [
        'User'    => ['id','name','dept_id','_as'=>'u'],
        'UserInfo'=> ['email','mobile','_as'=>'ui','_on'=>'ui.user_id=u.id'],
        'Dept'    => ['name'=>'dept_name','_on'=>'u.dept_id=Dept.id'],
    ];
}

// 控制器
$dao = D('User');
$dao->setView(['User','UserInfo','Dept']); // 指定啟用的視圖
$user = $dao->find(1);

優點：單一模型類同時支援單表操作與多視圖查詢，更靈活。

4. 多視圖定義（同一模型不同關聯場景）

class UserModel extends Model {
    public $viewFields = [
        // 視圖 1：用戶+部門
        'withDept' => [
            'User' => ['id','name','dept_id','_as'=>'u'],
            'Dept' => ['name'=>'dept_name','_on'=>'u.dept_id=Dept.id'],
        ],
        // 視圖 2：用戶+詳細信息+部門
        'withInfoDept' => [
            'User'    => ['id','name','dept_id','_as'=>'u'],
            'UserInfo'=> ['email','mobile','_as'=>'ui','_on'=>'ui.user_id=u.id'],
            'Dept'    => ['name'=>'dept_name','_on'=>'u.dept_id=Dept.id'],
        ],
    ];
}

// 使用
D('User')->setView('withInfoDept')->find(1);

效能與最佳實踐

1. 只選所需字段

嚴禁 使用 '*' 或省略字段列表。明確列出每個表需要的字段，減少網絡傳輸、內存佔用、查詢時間。

2. 索引優化

• 確保 _on 條件中的關聯字段（外鍵）有索引：user_info.user_id, user.dept_id。
• WHERE 條件字段（如 u.status, u.id）建立索引。

3. 避免過度關聯

單個視圖模型關聯表建議 ≤ 5 張。超過則拆分為多個視圖或改用原生 SQL/查詢構建器。

4. 緩存熱點查詢

$user = S('user_view_'.$uid);
if (!$user) {
    $user = D('UserView')->find($uid);
    S('user_view_'.$uid, $user, 3600);
}

5. 寫操作限制

視圖模型主要用於讀取。寫入（add()/save()/delete()）行為未定義/不支援，請使用對應的基礎模型（D('User')、D('UserInfo')）進行寫入。

常見錯誤避坑

總結

ThinkPHP 視圖模型（ViewModel/動態 $viewFields）將多表 JOIN 封裝為可復用的「虛擬單表」，讓控制器代碼保持單表操作的簡潔性，同時享受關聯查詢的強大威力。核心優勢在於：字段別名映射解決衝突、_on/_type 靈活定義關聯、完整支援連貫操作、動態多視圖切換。生產環境務必遵循「只選所需字段、關聯字段建索引、讀寫分離（視圖讀/基礎模型寫）、熱點緩存」原則，發揮最大效能。