CKTIS / PHP
Fiber
Suspende e retoma um contexto cooperativo desde o PHP 8.1. start devolve o argumento de suspend e o argumento de resume passa a ser o resultado interno de suspend.
Versão: PHP 8.4; repository runtime, production runtime not attested
Sintaxe
new Fiber($callback)Suspende e retoma um contexto cooperativo desde o PHP 8.1. start devolve o argumento de suspend e o argumento de resume passa a ser o resultado interno de suspend. Após a conclusão getReturn dá o resultado da função. A fibra não se agenda sozinha. Sem suspensão start devolve null. Uma exceção da função propaga-se ao chamador e getReturn lança FiberError após essa terminação.
$fiber=new Fiber(function(): int {$n=Fiber::suspend("ready"); return $n*2;});
$first=$fiber->start(); $paused=$fiber->isSuspended(); $last=$fiber->resume(3);
echo json_encode([$first,$paused,$last,$fiber->isTerminated(),$fiber->getReturn()]);
$plain=new Fiber(fn()=>3); $started=$plain->start();
$bad=new Fiber(fn()=>throw new LogicException("halt")); try{$bad->start();}catch(LogicException $e){$propagated=get_class($e);}
try{$bad->getReturn();}catch(FiberError $e){$noResult=get_class($e);} echo PHP_EOL,json_encode([$started,$plain->getReturn(),$propagated,$noResult]);
["ready",true,null,true,6]
[null,3,"LogicException","FiberError"]
Exemplos
<?php
$fiber=new Fiber(function(): int {$n=Fiber::suspend("ready"); return $n*2;});
$first=$fiber->start(); $paused=$fiber->isSuspended(); $last=$fiber->resume(3);
echo json_encode([$first,$paused,$last,$fiber->isTerminated(),$fiber->getReturn()]);
$plain=new Fiber(fn()=>3); $started=$plain->start();
$bad=new Fiber(fn()=>throw new LogicException("halt")); try{$bad->start();}catch(LogicException $e){$propagated=get_class($e);}
try{$bad->getReturn();}catch(FiberError $e){$noResult=get_class($e);} echo PHP_EOL,json_encode([$started,$plain->getReturn(),$propagated,$noResult]);
Resultado
["ready",true,null,true,6] [null,3,"LogicException","FiberError"]