WissensdatenbankPrüfungszentrum
DEDeutsch
Sprache wählen13

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

Quellen