Base de connaissancesCentre d’examen
FRFrançais
Choisir la langue13

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

Sources