Thinkphp 模型与表名定义_thinkphp8 model自定义表名-CSDN博客

本文详细介绍了ThinkPHP框架中模型数据表的定义方法，包括表前缀、表名、真实表名及数据库名的设置，适用于不同场景的数据表操作需求。

摘要生成于 C知道，由 DeepSeek-R1 满血版支持，前往体验 >

数据表定义

在ThinkPHP的模型里面，有几个关于数据表名称的属性定义：

属性	说明
tablePrefix	定义模型对应数据表的前缀，如果未定义则获取配置文件中的DB_PREFIX参数
tableName	不包含表前缀的数据表名称，一般情况下默认和模型名称相同，只有当你的表名和当前的模型类的名称不同的时候才需要定义。
trueTableName	包含前缀的数据表名称，也就是数据库中的实际表名，该名称无需设置，只有当上面的规则都不适用的情况或者特殊情况下才需要设置。
dbName	定义模型当前对应的数据库名称，只有当你当前的模型类对应的数据库名称和配置文件不同的时候才需要定义。

例如，在数据库里面有一个think_categories表，而我们定义的模型类名称是CategoryModel，按照系统的约定，这个模型的名称是Category，对应的数据表名称应该是think_category（全部小写），但是现在的数据表名称是think_categories，因此我们就需要设置tableName属性来改变默认的规则（假设我们已经在配置文件里面定义了DB_PREFIX 为 think_）。

namespace Home\Model;

use Think\Model;

class CategoryModel extends Model {

protected $tableName = 'categories';

}

注意这个属性的定义不需要加表的前缀think_

如果我们需要CategoryModel模型对应操作的数据表是 top_category，那么我们只需要设置数据表前缀即可：


namespace Home\Model;

use Think\Model;

class CategoryModel extends Model {

protected $tablePrefix = 'top_';

}

如果你的数据表直接就是category，而没有前缀，则可以设置tablePrefix为空字符串。

namespace Home\Model;

use Think\Model;

class CategoryModel extends Model {

protected $tablePrefix = '';

}

没有表前缀的情况必须设置，否则会获取当前配置文件中的 DB_PREFIX。

对于另外一种特殊情况，我们需要操作的数据表是top_categories，这个时候我们就需要定义 trueTableName 属性

namespace Home\Model;

use Think\Model;

class CategoryModel extends Model {

protected $trueTableName = 'top_categories';

}

注意trueTableName需要完整的表名定义。

除了数据表的定义外，还可以对数据库进行定义（用于操作当前数据库以外的数据表），例如 top.top_categories：

namespace Home\Model;

use Think\Model;

class CategoryModel extends Model {

protected $trueTableName = 'top_categories';

protected $dbName = 'top';

}

系统的规则下，tableName会转换为小写定义，但是trueTableName定义的数据表名称是保持原样。因此，如果你的数据表名称需要区分大小写的情况，那么可以通过设置trueTableName定义来解决。

实例化空模型类后还可以用table方法切换到具体的数据表进行操作：

$model = M();

$model ->table("top_user")->find();

来自tp手册。