# 在 PHP 中写真正的异步代码 TrueAsync 0.6.0 已支持数据库链接池

现代软件的构建最终仍然要回到实践。再复杂的产品，也必须经过真实用户的检验。只有最终用户，才能真正区分哪些设计是有效的、哪些方向值得继续推进。再优雅的架构，如果没有落到真实代码和真实问题里，就很难体现实际价值。

TrueAsync 是一个将原生异步能力带入 PHP 的项目，而且这套能力是直接向语言核心延伸的。`0.6.0` 是这个项目的一个关键里程碑：这是一个实验性版本，目标是让开发者已经可以开始编写真正的异步代码，并尽可能测试各种极端场景。

从项目推进方式来看，作者希望尽早把工具交到开发者手里，再和社区一起验证哪些设计是可行的、哪些部分还需要调整。因此，这个版本本质上也是一次面向社区的实验邀请。

## 完全异步化的 PHP Core

`0.6.0` 中最激进的一项变化，是 PHP 核心已经实现了完整的异步化。

长期以来，PHP 的运行模型一直以同步阻塞为主。一次 I/O 操作往往会直接阻塞当前执行流程，直到操作完成。而在这个版本中，这种情况已经发生了根本变化。

文件 I/O、socket、pipe、`STDIO`、`STDERR`、`CURL` 等能力现在都可以真正并发执行。无论是打开一个进程、读取文件，还是发起 HTTP 请求，这些操作都会运行在内部的 `EventLoop` 之下。不需要额外包装器，也不需要专门适配器，普通 PHP 函数本身就可以在协程中以异步方式运行。

这件事的难点并不只是“修改 `plain_wrapper.c` 的行为”这么简单。真正落到 PHP 内部实现时，会涉及相当复杂的内部 API。除此之外，PHP 在启动和关闭阶段仍然必须保持同步，因为异步能力由扩展提供，而扩展本身并不能在所有生命周期阶段运行。这些问题也让版本发布时间一度被推迟了几周。

截至目前，已经有超过 `70` 个 PHP 标准函数完成适配，包括 `file_get_contents()`、`fread()`、`curl_exec()`、`PDO`、`mysqli`、`pg_connect()`、`socket_*`、`proc_open()`、`sleep()`，甚至还有 `ob_start()`。在协程内部，这些能力都会自动转为非阻塞执行。

## 一套新的异步编程 API

在设计 TrueAsync 的 API 时，项目参考了多种流行语言的异步模型，重点目标是提供一套足够顺手、能够解决日常问题的工具集。`0.6.0` 已经带来了一套接近完整的异步原语集合，和此前 TrueAsync RFC 中出现过的版本并不完全相同。

目前可用的核心能力包括：

- `Coroutines`：通过 `spawn()` 启动异步任务
- `Future`：一种更便于处理异步结果的 Promise 变体
- `Awaiting`：包括 `await`、`await_all()`、`await_first_success()`、`await_any_of()`、`delay()`、`suspend()`
- `Channels`：通过 `Channel` 在协程之间传递数据
- `Cancellation`：提供 `cancel()`、`protect()`、`timeout()` 等一次性取消能力
- `Scope`：用于管理一组协程的生命周期
- `TaskGroup` / `TaskSet`：提供结构化并发能力
- `Context`：为协程绑定上下文数据
- `iterate()`：并发处理集合
- `Pool` / `PDO Pool`：资源池与数据库连接池

这类 API 的完整说明更适合直接阅读项目文档：<https://true-async.github.io> 。从项目演示来看，像进程池这类过去往往要依赖完整框架组件才能完成的功能，现在可以直接通过这些原语组合实现。

完整变更列表可参考 `CHANGELOG`。

## 更深入的 CURL 集成

`CURL` 这一部分的实现显然是本次发布中最复杂的部分之一。原因在于，`CURL` 的 API 非常丰富，并且和 PHP 的 I/O 体系耦合得很深。比如，用 `CURL` 下载文件、上传文件到远程服务器，这些流程过去都严格运行在同步阻塞模型中。现在语言核心已经可以异步执行，那么 `CURL` 也必须一并纳入这套机制。

下面这个例子演示了如何并行下载 `20` 个 WordPress 插件。`downloadFile` 本身只是普通的 `curl_init` + `curl_exec` 代码，没有任何显式的异步写法：

```php
function downloadFile(string $url, string $savePath): array
{
    $fp = fopen($savePath, 'wb');
    $ch = curl_init($url);

    curl_setopt_array($ch, [
        CURLOPT_FILE           => $fp,
        CURLOPT_FOLLOWLOCATION => true,
        CURLOPT_MAXREDIRS      => 5,
        CURLOPT_TIMEOUT        => 120,
        CURLOPT_CONNECTTIMEOUT => 10,
        CURLOPT_FAILONERROR    => true,
    ]);

    $ok    = curl_exec($ch);
    $error = curl_error($ch);
    $info  = curl_getinfo($ch);

    fclose($fp);

    if (!$ok) {
        unlink($savePath);
        return ['success' => false, 'error' => $error ?: "HTTP {$info['http_code']}"];
    }

    return [
        'success'  => true,
        'filename' => basename($savePath),
        'bytes'    => $info['size_download'],
        'speed'    => round($info['speed_download'] / 1024, 1) . ' KB/s',
    ];
}
```

要让这 `20` 个下载任务并发执行，只需要补几行代码：

```php
use Async\TaskGroup;

$group = new TaskGroup();

foreach ($files as $file) {
    $group->spawn(downloadFile(...), $file['url'], $downloadDir . '/' . $file['filename']);
}

$results = $group->all();
```

按照项目给出的说法，这种写法的运行速度可以达到 `curl_multi_exec` 的两倍，同时语义上也更清晰。它背后的核心原则是：如果一个函数本身执行的是顺序 I/O，那么只要把它放进协程运行，就可以自然获得异步执行能力。

在 Linux 上，文件写入会在可行时使用 `IO_URING`；在 Windows 上则会走线程池。

## PDO Pool：开箱即用的连接池

异步 PHP 里的另一个典型难点，是数据库连接的管理。

作者提到，自己最初探索 PHP 异步编程时，最大的挫败感之一，就是常用数据库驱动很难直接拿来使用。原因在于，数据库连接不能简单在多个协程之间共享：如果两个执行路径同时在同一个 socket 上读写数据，数据流就会互相污染。而如果每个协程都独立新建数据库连接，又会浪费大量资源。MySQL 默认只允许 `151` 个连接，PostgreSQL 默认允许 `100` 个。

`0.6.0` 的一个亮点，是 `PDO` 现在已经支持内建数据库连接池。

下面先看在协程里直接共享普通 `PDO` 对象会发生什么：

```php
$pdo = new PDO('mysql:host=localhost;dbname=app', 'root', 'secret');

// Ten coroutines sharing a single $pdo
for ($i = 0; $i < 10; $i++) {
    spawn(function() use ($pdo, $i) {
        $pdo->beginTransaction();
        $pdo->exec("INSERT INTO orders (user_id) VALUES ($i)");
        // Another coroutine already called COMMIT on this same connection!
        $pdo->commit(); // Chaos
    });
}
```

这里的 `10` 个协程实际上共享的是同一个 socket。事务会互相交错，数据会丢失，一个协程的 `COMMIT` 甚至可能提交另一个协程的改动，这本质上就是典型的数据竞争。

而启用连接池之后，行为就完全不同：

```php
$pdo = new PDO('mysql:host=localhost;dbname=app', 'root', 'secret', [
    PDO::ATTR_POOL_ENABLED => true,
    PDO::ATTR_POOL_MIN     => 2,
    PDO::ATTR_POOL_MAX     => 10,
]);

// Ten coroutines, each gets its own connection
for ($i = 0; $i < 10; $i++) {
    spawn(function() use ($pdo, $i) {
        // The pool automatically assigns a connection to this coroutine
        $pdo->beginTransaction();
        $pdo->exec("INSERT INTO orders (user_id) VALUES ($i)");
        $pdo->commit();
        // The connection returns to the pool
    });
}
```

开发者只需要在创建对象时增加几个参数，剩下的交给池本身处理即可。连接池会自动为每个协程分配独立连接，并在协程结束后归还。事务天然隔离；如果某个协程结束前没有显式调用 `commit()`，连接池还会自动执行回滚。

此外，`PDO Pool` 还支持自定义 `CircuitBreakerStrategy`，用于在数据库出现异常时更平滑地限制负载；也支持 `POOL_HEALTHCHECK_INTERVAL`，用于检测并销毁池中的空闲连接。

更多细节可以参考项目中的 `PDO Pool` 文档说明。

## 如何试用

PHP TrueAsync 已经可以在主流平台上使用。最快的试用方式仍然是 Docker：

```bash
docker pull trueasync/php-true-async:0.6.0-php8.6
docker run --rm trueasync/php-true-async:0.6.0-php8.6 php -v
```

在 Linux 和 macOS 上，也可以通过安装脚本从源码编译 PHP：

```bash
# Linux (Ubuntu/Debian)
curl -fsSL https://raw.githubusercontent.com/true-async/releases/master/installer/build-linux.sh | bash

# macOS (requires Homebrew)
curl -fsSL https://raw.githubusercontent.com/true-async/releases/master/installer/build-macos.sh | bash
```

安装流程会通过交互式向导完成，包括扩展选择、安装路径和 `PATH` 配置。对于 CI 或脚本环境，项目也提供了基于环境变量的非交互模式。

在 Windows 上，则可以直接通过 PowerShell 安装预编译二进制：

```powershell
irm https://raw.githubusercontent.com/true-async/releases/master/installer/install.ps1 | iex
```

## php-community RFC：面向所有人的实验性 PHP

除 `0.6.0` 版本本身外，原文也提到了另一个值得关注的方向：`php-community RFC`。

目前负责 RFC 流程的 Daniil Gentili 提出了一份文档，目标是建立一个带有实验性特性的官方 PHP 分支，即 `php-community`。它会采用日期型版本号，例如 `php-community 2026.03.01`，并按月发布更新。

这一思路的核心在于：像异步能力、新的标准库函数、实验性优化器这类重大语言特性，可以作为内建的 feature extension 交付，具备独立版本号、默认关闭，并允许开发者用一行配置完成启用。

如果这一机制能够成立，它有机会消除实验性特性推广中最常见的障碍：安装复杂度。对于 TrueAsync 而言，这也可能成为面向更广泛 PHP 开发者交付异步能力的一条自然路径，甚至不必等到最终 RFC 正式落地之后才开始大规模验证。

## 接下来：0.7.0

从项目路线来看，接下来的版本重点会继续放在稳定性、性能和兼容性上。当前在 `0.6.0` 中引入的 API 未来仍然可能调整，但其整体设计方向大概率不会发生大的变化。

## 参与项目

TrueAsync 仍然是一个开放项目，社区可以通过多种方式参与推进。并不一定需要直接编写 C 代码，项目中的大量测试本身就是用 PHP 编写的。

在当前阶段，测试仍然是验证和改进 API 最重要的工具之一。对于一个仍处于实验阶段、但已经开始走向真实应用场景的异步运行时来说，越早在真实项目与真实边界条件中暴露问题，就越有助于后续版本收敛。

[在 PHP 中写真正的异步代码 TrueAsync0.6 已支持数据库链接池](https://catchadmin.com/post/2026-03/trueasync-0-6-0-write-real-async-code-in-php)

现代软件的构建最终仍然要回到实践。再复杂的产品，也必须经过真实用户的检验。只有最终用户，才能真正区分哪些设计是有效的、哪些方向值得继续推进。再优雅的架构，如果没有落到真实代码和真实问题里，就很难体现实际价值。

在 PHP 中写真正的异步代码 TrueAsync 0.6.0 已支持数据库链接池

编程语言

TrueAsync 0.6.0为PHP带来原生异步能力，支持文件I/O、CURL、数据库连接池等异步操作。通过协程实现非阻塞执行，提升性能2倍以上。PDO连接池自动管理数据库连接，确保事务隔离。支持Docker快速部署，适合高并发场景开发。

数据库连接池

PostgreSQL

数据库

服务器

WordPress

数据流

Windows

Ubuntu

Debian

MySQL

Linux

2026新春采购季

tencentdb-catalog

腾讯云数据库特惠，新用户首单0.5折起


postgres

4核4G3M云服务器 新用户低至38元/年！

文章

问答

视频

教程

学习中心

腾讯云实验室

直播

竞赛

腾讯云代码分析专区

腾讯iOA零信任安全管理系统专区

腾讯云架构师技术同盟交流圈

腾讯云数据库专区

腾讯云智能顾问专区

腾讯云原生专区

腾讯混元专区

腾讯云TCE专区

腾讯云Lighthouse专区

腾讯云HAI专区

腾讯云Edgeone专区

腾讯云存储专区

腾讯云智能专区

腾讯轻联专区 

腾讯云开发专区

TAPD专区

腾讯轻量云游戏服专区

腾讯云最具价值专家

腾讯云架构师技术同盟

腾讯云创作之星

腾讯云开发者先锋

腾讯云AI代码助手

云原生构建

TAPD 敏捷项目管理

Cloud Studio

SDK中心

API中心

命令行工具

功能1上新10个字符

功能2描述100个字符功能2描述100个字符功能2描述100个字符功能2描述100个字符功能2描述100个字符功能2描述100个字符功能2描述100个字符功能2描述100个字符功能2描述100个字符。

功能2上新100个字符功能2上新100个字符功能2上新100个字符功能2上新100个字符功能2上新100个字符功能2上新100个字符功能2上新100个字符功能2上新100个字符功能2上新100个字符。

功能5描述100个字符功能5描述100个字符功能5描述100个字符功能5描述100个字符功能5描述100个字符功能5描述100个字符

功能5上新100个字符功能5上新100个字符功能5上新100个字符功能5上新100个字符功能5上新100个字符功能5上新100个字符功能5上新100个字符功能5上新100个字符功能5上新100个字符功能5上新100个字符

功能4上新

文章&问答评论现已支持表情

全新交互，全新视觉，新增快捷键、悬浮工具栏、高亮块等功能并同时优化现有功能，全面提升创作效率和体验

社区富文本编辑器全新改版！诚邀体验～ 

精选全网热门MCP server，让你的AI更好用 🚀

💥开发者 MCP广场重磅上线！

涵盖代码开发、场景应用、自动测试全流程，助你从零构建专属AI助手

一站式MCP教程库，解锁AI应用新玩法

聚焦“写作效率、视觉美观与运行性能”三方面进行全面升级，为您提供更高效、稳定的创作环境

社区富文本&Markdown编辑器全新改版上线，欢迎大家体验!

诚挚邀请您参与本次调研，分享您的真实使用感受与建议。您的反馈至关重要，感谢您的支持与参与！

社区新版编辑器体验调研

在 PHP 中写真正的异步代码 TrueAsync 0.6.0 已支持数据库链接池-腾讯云开发者社区-腾讯云

在 PHP 中写真正的异步代码 TrueAsync 0.6.0 已支持数据库链接池

在 PHP 中写真正的异步代码 TrueAsync 0.6.0 已支持数据库链接池

社区

活动

圈层

关于

腾讯云开发者

热门产品

热门推荐

更多推荐