# 数据读取

在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方法使用。更多的查询方法可以参考[查询语言](#)章节。