ThinkPHP中数据库操作返回值总结

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

  1. Create操作:create()(非链式) 、add()、addAll()支持的链式操作有:table 、data、field 、relation 、validate、auto 、filter、scope 、bind 、token 、comment

  2. Update操作save()、setField()、setInc()、setDec()支持的链式操作有:where、table 、alias、field、order、lock 、relation 、scope 、bind 、comment

  3. 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

  4. 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操作

  1. create 返回值:若发生错误,返回false;
    成功则返回创建的数据create为非链式操作,返回值为可能为布尔值,所以操作时要进行严格判断:
$User = M("User");

if($User->create()){

//进行更多操作

}
  1. add 返回值,addAll 返回值成功:如果主键是自动增长型,返回值为新增记录Id值(addAll为最大值),否 则返回true;发生错误返回 false;

3. update操作

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

4. read操作

  1. find 返回值如果查询出错,find的返回值为false如果查询结果为空返回NULL,查询成功则返回一个关联数组(键值是字段名或者别名)。

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

  3. getField 返回值

  4. 如果查询出错,getField的返回值为false

  5. 查询成功:

  6. getField($field):$field为一个字段,返回[数据库]中该字段的第一行的值

  7. getField($field,true):$field为一个字段,返回包含该字段的一维数组

  8. getField($fields):$fields为两个字段(以“,”隔开),返回array($field1=>$field2)的数组;若$field为多个字段,返回类似select的多维数组,键名为field1。

  9. getField($fields,”:”):$field为多个字段,返回类似array($field1=>”$field2:$field3”)的数组

  10. Count 、Max、Min 、Avg 、Sum返回值如果查询出错,返回值为false查询成功,则返回对应的值

5. Delete操作

delete 返回值:成功则返回true,查询错误则返回false

你可能感兴趣的:(ThinkPHP中数据库操作返回值总结)