Limitar cuánto tiempo espera await ​

A menudo necesitas una garantía de que una operación no tardará más de un tiempo determinado. Por ejemplo, si UserDirectory no responde durante demasiado tiempo, puede hacer que la API parezca averiada. Aquí hay dos posibles soluciones:

1. Establecer un timeout a nivel de la operación file_get_contents y cambiar el código de la función.
2. Añadir un límite directamente a await.

use function Async\timeout;
use Async\OperationCanceledException;

try {
    $isValid = await($validation, timeout(2000));
} catch (OperationCanceledException $e) {
    $validation->cancel();
} catch (RemoteApiException $e) {
    
}

El beneficio de limitar await es que no hay necesidad de cambiar el código de validateToken. Al mismo tiempo, fíjate en el catch (OperationCanceledException $e), y no en el catch (TimeoutException $e) que podrías esperar.

OperationCanceledException ​

timeout() no lanza nada por sí solo. Devuelve un token de cancelación — un objeto Async\Timeout. El código siguiente no lanzará nunca una excepción, por mucho que dure el script:

use function Async\timeout;

$token = timeout(2000);   // just an object; nothing happens

The token only takes effect once it is handed to an operation as a cancellation argument:

use function Async\timeout;
use Async\OperationCanceledException;

try {
    $isValid = await($validation, timeout(2000));
} catch (OperationCanceledException $e) {
    $validation->cancel();
    echo $e->getPrevious()->getMessage(); // mensaje de TimeoutException
}

Ten en cuenta que cuando el token se dispara recibes una OperationCanceledException, no una TimeoutException. El propio timeout está dentro, en getPrevious(). Esto es intencionado, para simplificar la lógica de manejo del try-catch de await y para distinguir con claridad una espera cancelada de una excepción surgida dentro de la corrutina. Normalmente, las corrutinas no deberían lanzar ellas mismas una OperationCanceledException.

Lo que se usa para limitar una espera de await no tiene por qué ser timeout(); también puede ser cualquier otra corrutina, o un Future, un contrato lógico que representa la finalización de alguna operación arbitraria.