查询

获取单个数据

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

取出主键为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方法返回的是当前模型的对象实例，可以使用模型的方法。

获取多个数据

取出多个数据：

// 根据主键获取多个数据
$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 appindexmodel;

use thinkModel;

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

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

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

// 获取某个用户的积分
User::where("id",10)->value("score");
// 获取某个列的所有值
User::where("status",1)->column("name");
// 以id为索引
User::where("status",1)->column("name","id");
User::where("status",1)->column("id,name"); // 同tp3的getField

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

动态查询

支持动态查询方法，例如：

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

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

通过Query类查询

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

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

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

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

数据分批处理

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

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表示开启查询缓存。