版本 | 调整功能 |
---|---|
5.0.5 | model 或者Loader::model 方法支持传入完整的模型类名 |
模型定义
定义一个User模型类:
namespace appindexmodel;
use thinkModel;
class User extends Model
{
}
默认主键为自动识别,如果需要指定,可以设置属性:
namespace appindexmodel;
use thinkModel;
class User extends Model
{
protected $pk = "uid";
}
模型会自动对应数据表,模型类的命名规则是除去表前缀的数据表名称,采用驼峰法命名,并且首字母大写,例如:
模型名 | 约定对应数据表(假设数据库的前缀定义是 think_) |
---|---|
User | think_user |
UserType | think_user_type |
如果你的规则和上面的系统约定不符合,那么需要设置Model类的数据表名称属性,以确保能够找到对应的数据表。
设置数据表
如果你想指定数据表甚至数据库连接的话,可以使用:
namespace appindexmodel;
class User extends hinkModel
{
// 设置当前模型对应的完整数据表名称
protected $table = "think_user";
// 设置当前模型的数据库连接
protected $connection = [
// 数据库类型
"type" => "mysql",
// 服务器地址
"hostname" => "127.0.0.1",
// 数据库名
"database" => "thinkphp",
// 数据库用户名
"username" => "root",
// 数据库密码
"password" => "",
// 数据库编码默认采用utf8
"charset" => "utf8",
// 数据库表前缀
"prefix" => "think_",
// 数据库调试模式
"debug" => false,
];
}
和连接数据库的参数一样,connection
属性的值也可以设置为数据库的配置参数,而且也是官方推荐的方式,这样可以避免把数据库连接固化在代码里面。
5.0不支持单独设置当前模型的数据表前缀。
模型调用
模型类可以使用静态调用或者实例化调用两种方式,例如:
// 静态调用
$user = User::get(1);
$user->name = "thinkphp";
$user->save();
// 实例化模型
$user = new User;
$user->name= "thinkphp";
$user->save();
// 使用 Loader 类实例化(单例)
$user = Loader::model("User");
// 或者使用助手函数`model`
$user = model("User");
$user->name= "thinkphp";
$user->save();
实例化模型类主要用于调用模型的自定义方法,更多用法参考后面的章节内容。