PHP 8.1 Fibers 纤程实战:用原生协程实现协作式多任务(Fiber 与调度器)

#PHP8.1Fibers纤程实战:用原生协程实现协作式多任务(Fiber与调度器)去年把业务从PHP7.4升到8.1,我在发布说明里看到"Fibers"这个词,第一反应是:终于,PHP原生支持协程了,是不是把…

PHP 8.1 Fibers 纤程实战:用原生协程实现协作式多任务(Fiber 与调度器)

去年把业务从 PHP 7.4 升到 8.1,我在发布说明里看到 "Fibers" 这个词,第一反应是:终于,PHP 原生支持协程了,是不是把 Swoole 卸了就能高并发了?于是我兴冲冲写了个抓取脚本,把十几个接口塞进 new Fiber(),然后在循环里挨个resume()。跑完一看耗时,我差点把键盘推给工位隔壁的同事——跟串行版本几乎一模一样。

那次踩坑让我明白一件事:Fiber 根本不是"自动并发"的开关。它只是给了你一个能随时按暂停键、以后再接着放的函数,调度权完完全全攥在你自己手里。你要是还按同步的写法一个接一个把它推到底,那它就是脱了壳的同步代码,一点并发味儿都没有。这篇就把我后来折腾明白的那点东西从头捋一遍:怎么让一个 Fiber 真正跑起来、它和 Generator 到底是不是一回事、以及最关键的——怎么自己写一个调度器,把"协作式多任务"从概念变成能跑的代码。

一句话认知:Fiber 是 PHP 8.1 引入的用户态、可中断的函数。它能在调用栈的任意深度挂起,等你想起来再恢复;它不自带调度器,也不帮你干活,只负责"暂停/恢复"这一个动作本身。

一、先别谈并发,把环境和一个最小的 Fiber 跑通

很多人(包括当时的我)上来就找框架、找事件循环,结果连start()都没调对。先把地基打牢。

关于 Fiber 到底怎么用,网上的说法五花八门,但核心就三点:第一,你的 PHP 版本必须是 8.1 或更高,Fiber 从这一版开始内置且默认启用,不需要在 php.ini里额外打开什么开关;第二,用new Fiber()创建一个纤程实例,构造时传一个闭包当纤程主体;第三,调用start()启动它,它会一路执行到遇到Fiber::suspend()才把控制权交还给你,之后你用resume()把它唤醒,它就从刚才停下的地方继续往下走。这三点如果没记牢,后面所有花活都是空中楼阁。

官方的Fiber 类手册把方法列得很清楚,但文档写得偏硬,我这里按"人话"翻译一遍,并且刻意把状态查询方法也塞进了例子里——isStarted()、isSuspended()、isTerminated()这三个是调试时最有用的,能让你随时知道这个纤程现在是没启动、挂着、还是已经寿终正寝。

php
复制
<?php// 第一个能跑的 Fiber:把"暂停/恢复"这件事彻底摸清楚$fiber = new Fiber(function (): void { echo" [纤程] 我开始执行了\n"; // suspend 把控制权交还调用者,并把"第一颗糖" 作为 start() 的返回值吐出去 $received = Fiber::suspend("第一颗糖"); // 注意:这里的 $received 正是外面 resume() 传进来的值,双向通道就这么通了 echo" [纤程] 我收到了:" . $received ."\n"; Fiber::suspend("第二颗糖"); echo" [纤程] 我终于跑完了\n";});echo"[主流程] 准备 start\n";$first = $fiber->start(); // 启动,一路执行到第一个 suspendecho"[主流程] start 返回:" . $first ."\n";var_dump($fiber->isStarted()); // 已启动 => truevar_dump($fiber->isSuspended()); // 正挂起 => true$second = $fiber->resume("外面的回礼"); // 恢复,上一处 suspend 拿到"回礼"echo"[主流程] resume 返回:" . $second ."\n";$fiber->resume(); // 再推一把,直到纤程自然结束var_dump($fiber->isTerminated()); // 已终止 => true

跑完这段,你应该能盯住输出顺序看明白一件事:start()和resume()都会"返回一个值",而这个值就是纤程里suspend()传出来的东西;反过来,resume($v)的参数又会变成suspend()那一行表达式的值。很多人第一次看会绕晕,其实你把它当成一次不带函数调用栈的对讲机通话就好——你喊一句,它回一句,两边轮流说话,谁也不打断谁。

顺带说一句,如果你在浏览器端遇到的是多个标签页抢同一份资源,那跟 PHP 服务端的纤程完全不是一个战场,得靠浏览器自己的锁机制来管,比如 Web Locks API 实战:用 navigator.locks 解决多标签页资源竞争(排他锁与共享锁)那套排他锁/共享锁。两边思想上有相通之处——都是"谁先谁后得有规矩",但实现细节天差地别,别混着用。

二、双向传值才是我真正觉得"黑科技"的地方

如果只是能暂停恢复,那 Fiber 跟普通的 yield也没多大差别。真正让我觉得这玩意儿有点东西的,是suspend($value)/resume($value)这一对组合拳带来的双向数据传递。

我第一次用的时候,是这么想的:我想让一个纤程一批一批地算数据,算完一批就把中间结果交给我看看,我看完再告诉它是继续还是停下。用回调写,你得维护一堆状态和嵌套;用 Fiber 写,代码长得跟同步顺序执行几乎一样,但中间可以随时插话。下面这段就是把源文里那个"生产者—消费者"的思路改写了:纤程里每累加一次就 suspend出中间值,外面通过resume('go')或resume('stop')决定它的命运。

php
复制
<?php// 双向通道:纤程吐中间值,调用者回传指令,像"你一言我一语"function makeWorker(): Fiber { return new Fiber(function (): void { $sum = 0; for ($i = 1; $i <= 5; $i++) { // suspend 把累加结果传出去,并返回外部 resume 塞回来的指令 $cmd = Fiber::suspend($sum += $i); if ($cmd === 'stop') { echo" [worker] 收到 stop,提前收工\n"; break; // 跳出循环,纤程自然终止 } } echo" [worker] 最终累加值:" . $sum ."\n"; });}$worker = makeWorker();$worker->start(); // 启动 => 吐出 1echo"拿到中间值:" . $worker->resume('go') ."\n"; // 继续 => 吐出 3echo"拿到中间值:" . $worker->resume('go') ."\n"; // 继续 => 吐出 6$worker->resume('stop'); // 外面喊停,纤程内部 breakvar_dump($worker->isTerminated()); // true

这里有个坑我必须提醒:很多人以为resume()只是"继续",忽略了它的参数会变成suspend()的返回值。你要是写resume()不传值,那suspend()那儿拿到的就是null,后面拿它做判断就会静默地走错分支,还不报错,排查起来能把人逼疯。所以但凡你的纤程里读了suspend()的返回值,外面就必须老老实实把值传回去——这是纪律问题,不是风格问题。

三、Fiber 和 Generator,到底是不是一回事

这是我被问得最多的问题,也是面试里最容易被问倒的问题。我的答案很明确:长得像,但不是一回事,而且 Fiber 的控制力要底层得多。

Generator(生成器)本质是个迭代器,它只能在yield那一行暂停,控制权在foreach或者说在调用current()/next()的那个人手里。你没法在生成器调用栈深处的某个普通函数里突然暂停——因为yield 只能写在生成器函数体内。而 Fiber 是一个完整的、可中断的函数上下文:它能在调用栈的任意深度调用Fiber::suspend(),哪怕你已经套了三层函数调用,照样说停就停。而且 Fiber 是一个真正的对象,你可以把它传来传去、存进数组、交给调度器管理,这也是它能撑起协程调度器的根本原因。

再看状态:生成器保存的是yield 处的状态,Fiber 保存的是整个函数调用栈的上下文,切换由引擎在用户态完成,没有内核参与,开销极小。这也是为什么大家说 Fiber 是"轻量级线程"——但它跟真线程有本质区别:纤程跑在单线程里,切换是你主动让出的(协作式),不是操作系统抢占的。谁不让出,谁就一直占着 CPU,别人别想插进来。

php
复制
<?php// Generator:本质上单向吐数据,暂停点只能是 yield 那一行function gen(): Generator { for ($i = 1; $i <= 3; $i++) { $back = yield $i; // yield 其实也能接收 next() 回传的值 echo" [生成器] 外部回传:" . var_export($back, true) ."\n"; }}foreach (gen() as $v) { echo"生成器产出:$v\n";}// Fiber:能在任意深度的调用栈里 suspend,且自身是一个可管理的对象function deepCall(): void { echo" [深层函数] 我在三层调用栈里也能说停就停\n"; Fiber::suspend('deep-pause');}$f = new Fiber(function (): void { deepCall(); // 深层函数里直接 suspend,生成器做不到 echo" [纤程] 恢复后继续往下执行\n";});$f->start();var_dump(Fiber::getCurrent() === null); // 主流程不在任何纤程里 => true$f->resume(); // 唤醒,从 deepCall 的 suspend 处继续

上面还藏了一个很多人不知道的 API:Fiber::getCurrent()。它是静态方法,返回当前正在执行的纤程对象;如果你在主流程(非纤程上下文)里调用它,返回的是null。这个东西在写通用库的时候特别香——比如你的日志组件想知道"我现在是在某个纤程里跑,还是在主流程里跑",靠它一判断就清楚了。细节可以翻官方的getCurrent 说明。

那什么时候用哪个?我的经验是:只是想省内存地遍历一个大数据集、生成无限序列,用 Generator,简单直接;想搭建异步流程、任务调度、协作式多任务,用 Fiber。两者也能配合——生成器负责产出数据,纤程负责消费和调度。顺便提一嘴,前端那边在"谁先谁后"这件事上的解法完全不同,像CSS @layer 级联层实战:用层级掌控样式优先级(告别 !important 与权重战争)是用层级来理顺样式的优先级,而纤程这边是把优先级交给调度器显式控制,思路异曲同工:都得有规矩,不能靠谁嗓门大。

四、重头戏:自己写一个协程调度器

好,终于到最关键的部分了。前面说过,我第一次踩坑就是因为这个——Fiber 本身不带调度器。你要是按顺序把每个纤程resume() 到死,那它本质上就是同步执行,一点并发都没捞着。真正让 Fiber 发挥价值的,是"批量启动 + 轮询推进"这八个字。

我把源文里那个多 URL 并发读取的核心思想抽出来,写成了一个极简的调度器 TinyScheduler。它的逻辑其实特别朴素:维护一个任务数组,每个任务是一个纤程;run()里一个do...while大循环,只要还有没结束的任务就一直转;每一轮遍历所有任务,没启动的就start(),挂起的就resume(),而且一次只推进一步,推完就去看下一个。这样多个任务的执行过程就会交错在一起,谁也不会因为自己慢就把整条队伍堵死——这就是"协作式多任务"的全部真相:大家轮流干活,谁干到一半都能主动说"我先让一让,下一位"。

php
复制
<?php// 一个极简协作式调度器:批量加入 + 轮询推进,谁没写完就下一轮接着来class TinyScheduler{ /** @var array<int, array{0: Fiber, 1: mixed}> 每个槽位存 [纤程, 携带值] */ private array $tasks = []; public function add(callable $job): void { $this->tasks[] = [new Fiber($job), null]; } public function run(): void { do { $active = false; foreach ($this->tasks as $i => &$slot) { [$fiber, $carry] = $slot; if ($fiber->isTerminated()) { continue; // 已完成的不再推进 } $active = true; // 未启动就 start,已挂起就 resume,一次只推进一小步 $slot[1] = $fiber->isStarted() ? $fiber->resume($carry) : $fiber->start($carry); } unset($slot); // 打断引用,避免后续误改 } while ($active); // 还有活人就再转一圈 }}$sched = new TinyScheduler();foreach ([1, 2, 3] as $id) { $sched->add(function () use ($id): void { for ($step = 1; $step <= 3; $step++) { echo"任务 {$id} 第 {$step} 步\n"; Fiber::suspend(); // 主动让出,调度器转去推别人 } });}// 输出会是交错的:任务1-1、任务2-1、任务3-1、任务1-2、任务2-2……$sched->run();

跑这个例子的时候,盯着输出顺序看,你会看到三个任务像接力一样交错打印,而不是"任务 1 全部跑完再任务 2"。那一刻我才算真正理解了协作式调度:并发不是引擎送你的礼物,是你用suspend()一次一次让出来的。每个纤程都得自觉,干一小步就让出控制权,整个系统才能转得起来;要是有个任务在里面死循环不让出,全队一起陪它卡死。

把这个调度器再往前推一步,就能处理真实的 I/O 场景了。比如源文里那个"多 URL 并发 fread"的例子:先用fopen()打开流并stream_set_blocking($stream, false)设成非阻塞,再为每个流建一个纤程,纤程里fread()读到数据就suspend($chunk)吐出去,读不到就suspend('')让出;外层调度器轮询所有纤程,谁有数据就拼谁的结果。这样一来,几个慢接口的等待时间就重叠了,而不是排成一队傻等。

不过这里有三个实打实的工程坑,我一个一个踩过:其一,fopen('https://...') 依赖 OpenSSL 扩展和 allow_url_fopen=On,环境没配好直接报错;其二,非阻塞流碰上 HTTPS 的 SSL 握手,底层未必真的非阻塞,生产环境别指望纯 Fiber 就万事大吉;其三,纯 Fiber 调度是用户态的,高并发吞吐仍受单线程限制,真要上规模还得靠成熟的事件循环库。另外,浏览器端处理"异步任务排队"这类问题也有自己的一套,比如 Web Speech API 实战:用浏览器原生能力做语音识别与语音合成(SpeechRecognition 与 speechSynthesis)就是靠回调和事件把异步结果送回来的,跟纤程的"主动让出"是两种截然不同的并发哲学,放一起对比着看特别有意思。

五、事件循环才是 Fiber 的真正战场

前面那个TinyScheduler只是用来讲原理的玩具,它有个致命的天真之处:它不知道"什么时候该唤醒谁"。轮询一圈,不管数据到没到,先把每个纤程推一步再说——这在示例里没问题,放到真实网络环境里就是忙等,CPU 呼呼地转,效率低得让人心疼。源文里反复强调的那句话我到现在都记得:Fiber 只负责"让出",不负责"何时回来";你 suspend()之后,究竟谁来resume(),这个职责属于事件循环。

所以真实世界的组合拳是这样的:纤程里发起一个异步 I/O 请求(比如一个 HTTP 调用),紧接着 Fiber::suspend() 把自己挂起,同时把这个纤程和对应的事件绑在一起注册到事件循环里;等数据到了、socket 可读了、或者定时器到点了,事件循环的回调被触发,回调里找到当初那个纤程,调用它的 resume($data),纤程就从刚才停下的那一行接着往下跑,而且看起来就像同步代码一样一气呵成。源文里用Revolt\EventLoop演示的EventLoop::delay(1, ...)就是这个套路——注册一个一秒后的定时器,回调里把纤程唤醒,纤程从suspend()处醒来继续打印。托管给成熟的事件循环库之后,你不用自己傻乎乎地一遍遍轮询,效率和高并发能力都上了一个台阶。

这里我要吐个槽:很多人(包括最初的我)看了几个 Fiber 的例子,就以为 "用了 Fiber 就等于异步了",结果在纤程里大大方方地写 sleep(1)、用同步的 PDO 查询,然后纳闷为什么并发没生效。答案是:事件循环再聪明也救不了一个主动阻塞的纤程——你 sleep 的那一秒,整个进程连同事件循环一起睡着了,谁也调度不了。用了 Fiber 就必须全程配套非阻塞 I/O,这是一条铁律。前端做文件读写这事也是同一个道理,像 File System Access API 实战:让网页直接读写本地文件(showOpenFilePicker 与 createWritable)里的createWritable() 走的就是流式、异步的写入路径,绝不会让主线程傻等;php.net 上关于 Fibers 概览 的章节也把这套"挂起—事件—恢复"的协作模型讲得很清楚,值得从头读一遍。至于选哪个事件循环库,Revolt 轻巧、Amphp 生态全、Swoole 性能好、ReactPHP 老牌稳,各有各的拥趸,别陷入"选型信仰战争",挑一个顺手的先把业务跑通最重要。

六、状态、异常和 FiberError:别让纤程变成内存黑洞

调度器能跑起来之后,下一个坑就是异常处理。纤程的执行流程是交错的、非线性的,异常如果处理不当,会从一个你完全没预料到的地方冒出来。

先说正确的姿势:纤程内部的异常,用try...catch...finally在纤程主体里就地捕获,finally里做资源清理(关连接、释放锁);如果你想从外部把一个异常"塞"回纤程,让它从suspend()那一行抛出来,用的是throw()方法,而不是resume()。这跟往常"在外面 catch"的直觉是反的,得刻意记一下。

再说会炸的情况,也就是FiberError:对一个还没启动的纤程调用resume()、或者对已经终止的纤程调用resume()、再或者对正在运行的纤程重复start(),都会抛FiberError。这类错误在调度器里尤其常见——因为你是轮询推进的,某个纤程这一轮刚结束,下一轮又去推它,就直接炸了。所以调度器里那句isTerminated()的判断绝对不能省,它不是可选的优化,而是保命的护栏。

php
复制
<?php// 异常怎么穿过纤程边界,以及那些一踩就炸的 FiberError$g = new Fiber(function (): void { try { echo" [纤程] 干活中,先挂起\n"; Fiber::suspend('wait'); echo" [纤程] 只有正常 resume 才会走到这行\n"; } catch (Throwable $e) { echo" [纤程] 捕获外部抛入的异常:" . $e->getMessage() ."\n"; } finally { echo" [纤程] finally 里清理连接、释放锁\n"; }});$g->start(); // 停在 suspend('wait')$g->throw(new RuntimeException('外部取消')); // 从 suspend 处把异常抛进去var_dump($g->isTerminated()); // true:异常被捕获后纤程终止// 反面教材:对已终止的纤程再 resume,直接抛 FiberErrortry { $g->resume();} catch (FiberError $e) { echo" [主流程] 抓到 FiberError:" . $e->getMessage() ."\n";}// getCurrent:判断当前是否在纤程上下文里(主流程返回 null)var_dump(Fiber::getCurrent() === null); // true

调试这类交错执行的纤程,光靠var_dump 会很痛苦,因为打印顺序跟代码书写顺序对不上。我的土办法是给每个纤程、每一步都打上唯一 ID(就像上面调度器例子里的"任务 X 第 Y 步"),再配合日志把执行轨迹串起来;有条件的直接上 Xdebug,不过记得确认它当前版本对 Fiber 调试的支持情况,别像我一样对着断点是灰色的一脸懵。

七、到底什么时候该用 Fiber,我的取舍

绕了一大圈,回到最现实的问题:我的项目到底该不该上 Fiber?我的判断标准就两条。

第一,看任务是I/O 密集还是 CPU 密集。Fiber 擅长的是 I/O 密集型场景——网络请求、数据库查询、消息队列消费这类会大量等待的活儿,等待期间让出纤程去干别的,收益明显。但如果你的任务是 CPU 密集的(比如大量计算、图像处理),Fiber 帮不上忙,因为它跑在单线程里,不能利用多核,该算多久还是多久,这种场景老老实实用多进程或者并行扩展。

第二,看你能不能保证全程不阻塞。这是最容易被忽略的一条:只要纤程里有一个阻塞调用(最典型的就是原生sleep()、同步的数据库客户端),整个进程都会被它拖住,别的纤程一个都跑不了。用了 Fiber 就得配套异步 I/O,否则等于白用。也正因如此,生产环境我一般不会自己手搓调度器,而是选成熟的生态:想要轻量事件循环就用 Revolt,想要 Promise 风格就用 Amphp,想要开箱即用的高性能协程就用 Swoole,ReactPHP 也是稳妥的选择。自己写调度器更适合用来理解原理、或者处理一些很轻量的定制场景——就像上面那个 TinyScheduler,拿来学习、演示足够了,真上生产还得靠久经考验的库。

回头看我一开始那个"耗时没变"的脚本,问题就特别清楚了:我用同步的sleep() 模拟耗时,又在循环里把每个纤程单独推到底,既没有非阻塞 I/O,也没有交错调度,Fiber 被我用成了最贵的同步写法。后来把它改成"批量启动 + 非阻塞等待 + 轮询推进",同样的接口数,耗时直接降到了原来的几分之一。这个落差让我记到现在:工具本身不产生价值,正确的用法才产生价值。

还有一个小经验想分享给准备上手的朋友:调试阶段一定要把状态判断写在调度循环里,isStarted()、isSuspended()、isTerminated()这三个方法几乎是我每写一个调度器都要先摆好的脚手架,少一个都可能在某次轮询里踩到FiberError。别嫌啰嗦,等线上出问题时,这些看似多余的状态检查能帮你把排查时间从半天压缩到几分钟。桐花巷里没有捷径,写并发代码尤其如此,把每一步的状态都攥在手里,心里才踏实。

小结

Fiber 是 PHP 8.1 送给我们的原生协程能力,它给你的是一个"可随时暂停/恢复的函数上下文",而不是一个开箱即用的并发框架。真正要记住的,一是 start()/resume()/suspend()三件套和它们之间的双向传值,二是isStarted()/isSuspended()/isTerminated()这些状态判断在调度里的保命作用,三是Fiber::getCurrent()和throw() 这些容易被忽略但很有用的 API,四是——也是最重要的——并发是你自己用 suspend() 让出来的,调度器得由你来写。搞清楚这几点,协作式多任务在 PHP 里就不再是玄学,而是一种你能完全掌控的编程方式。

标签:php, 后端, 开发语言描述:以第一人称踩坑经历串讲 PHP 8.1 Fiber 纤程,讲透 start/suspend/resume 双向传值、与 Generator 的本质区别、getCurrent 等 API,并手写一个轮询协程调度器实现协作式多任务,附异常处理与 FiberError 避坑。

1q5ojbryoo1q5ojbryoo
评论

评论列表共有0条评论

发表评论发布评论后审核成功,即可显示在列表中...

文章4
粉丝0
获赞0
私信