ThinkPHP中数据库操作返回值的相关内容总结

程序员文章站 2022-03-30 22:10:59

...

转载自：ThinkPHP中数据库操作返回值总结

关键字： Thinkphp,返回值,数据库操作,select返回值,add返回值,setDec返回值

Thinkphp中的Think\Model类提供了数据库的基本CURD（Create、Update、Read及Delete），通过该类可以很便捷的进行操作。
Model类及扩展类主要的方法有：

Create操作：
create()（非链式）、add()、addAll()
支持的链式操作有：
table 、data、field 、relation 、validate、auto 、filter、scope 、bind 、token 、comment
Update操作
save()、setField()、setInc()、setDec()
支持的链式操作有：
where、table 、alias、field、order、lock 、relation 、scope 、bind 、comment
Read操作
find()、select()、getField()、Count 、Max、Min 、Avg 、Sum
支持的链式操作有：
where 、table 、alias 、field 、order、group 、having 、join 、union 、distinct、lock、cache 、relation 、result 、scope 、bind 、comment
Delete操作
delete()
支持的链式操作有：
where 、table 、alias 、order、lock 、relation 、scope 、bind 、comment

这些方法的可能的返回值有false/true/一位数组/二维数组/numeric(数字)/null/类本身的实例，现在就总结如下：

1、链式操作：

所以链式操作都返回Model类的实例，即可以使用该返回值继续调用实例方法。

$User=M("User");
$U1=$User->$where("id = 1");//$U1可以继续调用其他方法。
$result=$U1->select();
//-------一般情况下没有必要这样，下面一句代码即可实现
$result=M("User")->$where("id = 1")->select();

2、Create操作

create 返回值：

若发生错误，返回false；

成功则返回创建的数据
create为非链式操作，返回值为可能为布尔值，所以操作时要进行严格判断：

$User = M("User");
if($User->create()){
//进行更多操作
}

add 返回值，addAll 返回值

成功：如果主键是自动增长型，返回值为新增记录Id值（addAll为最大值），否则返回true；
发生错误返回 false；

3、update操作

save 返回值（setField、setInc、setDec最后调用的都是save方法，所以返回值与save一致）：
save 返回值是影响的记录数（有可能为0），更新出错返回false，因此一定要用恒等来判断是否更新失败。

4、read操作

find 返回值
如果查询出错，find的返回值为false
如果查询结果为空返回NULL，查询成功则返回一个关联数组（键值是字段名或者别名）。
select 返回值
如果查询出错，select的返回值是false，
如果查询结果为空，则返回NULL，否则返回二维数组。
getField 返回值

getField($field):$field为一个字段,返回数据库中该字段的第一行的值
getField($field,true):$field为一个字段,返回包含该字段的一维数组
getField($fields):$fields为两个字段（以“,”隔开），返回array($field1=>$field2)的数组;若$field为多个字段，返回类似select的多维数组,键名为field1。
getField($fields,”:”):$field为多个字段,返回类似array($field1=>”$field2:$field3”)的数组
如果查询出错，getField的返回值为false
查询成功：