# Laravel rescue() helper

# rescue()

[rescue()](https://laravel.com/docs/9.x/helpers#method-rescue) es un helper de Laravel que ejecuta una función closure (función anónima en PHP) y detecta cualquier excepción durante su ejecución. Las excepciones se enviarán a su controlador de excepciones, pero la solicitud continuará siendo procesada.

## Requisitos

- Laravel (el helper existe desde versiones antiguas; cualquier 8.x/9.x+ lo trae).
- Un caso donde una operación puede fallar sin que deba tumbar la petición (en el ejemplo, comprobar si un fichero existe en un CDN que puede estar caído).

## Ejemplo

```php
// Viejo método - try / catch ignorando la excepción. Un poco feo
private static function existsOnCDN(string $path): bool
{
  $cdn = $false;
  
  try {
    $cdn = Storage::disk('cdn')->exists($path);
  } catch (\Exception $e) {
    // CDN no esta disponible por problemas de red.
  }
  return $cdn;
}

// Mas claro, rescue() ignora la excepcion y permite al código continuar. Opcionalmente podemos pasar un valor de retorno
private static function existsOnCDN(string $path): bool
{
  return rescue(fn () => Storage::disk('cdn')->exists($path), false);	
}

```

Cómo funciona: `rescue(fn () => ..., false)` ejecuta la closure y, si lanza, reporta la excepción al handler y devuelve el segundo argumento (`false` aquí) en lugar de romper la ejecución.

#### Agradecimientos

A @shawnlindstrom por su [tuit](https://twitter.com/shawnlindstrom/status/1503845090279702529)

##### Aviso

Esta documentación y su contenido, no implica que funcione en tu caso o determinados casos.
También implica que tienes conocimientos sobre lo que trata, y que en cualquier caso tienes copias de seguridad.
El contenido se entrega, tal y como está, sin que ello implique ninguna obligación ni responsabilidad por parte de [Castris](https://castris.com)

Si necesitas soporte profesional puedes contratar con Castris [soporte profesional](https://intranet.castris.com/cart.php?gid=18).

## Verificación

- Un test con el disco `cdn` falseado para lanzar: `rescue(..., false)` debe devolver `false` sin propagar la excepción, y el test debe terminar en verde.
- El segundo argumento es opcional: sin él, el valor de retorno en fallo es `null`; comprobar cuál de los dos comportamientos espera el llamante antes de decidir.