版本 调整功能
5.0.19 模型增加readMaster方法用于后续都从主库读取

获取单个数据

获取单个数据的方法包括:

取出主键为1的数据
$user = User::get(1);
echo $user->name;

// 使用数组查询
$user = User::get(['name' => 'thinkphp']);

// 使用闭包查询
$user = User::get(function($query){
    $query->where('name', 'thinkphp');
});
echo $user->name;

如果你是在模型内部,请不要使用$this->name的方式来获取数据,请使用$this->getAttr('name') 替代。

或者在实例化模型后调用查询方法

$user = new User();
// 查询单个数据
$user->where('name', 'thinkphp')
    ->find();

get或者find方法返回的是当前模型的对象实例,可以使用模型的方法。

获取多个数据

版本 新增功能
5.0.4 支持在模型中设置resultSetType返回数据集对象的名称

取出多个数据:

// 根据主键获取多个数据
$list = User::all('1,2,3');
// 或者使用数组
$list = User::all([1,2,3]);
foreach($list as $key=>$user){
    echo $user->name;
}
// 使用数组查询
$list = User::all(['status'=>1]);
// 使用闭包查询 不能使用变量 比如where('status', $id)
$list = User::all(function($query){
    $query->where('status', 1)->limit(3)->order('id', 'asc');
});
foreach($list as $key=>$user){
    echo $user->name;
}

数组方式和闭包方式的数据查询的区别在于,数组方式只能定义查询条件,闭包方式可以支持更多的连贯操作,包括排序、数量限制等。

或者在实例化模型后调用查询方法

$user = new User();
// 查询数据集
$user->where('name', 'thinkphp')
    ->limit(10)
    ->order('id', 'desc')
    ->field('rank','weiyue')
    ->select();

模型的all方法或者select方法返回的是一个包含模型对象的二维数组或者数据集对象。

自定义数据集对象

V5.0.4+版本开始,支持在模型中单独设置查询数据集的返回对象的名称(默认是数组),例如:

<?php
namespace app\index\model;

use think\Model;

class User extends Model
{
	// 设置返回数据集的对象名
	protected $resultSetType = 'collection';
}

resultSetType字段如果为空则使用数组作为数据集返回类型,如果设置为collection则表示使用think\Collection作为返回对象名,也可以设置自定义的数据集对象名称(使用完整的命名空间定义)。

获取某个字段或者某个列的值

// 获取某个用户的积分
User::where('id',10)->value('score');
// 获取某个列的所有值
User::where('status',1)->column('name');
// 以id为索引
Member::where('mid',2)->column('nickname','mid');//  3 => string '李白'
User::where('status',1)->column('name','id'); 
User::where('status',1)->column('id,name'); // 同tp3的getField

注意valuecolumn方法返回的不再是一个模型对象实例,而是单纯的值或者某个列的数组。

动态查询

支持动态查询方法,例如:

// 根据name字段查询用户
$user = User::getByName('thinkphp');

// 根据email字段查询用户
$user = User::getByEmail('thinkphp@qq.com');

通过Query类查询

或者使用数据库的查询方法进行更复杂的查询:

User::where('id','>',10)->select();
User::where('name','thinkphp')->find();
User::where('name','thinkphp')->whereor('email','123@qq.com')->select();

可以在模型中直接使用所有数据库的链式操作方法。

返回的查询结果是当前模型对应的对象或者包含模型对象的数据集。

数据分批处理

模型也可以支持对返回的数据分批处理,这在处理大量数据的时候非常有用,例如:

User::chunk(100,function($users){
    foreach($users as $user){
        // 处理user模型对象
    }
});

更多的分批处理用法,可以参考数据库的查询数据部分。

查询缓存

get方法和all方法的第三个参数表示是否使用查询缓存,或者设置缓存标识。

$user = User::get(1,'',true);
$list  = User::all('1,2,3','',true);

由于第二个参数是关联预载入定义,V5.0.6+版本开始,可以直接在第二个参数传入true表示开启查询缓存。

主库读取

如果你采用分布式数据库,如果写入数据后立刻进行该数据的读取,将会导致数据读取失败,原因是数据库同步尚未完成。

规范的解决方案是在写入数据后,不要马上从从库读取,而应该调用master方法读取主库。

$user           = new User;
$user->name     = 'thinkphp';
$user->email    = 'thinkphp@qq.com';
$user->save();
// 从主库读取数据
$user->master()->get($user->id);

V5.0.19+版本开始,你可以在数据库配置文件中设置

// 主库写入后从主从库读取
'read_master'	=> true

设置开启后,一旦你的模型写入数据,那么该请求后续的模型读取操作都会自动读取主库。

或者可以在你完成主库写入操作后,执行下模型类的readMaster方法

$user           = new User;
$user->name     = 'thinkphp';
$user->email    = 'thinkphp@qq.com';
$user->readMaster()->save();
// 后续该模型的操作从主库读取数据

也可以支持后续所有模型的查询都在主库

$user           = new User;
$user->name     = 'thinkphp';
$user->email    = 'thinkphp@qq.com';
$user->readMaster(true)->save();
// 后续该模型的操作从主库读取数据

注意上述设置和方法仅对模型查询有效,直接调用Db类查询无效。