boa框架开发手册v5.2

builder类
版本 1.0+
命名空间 boa\database
文件 boa/database/builder.php
说明 查询构造器类
目录
方法 说明
__construct() 初始化
distinct() 设置SQL中distinct部分,用于排重
field() 设置SQL中field部分,查询字段,如未设置系统则使用 *
force() 设置SQL中force index部分,强制索引
join() 设置SQL中join部分,连接查询,支持多表(多次调用)
where() 设置SQL中where部分,查询条件
group() 设置SQL中group by部分,分组汇总
having() 设置SQL中having部分,过滤条件
order() 设置SQL中order by部分,结果排序
limit() 设置SQL中limit部分,用于结果分页
union() 设置SQL中union部分,联合查询,支持多次调用
union_all() 设置SQL中union all部分,允许重复记录的联合查询,支持多次调用
lock() 设置SQL中锁部分,操作加锁
getsql() 设置返回SQL语句,而不是操作结果(SQL没有实际执行)
select() 查询操作
insert() 插入操作
update() 更新操作
delete() 删除操作
error() 获取最近一条错误
方法

__construct()

说明
初始化
参数 必须 默认值 类型 说明
$table Y string 要操作的数据表名,支持别名

distinct()

说明
设置SQL中distinct部分,用于排重
参数 必须 默认值 类型 说明
$field Y string 要排重的字段名,支持别名

field()

说明
设置SQL中field部分,查询字段,如未设置系统则使用 *
参数 必须 默认值 类型 说明
$field Y string 字段或聚合函数,支持别名

force()

说明
设置SQL中force index部分,强制索引
参数 必须 默认值 类型 说明
$index Y string 索引名

join()

说明
设置SQL中join部分,连接查询,支持多表(多次调用)
参数 必须 默认值 类型 说明
$table Y string 要连接的数据表名,支持别名
$on Y string 连接条件
$type LEFT string 连接类型,INNER=交集,LEFT=左连,RIGHT=右连,FULL=并集

where()

说明
设置SQL中where部分,查询条件
参数 必须 默认值 类型 说明
$where Y string 条件语句,支持占位符?

group()

说明
设置SQL中group by部分,分组汇总
参数 必须 默认值 类型 说明
$field Y string 字段或聚合函数

having()

说明
设置SQL中having部分,过滤条件
参数 必须 默认值 类型 说明
$where Y string 条件语句,支持占位符?

order()

说明
设置SQL中order by部分,结果排序
参数 必须 默认值 类型 说明
$order Y string 字段或聚合函数的排序条件,支持多列

limit()

说明
设置SQL中limit部分,用于结果分页
参数 必须 默认值 类型 说明
$limit Y string 设置偏移和行数

union()

说明
设置SQL中union部分,联合查询,支持多次调用
参数 必须 默认值 类型 说明
$sql Y string SQL语句,支持占位符?

union_all()

说明
设置SQL中union all部分,允许重复记录的联合查询,支持多次调用
参数 必须 默认值 类型 说明
$sql Y string SQL语句,支持占位符?

lock()

说明
设置SQL中锁部分,操作加锁
参数 必须 默认值 类型 说明
$lock Y string 锁类型,支持自定义值
share=共享锁,update=排他锁

getsql()

说明
设置返回SQL语句,而不是操作结果(SQL没有实际执行)

select()

说明
查询操作
参数 必须 默认值 类型 说明
$type 0 int 返回类型,0=返回所有记录,1=返回一条记录
$db Y object 数据库驱动实例
返回值
如果设置getsql(),直接返回SQL语句(string),否则返回操作结果:成功时数组(array),失败时false(bool)

insert()

说明
插入操作
参数 必须 默认值 类型 说明
$data Y array 要插入的数据
$db Y object 数据库驱动实例
返回值
如果设置getsql(),直接返回SQL语句(string),否则返回操作结果:成功时ID(int),失败时false(bool)

update()

说明
更新操作
参数 必须 默认值 类型 说明
$data Y array 要更新的数据
$db Y object 数据库驱动实例
返回值
如果设置getsql(),直接返回SQL语句(string),否则返回操作结果:成功时受影响的行数(int),失败时false(bool)

delete()

说明
删除操作
参数 必须 默认值 类型 说明
$db Y object 数据库驱动实例
返回值
如果设置getsql(),直接返回SQL语句(string),否则返回操作结果:成功时受影响的行数(int),失败时false(bool)

error()

说明
获取最近一条错误
返回值
返回错误描述(string)