comphp/dbengine

提供统一的数据库引擎访问,无论底层连接如何

v0.1.2 2024-08-04 15:01 UTC

This package is auto-updated.

Last update: 2024-09-04 15:13:09 UTC


README

CommonPHP的数据库库是PHP应用程序中数据库交互和管理的工具包。它提供了一组全面的特性,用于连接数据库、对象化查询、执行查询和高效处理结果。

特性

  • 连接管理:简化数据库连接的设置和管理。
  • 查询构建器:提供流畅的接口用于构建SQL查询,包括参数管理和动态查询部分(SELECT * FROM {0} WHERE id=@id)
  • 类型转换:提供了一种可扩展的系统,用于在PHP类型和数据库类型之间进行转换。
  • 异常处理:包括详细的异常,用于精确处理数据库操作中的错误。

组件

该库结构化为几个关键组件,包括连接管理器、查询构建器和各种类型转换器。它还定义了可扩展性的接口和契约,以及一系列异常,用于健壮的错误管理。

要求

需要PHP 8.3或更高版本,并构建为与其他CommonPHP库无缝集成。

安装

使用Composer进行安装

composer require comphp/dbengine

基本用法

初始化连接管理器,并使用查询构建器创建和执行数据库查询。可以使用类型转换器处理复杂数据类型,并在数据库操作过程中遇到任何错误时抛出异常。

扩展库

通过遵循提供的接口,可以实现自定义类型转换器,增强库的灵活性和对不同数据库系统和要求的适应性。

文档

有关详细示例和用法说明,请参阅每个组件中的源代码和PHPDoc注释。

贡献

欢迎贡献,请遵循存储库中提供的贡献指南。

测试

该库包括使用PHPUnit的单元测试。提供了运行测试的说明,鼓励为维护高测试覆盖率做出贡献。

许可证

根据MIT许可证许可,促进在项目中开放和宽容的使用。