Panoramica sulle fiber
(PHP 8 >= 8.1.0)
Le fiber rappresentano funzioni interrompibili con stack completo. Le fiber possono essere sospese da qualsiasi punto nello stack delle chiamate,
mettendo in pausa l'esecuzione all'interno della fiber fino a quando la fiber non viene ripresa in un secondo momento.
Le fiber mettono in pausa l'intero stack di esecuzione, quindi il chiamante diretto della funzione non ha bisogno di cambiare il modo in cui
invoca la funzione.
L'esecuzione può essere interrotta in qualsiasi punto dello stack delle chiamate utilizzando Fiber::suspend()
(ovvero, la chiamata a Fiber::suspend() può trovarsi in una funzione profondamente annidata oppure non
esistere affatto).
A differenza dei Generator senza stack, ogni Fiber ha il proprio stack delle chiamate,
consentendo di metterle in pausa all'interno di chiamate di funzione profondamente annidate. Una funzione che dichiara un punto di interruzione
(ovvero, che chiama Fiber::suspend()) non ha bisogno di cambiare il proprio tipo di ritorno, a differenza di una funzione che utilizza
yield che deve restituire un'istanza di Generator.
Le fiber possono essere sospese in qualsiasi chiamata di funzione, incluse quelle chiamate dall'interno della VM PHP, come le funzioni
fornite a array_map() o i metodi chiamati da foreach su un
oggetto Iterator.
Una volta sospesa, l'esecuzione della fiber può essere ripresa con qualsiasi valore utilizzando Fiber::resume()
o lanciando un'eccezione nella fiber utilizzando Fiber::throw(). Il valore viene restituito
(o l'eccezione viene lanciata) da Fiber::suspend().
Nota:
Prima di PHP 8.4.0, il cambio di fiber durante l'esecuzione di un
distruttore di oggetto non era
consentito.
Example #1 Utilizzo di base
<?php
$fiber = new Fiber(function (): void {
$value = Fiber::suspend('fiber');
echo "Value used to resume fiber: ", $value, PHP_EOL;
});
$value = $fiber->start();
echo "Value from fiber suspending: ", $value, PHP_EOL;
$fiber->resume('test');
?>
Il precedente esempio visualizzerà:
Value from fiber suspending: fiber
Value used to resume fiber: test