# 数据读取 [上一页](# "上一页")[下一页](# "下一页") 在ThinkPHP中读取数据的方式很多，通常分为读取数据、读取数据集和读取字段值。 数据查询方法支持的连贯操作方法有： | 连贯操作 | 作用 | 支持的参数类型 | |-----|-----|-----| | where | 用于查询或者更新条件的定义 | 字符串、数组和对象 | | table | 用于定义要操作的数据表名称 | 字符串和数组 | | alias | 用于给当前数据表定义别名 | 字符串 | | field | 用于定义要查询的字段（支持字段排除） | 字符串和数组 | | order | 用于对结果排序 | 字符串和数组 | | group | 用于对查询的group支持 | 字符串 | | having | 用于对查询的having支持 | 字符串 | | join | 用于对查询的join支持 | 字符串和数组 | | union | 用于对查询的union支持 | 字符串、数组和对象 | | distinct | 用于查询的distinct支持 | 布尔值 | | lock | 用于数据库的锁机制 | 布尔值 | | cache | 用于查询缓存 | 支持多个参数 | | relation | 用于关联查询（需要关联模型支持） | 字符串 | | result | 用于返回数据转换 | 字符串 | | scope | 用于命名范围 | 字符串、数组 | | bind | 用于数据绑定操作 | 数组 | | comment | 用于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方法使用。更多的查询方法可以参考[查询语言](#)章节。 [上一页](# "上一页")[下一页](# "下一页")