comphp / dbengine
提供统一的数据库引擎访问,无论底层连接如何
v0.1.2
2024-08-04 15:01 UTC
Requires
- php: ^8.3
- psr/container: ^2.0
Requires (Dev)
- phpunit/phpunit: ^10.5.9
README
CommonPHP的数据库库是PHP应用程序中数据库交互和管理的工具包。它提供了一组全面的特性,用于连接数据库、对象化查询、执行查询和高效处理结果。
特性
- 连接管理:简化数据库连接的设置和管理。
- 查询构建器:提供流畅的接口用于构建SQL查询,包括参数管理和动态查询部分(SELECT * FROM {0} WHERE id=@id)
- 类型转换:提供了一种可扩展的系统,用于在PHP类型和数据库类型之间进行转换。
- 异常处理:包括详细的异常,用于精确处理数据库操作中的错误。
组件
该库结构化为几个关键组件,包括连接管理器、查询构建器和各种类型转换器。它还定义了可扩展性的接口和契约,以及一系列异常,用于健壮的错误管理。
要求
需要PHP 8.3或更高版本,并构建为与其他CommonPHP库无缝集成。
安装
使用Composer进行安装
composer require comphp/dbengine
基本用法
初始化连接管理器,并使用查询构建器创建和执行数据库查询。可以使用类型转换器处理复杂数据类型,并在数据库操作过程中遇到任何错误时抛出异常。
扩展库
通过遵循提供的接口,可以实现自定义类型转换器,增强库的灵活性和对不同数据库系统和要求的适应性。
文档
有关详细示例和用法说明,请参阅每个组件中的源代码和PHPDoc注释。
贡献
欢迎贡献,请遵循存储库中提供的贡献指南。
测试
该库包括使用PHPUnit的单元测试。提供了运行测试的说明,鼓励为维护高测试覆盖率做出贡献。
许可证
根据MIT许可证许可,促进在项目中开放和宽容的使用。