6.12 连贯操作 · thinkphp3.1.2

# 连贯操作 [上一页](65.html "上一页")[下一页](67.html "下一页") ThinkPHP模型基础类提供的连贯操作方法，可以有效的提高数据存取的代码清晰度和开发效率，并且支持所有的CURD操作。使用也比较简单，假如我们现在要查询一个User表的满足状态为1的前10条记录，并希望按照用户的创建时间排序，代码如下： `$User->where('status=1')->order('create_time')->limit(10)->select();`这里的where、order和limit方法就被称之为连贯操作方法，T除了select方法必须放到最后一个外（因为select方法并不是连贯操作方法），连贯操作T的方法调用顺序没有先后，例如，下面的代码和上面的等效： `$User->order('create_time')->limit(10)->where('status=1')->select();`如果不习惯使用连贯操作的话，还支持直接使用参数进行查询的方式。例如上面的代码可以改写为：`$User->select(array('order'=>'create_time','where'=>'status=1','limit'=>'10'));`使用数组参数方式的话，索引的名称就是连贯操作的方法名称。其实T不仅仅是查询方法可以使用连贯操作，包括所有的CURD方法都可以使用，例如： `$User->where('id=1')->field('id,name,email')->find(); $User->where('status=1 and id=1')->delete();`连贯操作通常只有一个参数，并且仅在当此查询或者操作有效，完成后会自动清空连贯操作的所有传值（有个别特殊的连贯操作有多个参数，并且会记录当前的传值）。简而言之，连贯操作的结果不会带入以后的查询。系统支持的连贯操作方法有：连贯操作作用支持的参数类型 where 用于查询或者更新条件的定义字符串、数组和对象 table 用于定义要操作的数据表名称字符串和数组 alias 用于给当前数据表定义别名字符串 data 用于新增或者更新数据之前的数据对象赋值数组和对象 field 用于定义要查询的字段（支持字段排除）字符串和数组 order 用于对结果排序字符串和数组 limit 用于限制查询结果数量字符串和数字 page 用于查询分页（内部会转换成limit）字符串和数字 group 用于对查询的group支持字符串 having 用于对查询的having支持字符串 join\* 用于对查询的join支持字符串和数组 union\* 用于对查询的union支持字符串、数组和对象 distinct 用于查询的distinct支持布尔值 lock 用于数据库的锁机制布尔值 cache 用于查询缓存支持多个参数 relation 用于关联查询（需要关联模型支持）字符串所有的连贯操作都返回当前的模型实例对象（this），其中带*标识的表示支持多次调用。### WHERE where 用于查询或者更新条件的定义用法 where($where) 参数 where（必须）：查询或者操作条件，支持字符串、数组和对象返回值当前模型实例备注如果不调用where方法，默认不会执行更新和删除操作 Where方法是使用最多的连贯操作方法，更详细的用法请参考后面的6.13 CURD操作和6.18查询语言部分。### TABLE table 定义要操作的数据表名称，动态改变当前操作的数据表名称，需要写数据表的全名，包含前缀，可以使用别名和跨库操作用法 table($table,$parse=null) 参数 table（必须）：数据表名称，支持操作多个表，支持字符串、数组和对象 parse（可选）预处理参数，详见14.3防止SQL注入查询条件预处理返回值当前模型实例备注如果不调用table方法，会自动获取模型对应或者定义的数据表用法示例：`$Model->Table('think_user user')->where('status>1')->select();`也可以在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();`使用数组方式定义的优势是可以避免因为表名和关键字冲突而出错的情况。一般情况下，无需调用table方法，默认会自动获取当前模型对应或者定义的数据表。### DATA 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($field,$except=false) 参数 field（必须）：字段名，支持字符串和数组，支持指定字段别名；如果为true则表示显式或者数据表的所有字段。 except（可选）：是否排除，默认为false，如果为true表示定义的字段为数据表中排除field参数定义之外的所有字段。返回值当前模型实例备注如果不调用field方法，则默认返回所有字段，和field（'\*'）等效使用示例：`$Model->field('id,nickname as name')->select(); $Model->field(array('id','nickname'=>'name'))->select();`如果不调用field方法或者field方法传入参数为空的话，和使用field（'*'）是等效的。如果需要显式的传入所有的字段，可以使用下面的方法：`$Model->field(true)->select();`但是我们更建议只获取需要显式的字段名，或者采用字段排除方式来定义，例如：`$Model->field('status',true)->select();`表示获取除了status之外的所有字段。### ORDER order 用于对操作结果排序用法 order($order) 参数 order（必须）：排序的字段名，支持字符串和数组，支持多个字段排序返回值当前模型实例备注如果不调用order方法，按照数据库的默认规则使用示例：`order('id desc') `排序方法支持对多个字段的排序`order('status desc,id asc')`order方法的参数支持字符串和数组，数组的用法如下：`order(array('status'=>'desc','id'))`### LIMIT limit 用于定义要查询的结果限制（支持所有的数据库类型）用法 limit($limit) 参数 limit（必须）：限制数量，支持字符串返回值当前模型实例备注如果不调用limit方法，则表示没有限制备注如果不调用limit方法，则表示没有限制我们知道不同的数据库类型的limit用法是不尽相同的，但是在ThinkPHP的用法里面始终是统一的方法，也就是limit('offset,length') ，无论是Mysql、SqlServer还是Oracle数据库，都是这样使用，系统的数据库驱动类会负责解决这个差异化。使用示例：`limit('1,10')`如果使用limit('10') 等效于 limit('0,10') 3.1版本以后，limit方法增加第二个参数支持，例如：`$this->limit(10,100)->select();`和之前的用法`$this->limit('10,100')->select();`等效。### PAGE 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条记录。 3.1版本以后，page方法增加第二个参数支持，例如：`$this->page(5,25)->select();`和之前的用法`$this->page('5,25')->select();`等效。### GROUP group 用于数据库的group查询支持用法 group($group) 参数 group（必须）：group的字段名，支持字符串返回值当前模型实例备注无使用示例：`group('user_id')`Group方法的参数只支持字符串### HAVING having 用于数据库的having查询支持用法 having($having) 参数 having（必须）：having，支持字符串返回值当前模型实例备注无使用示例：`having('user_id>0')`having方法的参数只支持字符串### JOIN join 用于数据库的join查询支持用法 join($join) 参数 join（必须）：join操作，支持字符串和数组返回值当前模型实例备注 join方法支持多次调用使用示例：`$Model->join(' work ON artist.id = work.artist_id')->join('card ON artist.card_id = card.id')->select();`默认采用LEFT JOIN 方式，如果需要用其他的JOIN方式，可以改成`$Model->join('RIGHT JOIN work ON artist.id = work.artist_id')->select();`如果join方法的参数用数组的话，只能使用一次join方法，并且不能和字符串方式混合使用。例如：`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方法支持多次调用使用示例：`$Model->field('name') ->table('think_user_0') ->union('SELECT name FROM think_user_1') ->union('SELECT name FROM think_user_2') ->select();`数组用法：`$Model->field('name') ->table('think_user_0') ->union(array('field'=>'name','table'=>'think_user_1')) ->union(array('field'=>'name','table'=>'think_user_2')) ->select();`或者`$Model->field('name') ->table('think_user_0') ->union(array('SELECT name FROM think_user_1','SELECT name FROM think_user_2')) ->select();`支持UNION ALL 操作，例如：`$Model->field('name') ->table('think_user_0') ->union('SELECT name FROM think_user_1',true) ->union('SELECT name FROM think_user_2',true) ->select();`或者`$Model->field('name') ->table('think_user_0') ->union(array('SELECT name FROM think_user_1','SELECT name FROM think_user_2'),true) ->select();`每个union方法相当于一个独立的SELECT语句。注意：UNION 内部的 SELECT 语句必须拥有相同数量的列。列也必须拥有相似的数据类型。同时，每条 SELECT 语句中的列的顺序必须相同。### DISTINCT distinct 查询数据的时候进行唯一过滤用法 distinct($distinct) 参数 distinct（必须）：是否采用distinct，支持布尔值返回值当前模型实例备注无使用示例：`$Model->Distinct(true)->field('name')->select();`### RELATION relation 用于关联查询支持用法 relation($relation) 参数 relation（必须）：关联操作返回值当前模型实例备注使用关联模型才支持关联查询方法的详细用法请参考后面的6.23关联模型部分。### LOCK lock 用于查询或者写入锁定用法 lock($lock) 参数 lock（必须）：是否需要锁定，支持布尔值返回值当前模型实例备注 join方法支持多次调用 Lock方法是用于数据库的锁机制，如果在查询或者执行操作的时候使用：`lock(true)`就会自动在生成的SQL语句最后加上 FOR UPDATE或者FOR UPDATE NOWAIT（Oracle数据库）。### CACHE cache 用于查询缓存操作用法 cache($key=true,$expire='',$type='') 参数 key（可选）：是否启用查询缓存，支持布尔值和字符串，如果是字符串表示查询缓存的缓存名 expire（可选）：查询缓存的有效期，如果留空取系统默认的缓存有效期 type（可选）：查询缓存的缓存类型，如果留空取系统默认的缓存类型返回值当前模型实例备注如果不调用field方法，则默认返回所有字段，和field（'\*'）等效查询缓存的详细用法会在后面的12.6查询缓存部分详细描述。 [上一页](65.html "上一页")[下一页](67.html "下一页")