在ThinkPHP3.2.3的模型里面,有几个关于数据表名称的属性定义:
属性 | 说明 |
---|---|
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定义来解决。