\think\dbQuery

Summary

Methods

Properties

Constants

__construct()
__call()
getConnection()
connect()
getModel()
readMaster()
getBuilder()
name()
setTable()
getTable()
parseSqlTable()
query()
execute()
getLastInsID()
getLastSql()
transaction()
startTrans()
commit()
rollback()
batchQuery()
getConfig()
getPartitionTableName()
value()
column()
count()
aggregate()
sum()
min()
max()
avg()
setField()
setInc()
setDec()
join()
union()
field()
fieldRaw()
data()
inc()
dec()
exp()
raw()
view()
partition()
where()
whereOr()
whereXor()
whereRaw()
whereOrRaw()
whereNull()
whereNotNull()
whereExists()
whereNotExists()
whereIn()
whereNotIn()
whereLike()
whereNotLike()
whereBetween()
whereNotBetween()
whereExp()
useSoftDelete()
removeWhereField()
removeOption()
limit()
page()
paginate()
table()
using()
order()
orderRaw()
cache()
group()
having()
lock()
distinct()
alias()
force()
comment()
fetchSql()
fetchPdo()
master()
strict()
failException()
sequence()
pk()
whereTime()
getTableInfo()
getPk()
getTableFields()
getFieldsType()
getFieldsBind()
bind()
isBind()
getOptions()
with()
withCount()
withField()
via()
relation()
insert()
insertGetId()
insertAll()
selectInsert()
update()
getPdo()
select()
find()
selectOrFail()
findOrFail()
chunk()
getBind()
buildSql()
delete()
event()

No public properties found

No constants found

setBuilder()
lazyWrite()
getJoinTable()
parseWhereExp()
getFieldBindType()
options()
parsePkWhere()
cacheData()
getCacheKey()
throwNotFound()
parseExpress()
trigger()

$connection
$builder
$model
$table
$name
$pk
$prefix
$options
$bind
$info
$readMaster

N/A

checkMultiField()

$event

N/A

File: back/vendor/topthink/framework/library/think/db/Query.php
Package: Application
Class hierarchy: \think\db\Query
Uses

Properties

$connection

$connection

$builder

$builder

$model

$model

$table

$table

$name

$name

$pk

$pk

$prefix

$prefix

$options

$options

$bind

$bind

$info

$info

$readMaster

$readMaster

$event

$event

Methods

__construct()

__construct(\think\db\Connection  $connection = null, \think\Model  $model = null) : mixed

构造函数

Parameters

\think\db\Connection	$connection	数据库对象实例
\think\Model	$model	模型对象

Returns

mixed —

__call()

__call(string  $method, array  $args) : mixed

利用__call方法实现一些特殊的Model方法

Parameters

string	$method	方法名称
array	$args	调用参数

Throws

\think\exception\DbException
\think\Exception

Returns

mixed —

getConnection()

getConnection() : \think\db\Connection

获取当前的数据库Connection对象

Returns

\think\db\Connection —

connect()

connect(mixed  $config) : $this

切换当前的数据库连接

Parameters

mixed

$config

Returns

$this —

getModel()

getModel() : \think\Model|null

获取当前的模型对象实例

Returns

\think\Model|null —

readMaster()

readMaster(bool  $allTable = false) : void

设置后续从主库读取数据

Parameters

bool

$allTable

getBuilder()

getBuilder() : \think\db\Builder

获取当前的builder实例对象

Returns

\think\db\Builder —

name()

name(string  $name) : $this

指定默认的数据表名（不含前缀）

Parameters

string

$name

Returns

$this —

setTable()

setTable(string  $table) : $this

指定默认数据表名（含前缀）

Parameters

string

$table

表名

Returns

$this —

getTable()

getTable(string  $name = '') : string

得到当前或者指定名称的数据表

Parameters

string

$name

Returns

string —

parseSqlTable()

parseSqlTable(string  $sql) : string

将SQL语句中的__TABLE_NAME__字符串替换成带前缀的表名（小写）

Parameters

string

$sql

sql语句

Returns

string —

query()

query(string  $sql, array  $bind = [], bool  $master = false, bool|string  $class = false) : mixed

执行查询返回数据集

Parameters

string	$sql	sql指令
array	$bind	参数绑定
bool	$master	是否在主服务器读操作
bool\|string	$class	指定返回的数据集对象

Throws

\think\db\exception\BindParamException
\think\exception\PDOException

Returns

mixed —

execute()

execute(string  $sql, array  $bind = []) : int

执行语句

Parameters

string	$sql	sql指令
array	$bind	参数绑定

Throws

\think\db\exception\BindParamException
\think\exception\PDOException

Returns

int —

getLastInsID()

getLastInsID(string  $sequence = null) : string

获取最近插入的ID

Parameters

string

$sequence

自增序列名

Returns

string —

getLastSql()

getLastSql() : string

获取最近一次查询的sql语句

Returns

string —

transaction()

transaction(callable  $callback) : mixed

执行数据库事务

Parameters

callable

$callback

数据操作方法回调

Returns

mixed —

startTrans()

startTrans() : void

启动事务

commit()

commit() : void

用于非自动提交状态下面的查询提交

Throws

\think\exception\PDOException

rollback()

rollback() : void

事务回滚

Throws

\think\exception\PDOException

batchQuery()

batchQuery(array  $sql = [], mixed  $bind = []) : bool

批处理执行SQL语句批处理的指令都认为是execute操作

Parameters

array	$sql	SQL批处理指令
mixed	$bind

Returns

bool —

getConfig()

getConfig(string  $name = '') : bool

获取数据库的配置参数

Parameters

string

$name

参数名称

Returns

bool —

getPartitionTableName()

getPartitionTableName(array  $data, string  $field, array  $rule = []) : string

得到分表的的数据表名

Parameters

array	$data	操作的数据
string	$field	分表依据的字段
array	$rule	分表规则

Returns

string —

value()

value(string  $field, mixed  $default = null, bool  $force = false) : mixed

得到某个字段的值

Parameters

string	$field	字段名
mixed	$default	默认值
bool	$force	强制转为数字类型

Returns

mixed —

column()

column(string  $field, string  $key = '') : array

得到某个列的数组

Parameters

string	$field	字段名多个字段用逗号分隔
string	$key	索引

Returns

array —

count()

count(string  $field = '*') : int|string

COUNT查询

Parameters

string

$field

字段名

Returns

int|string —

aggregate()

aggregate(string  $aggregate, string  $field, bool  $force = false) : mixed

聚合查询

Parameters

string	$aggregate	聚合方法
string	$field	字段名
bool	$force	强制转为数字类型

Returns

mixed —

sum()

sum(string  $field) : float|int

SUM查询

Parameters

string

$field

字段名

Returns

float|int —

min()

min(string  $field, bool  $force = true) : mixed

MIN查询

Parameters

string	$field	字段名
bool	$force	强制转为数字类型

Returns

mixed —

max()

max(string  $field, bool  $force = true) : mixed

MAX查询

Parameters

string	$field	字段名
bool	$force	强制转为数字类型

Returns

mixed —

avg()

avg(string  $field) : float|int

AVG查询

Parameters

string

$field

字段名

Returns

float|int —

setField()

setField(string|array  $field, mixed  $value = '') : int

设置记录的某个字段值支持使用数据库字段和方法

Parameters

string\|array	$field	字段名
mixed	$value	字段值

Returns

int —

setInc()

setInc(string  $field, int  $step = 1, int  $lazyTime) : int|true

字段值(延迟)增长

Parameters

string	$field	字段名
int	$step	增长值
int	$lazyTime	延时时间(s)

Throws

\think\Exception

Returns

int|true —

setDec()

setDec(string  $field, int  $step = 1, int  $lazyTime) : int|true

字段值（延迟）减少

Parameters

string	$field	字段名
int	$step	减少值
int	$lazyTime	延时时间(s)

Throws

\think\Exception

Returns

int|true —

join()

join(mixed  $join, mixed  $condition = null, string  $type = 'INNER') : $this

查询SQL组装 join

Parameters

mixed	$join	关联的表名
mixed	$condition	条件
string	$type	JOIN类型

Returns

$this —

union()

union(mixed  $union, bool  $all = false) : $this

查询SQL组装 union

Parameters

mixed	$union
bool	$all

Returns

$this —

field()

field(mixed  $field, bool  $except = false, string  $tableName = '', string  $prefix = '', string  $alias = '') : $this

指定查询字段支持字段排除和指定数据表

Parameters

mixed	$field
bool	$except	是否排除
string	$tableName	数据表名
string	$prefix	字段前缀
string	$alias	别名前缀

Returns

$this —

fieldRaw()

fieldRaw(string  $field, array  $bind = []) : $this

表达式方式指定查询字段

Parameters

string	$field	字段名
array	$bind	参数绑定

Returns

$this —

data()

data(mixed  $field, mixed  $value = null) : $this

设置数据

Parameters

mixed	$field	字段名或者数据
mixed	$value	字段值

Returns

$this —

inc()

inc(string|array  $field, int  $step = 1) : $this

字段值增长

Parameters

string\|array	$field	字段名
int	$step	增长值

Returns

$this —

dec()

dec(string|array  $field, int  $step = 1) : $this

字段值减少

Parameters

string\|array	$field	字段名
int	$step	增长值

Returns

$this —

exp()

exp(string  $field, string  $value) : $this

使用表达式设置数据

Parameters

string	$field	字段名
string	$value	字段值

Returns

$this —

raw()

raw(mixed  $value) : \think\db\Expression

使用表达式设置数据

Parameters

mixed

$value

表达式

Returns

\think\db\Expression —

view()

view(mixed  $join, string|array  $field = true, mixed  $on = null, string  $type = 'INNER') : $this

指定JOIN查询字段

Parameters

mixed	$join
string\|array	$field	查询字段
mixed	$on	JOIN条件
string	$type	JOIN类型

Returns

$this —

partition()

partition(array  $data, string  $field, array  $rule = []) : $this

设置分表规则

Parameters

array	$data	操作的数据
string	$field	分表依据的字段
array	$rule	分表规则

Returns

$this —

where()

where(mixed  $field, mixed  $op = null, mixed  $condition = null) : $this

指定AND查询条件

Parameters

mixed	$field	查询字段
mixed	$op	查询表达式
mixed	$condition	查询条件

Returns

$this —

whereOr()

whereOr(mixed  $field, mixed  $op = null, mixed  $condition = null) : $this

指定OR查询条件

Parameters

mixed	$field	查询字段
mixed	$op	查询表达式
mixed	$condition	查询条件

Returns

$this —

whereXor()

whereXor(mixed  $field, mixed  $op = null, mixed  $condition = null) : $this

指定XOR查询条件

Parameters

mixed	$field	查询字段
mixed	$op	查询表达式
mixed	$condition	查询条件

Returns

$this —

whereRaw()

whereRaw(string  $where, array  $bind = [], string  $logic = 'AND') : $this

指定表达式查询条件

Parameters

string	$where	查询条件
array	$bind	参数绑定
string	$logic	查询逻辑 and or xor

Returns

$this —

whereOrRaw()

whereOrRaw(string  $where, array  $bind = []) : $this

指定表达式查询条件 OR

Parameters

string	$where	查询条件
array	$bind	参数绑定

Returns

$this —

whereNull()

whereNull(mixed  $field, string  $logic = 'AND') : $this

指定Null查询条件

Parameters

mixed	$field	查询字段
string	$logic	查询逻辑 and or xor

Returns

$this —

whereNotNull()

whereNotNull(mixed  $field, string  $logic = 'AND') : $this

指定NotNull查询条件

Parameters

mixed	$field	查询字段
string	$logic	查询逻辑 and or xor

Returns

$this —

whereExists()

whereExists(mixed  $condition, string  $logic = 'AND') : $this

指定Exists查询条件

Parameters

mixed	$condition	查询条件
string	$logic	查询逻辑 and or xor

Returns

$this —

whereNotExists()

whereNotExists(mixed  $condition, string  $logic = 'AND') : $this

指定NotExists查询条件

Parameters

mixed	$condition	查询条件
string	$logic	查询逻辑 and or xor

Returns

$this —

whereIn()

whereIn(mixed  $field, mixed  $condition, string  $logic = 'AND') : $this

指定In查询条件

Parameters

mixed	$field	查询字段
mixed	$condition	查询条件
string	$logic	查询逻辑 and or xor

Returns

$this —

whereNotIn()

whereNotIn(mixed  $field, mixed  $condition, string  $logic = 'AND') : $this

指定NotIn查询条件

Parameters

mixed	$field	查询字段
mixed	$condition	查询条件
string	$logic	查询逻辑 and or xor

Returns

$this —

whereLike()

whereLike(mixed  $field, mixed  $condition, string  $logic = 'AND') : $this

指定Like查询条件

Parameters

mixed	$field	查询字段
mixed	$condition	查询条件
string	$logic	查询逻辑 and or xor

Returns

$this —

whereNotLike()

whereNotLike(mixed  $field, mixed  $condition, string  $logic = 'AND') : $this

指定NotLike查询条件

Parameters

mixed	$field	查询字段
mixed	$condition	查询条件
string	$logic	查询逻辑 and or xor

Returns

$this —

whereBetween()

whereBetween(mixed  $field, mixed  $condition, string  $logic = 'AND') : $this

指定Between查询条件

Parameters

mixed	$field	查询字段
mixed	$condition	查询条件
string	$logic	查询逻辑 and or xor

Returns

$this —

whereNotBetween()

whereNotBetween(mixed  $field, mixed  $condition, string  $logic = 'AND') : $this

指定NotBetween查询条件

Parameters

mixed	$field	查询字段
mixed	$condition	查询条件
string	$logic	查询逻辑 and or xor

Returns

$this —

whereExp()

whereExp(mixed  $field, mixed  $condition, string  $logic = 'AND') : $this

指定Exp查询条件

Parameters

mixed	$field	查询字段
mixed	$condition	查询条件
string	$logic	查询逻辑 and or xor

Returns

$this —

useSoftDelete()

useSoftDelete(false|string  $field, mixed  $condition = null) : $this

设置软删除字段及条件

Parameters

false\|string	$field	查询字段
mixed	$condition	查询条件

Returns

$this —

removeWhereField()

removeWhereField(string  $field, string  $logic = 'AND') : $this

去除某个查询条件

Parameters

string	$field	查询字段
string	$logic	查询逻辑 and or xor

Returns

$this —

removeOption()

removeOption(string|bool  $option = true) : $this

去除查询参数

Parameters

string|bool

$option

参数名 true 表示去除所有参数

Returns

$this —

limit()

limit(mixed  $offset, mixed  $length = null) : $this

指定查询数量

Parameters

mixed	$offset	起始位置
mixed	$length	查询数量

Returns

$this —

page()

page(mixed  $page, mixed  $listRows = null) : $this

指定分页

Parameters

mixed	$page	页数
mixed	$listRows	每页数量

Returns

$this —

paginate()

paginate(int|array  $listRows = null, int|bool  $simple = false, array  $config = []) : \think\Paginator

分页查询

Parameters

int\|array	$listRows	每页数量数组表示配置参数
int\|bool	$simple	是否简洁模式或者总记录数
array	$config	配置参数 page:当前页, path:url路径, query:url额外参数, fragment:url锚点, var_page:分页变量, list_rows:每页数量 type:分页类名

Throws

\think\exception\DbException

Returns

\think\Paginator —

table()

table(mixed  $table) : $this

指定当前操作的数据表

Parameters

mixed

$table

表名

Returns

$this —

using()

using(mixed  $using) : $this

USING支持用于多表删除

Parameters

mixed

$using

Returns

$this —

order()

order(string|array  $field, string  $order = null) : $this

指定排序 order('id','desc') 或者 order(['id'=>'desc','create_time'=>'desc'])

Parameters

string\|array	$field	排序字段
string	$order	排序

Returns

$this —

orderRaw()

orderRaw(string  $field, array  $bind = []) : $this

表达式方式指定Field排序

Parameters

string	$field	排序字段
array	$bind	参数绑定

Returns

$this —

cache()

cache(mixed  $key = true, int|\DateTime  $expire = null, string  $tag = null) : $this

查询缓存

Parameters

mixed	$key	缓存key
int\|\DateTime	$expire	缓存有效期
string	$tag	缓存标签

Returns

$this —

group()

group(string  $group) : $this

指定group查询

Parameters

string

$group

GROUP

Returns

$this —

having()

having(string  $having) : $this

指定having查询

Parameters

string

$having

having

Returns

$this —

lock()

lock(bool|string  $lock = false) : $this

指定查询lock

Parameters

bool|string

$lock

是否lock

Returns

$this —

distinct()

distinct(string  $distinct) : $this

指定distinct查询

Parameters

string

$distinct

是否唯一

Returns

$this —

alias()

alias(mixed  $alias) : $this

指定数据表别名

Parameters

mixed

$alias

数据表别名

Returns

$this —

force()

force(string  $force) : $this

指定强制索引

Parameters

string

$force

索引名称

Returns

$this —

comment()

comment(string  $comment) : $this

查询注释

Parameters

string

$comment

注释

Returns

$this —

fetchSql()

fetchSql(bool  $fetch = true) : $this

获取执行的SQL语句

Parameters

bool

$fetch

是否返回sql

Returns

$this —

fetchPdo()

fetchPdo(bool  $pdo = true) : $this

不主动获取数据集

Parameters

bool

$pdo

是否返回 PDOStatement 对象

Returns

$this —

master()

master() : $this

设置从主服务器读取数据

Returns

$this —

strict()

strict(bool  $strict = true) : $this

设置是否严格检查字段名

Parameters

bool

$strict

是否严格检查字段

Returns

$this —

failException()

failException(bool  $fail = true) : $this

设置查询数据不存在是否抛出异常

Parameters

bool

$fail

数据不存在是否抛出异常

Returns

$this —

sequence()

sequence(string  $sequence = null) : $this

设置自增序列名

Parameters

string

$sequence

自增序列名

Returns

$this —

pk()

pk(string  $pk) : $this

指定数据表主键

Parameters

string

$pk

主键

Returns

$this —

whereTime()

whereTime(string  $field, string|array  $op, string|array  $range = null) : $this

查询日期或者时间

Parameters

string	$field	日期字段名
string\|array	$op	比较运算符或者表达式
string\|array	$range	比较范围

Returns

$this —

getTableInfo()

getTableInfo(mixed  $tableName = '', string  $fetch = '') : mixed

获取数据表信息

Parameters

mixed	$tableName	数据表名留空自动获取
string	$fetch	获取信息类型包括 fields type bind pk

Returns

mixed —

getPk()

getPk(string|array  $options = '') : string|array

获取当前数据表的主键

Parameters

string|array

$options

数据表名或者查询参数

Returns

string|array —

getTableFields()

getTableFields(mixed  $table = '') : mixed

Parameters

mixed

$table

Returns

mixed —

getFieldsType()

getFieldsType(mixed  $table = '') : mixed

Parameters

mixed

$table

Returns

mixed —

getFieldsBind()

getFieldsBind(mixed  $table = '') : mixed

Parameters

mixed

$table

Returns

mixed —

bind()

bind(mixed  $key, mixed  $value = false, int  $type = PDO::PARAM_STR) : $this

参数绑定

Parameters

mixed	$key	参数名
mixed	$value	绑定变量值
int	$type	绑定类型

Returns

$this —

isBind()

isBind(string  $key) : bool

检测参数是否已经绑定

Parameters

string

$key

参数名

Returns

bool —

getOptions()

getOptions(string  $name = '') : mixed

获取当前的查询参数

Parameters

string

$name

参数名

Returns

mixed —

with()

with(string|array  $with) : $this

设置关联查询JOIN预查询

Parameters

string|array

$with

关联方法名称

Returns

$this —

withCount()

withCount(string|array  $relation, bool  $subQuery = true) : $this

关联统计

Parameters

string\|array	$relation	关联方法名
bool	$subQuery	是否使用子查询

Returns

$this —

withField()

withField(mixed  $field) : $this

关联预加载中获取关联指定字段值 example: Model::with(['relation' => function($query){ $query->withField("id,name"); }])

Parameters

mixed

$field

Returns

$this —

via()

via(string  $via = '') : $this

设置当前字段添加的表别名

Parameters

string

$via

Returns

$this —

relation()

relation(string|array  $relation) : $this

设置关联查询

Parameters

string|array

$relation

关联名称

Returns

$this —

insert()

insert(mixed  $data = [], bool  $replace = false, bool  $getLastInsID = false, string  $sequence = null) : int|string

插入记录

Parameters

mixed	$data	数据
bool	$replace	是否replace
bool	$getLastInsID	返回自增主键
string	$sequence	自增序列名

Returns

int|string —

insertGetId()

insertGetId(mixed  $data, bool  $replace = false, string  $sequence = null) : int|string

插入记录并获取自增ID

Parameters

mixed	$data	数据
bool	$replace	是否replace
string	$sequence	自增序列名

Returns

int|string —

insertAll()

insertAll(mixed  $dataSet, bool  $replace = false, int  $limit = null) : int|string

批量插入记录

Parameters

mixed	$dataSet	数据集
bool	$replace	是否replace
int	$limit	每次写入数据限制

Returns

int|string —

selectInsert()

selectInsert(string  $fields, string  $table) : int|string

通过Select方式插入记录

Parameters

string	$fields	要插入的数据表字段名
string	$table	要插入的数据表名

Throws

\think\exception\PDOException

Returns

int|string —

update()

update(mixed  $data = []) : int|string

更新记录

Parameters

mixed

$data

数据

Throws

\think\Exception
\think\exception\PDOException

Returns

int|string —

getPdo()

getPdo() : \PDOStatement|string

执行查询但只返回PDOStatement对象

Returns

\PDOStatement|string —

select()

select(array|string|\think\db\Query|\Closure  $data = null) : \think\Collection|false|\PDOStatement|string

查找记录

Parameters

array|string|\think\db\Query|\Closure

$data

Throws

\think\exception\DbException
\think\db\exception\ModelNotFoundException
\think\db\exception\DataNotFoundException

Returns

\think\Collection|false|\PDOStatement|string —

find()

find(array|string|\think\db\Query|\Closure  $data = null) : array|false|\PDOStatement|string|\think\Model

查找单条记录

Parameters

array|string|\think\db\Query|\Closure

$data

Throws

\think\exception\DbException
\think\db\exception\ModelNotFoundException
\think\db\exception\DataNotFoundException

Returns

array|false|\PDOStatement|string|\think\Model —

selectOrFail()

selectOrFail(array|string|\think\db\Query|\Closure  $data = null) : array|\PDOStatement|string|\think\Model

查找多条记录如果不存在则抛出异常

Parameters

array|string|\think\db\Query|\Closure

$data

Throws

\think\exception\DbException
\think\db\exception\ModelNotFoundException
\think\db\exception\DataNotFoundException

Returns

array|\PDOStatement|string|\think\Model —

findOrFail()

findOrFail(array|string|\think\db\Query|\Closure  $data = null) : array|\PDOStatement|string|\think\Model

查找单条记录如果不存在则抛出异常

Parameters

array|string|\think\db\Query|\Closure

$data

Throws

\think\exception\DbException
\think\db\exception\ModelNotFoundException
\think\db\exception\DataNotFoundException

Returns

array|\PDOStatement|string|\think\Model —

chunk()

chunk(int  $count, callable  $callback, string  $column = null, string  $order = 'asc') : bool

分批数据返回处理

Parameters

int	$count	每次处理的数据数量
callable	$callback	处理回调方法
string	$column	分批处理的字段名
string	$order	排序规则

Throws

\LogicException

Returns

bool —

getBind()

getBind() : array

获取绑定的参数并清空

Returns

array —

buildSql()

buildSql(bool  $sub = true) : string

创建子查询SQL

Parameters

bool

$sub

Throws

\think\exception\DbException

Returns

string —

delete()

delete(mixed  $data = null) : int

删除记录

Parameters

mixed

$data

表达式 true 表示强制删除

Throws

\think\Exception
\think\exception\PDOException

Returns

int —

event()

event(string  $event, callable  $callback) : void

注册回调方法

Parameters

string	$event	事件名
callable	$callback	回调方法

setBuilder()

setBuilder() : void

设置当前的数据库Builder对象

lazyWrite()

lazyWrite(string  $type, string  $guid, int  $step, int  $lazyTime) : false|int

延时更新检查返回false表示需要延时否则返回实际写入的数值

Parameters

string	$type	自增或者自减
string	$guid	写入标识
int	$step	写入步进值
int	$lazyTime	延时时间(s)

Returns

false|int —

getJoinTable()

getJoinTable(array|string  $join, mixed  $alias = null) : array|string

获取Join表名及别名支持 ['prefix_table或者子查询'=>'alias'] 'prefix_table alias' 'table alias'

Parameters

array\|string	$join
mixed	$alias

Returns

array|string —

parseWhereExp()

parseWhereExp(string  $logic, string|array|\Closure  $field, mixed  $op, mixed  $condition, array  $param = [], bool  $strict = false) : void

分析查询表达式

Parameters

string	$logic	查询逻辑 and or xor
string\|array\|\Closure	$field	查询字段
mixed	$op	查询表达式
mixed	$condition	查询条件
array	$param	查询参数
bool	$strict	严格模式

getFieldBindType()

getFieldBindType(string  $type) : int

获取字段绑定类型

Parameters

string

$type

字段类型

Returns

int —

options()

options(array  $options) : $this

查询参数赋值

Parameters

array

$options

表达式参数

Returns

$this —

parsePkWhere()

parsePkWhere(array|string  $data, mixed  $options) : void

把主键值转换为查询条件支持复合主键

Parameters

array\|string	$data	主键数据
mixed	$options	表达式参数

Throws

\think\Exception

cacheData()

cacheData(string  $key, mixed  $data, array  $config = []) : mixed

缓存数据

Parameters

string	$key	缓存标识
mixed	$data	缓存数据
array	$config	缓存参数

Returns

mixed —

getCacheKey()

getCacheKey(mixed  $value, array  $options, array  $bind = []) : string

生成缓存标识

Parameters

mixed	$value	缓存数据
array	$options	缓存参数
array	$bind	绑定参数

Returns

string —

throwNotFound()

throwNotFound(array  $options = []) : mixed

查询失败抛出异常

Parameters

array

$options

查询参数

Throws

\think\db\exception\ModelNotFoundException
\think\db\exception\DataNotFoundException

Returns

mixed —

parseExpress()

parseExpress() : array

分析表达式（可用于查询或者写入操作）

Returns

array —

trigger()

trigger(string  $event, mixed  $params = []) : bool

触发事件

Parameters

string	$event	事件名
mixed	$params	额外参数

Returns

bool —

checkMultiField()

checkMultiField(string  $field, string  $logic) : bool

检查是否存在一个字段多次查询条件

Parameters

string	$field	查询字段
string	$logic	查询逻辑 and or xor

Returns

bool —