ThinkPHP 读取数据

在ThinkPHP中读取数据的方式很多，通常分为读取数据、读取数据集和读取字段值。

数据查询方法支持的连贯操作方法有：

连贯操作	作用	支持的参数类型
where	用于查询或者更新条件的定义	字符串、数组和对象
table	用于定义要操作的数据表名称	字符串和数组
alias	用于给当前数据表定义别名	字符串
field	用于定义要查询的字段（支持字段排除）	字符串和数组
order	用于对结果排序	字符串和数组
group	用于对查询的group支持	字符串
having	用于对查询的having支持	字符串
join	用于对查询的join支持	字符串和数组
union	用于对查询的union支持	字符串、数组和对象
distinct	用于查询的distinct支持	布尔值
lock	用于数据库的锁机制	布尔值
cache	用于查询缓存	支持多个参数
relation	用于关联查询（需要关联模型支持）	字符串
result	用于返回数据转换	字符串
scope	用于命名范围	字符串、数组
bind	用于数据绑定操作	数组
comment	用于SQL注释	字符串
fetchSql	不执行SQL而只是返回SQL	布尔值

注意：某些情况下有些连贯操作是无效的，例如limit方法对find方法是无效的。

读取数据

读取数据是指读取数据表中的一行数据（或者关联数据），主要通过find方法完成，例如：

$User = M("User"); // 实例化User对象
// 查找status值为1name值为think的用户数据
$data = $User->where('status=1 AND name="thinkphp"')->find();
dump($data);

find方法查询数据的时候可以配合相关的连贯操作方法，其中最关键的则是where方法，如何使用where方法我们会在查询语言章节中详细描述。

如果查询出错，find方法返回false，如果查询结果为空返回NULL，查询成功则返回一个关联数组（键值是字段名或者别名）。如果上面的查询成功的话，会输出：

array (size=3)
'name' => string 'thinkphp' (length=8)
'email' => string 'thinkphp@gmail.com' (length=18)
'status'=> int 1

即使满足条件的数据不止一个，find方法也只会返回第一条记录（可以通过order方法排序后查询）。

还可以用data方法获取查询后的数据对象（查询成功后）

$User = M("User"); // 实例化User对象
// 查找status值为1name值为think的用户数据
$User->where('status=1 AND name="thinkphp"')->find();
dump($User->data());

读取数据集

读取数据集其实就是获取数据表中的多行记录（以及关联数据），使用select方法，使用示例：

$User = M("User"); // 实例化User对象
// 查找status值为1的用户数据以创建时间排序返回10条数据
$list = $User->where('status=1')->order('create_time')->limit(10)->select();

如果查询出错，select的返回值是false，如果查询结果为空，则返回NULL，否则返回二维数组。

读取字段值

读取字段值其实就是获取数据表中的某个列的多个或者单个数据，最常用的方法是 getField方法。

示例如下：

$User = M("User"); // 实例化User对象
// 获取ID为3的用户的昵称
$nickname = $User->where('id=3')->getField('nickname');

默认情况下，当只有一个字段的时候，返回满足条件的数据表中的该字段的第一行的值。

如果需要返回整个列的数据，可以用：

$User->getField('id',true); // 获取id数组
//返回数据格式如array(1,2,3,4,5)一维数组，其中value就是id列的每行的值

如果传入多个字段的话，默认返回一个关联数组：

$User = M("User"); // 实例化User对象
// 获取所有用户的ID和昵称列表
$list = $User->getField('id,nickname');
//两个字段的情况下返回的是array(`id`=>`nickname`)的关联数组，以id的值为key，nickname字段值为value

这样返回的list是一个数组，键名是用户的id字段的值，键值是用户的昵称nickname。

如果传入多个字段的名称，例如：

$list = $User->getField('id,nickname,email');
//返回的数组格式是array(`id`=>array(`id`=>value,`nickname`=>value,`email`=>value))是一个二维数组，key还是id字段的值，但value是整行的array数组，类似于select()方法的结果遍历将id的值设为数组key

返回的是一个二维数组，类似select方法的返回结果，区别的是这个二维数组的键名是用户的id（准确的说是getField方法的第一个字段名）。

如果我们传入一个字符串分隔符：

$list = $User->getField('id,nickname,email',':');

那么返回的结果就是一个数组，键名是用户id，键值是 nickname:email的输出字符串。

getField方法还可以支持限制数量，例如：

$this->getField('id,name',5); // 限制返回5条记录
$this->getField('id',3); // 获取id数组限制3条记录

可以配合使用order方法使用。更多的查询方法可以参考查询语言章节。