monkeyslegion/monkeyslegiondb

Monkeyslegion PHP 框架的数据库连接管理器。

0.0.2 2023-08-31 00:32 UTC

This package is auto-updated.

Last update: 2024-09-30 01:51:13 UTC


README

MonkeyslegionDB 是专为 Monkeyslegion PHP 框架设计的数据库连接管理器。它提供了一套强大的功能,用于处理数据库连接、查询构建、事务和日志记录。

功能

  • 连接池:有效地管理和重用数据库连接。
  • 查询构建器:以编程方式构建 SQL 查询。
  • 事务:原子地执行一组操作。
  • 日志记录:记录 SQL 查询并调试问题。

需求

  • PHP 8.2 或更高版本
  • Composer 用于依赖管理

安装

要安装 MonkeyslegionDB,请运行以下 Composer 命令

composer require monkeyslegion/monkeyslegiondb

用法

连接池

use Monkeyslegion\\MonkeyslegionDB\\ConnectionPool;

$connection = ConnectionPool::getConnection();

函数

  • setConfig(array $config): void:设置数据库配置。
  • getConnection(): PDO:从池中检索 PDO 连接。
  • releaseConnection(PDO $connection): void:将 PDO 连接释放回池中。

查询构建

use Monkeyslegion\\MonkeyslegionDB\\QueryBuilder;

$query = (new QueryBuilder())
.select('*')
.from('users')
.where('id', '=', 1)
.build();

函数

  • select(string $columns): self:设置要选择的列。
  • from(string $table): self:设置要查询的表。
  • where(string $column, string $operator, mixed $value): self:添加 WHERE 条件。
  • build(): string:构建并返回 SQL 查询。

事务

use Monkeyslegion\\MonkeyslegionDB\\Transaction;

$transaction = new Transaction($connection);
$transaction->begin();
// ... perform operations
$transaction->commit();

函数

  • begin(): bool:开始新事务。
  • commit(): bool:提交当前事务。
  • rollback(): bool:回滚当前事务。

日志记录

use Monkeyslegion\\MonkeyslegionDB\\Logger;

$dbLogger = new Logger($yourPsr3Logger);
$dbLogger->logQuery('SELECT * FROM users WHERE id = ?', [1]);

函数

  • logQuery(string $query, array $params = []): void:记录已执行的 SQL 查询。
  • logError(string $message): void:记录错误消息。

文档

有关详细文档,请访问 我们的文档站点

贡献

我们欢迎贡献!请参阅我们的 贡献指南 以获取更多信息。

许可

MonkeyslegionDB 是开源软件,采用 MIT 许可证