2025年9月25日: PostgreSQL 18 发布!

PHP 发布 pg_builder 1.0.0 和 pg_wrapper 1.0.0 包

发布于 2021-07-06 by Alexey Borzov
相关开源项目

我很高兴地宣布 pg_builderpg_wrapper 包的第一个稳定版本发布。

这两个包现在需要 PHP 7.2+,并且支持 PHP 8,并已通过 phpstan 和 psalm 工具的静态代码分析。

pg_builder 版本 1.0.0

pg_builder 是一个用于 Postgres 的查询构建器,它部分 PHP 重实现了 PostgreSQL 自己的 SQL 解析器。它支持 Postgres 13 中几乎所有的 SELECT(和 VALUES)、INSERTUPDATEDELETE 查询的语法。

使用 pg_builder,您可以从手动编写的查询开始,将其解析为抽象语法树(AST),然后向该树添加查询部分(可以是 Node 对象或字符串)或移除它们,最后将树转换回 SQL 字符串。

发行亮点

  • 实现了对字符串和标识符中 Unicode 转义的支持。
  • 修复了 FROM 子句中函数类结构的解析。
  • 在生成 SQL 时,可以选择以 PDO 而非 pg_wrapper / 原生 pgsql 扩展作为目标。
  • 显著的性能提升,尤其是在使用缓存存储解析后的查询时。

完整发行说明

该包可以从 Github 下载 或使用 Composer 安装

$ composer require sad_spirit/pg_builder

pg_builder 可以独立使用,将其与 pg_wrapper 一起使用可以运行构建的查询,并能透明地将查询参数转换为 Postgres 类型。

pg_wrapper 版本 1.0.0

pg_wrapper 提供了 PostgreSQL 数据类型的转换器,以及一个围绕 PHP 原生 pgsql 扩展的面向对象的封装,该封装使用了这些转换器。查询结果字段的转换是自动完成的,利用数据库元数据;查询参数可能需要指定类型。

对于有对应原生 PHP 类型或类的类型,将使用它们(text -> string,timestamp -> DateTimeImmutable,hstore -> 关联数组等)。对于其他类型(几何类型、范围类型),该包提供了自定义类。

发行亮点

  • 类型元数据已预先填充了 PostgreSQL 的内置数据类型。只有在使用自定义类型时才需要从 DB / 缓存加载元数据。
  • Connection::atomic() 方法接受一个可调用对象并以原子方式执行它。atomic() 调用可以嵌套,并且可以设置在最终 COMMITROLLBACK 之后执行的回调。
  • 专门的异常子类,根据 SQLSTATE 错误代码在数据库错误时抛出。
  • 表示数据库类型的对象现在是不可变的。

完整发行说明

该包可以从 Github 下载 或使用 Composer 安装

$ composer require sad_spirit/pg_wrapper