ThinkPHP3.1快速入门（4）连贯操作

上一篇我们详细描述了查询语言的用法，但是查询语言仅仅解决了查询或者操作条件的问题，更多的配合还需要使用模型提供的连贯操作方法。


介绍

连贯操作可以有效的提高数据存取的代码清晰度和开发效率，并且支持所有的CURD操作，也是ThinkPHP的ORM中的一个亮点。使用也比较简单， 假如我们现在要查询一个User表的满足状态为1的前10条记录，并希望按照用户的创建时间排序 ，代码如下：

  1. $User->where('status=1')->order('create_time')->limit(10)->select();

这里的where、order和limit方法就称之为连贯操作方法，除了select方法必须放到最后一个外（因为select方法并不是连贯操作方法），连贯操作的方法调用顺序没有先后，例如，下面的代码和上面的等效：

  1. $User->order('create_time')->limit(10)->where('status=1')->select();

其实不仅仅是查询方法可以使用连贯操作，包括所有的CURD方法都可以使用，例如：

  1. $User->where('id=1')->field('id,name,email')->find(); 
  2. $User->where('status=1 and id=1')->delete();

连贯操作仅在当次查询或者操作有效，完成后会自动清空连贯操作的所有传值（有个别特殊的连贯操作会记录当前的传值，如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），其中带*标识的表示支持多次调用。


用法

由于连贯操作的使用往往涉及到多个方法的联合使用，下面大概介绍下各个连贯操作的基本用法：

WHERE

where 用于查询或者更新条件的定义
用法 where($where)
参数 where（必须）：查询或者操作条件，支持字符串、数组和对象
返回值 当前模型实例
备注 如果不调用where方法，默认不会执行更新和删除操作

Where方法是使用最多的连贯操作方法，更详细的用法请参考：快速入门（3）查询语言。

TABLE

table  定义要操作的数据表名称，动态改变当前操作的数据表名称，需要写数据表的全名，包含前缀，可以使用别名和跨库操作
用法 table($table)
参数 table（必须）：数据表名称，支持操作多个表，支持字符串、数组和对象
返回值 当前模型实例
备注 如果不调用table方法，会自动获取模型对应或者定义的数据表

用法示例：

  1. $Model->Table('think_user user')->where('status>1')->select();

也可以在table方法中跨库操作，例如：

  1. $Model->Table('db_name.think_user user')->where('status>1')->select();

Table方法的参数支持字符串和数组，数组方式的用法：

  1. $Model->Table(array('think_user'=>'user','think_group'=>'group'))->where('status>1')->select();

使用数组方式定义的优势是可以避免因为表名和关键字冲突而出错的情况。
一般情况下，无需调用table方法，默认会自动获取当前模型对应或者定义的数据表。

DATA

data  可以用于新增或者保存数据之前的数据对象赋值
用法 data($data)
参数 data（必须）：数据，支持数组和对象
返回值 当前模型实例
备注 如果不调用data方法，则会取当前的数据对象或者传入add和save的数据

使用示例：

  1. $Model->data($data)->add();
  2. $Model->data($data)->where('id=3')->save();

Data方法的参数支持对象和数组，如果是对象会自动转换成数组。如果不定义data方法赋值，也可以使用create方法或者手动给数据对象赋值的方式。

模型的data方法除了创建数据对象之外，还可以读取当前的数据对象，
例如：

  1. $this->find(3);
  2. $data = $this->data();

FIELD

field  用于定义要查询的字段
用法 field($field,$except=false)
参数
field（必须）：字段名，支持字符串和数组，支持指定字段别名；如果为true则表示显式或者数据表的所有字段。

except（可选）：是否排除，默认为false，如果为true表示定义的字段为数据表中排除field参数定义之外的所有字段。
返回值 当前模型实例
备注 如果不调用field方法，则默认返回所有字段，和field（'*'）等效

使用示例：

  1. $Model->field('id,nickname as name')->select();
  2. $Model->field(array('id','nickname'=>'name'))->select();

如果不调用field方法或者field方法传入参数为空的话，和使用field（'*'）是等效的。
如果需要显式的传入所有的字段，可以使用下面的方法：

  1. $Model->field(true)->select();

但是我们更建议只获取需要显式的字段名，或者采用字段排除方式来定义，例如：

  1. $Model->field('status',true)->select();

表示获取除了status之外的所有字段。

ORDER

order  用于对操作结果排序
用法 order($order)
参数 order（必须）：排序的字段名，支持字符串和数组，支持多个字段排序
返回值 当前模型实例
备注 如果不调用order方法，按照数据库的默认规则

使用示例：

  1. order('id desc') 

排序方法支持对多个字段的排序

  1. order('status desc,id asc')

order方法的参数支持字符串和数组，数组的用法如下：

  1. order(array('status'=>'desc','id'))

LIMIT

limit  用于定义要查询的结果限制（支持所有的数据库类型）
用法 limit($limit)
参数 limit（必须）：限制数量，支持字符串
返回值 当前模型实例
备注 如果不调用limit方法，则表示没有限制

备注 如果不调用limit方法，则表示没有限制
我们知道不同的数据库类型的limit用法是不尽相同的，但是在ThinkPHP的用法里面始终是统一的方法，也就是limit('offset,length') ，无论是Mysql、SqlServer还是Oracle数据库，都是这样使用，系统的数据库驱动类会负责解决这个差异化。
使用示例：

  1. limit('1,10')

也可以用下面的写法，是等效的：

  1. limit(1,10)

如果使用

  1. limit('10')

等效于

  1. limit('0,10')

PAGE

page 用于定义要查询的数据分页
用法 page($page)
参数 page（必须）：分页，支持字符串
返回值 当前模型实例
备注 无

Page操作方法是新增的特性，可以更加快速的进行分页查询。
Page方法的用法和limit方法类似，格式为：

  1. Page('page[,listRows]')

Page表示当前的页数，listRows表示每页显示的记录数。例如：

  1. Page('2,10')

表示每页显示10条记录的情况下面，获取第2页的数据。
下面的写法等效：

  1. Page(2,10);

listRow如果不写的话，会读取limit('length') 的值，例如：

  1. limit(25)->page(3);

表示每页显示25条记录的情况下面，获取第3页的数据。
如果limit也没有设置的话，则默认为每页显示20条记录。
page方法增加第二个参数支持，例如：

  1. $this->page(5,25)->select();

和之前的用法

  1. $this->limit('5,25')->select();

等效。

GROUP

group 用于数据库的group查询支持
用法 group($group)
参数 group（必须）：group的字段名，支持字符串
返回值 当前模型实例
备注 无

使用示例：

  1. group('user_id')

Group方法的参数只支持字符串

HAVING

having 用于数据库的having查询支持
用法 having($having)
参数 having（必须）：having，支持字符串
返回值 当前模型实例
备注 无

使用示例：

  1. having('user_id>0')

having方法的参数只支持字符串

JOIN

join 用于数据库的join查询支持
用法 join($join)
参数 join（必须）：join操作，支持字符串和数组
返回值 当前模型实例
备注 join方法支持多次调用

使用示例：

  1. $Model->join(' work ON artist.id = work.artist_id')->join('card ON artist.card_id = card.id')->select();

默认采用LEFT JOIN 方式，如果需要用其他的JOIN方式，可以改成

  1. $Model->join('RIGHT JOIN work ON artist.id = work.artist_id')->select();

如果join方法的参数用数组的话，只能使用一次join方法，并且不能和字符串方式混合使用。
例如：

  1. join(array(' work ON artist.id = work.artist_id','card ON artist.card_id = card.id'))

UNION

union 用于数据库的union查询支持
用法 union($union,$all=false)
参数 union（必须）：union操作，支持字符串、数组和对象
all（可选）：是否采用UNION ALL 操作，默认为false
返回值 当前模型实例
备注 Union方法支持多次调用

使用示例：

  1. $Model->field('name')
  2.       ->table('think_user_0')
  3.       ->union('SELECT name FROM think_user_1')
  4.       ->union('SELECT name FROM think_user_2')
  5.       ->select();

数组用法：

  1. $Model->field('name')
  2.       ->table('think_user_0')
  3.       ->union(array('field'=>'name','table'=>'think_user_1'))
  4.       ->union(array('field'=>'name','table'=>'think_user_2'))
  5.       ->select();

或者

  1. $Model->field('name')
  2.       ->table('think_user_0')
  3.       ->union(array('SELECT name FROM think_user_1','SELECT name FROM think_user_2'))
  4.       ->select();

支持UNION ALL 操作，例如：

  1. $Model->field('name')
  2.       ->table('think_user_0')
  3.       ->union('SELECT name FROM think_user_1',true)
  4.       ->union('SELECT name FROM think_user_2',true)
  5.       ->select();

或者

  1. $Model->field('name')
  2.       ->table('think_user_0')
  3.       ->union(array('SELECT name FROM think_user_1','SELECT name FROM think_user_2'),true)
  4.       ->select();

每个union方法相当于一个独立的SELECT语句。
注意：UNION 内部的 SELECT 语句必须拥有相同数量的列。列也必须拥有相似的数据类型。同时，每条 SELECT 语句中的列的顺序必须相同。

DISTINCT

distinct 查询数据的时候进行唯一过滤
用法 distinct($distinct)
参数 distinct（必须）：是否采用distinct，支持布尔值
返回值 当前模型实例
备注 无

使用示例：

  1. $Model->Distinct(true)->field('name')->select();

LOCK

lock 用于查询或者写入锁定
用法 lock($lock)
参数 lock（必须）：是否需要锁定，支持布尔值
返回值 当前模型实例
备注 join方法支持多次调用

Lock方法是用于数据库的锁机制，如果在查询或者执行操作的时候使用：

  1. lock(true)

就会自动在生成的SQL语句最后加上 FOR UPDATE或者FOR UPDATE NOWAIT（Oracle数据库）。

VALIDATE

validate 用于数据的自动验证
用法 validate($validate)
参数 validate（必须）：自动验证定义
返回值 当前模型实例
备注 只能和create方法配合使用

validate方法用于数据的自动验证，我们会在数据验证部分详细描述。

AUTO

auto 用于数据自动完成
用法 auto($auto)
参数 auto（必须）：定义自动完成
返回值 当前模型实例
备注 auto方法只能配合create方法使用

auto方法用于数据的自动完成操作，具体使用我们会在数据自动完成部分描述。

SCOPE

scope 用于模型的命名范围
用法 scope($scope)
参数 scope（必须）：命名范围定义
返回值 当前模型实例
备注 scope方法其实是连贯操作的预定义

scope方法的具体用法可以参考：3.1的新特性 命名范围

FILTER

filter 用于数据的安全过滤
用法 filter($filter)
参数 filter（必须）：过滤方法名
返回值 当前模型实例
备注 filter方法一般用于写入和更新操作

filter方法用于对数据对象的安全过滤，例如：

  1. $Model->data($data)->filter('strip_tags')->add();

目前filter方法不支持多个方法的过滤。


总结

连贯操作为我们的数据操作带来了很大的便捷之处，并且只要SQL可以实现的操作，基本上都可以用ThinkPHP的连贯操作来实现，并且不用考虑数据库之间的表达差异，具有可移植性。后面会和大家讲解如何操作和获取变量。

时间： 2025-01-31 06:04:43

ThinkPHP3.1快速入门（4）连贯操作的相关文章

ThinkPHP 3.1快速入门：连贯操作

上一篇我们详细描述了查询语言的用法,但是查询语言仅仅解决了查询或者操作条件的问题,更多的配合还需要使用模型提供的连贯操作方法. 介绍 连贯操作可以有效的提高数据存取的代码清晰度和开发效率,并且支持所有的CURD操作,也是ThinkPHP的ORM中的一个亮点.使用也比较简单, 假如我们现在要查询一个User表的满足状态为1的前10条记录,并希望按照用户的创建时间排序 ,代码如下: $User->where('status=1')->order('create_time')->limit(1

Spread for Windows Forms快速入门(14)---文件操作

你可以将数据从Spread中存到几种不同类型的文件中或者可以在Spread中打开几种不同类型的数据文件.通过使用相应的代码,你可以将整个控件,某个特定的表单,或者某个特定单元格区域中的数据保存为几种不同的文件类型或者流.类似的,你可以允许用户对某几种文件类型进行文件操作. 保存到Excel文件 你可以使用ExcelSaveFlags枚举类型的UseOOXMLFormat选项,将数据保存到Excel格式文件(BIFF8 格式)或者Excel 2007 XML 格式(xlsx).默认的,当你保存为E

ThinkPHP3.1快速入门（3）查询语言

上一篇中我们掌握了基本的数据CURD方法,但更多的情况下面,由于业务逻辑的差异,CURD操作往往不是那么简单,尤其是复杂的业务逻辑下面,这也是ActiveRecord模式的不足之处.ThinkPHP的查询语言配合连贯操作可以很好解决复杂的业务逻辑需求,本篇我们就首先来深入了解下框架的查询语言. 介绍 ThinkPHP内置了非常灵活的查询方法,可以快速的进行数据查询操作,查询条件可以用于读取.更新和删除等操作,主要涉及到where方法等连贯操作即可,无论是采用什么数据库,你几乎采用一样的查询方法(

ThinkPHP3.1快速入门（2）数据CURD

上一篇中,我们了解了ThinkPHP的基础部分,以及如何创建一个控制器和模板,并知道了M方法的用法,本篇将会讲解下数据的CURD操作,探索下更多的数据操作. CURD CURD是一个数据库技术中的缩写词,一般的项目开发的各种参数的基本功能都是CURD.它代表创建(Create).更新(Update).读取(Read)和删除(Delete)操作.CURD 定义了用于处理数据的基本原子操作.之所以将CURD 提升到一个技术难题的高度是因为完成一个涉及在多个数据库系统中进行CURD操作的汇总相关的活动

ThinkPHP3.1基础知识快速入门_php实例

在当今众多的MVC框架中,ThinkPHP是一个快速.简单的基于MVC和面向对象的轻量级PHP开发框架,其遵循Apache2开源协议发布,自从诞生以来一直秉承简洁实用的设计原则,在保持出色的性能和至简的代码的同时,尤其注重开发体验及易用性,并且拥有众多的原创功能和特性,为WEB应用开发提供了强有力的支持.是众多PHP开发人员的首选.本文就ThinkPHP3.1基础知识做一简述. 1.目录结构 ThinkPHP最新版本可以在官方网站(http://thinkphp.cn/down/framewor

Spread for Windows Forms快速入门(7)---单元格的交互操作

单元格的编辑模式 通常情况下,当终端用户双击单元格时,编辑控件将允许用户在该单元格中输入内容.在一个单元格中编辑的能力被称为编辑模式.一些属性和方法可以用来自定义编辑模式的使用. 当一个单元格处于编辑模式时,活动单元格将显示一个I型光标,如下图所示.当该单元格不处于编辑模式时,活动单元格将显示一个焦点长方形,如下图所示. 处于编辑模式下的单元格 被选中但是并不处于编辑模式下的单元格 一个单元格将进入编辑模式(开启编辑模式),当: 用户在单元格中输入内容 用户双击单元格 EditMode属性设置为

Asp快速入门，快速出程序！

程序|快速入门 我工作一年了,学会了Asp.Php,本人是金属材料热处理专业毕业,在学校根本没搞过,后来毕业在网吧干了一个月受不了回家自学asp,照着书学了三个月,才勉强写了个聊天室程序.后来在公司学php,只用了一个星期就上手了,把东方自助建站有几个小错误搞定,还写了一个简单的自助站点列表.我总结了一下,之所以后来学php能有这样的速度就是因为我直接接触程序(当然和asp的基础是分不开的),所以我认为要快速入门asp最好的办法就是看程序. asp和htm相比最重要的就是操作数据库,所以快速入门

Spread for Windows Forms快速入门(11)---数据筛选

Spread支持开发人员自定义筛选数据的用户体验.基于行数据筛选,你可以允许用户分列进行筛选,从而仅显示符合了下拉列表中条件的行的数据,或者根据筛选结果更改行的外观.你可以使用默认的筛选方式,或者你可以从实际出发,自定义筛选器的每一个方面. 允许用户进行行筛选 默认情况下,表单禁止用户对表单的行进行筛选.你可以开启这一特性, 允许用户在所有列或者指定的列中进行行筛选.根据你要隐藏被筛除的列,还是更改列的外观,分别使用HideRowFilter类或StyleRowFilter类. 使用列Allow

Spread for Windows Forms快速入门(15)---使用 Spread 设计器

通过 Spread 设计器用户可以快速地对 Spread 控件进行设计.无论用户是正在做一个关于 Spread 控件特性的原型研究,还是对于一个已经存在的 Spread 控件在某些方面进行进一步的定制,Spread 设计器专有的图形界面可节省大量的时间和精力.Spread 设计器允许用户添加数据,同时设置控件属性,而且还包括那些在 Visual Studio 中无法设置的属性.用户可以同时设置运行时和设计时属性,大多数情况下用户可以在应用设置之前预览效果,设置完成后,就可以将所有的设置应用到 S