Add lazy and proxy helpers

Author: timacdonald

src/Illuminate/Support/helpers.php

@@ -13,6 +13,7 @@
 use Illuminate\Support\Sleep;
 use Illuminate\Support\Str;
 use Illuminate\Support\Stringable as SupportStringable;
+use Illuminate\Support\Traits\ReflectsClosures;
 
 if (! function_exists('append_config')) {
     /**
@@ -196,6 +197,43 @@ function literal(...$arguments)
     }
 }
 
+if (! function_exists('lazy')) {
+    /**
+     * Create a lazy instance.
+     *
+     * @template TValue of object
+     *
+     * @param  class-string<TValue>|(\Closure(TValue): mixed)  $class
+     * @param  (\Closure(TValue): mixed)|int  $callback
+     * @param  int  $options
+     * @return TValue
+     */
+    function lazy($class, $callback = 0, $options = 0)
+    {
+        static $reflector = new class
+        {
+            use ReflectsClosures;
+
+            public function get($callback)
+            {
+                return $this->firstClosureParameterType($callback);
+            }
+        };
+
+        [$class, $callback, $options] = is_string($class)
+            ? [$class, $callback, $options]
+            : [$reflector->get($class), $class, $callback ?: $options];
+
+        return (new ReflectionClass($class))->newLazyGhost(function ($instance) use ($callback) {
+            $result = $callback($instance);
+
+            if (is_array($result)) {
+                $instance->__construct(...$result);
+            }
+        }, $options);
+    }
+}
+
 if (! function_exists('object_get')) {
     /**
      * Get an item from an object using "dot" notation.
@@ -295,6 +333,37 @@ function preg_replace_array($pattern, array $replacements, $subject): string
     }
 }
 
+if (! function_exists('proxy')) {
+    /**
+     * Create a lazy proxy instance.
+     *
+     * @template TValue of object
+     *
+     * @param  class-string<TValue>|(\Closure(TValue): TValue)  $class
+     * @param  (\Closure(TValue): TValue)|int  $callback
+     * @param  int  $options
+     * @return TValue
+     */
+    function proxy($class, $callback = 0, $options = 0)
+    {
+        static $reflector = new class
+        {
+            use ReflectsClosures;
+
+            public function get($callback)
+            {
+                return $this->firstClosureParameterType($callback);
+            }
+        };
+
+        [$class, $callback, $options] = is_string($class)
+            ? [$class, $callback, $options]
+            : [$reflector->get($class), $class, $callback ?: $options];
+
+        return (new ReflectionClass($class))->newLazyProxy($callback, $options);
+    }
+}
+
 if (! function_exists('retry')) {
     /**
      * Retry an operation a given number of times.