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

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

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 代码，没有任何显式的异步写法：

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 个下载任务并发执行，只需要补几行代码：

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 对象会发生什么：

$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 甚至可能提交另一个协程的改动，这本质上就是典型的数据竞争。

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

$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：

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：

# 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 安装预编译二进制：

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 最重要的工具之一。对于一个仍处于实验阶段、但已经开始走向真实应用场景的异步运行时来说，越早在真实项目与真实边界条件中暴露问题，就越有助于后续版本收敛。