Base de conhecimentoCentro de Exames
PT · PTPortuguês (Portugal)
Escolher idioma13

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"]

Fontes