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