CKTIS / PHP
Fiber
Suspend et reprend un contexte coopératif depuis PHP 8.1. start renvoie l’argument de suspend et l’argument de resume devient le résultat interne de suspend.
Version : PHP 8.4; repository runtime, production runtime not attested
Syntaxe
new Fiber($callback)Suspend et reprend un contexte coopératif depuis PHP 8.1. start renvoie l’argument de suspend et l’argument de resume devient le résultat interne de suspend. Après achèvement getReturn livre le résultat de la fonction. La fibre ne se planifie pas elle-même. Sans suspension start renvoie null. Une exception de la fonction remonte à l’appelant et getReturn lève FiberError après cet arrêt.
$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"]
Exemples
<?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]);
Résultat
["ready",true,null,true,6] [null,3,"LogicException","FiberError"]