thinkphp模型通过继承 think\model 类来定义，并在类中配置 name 和 table 属性以指定数据表。两者的核心区别在于： name 属性遵循自动推导规则，通常只需填写表名（不含前缀），系统会自动拼接数据库配置中的表前缀；而 table 属性则使用绝对完整的表名，直接覆盖自动推导逻辑，适用于跨库查询、视图或包含特殊字符的表名场景。
name 属性如何自动处理表前缀？
name 属性是 ThinkPHP 模型的默认约定，它允许开发者只关注业务表名，由框架自动完成前缀拼接。当你在模型中设置 protected $name = 'user'; 时，如果数据库配置中的前缀为 tp_，最终生成的 SQL 语句将指向 tp_user 表。这种机制简化了多环境部署时的配置管理，因为切换数据库或修改前缀时无需改动模型代码。若未显式定义 $name，ThinkPHP 会尝试根据模型类名（如 UserModel）自动推导表名，通常会去除后缀并转为小写蛇形命名。
namespace app\model;
use think\Model;
class User extends Model {
// 仅定义业务表名，前缀由配置决定
protected $name = 'user';
}上述代码定义了基础用户模型。假设配置文件中 prefix 为 tp_，则所有基于此模型的查询（如 User::select()）都将操作 tp_user 表。若配置变更为 prod_，同一代码将无缝切换至 prod_user，无需修改模型源码。
立即学习“PHP免费学习笔记（深入）”；
table 属性在什么情况下必须使用？
table 属性用于提供完全确定的表名，绕过框架的前缀推导机制。它在三种典型场景中不可或缺：一是查询非当前数据库的表（跨库操作），二是操作数据库视图或临时表，三是表名包含连字符等不符合常规命名规范的字符。设置 protected $table = 'other_db.user_info'; 后，所有对该模型的 CRUD 操作都将严格指向该完整路径，忽略任何全局或局部的前缀配置。这确保了在复杂架构下数据访问的精确性，避免因前缀冲突导致的错误。
namespace app\model;
use think\Model;
class OrderView extends Model {
// 指定完整表名，常用于视图或跨库表
protected $table = 'report.order_summary';
}该模型直接绑定到 report 数据库下的 order_summary 表。即使全局前缀设为 tp_，查询仍指向 report.order_summary，不会添加额外前缀。这在聚合报表或多租户系统中非常实用，确保数据源的唯一性和稳定性。
同时定义 name 和 table 时哪个生效？
当模型中同时存在 $name 和 $table 属性时， table 属性的优先级更高，将完全覆盖 $name 的推导结果。ThinkPHP 内部逻辑优先检查 $table，若其非空且为有效字符串，则直接使用；否则回退到 $name 进行前缀拼接。这种设计允许开发者在特定模型中强制指定表名，而不影响其他遵循默认约定的模型。例如，在一个混合应用中，大部分模型使用 $name 保持简洁，而少数涉及历史遗留表或视图的模型使用 $table 确保兼容性。
