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() | 删除操作 |
方法
说明 | ||||
---|---|---|---|---|
初始化 | ||||
参数 | 必须 | 默认值 | 类型 | 说明 |
$table | Y | string | 要操作的数据表名,支持别名 |
说明 | ||||
---|---|---|---|---|
设置SQL中distinct部分,用于排重 | ||||
参数 | 必须 | 默认值 | 类型 | 说明 |
$field | Y | string | 要排重的字段名,支持别名 |
说明 | ||||
---|---|---|---|---|
设置SQL中field部分,查询字段,如未设置系统则使用 * | ||||
参数 | 必须 | 默认值 | 类型 | 说明 |
$field | Y | string | 字段或聚合函数,支持别名 |
说明 | ||||
---|---|---|---|---|
设置SQL中force index部分,强制索引 | ||||
参数 | 必须 | 默认值 | 类型 | 说明 |
$index | Y | string | 索引名 |
说明 | ||||
---|---|---|---|---|
设置SQL中join部分,连接查询,支持多表(多次调用) | ||||
参数 | 必须 | 默认值 | 类型 | 说明 |
$table | Y | string | 要连接的数据表名,支持别名 | |
$on | Y | string | 连接条件 | |
$type | LEFT | string | 连接类型,INNER=交集,LEFT=左连,RIGHT=右连,FULL=并集 |
说明 | ||||
---|---|---|---|---|
设置SQL中where部分,查询条件 | ||||
参数 | 必须 | 默认值 | 类型 | 说明 |
$where | Y | string | 条件语句,支持占位符? |
说明 | ||||
---|---|---|---|---|
设置SQL中group by部分,分组汇总 | ||||
参数 | 必须 | 默认值 | 类型 | 说明 |
$field | Y | string | 字段或聚合函数 |
说明 | ||||
---|---|---|---|---|
设置SQL中having部分,过滤条件 | ||||
参数 | 必须 | 默认值 | 类型 | 说明 |
$where | Y | string | 条件语句,支持占位符? |
说明 | ||||
---|---|---|---|---|
设置SQL中order by部分,结果排序 | ||||
参数 | 必须 | 默认值 | 类型 | 说明 |
$order | Y | string | 字段或聚合函数的排序条件,支持多列 |
说明 | ||||
---|---|---|---|---|
设置SQL中limit部分,用于结果分页 | ||||
参数 | 必须 | 默认值 | 类型 | 说明 |
$limit | Y | string | 设置偏移和行数 |
说明 | ||||
---|---|---|---|---|
设置SQL中union部分,联合查询,支持多次调用 | ||||
参数 | 必须 | 默认值 | 类型 | 说明 |
$sql | Y | string | SQL语句,支持占位符? |
说明 | ||||
---|---|---|---|---|
设置SQL中union all部分,允许重复记录的联合查询,支持多次调用 | ||||
参数 | 必须 | 默认值 | 类型 | 说明 |
$sql | Y | string | SQL语句,支持占位符? |
说明 | ||||
---|---|---|---|---|
设置SQL中锁部分,操作加锁 | ||||
参数 | 必须 | 默认值 | 类型 | 说明 |
$lock | Y | string | 锁类型,支持自定义值 share=共享锁,update=排他锁 |
说明 | ||||
---|---|---|---|---|
设置返回SQL语句,而不是操作结果(SQL没有实际执行) |
说明 | ||||
---|---|---|---|---|
查询操作 | ||||
参数 | 必须 | 默认值 | 类型 | 说明 |
$type | 0 | int | 返回类型,0=返回所有记录,1=返回一条记录 | |
$db | Y | object | 数据库驱动实例 | |
返回值 | ||||
如果设置getsql(),直接返回SQL语句(string),否则返回操作结果:成功时数组(array),失败时false(bool) |
说明 | ||||
---|---|---|---|---|
插入操作 | ||||
参数 | 必须 | 默认值 | 类型 | 说明 |
$data | Y | array | 要插入的数据 | |
$db | Y | object | 数据库驱动实例 | |
返回值 | ||||
如果设置getsql(),直接返回SQL语句(string),否则返回操作结果:成功时ID(int),失败时false(bool) |
说明 | ||||
---|---|---|---|---|
更新操作 | ||||
参数 | 必须 | 默认值 | 类型 | 说明 |
$data | Y | array | 要更新的数据 | |
$db | Y | object | 数据库驱动实例 | |
返回值 | ||||
如果设置getsql(),直接返回SQL语句(string),否则返回操作结果:成功时受影响的行数(int),失败时false(bool) |
说明 | ||||
---|---|---|---|---|
删除操作 | ||||
参数 | 必须 | 默认值 | 类型 | 说明 |
$db | Y | object | 数据库驱动实例 | |
返回值 | ||||
如果设置getsql(),直接返回SQL语句(string),否则返回操作结果:成功时受影响的行数(int),失败时false(bool) |