Documentazione

Scopri come usare TrueAsync per creare applicazioni PHP concorrenti.

Future::catch

(PHP 8.6+, True Async 1.0)

public function catch(callable $catch): Future

Registra un gestore di errori per il Future. Il callback viene invocato se il Future si e’ completato con un’eccezione. Se il callback restituisce un valore, questo diventa il risultato del nuovo Future. Se il callback lancia un’eccezione, il nuovo Future si completa con quell’errore.

Parametri

catch — la funzione di gestione degli errori. Riceve un Throwable, puo’ restituire un valore per il recupero. Firma: function(\Throwable $e): mixed.

Valore di ritorno

Future — un nuovo Future con il risultato della gestione dell’errore, oppure con il valore originale se non c’e’ stato alcun errore.

Esempi

Esempio #1 Gestione degli errori con recupero

<?php

use Async\Future;

$future = Future::failed(new \RuntimeException("Service unavailable"))
    ->catch(function(\Throwable $e) {
        echo "Error: " . $e->getMessage() . "\n";
        return "default value"; // Recupero
    });

$result = $future->await();
echo $result; // default value

Esempio #2 Cattura degli errori nelle operazioni asincrone

<?php

use Async\Future;

$future = \Async\async(function() {
    $response = httpGet('https://api.example.com/users');
    if ($response->status !== 200) {
        throw new \RuntimeException("HTTP error: {$response->status}");
    }
    return json_decode($response->body, true);
})
->catch(function(\Throwable $e) {
    // Registra l'errore e restituisce un array vuoto
    error_log("API error: " . $e->getMessage());
    return [];
})
->map(function(array $users) {
    return count($users);
});

$count = $future->await();
echo "Users found: $count\n";

Vedi anche