Thinkphp5使用model模型操作数据库

thinkphp标准数据表设计：
创建时间字段：create_time

更新时间字段：update_time

删除时间字段：delete_time

类型选int，如下图：

一、创建model的文件夹
在application文件夹下的二级对象目录中新建名为model的文件夹，该文件夹与对应的controller和view目录同级，

如下图：

如果有多个模块（比如前台index，后台admin），操作的数据库都差不多，

那么可以把model模型放到common公共模块里，如下：

二、创建model模型类
1、在model目录下创建model对象文件，一般model的名字和表名是对应的，例如：

表名 pre_user ---------------> 模型名 User.php
表名 pre_user_info ---------------> 模型名 UserInfo.php
2、定义model模型

<?php
namespace app\index\model;
use think\Model;
use think\Db;

class User extends Model{
/**
* 定义变量
* 1.变量名称应与数据表中的字段名相同
* 2.此处可根据需求省略，因为如果没有，thinkphp会自动在数据表中寻找的对应字段名
*/
public $username;
public $password;
}
?>
3、如果数据模型定义名和表名不一致，那么就需要额外定义和声明，如下：

<?php
namespace app\index\model;
use think\Model;
use think\Db;

class User extends Model
{
protected $table = "admin_user";//指定数据表名
protected $pk = 'id'; //指定主键的字段
}
?>
三、调用model模型的方法
//导入定义的数据模型类
use \app\index\model\User;

//方法一：
$res = User::get(1);

//方法二：
$user = new User;
$res = $user::get(1);

//方法三：
use think\Loader;
$user = Loader::model("User");
$res = $user::get(1);

//方法四：
$user = model("User");
$res = $user::get(1);
四、查询操作
get 获取一条记录

$res = User::get(1);
all 获取多条记录

1、不传参

$result = User::all(); //查询出所有记录
2、参数为n，n为正整数

$result = User::all(1); //查询出id为1的记录
3、参数为'n1, n2, n3...'

$result = User::all('7, 8, 9, 10'); //查询出id为7、8、9、10的4条记录
4、参数为[n1, n2, n3...]

$result = User::all([7, 8, 9, 10]); //查询出id为7、8、9、10的4条记录
find 查询某一条

$res = User::where('id','1')->field('name')->find();
不等于

->where('id','neq',1)

select 多条查询

$res = User::where('id','1')->field('name')->limit(2)->order('id DESC')->select();
value 按字段查询一条

$res = User::where('id','1')->value('name');
将结果转换成数组

$res = $res->toArray();
查询数目

//查询总条数
$res = User::count();
//按条件统计条数
$res = User::where('id','>',3)->count();
whereTime() 时间条件查询
1、获取今天的信息

db('table')->whereTime('c_time', 'today')->select();
//也可以简化为下面方式
db('table')->whereTime('c_time', 'd')->select();
2、获取昨天的信息

db('table')->whereTime('c_time', 'yesterday')->select();
3、获取本周的信息

db('table')->whereTime('c_time', 'week')->select();
//也可以简化为下面方式
db('table')->whereTime('c_time', 'w')->select();
4、获取本月的信息

db('table')->whereTime('c_time', 'month')->select();
//也可以简化为下面方式
db('table')->whereTime('c_time', 'm')->select();
5、获取上月的信息

db('table')->whereTime('c_time','last month')->select();
6、获取今年的信息

db('table')->whereTime('c_time', 'year')->select();
//也可以简化为下面方式
db('table')->whereTime('c_time', 'y')->select();
7、获取去年的信息

db('table')->whereTime('c_time','last year')->select();
8、日期区间查询

//根据时间戳查询今天到后天
db('table')->whereTime('time', 'between', [strtotime(date('Y-m-d')), strtotime(date('Y-m-d', strtotime('+2 day')))])->select();
根据日期查询今天到后天
db('table')->whereTime('time', 'between', ['2020-3-28', '2020-3-30'])->select();
五、添加操作
1、使用create()方法添加

$res = User::create([
'name' => '安阳',
'age' => 23,
'sex' => 1,
'password' => '123456'
]);
2、添加数据，并返回添加的主键

$uid=UserModel::create([
'name' => '安阳',
'age' => 23,
'sex' => 1,
'password' => '123456'
])->id;
也可以使用DB类的insertGetId方法，如下：

$uid = User::insertGetId([
'name' => '安阳',
'age' => 23,
'sex' => 1,
'password' => '123456'
]);
3、实例化方式添加

$user = new User;
$user->name = '安阳';
$user->age = 23;
$user->save();
4、实例化方式过滤插入字段，返回插入行数

$user = new User;
$data = [
'name' => '安阳',
'age' => 23,
'email' => '123456@qq.com'
];
//只有name和age字段会写入
$res = $user->allowField(['name', 'age'])->save($data);
5、模型使用allowField()过滤非数据表字段的数据

//定义模型对象，并传入post数据
$user = new User($_POST);
//过滤post数组中的非数据表字段数据
$user->allowField(true)->save();
6、模型使用allowField()指定某些字段写入

$user = new User;
// post数组中只有name和email字段会写入
$user->allowField(['name','email'])->save($_POST, ['id' => 1]);
7、批量添加使用saveAll()

user = new User;
$list = [
['name'=>'安阳','email'=>'thinkphp@qq.com'],
['name'=>'小柒','email'=>'12345678@qq.com']
];
$user->saveAll($list);
也可以使用DB类的insertAll()方法，返回添加成功的条数

$res = User::insertAll([
'name' => '安阳',
'age' => 23,
'sex' => 1,
'password' => '123456'
]);
补充，过滤字段的其他方法：

1、在DB操作中，可以使用 strict 关闭字段严格检查

Db::name(‘user’)->strict(false)->insert($data);
2、使用php的 unset() 方法销毁变量

unset($data[‘file’]);
6、saveAll添加多条数据，返回对象列表

$user = new User;
$data = [
[
'name' => '安阳',
'age' => 20,
'email' => '123456@qq.com'
],
[
'name' => '小柒',
'age' => 25,
'email' => 'ap555@qq.com'
]
];
$res = $user->allowField(['name', 'age'])->saveAll($data);
六、更新操作
1、update 返回影响行数

$res = User::where(['id'=>1])->update(['name'=>'安阳']);
2、setField 单独更新某个字段

User::where('id',1)->setField('name','安阳');
3、setInc

//setInc('money',10)表示将money字段加上10
User::where(['id'=>1])->setInc('money', 10);
4、setDec

//setDec('money',10)表示将money字段减去10
User::where(['id'=>1])->setDec('money', 10);
5、批量更新，要求数据中含有主键，返回更新对象列表

$user = new User;
$res = $user->saveAll([
['id'=>1, 'name' => '安阳'],
['id'=>2, 'name' => '小柒']
]);
七、删除操作
1、传入主键，返回影响行数

$res = User::destroy(1);
2、传入条件，返回影响行数

$res = User::destroy(['name'=>'安阳']);
3、条件删除返回影响行数

$res = User::where(['id'=>1])->delete();
八、事务
1、自动控制事务处理

Db::transaction(function(){
Db::table('order')->where(['id'=>1])->delete();
Db::table('user')->where('id'=>1)->setInc('money',10);
});
2、手动控制事务

Db::startTrans();//启动事务
try {
Order::where(['id'=>1])->delete();
User::where('id'=>1)->setInc('money',10);
Db::commit();//提交事务
} catch (Exception $e) {
Db::rollback(); //回滚
}
九、model模型的获取器
读取器的命名规范是：->get + 属性名的驼峰命名 + Attr

<?php
namespace app\index\model;
use think\Model;
class User extends Model
{
//获取器：将性别的012修改为男、女、未知返回
public function getSexAttr($val)
{
switch ($val) {
case 1:
return '男';
case 2:
return '女';
default:
return '未知';
}
}
//获取器：格式化时间戳后返回
public function getUpdateTimeAttr($val){
if(!empty($val)){
//如果是时间戳，就格式化
if(!strtotime($val)) {
return date('Y-m-d H:i:s',$val);
}else{
return $val;
}
}else{
return '';
}
}
}
补充说明：strtotime()将任何英文文本的日期时间描述解析为Unix 时间戳,成功则返回时间戳，否则返回 FALSE（在 PHP 5.1.0之前本函数在失败时返回 -1）

十、model模型的修改器
<?php
namespace app\index\model;
use think\Model;
class User extends Model
{
//修改器
public function setTimeAttr()
{
return time();
}
/** 修改器：对密码字段加密之后存储
* $val 第一个参数是密码
* $data 第二个参数是添加的数据（可选）
*/
public function setPasswordAttr($val,$data){
if($val === '') {
return $val;
}else{
return md5($val.$data['email']);
}
}
}
十一、model模型的自动完成
auto 新增及更新的时候，自动完成的属性数组
insert 仅新增的时候，自动完成的属性数组
update 仅更新的时候，自动完成的属性数组

1、自动完成

<?php
namespace app\index\model;
use think\Model;
class User extends Model
{
//添加和修改时，都会自动完成的字段
protected $auto = ['addtime'];

public function setAddtimeAttr(){
return time();
}
}
2、添加数据时，自动完成

<?php
namespace app\index\model;
use think\Model;
class User extends Model
{
// 新增自动完成
protected $insert = ['addtime'];

public function setAddtimeAttr(){
return time();
}
}
3、更新数据时，自动完成：

<?php
namespace app\index\model;
use think\Model;
class User extends Model
{
// 更新自动完成
protected $update = ['addtime'];

public function setAddtimeAttr(){
return time();
}
}
十二、自动完成时间戳
在数据库配置文件database.php中，有下列这项配置：

//自动写入时间戳字段
'auto_timestamp' => false,
//如果开启（设置为true），则会自动完成所有表的时间戳，但是不建议这样，只在需要的地方设置更安全。
例如对用户表的时间戳自动完成，就在User的model中设置：

<?php
namespace app\index\model;
use think\Model;

class User extends Model{
//开启自动完成时间戳功能
protected $autoWriteTimestamp = true;
//开启后，
//添加数据时，默认自动完成的字段是：create_time和update_time
//修改数据时，默认自动完成的字段是：update_time

//如果数据表里不是这两个字段，则会报错。需要进行如下修改：
protected $createTime = 'addtime';//修改默认的添加时间字段
protected $updateTime = 'updtime';//修改默认的修改时间字段
protected $updateTime = false;//当不需要这个字段时设置为false
}
Thinkphp更新时，自动更新update_time字段时间戳的方法：
1、使用update

User::update(['name'=>'安阳'],['id'=>1]);
Thinkphp中update方法的源代码如下：

/**
* 更新数据
* @access public
* @param array $data 数据数组
* @param array $where 更新条件
* @param array|true $field 允许字段
* @return $this
*/
public static function update($data = [], $where = [], $field = null)
{
$model = new static();
if (!empty($field)) {
$model->allowField($field);
}
$result = $model->isUpdate(true)->save($data, $where);
return $model;
}
2、使用save

$user=new User;
$user->isUpdate(true)->save(['name'=>'安阳'],['id'=>1]);

十三、软删除
什么是软删除？

当删除某些记录时，有时我们需要假删除，只通过修改某个字段状态来标记该记录已删除，但实际上，数据库中还是存在这些记录的。假删除的应用场景还是比较多的，例如支付宝的收款记录，我们在APP上删除后，就不会再显示出来，你是不是以为真的删掉了，不会再留下任何痕迹？非也，非也，删除支付宝收款记录只是软删除，在支付宝的数据库中，实际上还保留有这些收款记录，如果你的收款涉嫌违规或者触犯法律，警方还是能通过支付宝的网警后台查看到的。

1、开启软删除

<?php
namespace app\index\model;
use think\Model;
use traits\model\SoftDelete;//引入软删除的类

class Order extends Model{
//使用软删除
//删除时，默认更新的字段是delete_time
use SoftDelete;
//如果数据表里不是delete_time这个字段，则会报错。需要进行如下修改：
protected $deleteTime = 'deltime';
}
2、控制器里软删除，返回影响的行数