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) | ||||