Baza wiedzyCentrum egzaminacyjne
PLPolski
Wybierz język13

CKTIS / PHP

Fiber

Od PHP 8.1 wstrzymuje i wznawia współpracujący kontekst wykonania. start oddaje argument suspend, a argument resume staje się wynikiem suspend wewnątrz włókna.

Wersja: PHP 8.4; repository runtime, production runtime not attested

Składnia

new Fiber($callback)

Od PHP 8.1 wstrzymuje i wznawia współpracujący kontekst wykonania. start oddaje argument suspend, a argument resume staje się wynikiem suspend wewnątrz włókna. Po zakończeniu funkcji getReturn podaje jej wynik. Włókno samo nie planuje wznowienia. Jeśli funkcja nigdy się nie wstrzyma, start zwraca null. Jej wyjątek wychodzi do wywołującego, a getReturn po takim zakończeniu rzuca 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"]

Przykłady

<?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]);

Wynik

["ready",true,null,true,6]
[null,3,"LogicException","FiberError"]

Źródła