Download the PHP package wazsmwazsm/db without Composer

DB Query Builder

一个简单好用的查询构造器，基于 PDO，支持 mysql、postgresql、sqlite，支持常驻内存模式的断线重连。

安装

依赖

• php pdo 扩展
• php pdo_mysql 扩展（可选）
• php pdo_pgsql 扩展（可选）
• php pdo_sqlite 扩展（可选）

如何开始

初始化配置

查询构造器支持多个数据库连接，初始化后每个连接以单例的形式存在。

获取连接

模型

这里的模型并不是 ORM 模型，它只是为了方便操作而对查询构造器 \DB\DB 的一个封装。

查询数据

获取结果

获取结果的方法有：get，row，getList，count，sum，avg，max，min。参数等信息参考 ConnectorInterface。

获取结果集

table 方法用来指定查询的数据表。

get 方法用来获取结果集，返回值是一个查询结果的数组。

获取一行数据

select 方法用来指定要取的列，select('*\') 代表取所有列 (此时 select 可以省略不写)。

row 方法用来获取一行数据。

获取一列

有时候我们需要获得某一列的数据，这时 getList 方法就派上用场了，getList 方法直接返回该列值的数组。

聚合函数

查询构造器为获取聚合函数的结果做了封装，你可以使用 count，sum 等方法获取聚合数据。

如果要执行 count(distinct name) 此类的 SQL，请使用 countRaw() 方法

where 子句

构建 where 子句的方法有 where、orWhere。

where 、orWhere 方法的参数支持三种模式：

• where(['name' => 'mike', 'age' => 18])
• where('age', 24)
• where('score', '>=', 60)、where('tag', 'like', '%php%')

一些常用的例子：

对于 null 的条件查询，查询构造器提供了 whereNull、whereNotNull 等方法：

注：where is null 子句的构造提供 whereNull、orWhereNull、whereNotNull、orWhereNotNull 四个方法。

where between 子句：

注：where between 子句的构造提供 whereBetween、orWhereBetween 个方法。

where in 子句：

注：where in 子句的构造提供 whereIn、orWhereIn、whereNotIn、orWhereNotIn 四个方法。

复杂 where 子句

where exists 子句：

注：where exists 子句的构造提供 whereExists、orWhereExists、whereNotExists、orWhereNotExists 四个方法。

where in 子查询：

注：where in 子查询的构造提供 whereInSub、orWhereInSub、whereNotInSub、orWhereNotInSub 四个方法。

对于复杂的 where 逻辑，我们经常使用圆括号来确定优先级。查询构造器提供了 whereBrackets() 和 orWwhereBrackets() 方法来添加圆括号。

子查询

查询构造器提供了 fromSub 方法进行子查询：

分组

查询构造器提供了 group 方法对字段进行分组，having (orHaving) 方法进行分组条件筛选。

having 方法和 where 方法一样支持三种参数模式，这里就不再赘述。

查询构造器还提供了一个输入原生字符串的 havingRaw 方法，可以处理一些复杂的情况：

排序

查询构造器提供了 orderBy 方法对查询结果排序：

limit

查询构造器提供了 limit 方法来取一定范围的数据：

分页

查询构造器提供了 paginate 方法实现了数据的分页读取，底层基于 limit 方法。

假设有 35 条数据，每页有 10 条数据，我们取第 2 页的数据，做如下查询：

paginate 方法返回结果：

关联

查询构造器提供了 join、leftJoin、rightJoin 三个方法来实现关联查询的构造。

注： 使用关联查询后，防止字段重名字段需要带表前缀。 sqlite 不支持 RIGHT JOIN 语言，rightJoin 方法在 sqlite 中不生效。

一些例子：

构造复杂的语句

查询构造器提供了灵活的接口，有了上面的基础，我们现在构造一些复杂的查询：

DML 语句

除了基本的查询，查询构造器还提供了基础的 DML 操作，如插入、跟新、删除。

插入

insert 方法：

获取插入 ID，insertGetLastId 方法：

更新

update 方法。

注：为了安全考虑，update 方法必须要和 where 子句一起使用，否则会抛出 InvalidArgumentException 异常。

删除

delete 方法。

注：为了安全考虑，delete 方法必须要和 where 子句一起使用，否则会抛出 InvalidArgumentException 异常。

事务

查询构造器提供了 beginTrans、commitTrans、rollBackTrans 三个方法来支持事务：

事务回滚：

提交事务：

License

The DB is open-sourced software licensed under the MIT license.