trait Query

Trait Query

Properties

$wlink
$rlink

Methods

where(string|array $column, string $value = '')

where条件组装 相等

whereColumn(string $column, string $column2)

where条件组装 两个列相等

whereRaw(string $where, array $params)

where条件原生条件

whereNot(string $column, string $value)

where条件组装 不等

whereGt(string $column, string $value)

where条件组装 大于

whereLt(string $column, string $value)

where条件组装 小于

whereGte(string $column, string $value)

where条件组装 大于等于

whereLte(string $column, string $value)

where条件组装 小于等于

whereIn(string $column, array $value)

where条件组装 in

whereNotIn(string $column, array $value)

where条件组装 not in

whereRegExp(string $column, string $value)

where条件组装 REGEXP

whereLike(string $column, bool $leftBlur = false, string $value = null, bool $rightBlur = false)

where条件组装 LIKE

whereNotLike(string $column, bool $leftBlur = false, string $value = null, bool $rightBlur = false)

where条件组装 LIKE

whereBetween(string $column, string $value, string $value2 = null)

where条件组装 BETWEEN

whereNotBetween(string $column, string $value, string $value2 = null)

where条件组装 NOT BETWEEN

whereNull(string $column)

where条件组装 IS NULL

whereNotNull(string $column)

where条件组装 IS NOT NULL

_and(callable $callable = null)

增加 and条件操作符

_or(callable $callable = null)

增加or条件操作符

lBrackets()

where条件增加左括号

rBrackets()

where条件增加右括号

columns(string|array $columns = '*')

选择列

$this;
addRawColumnPleaseUseCautiousIsMaybeUnsafe(string $column, array $bindParams = [])

No description

array
parseStringColumn(mixed $column)

解析字符串的字段 id, name,ctime 为数组

bool
haveMysqlFunction(string $column)

是否包含mysql函数

limit(int $offset = 0, int $limit = 10)

LIMIT

forceIndex(string $table, string $index, string $tablePrefix = null)

强制使用索引

orderBy(string $column, string $order = 'ASC')

排序

groupBy(string $column)

分组

having(string $column, string $operator = '=', string|array $value = null, string $logic = 'AND')

having语句

union(string|array $sql, bool $all = false)

union联结

bool
transaction(callable $query)

执行

paramsAutoReset(bool $autoReset = true, bool $alwaysClearTable = false, bool $alwaysClearColumns = true)

orm参数是否自动重置, 默认在执行语句后会重置orm参数,包含查询的表、字段信息、条件等信息

noCache()

标记本次查询不使用缓存

array
pluck(string $column, null $key = null, int $limit = null, bool $useMaster = false)

获取数据列值列表

plunk() deprecated

No description

chunk(int $num = 100, callable $func = null)

组块结果集-此方法前调用paramsAutoReset无效

bool|mixed
getOneValue(string $column, bool $useMaster = false)

获取一列

mixed
exists(bool|string $useMaster = false)

数据是否存在

mixed
doesntExist(bool|string $useMaster = false)

数据是否不存在

bool
startTransAction()

开启事务

bool
commit()

提交事务

bool
savePoint(string $pointName)

设置一个事务保存点

bool
rollBack(bool $rollBackTo = false)

回滚事务

Details

at line 37
Query where(string|array $column, string $value = '')

where条件组装 相等

Parameters

string|array $column 如 id user.id (这边的user为表别名如表pre_user as user 这边用user而非带前缀的原表名) 当$column为数组时 批量设置
string $value |int $value 当$column为数组时 此时$value为false时条件为or 否则为and

Return Value

Query

at line 60
Query whereColumn(string $column, string $column2)

where条件组装 两个列相等

Parameters

string $column eg:username | user.username
string $column2 eg: nickname | user.nickname

Return Value

Query

at line 76
Query whereRaw(string $where, array $params)

where条件原生条件

Parameters

string $where eg:utime > ctime + ?
array $params eg: [10]

Return Value

Query

at line 90
Query whereNot(string $column, string $value)

where条件组装 不等

Parameters

string $column 如 id user.id (这边的user为表别名如表pre_user as user 这边用user而非带前缀的原表名)
string $value |int $value

Return Value

Query

at line 104
Query whereGt(string $column, string $value)

where条件组装 大于

Parameters

string $column 如 id user.id (这边的user为表别名如表pre_user as user 这边用user而非带前缀的原表名)
string $value |int $value

Return Value

Query

at line 118
Query whereLt(string $column, string $value)

where条件组装 小于

Parameters

string $column 如 id user.id (这边的user为表别名如表pre_user as user 这边用user而非带前缀的原表名)
string $value |int $value

Return Value

Query

at line 132
Query whereGte(string $column, string $value)

where条件组装 大于等于

Parameters

string $column 如 id user.id (这边的user为表别名如表pre_user as user 这边用user而非带前缀的原表名)
string $value |int $value

Return Value

Query

at line 146
Query whereLte(string $column, string $value)

where条件组装 小于等于

Parameters

string $column 如 id user.id (这边的user为表别名如表pre_user as user 这边用user而非带前缀的原表名)
string $value |int $value

Return Value

Query

at line 160
Query whereIn(string $column, array $value)

where条件组装 in

Parameters

string $column 如 id user.id (这边的user为表别名如表pre_user as user 这边用user而非带前缀的原表名)
array $value

Return Value

Query

at line 174
Query whereNotIn(string $column, array $value)

where条件组装 not in

Parameters

string $column 如 id user.id (这边的user为表别名如表pre_user as user 这边用user而非带前缀的原表名)
array $value [1,2,3]

Return Value

Query

at line 188
Query whereRegExp(string $column, string $value)

where条件组装 REGEXP

Parameters

string $column 如 id user.id (这边的user为表别名如表pre_user as user 这边用user而非带前缀的原表名)
string $value |int $value

Return Value

Query

at line 204
Query whereLike(string $column, bool $leftBlur = false, string $value = null, bool $rightBlur = false)

where条件组装 LIKE

Parameters

string $column 如 id user.id (这边的user为表别名如表pre_user as user 这边用user而非带前缀的原表名)
bool $leftBlur 是否开始左模糊匹配
string $value |int $value
bool $rightBlur 是否开始右模糊匹配

Return Value

Query

at line 224
Query whereNotLike(string $column, bool $leftBlur = false, string $value = null, bool $rightBlur = false)

where条件组装 LIKE

Parameters

string $column 如 id user.id (这边的user为表别名如表pre_user as user 这边用user而非带前缀的原表名)
bool $leftBlur 是否开始左模糊匹配
string $value |int $value
bool $rightBlur 是否开始右模糊匹配

Return Value

Query

at line 243
Query whereBetween(string $column, string $value, string $value2 = null)

where条件组装 BETWEEN

Parameters

string $column 如 id user.id (这边的user为表别名如表pre_user as user 这边用user而非带前缀的原表名)
string $value |int | array $value
string $value2 |int | null $value2

Return Value

Query

at line 266
Query whereNotBetween(string $column, string $value, string $value2 = null)

where条件组装 NOT BETWEEN

Parameters

string $column 如 id user.id (这边的user为表别名如表pre_user as user 这边用user而非带前缀的原表名)
string $value |int | array $value
string $value2 |int | null $value2

Return Value

Query

at line 287
Query whereNull(string $column)

where条件组装 IS NULL

Parameters

string $column 如 id user.id (这边的user为表别名如表pre_user as user 这边用user而非带前缀的原表名)

Return Value

Query

at line 300
Query whereNotNull(string $column)

where条件组装 IS NOT NULL

Parameters

string $column 如 id user.id (这边的user为表别名如表pre_user as user 这边用user而非带前缀的原表名)

Return Value

Query

at line 313
Query _and(callable $callable = null)

增加 and条件操作符

Parameters

callable $callable 如果传入函数则函数内执行的条件会被()包围

Return Value

Query

at line 335
Query _or(callable $callable = null)

增加or条件操作符

Parameters

callable $callable 如果传入函数则函数内执行的条件会被()包围

Return Value

Query

at line 355
Query lBrackets()

where条件增加左括号

Return Value

Query

at line 377
Query rBrackets()

where条件增加右括号

Return Value

Query

at line 391
Query columns(string|array $columns = '*')

选择列

Parameters

string|array $columns 默认选取所有 ['id, 'name'] 选取id,name两列,['article.id' => 'aid', 'article.title' => 'article_title'] 别名

Return Value

Query

at line 420
$this; addRawColumnPleaseUseCautiousIsMaybeUnsafe(string $column, array $bindParams = [])

Parameters

string $column
array $bindParams

Return Value

$this;

at line 434
protected array parseStringColumn(mixed $column)

解析字符串的字段 id, name,ctime 为数组

Parameters

mixed $column

Return Value

array

at line 454
protected bool haveMysqlFunction(string $column)

是否包含mysql函数

->columns("DATE_FORMAT(from_unixtime(createtime),'%%H') as hour,SUM(value) AS nums,COUNT(DISTINCT identity) AS num")

Parameters

string $column

Return Value

bool

at line 472
Query limit(int $offset = 0, int $limit = 10)

LIMIT

Parameters

int $offset 偏移量
int $limit 返回的条数

Return Value

Query

at line 491
Query forceIndex(string $table, string $index, string $tablePrefix = null)

强制使用索引

Parameters

string $table 要强制索引的表名(不带前缀)
string $index 要强制使用的索引
string $tablePrefix 表前缀 不传则获取配置中配置的前缀

Return Value

Query

at line 507
Query orderBy(string $column, string $order = 'ASC')

排序

Parameters

string $column 要排序的字段
string $order 方向,默认为正序

Return Value

Query

at line 529
Query groupBy(string $column)

分组

Parameters

string $column 要设置分组的字段名

Return Value

Query

at line 551
Query having(string $column, string $operator = '=', string|array $value = null, string $logic = 'AND')

having语句

Parameters

string $column 字段名
string $operator 操作符
string|array $value
string $logic 逻辑AND OR

Return Value

Query

at line 575
Query union(string|array $sql, bool $all = false)

union联结

Parameters

string|array $sql 要union的sql
bool $all 是否为union all

Return Value

Query

at line 597
bool transaction(callable $query)

执行

Parameters

callable $query

Return Value

bool

Exceptions

Exception

at line 618
Query paramsAutoReset(bool $autoReset = true, bool $alwaysClearTable = false, bool $alwaysClearColumns = true)

orm参数是否自动重置, 默认在执行语句后会重置orm参数,包含查询的表、字段信息、条件等信息

Parameters

bool $autoReset 是否自动重置 查询的表、字段信息、条件等信息
bool $alwaysClearTable 用来控制在$paramsAutoReset = false 的时候是否清除查询的table信息.避免快捷方法重复调用table();
bool $alwaysClearColumns 用来控制在$paramsAutoReset = false 的时候是否清除查询的字段信息.主要用于按批获取数据不用多次调用columns();

Return Value

Query

at line 631
Query noCache()

标记本次查询不使用缓存

Return Value

Query

at line 647
array pluck(string $column, null $key = null, int $limit = null, bool $useMaster = false)

获取数据列值列表

Parameters

string $column 列名
null $key 返回数组中为列值指定自定义键(该自定义键必须是该表的其它字段列名)
int $limit 返回的条数
bool $useMaster 是否使用主库 默认读取从库

Return Value

array

at line 662
plunk() deprecated

deprecated 请使用pluck方法

at line 673
chunk(int $num = 100, callable $func = null)

组块结果集-此方法前调用paramsAutoReset无效

Parameters

int $num 每次获取的条数
callable $func 结果集处理函数。本回调函数内调用paramsAutoReset无效

at line 710
bool|mixed getOneValue(string $column, bool $useMaster = false)

获取一列

Parameters

string $column 列名
bool $useMaster 是否使用主库 默认读取从库

Return Value

bool|mixed

at line 724
mixed exists(bool|string $useMaster = false)

数据是否存在

Parameters

bool|string $useMaster 是否使用主库 默认读取从库

Return Value

mixed

at line 736
mixed doesntExist(bool|string $useMaster = false)

数据是否不存在

Parameters

bool|string $useMaster 是否使用主库 默认读取从库

Return Value

mixed

at line 746
bool startTransAction()

开启事务

Return Value

bool

at line 757
bool commit()

提交事务

Return Value

bool

at line 770
bool savePoint(string $pointName)

设置一个事务保存点

Parameters

string $pointName

Return Value

bool

at line 783
bool rollBack(bool $rollBackTo = false)

回滚事务

Parameters

bool $rollBackTo 是否为还原到某个保存点

Return Value

bool