feat: add rescue function for exception handling with default values (#843)

* feat: add rescue function for exception handling with default values

* refactor: rename report parameter to exceptionHandler in rescue function

---------

Co-authored-by: Deeka Wong <8337659+huangdijia@users.noreply.github.com>

Author: huangdijia

src/Functions.php

@@ -49,6 +49,7 @@
 use RuntimeException;
 use stdClass;
 use Stringable;
+use Throwable;
 use UnitEnum;
 
 use function Hyperf\Collection\value;
@@ -482,6 +483,30 @@ function ($response) use ($headers) {
     );
 }
 
+/**
+ * Catch a potential exception and return a default value.
+ *
+ * @template TValue
+ * @template TFallback
+ *
+ * @param callable(): TValue $callback
+ * @param (callable(Throwable): TFallback)|TFallback $rescue
+ * @param Closure(Throwable): void|null $exceptionHandler
+ * @return TValue|TFallback
+ */
+function rescue(callable $callback, mixed $rescue = null, ?Closure $exceptionHandler = null)
+{
+    try {
+        return $callback();
+    } catch (Throwable $e) {
+        if ($exceptionHandler) {
+            $exceptionHandler($e);
+        }
+
+        return value($rescue, $e);
+    }
+}
+
 /**
  * Get / set the specified session value.
  *