CKTIS / PHP
Fiber
Unterbricht seit PHP 8.1 einen kooperativen Ausführungskontext und setzt ihn fort. start liefert das Argument von suspend, das Argument von resume wird innen zum Ergebnis von suspend.
Version: PHP 8.4; repository runtime, production runtime not attested
Syntax
new Fiber($callback)Unterbricht seit PHP 8.1 einen kooperativen Ausführungskontext und setzt ihn fort. start liefert das Argument von suspend, das Argument von resume wird innen zum Ergebnis von suspend. Nach Abschluss liefert getReturn das Callback-Ergebnis. Die Planung erfolgt nicht automatisch. Ohne Unterbrechung liefert start null. Eine Ausnahme des Callbacks erreicht den Aufrufer und getReturn wirft nach diesem Abbruch FiberError.
$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"]
Beispiele
<?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]);
Ergebnis
["ready",true,null,true,6] [null,3,"LogicException","FiberError"]