[10.x] Add ability to measure a single callable and get result (#48077)

* Add ability to measure a single callable and get result

* rename method

---------

Co-authored-by: Taylor Otwell <[email protected]>

Author: timacdonald

src/Illuminate/Support/Benchmark.php

@@ -32,6 +32,25 @@ public static function measure(Closure|array $benchmarkables, int $iterations =
         );
     }
 
+    /**
+     * Measure a callable once and return the duration and result.
+     *
+     * @template TReturn of mixed
+     *
+     * @param  (callable(): TReturn)  $callback
+     * @return array{0: TReturn, 1: float}
+     */
+    public static function value(callable $callback): array
+    {
+        gc_collect_cycles();
+
+        $start = hrtime(true);
+
+        $result = $callback();
+
+        return [$result, (hrtime(true) - $start) / 1000000];
+    }
+
     /**
      * Measure a callable or array of callables over the given number of iterations, then dump and die.
      *