PHP完全自学手册(珍藏版) 中文pdf扫描版下载
连贯操作仅在当次查询或者操作有效,完成后会自动清空连贯操作的所有传值(有个别特殊的连贯操作会记录当前的传值,如cache连贯操作)。简而言之,连贯操作的结果不会带入以后的查询。
系统支持的连贯操作方法有:
方法 作用 支持的参数类型
where 用于查询或者更新条件的定义 字符串、数组和对象
table 用于定义要操作的数据表名称 字符串和数组
alias 用于给当前数据表定义别名 字符串
data 用于新增或者更新数据之前的数据对象赋值 数组和对象
field 用于定义要查询的字段(支持字段排除) 字符串和数组
order 用于对结果排序 字符串和数组
limit 用于限制查询结果数量 字符串和数字
page 用于查询分页(内部会转换成limit) 字符串和数字
group 用于对查询的group支持 字符串
having 用于对查询的having支持 字符串
join* 用于对查询的join支持 字符串和数组
union* 用于对查询的union支持 字符串、数组和对象
distinct 用于查询的distinct支持 布尔值
lock 用于数据库的锁机制 布尔值
cache 用于查询缓存 支持多个参数(以后在缓存部分再详细描述)
relation 用于关联查询(需要关联模型扩展支持) 字符串
validate 用于数据自动验证 数组
auto 用于数据自动完成 数组
filter 用于数据过滤 字符串
scope* 用于命名范围 字符串、数组
所有的连贯操作都返回当前的模型实例对象(this),其中带*标识的表示支持多次调用。
用法
TABLE 定义要操作的数据表名称,动态改变当前操作的数据表名称,需要写数据表的全名,包含前缀,可以使用别名和跨库操作
可以在table方法中跨库操作,例如:
$Model->Table('db_name.think_user user')->where('status>1')->select();
Table方法的参数支持字符串和数组,数组方式的用法:
$Model->Table(array('think_user'=>'user','think_group'=>'group'))->where('status>1')->select();
DATA 可以用于新增或者保存数据之前的数据对象赋值
用法 data($data)
参数 data(必须):数据,支持数组和对象
返回值 当前模型实例
备注 如果不调用data方法,则会取当前的数据对象或者传入add和save的数
$Model->data($data)->add();
$Model->data($data)->where('id=3')->save();
Data方法的参数支持对象和数组,如果是对象会自动转换成数组。如果不定义data方法赋值,也可以使用create方法或者手动给数据对象赋值的方式。
模型的data方法除了创建数据对象之外,还可以读取当前的数据对象,
例如:
-
$this->find(3);
-
$data = $this->data();
FIELD 用于定义要查询的字段
用法 field($field,$except=false)
参数
field(必须):字段名,支持字符串和数组,支持指定字段别名;如果为true则表示显式或者数据表的所有字段。
except(可选):是否排除,默认为false,如果为true表示定义的字段为数据表中排除field参数定义之外的所有字段。
返回值 当前模型实例
备注 如果不调用field方法,则默认返回所有字段,和field('*')等效
如果不调用field方法或者field方法传入参数为空的话,和使用field('*')是等效的。
如果需要显式的传入所有的字段,可以使用下面的方法:
$Model->field(true)->select();
但是我们更建议只获取需要显式的字段名,或者采用字段排除方式来定义,例如:
$Model->field('status',true)->select(); //表示获取除了status之外的所有字段。
ORDER 用于对操作结果排序
用法 order($order)
参数 order(必须):排序的字段名,支持字符串和数组,支持多个字段排序
返回值 当前模型实例
备注 如果不调用order方法,按照数据库的默认规则
order('status desc,id asc') //排序方法支持对多个字段的排序
order(array('status'=>'desc','id')) //order方法的参数支持字符串和数组
LIMIT 用于定义要查询的结果限制(支持所有的数据库类型)
limit('10') 等效于 limit('0,10')
PAGE 用于定义要查询的数据分页
用法 page($page)
参数 page(必须):分页,支持字符串
返回值 当前模型实例
Page操作方法可以更加快速的进行分页查询。
Page方法的用法和limit方法类似,格式为: Page('page[,listRows]')
Page表示当前的页数,listRows表示每页显示的记录数。
Page('2,10') //表示每页显示10条记录的情况下面,获取第2页的数据。
listRow如果不写的话,会读取limit('length') 的值,例如:
limit(25)->page(3); //表示每页显示25条记录的情况下面,获取第3页的数据。
如果limit也没有设置的话,则默认为每页显示20条记录。
page方法也支持传入二个参数,例如:
$this->page(5,25)->select(); 等效于 $this->page('5,25')->select();
GROUP 用于数据库的group查询支持,Group方法的参数只支持字符串
group('user_id')
HAVING having方法的参数只支持字符串
用法 having($having)
参数 having(必须):having,支持字符串
返回值 当前模型实例
转载请注明:谷谷点程序 » ThinkPHP连贯操作