代码 PHP 8.6 的 Io\Poll:换掉 stream_select 的内核后端,但没有 event loop

2026-11-17 21:01:06

PHP 8.6 的 Io\Poll:给 stream_select 换掉内核后端,但不带 event loop

PHP 8.6 计划于 2026-11-19 GA,新增一套原生 I/O 轮询 API,命名空间为 Io\Poll。它取代的是用户态代码里对 stream_select() 的直接依赖,把多路复用下沉到扩展层,并顺带提供内部 C API 供其他扩展共享同一套后端。

API 组成

  • Io\Poll\Context:轮询上下文,负责注册 watcher 和等待事件
  • Io\Poll\Watcher:单个被监视对象,可查询触发的事件
  • Io\Poll\Backend 枚举:后端类型
  • Io\Poll\Event 枚举:可读 / 可写等事件位
  • Io\Poll\Handle 接口:被监视句柄的抽象
  • StreamPollHandle:PHP stream 的实现

底层后端按平台选择:Linux 用 epoll,BSD/macOS 用 kqueue,Solaris 用 event ports,Windows 用 WSAPoll,其余平台回落到 poll。同时支持 edge-triggered 与 one-shot 两种模式。

官方示例

use Io\Poll\{Context, Event};
use Time\Duration;

$poll = new Context();

$server = stream_socket_server('tcp://0.0.0.0:8080');
stream_set_blocking($server, false);

// 注册服务端 socket,只关心可读事件;第三个参数是附带的自定义数据
$poll->add(new StreamPollHandle($server), [Event::Read], ['type' => 'server']);

while (true) {
    // 超时是 Time\Duration 对象,这里是 1 秒
    foreach ($poll->wait(Duration::fromSeconds(1)) as $watcher) {
        if ($watcher->hasTriggered(Event::Read)) {
            // accept the connection
        }
    }
}

wait() 的超时参数是 Time\Duration,这是 PHP 8.6 同期引入的纳秒精度时长类型,不再是 stream_select() 那种「秒 + 微秒」两个 int 的写法。

和 stream_select 的差别

stream_select() 有三个结构性限制:

  1. fd 上限:依赖 fd_set,通常最大 1024,超过就不可用。
  2. 每次调用重建数组:读、写、异常三个数组要重新构造,兴趣集合无法在内核侧长期驻留。
  3. O(n) 扫描:返回后要遍历全部 fd 判断谁就绪,即使只有一个活跃连接。

Io\Poll 把兴趣集合交给 epoll / kqueue / WSAPoll 维护,不再受 fd_set 的位图大小限制。在存在这些后端的平台上,规模上去之后性能优于 stream_select()。

edge-triggered 与 one-shot 的取舍

edge-triggered 只在状态发生变化时通知一次,拿到事件后必须把数据读到 EAGAIN,否则剩余数据不会再触发通知——漏读就是挂起。

one-shot 是触发一次后 watcher 自动失效,处理完要显式重新 add。它避免了「忘记读干净」的坑,代价是每次事件都多一次注册开销,高吞吐场景下这笔开销不可忽略。

两者都不是默认帮你兜底的东西,选哪个取决于你的读取循环是否保证读尽。

没有内置 event loop

这一点容易被误读。stitcher.io 的说法是:PHP 8.6 没有引入 async 特性,只是换了一种更容易的方式与已有的异步能力交互。Io\Poll 只提供「等哪些 fd 就绪」这一层,定时器、协程调度、任务队列、Promise 组合这些仍然由用户态库负责。把它当成 event loop 用会缺很多零件。

RFC 里写明的主要动机其实是内部用途:信号处理、FPM 改进。用户态异步框架是次要受众。过去 PHP 只有 stream_select() 一种多路复用方式,这个 API 补的是这一层的空缺。

谁适合用

  • 自己手写 stream_select() 循环、并且已经碰到 1024 fd 上限的代码
  • 需要在一个进程里同时盯大量连接,又不想引入完整异步框架的场景
  • 扩展作者:可以通过内部 C API 复用同一套后端,不必各自封装

谁先别动

已经在 ReactPHP / AMPHP / Swoole 上的项目,短期没有更换的必要。这些库的高层抽象、定时器、协程调度都不在 Io\Poll 的覆盖范围内,换掉底层轮询只是把框架的一小块替换掉,收益有限。合理的路径是等框架自己适配新后端,业务代码不动。

同理,单进程只处理几个连接的脚本,stream_select() 依然够用,迁移过来只是多一层对象。

来源

复制全文 生成海报 PHP 异步 IO 内核

推荐文章

程序员茄子在线接单