ThinkPHP视图模型_ThinkPHP虚拟模型介绍【指南】-ThinkPHP-PHP中文网

viewmodel是thinkphp 3.2.x特有仅支持只读的虚拟模型，用于简化多表联合查询，不支持增删改，适用于跨表展示场景。

thinkphp视图模型_thinkphp虚拟模型介绍【指南】

ViewModel 不是数据库原生视图，也不是通用 ORM 的“视图层”，它是 ThinkPHP 3.2.x 特有的、用于简化多表只读查询的虚拟模型机制。它不支持写操作（add、save、delete），只适合做联合展示类需求。

为什么用 `ViewModel` 而不用关联模型？

当你要查「文章 + 分类名 + 作者昵称 + 标签列表」这类跨 3 张以上表、且只需读取、不需更新的场景时：
– has_one / belongs_to 关联模型会触发 N+1 查询，性能差；
– 手写 join SQL 又难维护、无法复用分页和自动字段映射；
– ViewModel 正好填补这个空档：一条定义，自动拼 LEFT JOIN，字段可重命名，支持 count 和 select。

`viewFields` 字段定义的顺序和语法陷阱

定义顺序直接影响 JOIN 类型作用范围，_type 只对紧随其后的表生效：

btpanel phpsite 宝塔面板PHP网站

宝塔面板 PHP 网站管理：站点创建、删除、启停、PHP 版本切换、域名管理、SSL证书管理、伪静态管理、数据库管理

下载

'article' => array('id', 'title', '_type' => 'LEFT') → 下一个表（如 cate）将用 LEFT JOIN
'cate' => array('name', '_on' => 'article.cateid=cate.id') → 这里 _on 必须写完整字段路径，不能省略别名，也不能写成 cateid=cate.id
若中间插入第三个表（如 user），需再显式加一次 _type，否则沿用上一个类型
字段别名要用数组键值对形式：'count(*)' => 'nums'，不能写成 'nums' => 'count(*)'

分页、统计、排序怎么写才不出错？

ViewModel 支持 count()、order()、limit()，但必须注意底层是单条 SQL，所以：

count() 默认统计主表行数，要统计关联后总条数需显式写 count('DISTINCT article.id') 或改用子查询
order 字段必须出现在 viewFields 中，否则 MySQL 会报 Unknown column
不能在 where 条件里直接用副表字段（如 cate.status = 1），得用 where('cate.status = 1') 字符串形式，否则框架会误判为条件绑定
如果用了 GROUP BY，必须手动设置 $this->options['group'] = 'article.id'，框架不自动识别

替代方案：什么时候该放弃 `ViewModel`？

遇到这些情况，硬套 ViewModel 反而更麻烦：

需要动态切换 JOIN 类型（比如有时 INNER，有时 LEFT）→ 改用 M()->table()->join()->select()
关联字段含函数或表达式（如 DATE_FORMAT(create_time, "%Y-%m")）→ viewFields 不支持表达式，只能手写 SQL
要同时查出一对多关系（如一篇文章带多个标签）→ ViewModel 是扁平结构，无法嵌套数组，得用关联模型或两次查询
项目已升级到 ThinkPHP 5/6 → 原生已无 ViewModel，改用 withJoin 或 Query Builder