PHPackages                             reactphp-x/cycle-database - PHPackages - PHPackages  [Skip to content](#main-content)[PHPackages](/)[Directory](/)[Categories](/categories)[Trending](/trending)[Leaderboard](/leaderboard)[Changelog](/changelog)[Analyze](/analyze)[Collections](/collections)[Log in](/login)[Sign up](/register)

1. [Directory](/)
2. /
3. [Database & ORM](/categories/database)
4. /
5. reactphp-x/cycle-database

ActiveLibrary[Database & ORM](/categories/database)

reactphp-x/cycle-database
=========================

v1.0.0(8mo ago)029MITPHP

Since Sep 16Pushed 6mo agoCompare

[ Source](https://github.com/reactphp-x/cycle-database)[ Packagist](https://packagist.org/packages/reactphp-x/cycle-database)[ RSS](/packages/reactphp-x-cycle-database/feed)WikiDiscussions master Synced 1mo ago

READMEChangelog (1)Dependencies (3)Versions (2)Used By (0)

reactphp-x/cycle-database
-------------------------

[](#reactphp-xcycle-database)

使用 ReactPHP 的 MySQL 连接池为 Cycle Database 提供异步驱动，在非阻塞环境下保持 Cycle 风格的同步 API（`$db->query()` / `$db->execute()` / 查询构建器等）。

基于组件：

- 驱动与管理：`ReactphpX\CycleDatabase\AsyncDatabaseManager`、`AsyncMysqlDriver`、`AsyncMySQLDriverConfig`、`AsyncTcpConnectionConfig`
- 查询/语句：`ReactphpX\CycleDatabase\AsyncDatabase`、`AsyncStatement`
- 依赖：`reactphp-x/mysql-pool`、`react/async`、`wpjscc/database`（Cycle Database 兼容实现）

### 特性

[](#特性)

- **异步驱动**：内部使用连接池与 `React\Async\await`，对外暴露同步风格接口
- **兼容 Cycle Database API**：支持 `select/insert/update/delete/upsert` 构建器与 `DatabaseInterface`
- **事务（回调）**：通过驱动的 `transaction(callable)` 以回调方式执行
- **流式查询**：驱动层提供 `queryStream()`，适合大结果集
- **连接池**：可配置最小/最大连接数、等待队列与超时

> 仅支持 MySQL（`AsyncMysqlDriver`）。

---

### 安装

[](#安装)

```
composer require reactphp-x/cycle-database
```

要求：PHP 8.1+（代码使用 `BackedEnum` 等特性），MySQL 5.7+/8.0+。

---

### 快速开始（Basic）

[](#快速开始basic)

```