> ThinkPHP5手册 > 查询

查询


获取单个数据

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

取出主键为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]);
// 使用闭包查询
$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')
    ->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为索引
User::where('status',1)->column('name','id');

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

动态查询

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

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

// 根据email字段查询用户
$user = User::getByEmail('[email protected]');

通过Query类查询

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

User::where('id','>',10)->select();
User::where('name','thinkphp')->find();

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

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

数据分批处理

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

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

上一篇:
下一篇: