proxy attribute

Author: cosmastech

src/Illuminate/Container/Attributes/Proxy.php

@@ -0,0 +1,10 @@
+<?php
+
+namespace Illuminate\Container\Attributes;
+
+use Attribute;
+
+#[Attribute(Attribute::TARGET_PROPERTY | Attribute::TARGET_CLASS)]
+class Proxy
+{
+}

src/Illuminate/Container/Container.php

@@ -6,6 +6,7 @@
 use Closure;
 use Exception;
 use Illuminate\Container\Attributes\Bind;
+use Illuminate\Container\Attributes\Proxy;
 use Illuminate\Container\Attributes\Scoped;
 use Illuminate\Container\Attributes\Singleton;
 use Illuminate\Contracts\Container\BindingResolutionException;
@@ -1108,12 +1109,13 @@ protected function isBuildable($concrete, $abstract)
      * @template TClass of object
      *
      * @param  \Closure(static, array): TClass|class-string<TClass>  $concrete
+     * @param  array<class-string>  $withoutLazyFor
      * @return TClass
      *
      * @throws \Illuminate\Contracts\Container\BindingResolutionException
      * @throws \Illuminate\Contracts\Container\CircularDependencyException
      */
-    public function build($concrete)
+    public function build($concrete, $withoutLazyFor = [])
     {
         // If the concrete type is actually a Closure, we will just execute it and
         // hand back the results of the functions, which allows functions to be
@@ -1163,6 +1165,10 @@ public function build($concrete)
             return $instance;
         }
 
+        if (! in_array($concrete, $withoutLazyFor) && ! empty($reflector->getAttributes(Proxy::class))) {
+            return proxy($concrete, fn () => $this->build($concrete, [$concrete]));
+        }
+
         $dependencies = $constructor->getParameters();
 
         // Once we have all the constructor's parameters we can create each of the

tests/Container/ContainerTest.php

@@ -4,6 +4,7 @@
 
 use Attribute;
 use Illuminate\Container\Attributes\Bind;
+use Illuminate\Container\Attributes\Proxy;
 use Illuminate\Container\Attributes\Scoped;
 use Illuminate\Container\Attributes\Singleton;
 use Illuminate\Container\Container;
@@ -13,6 +14,7 @@
 use Illuminate\Contracts\Container\SelfBuilding;
 use PHPUnit\Framework\TestCase;
 use Psr\Container\ContainerExceptionInterface;
+use ReflectionClass;
 use stdClass;
 use TypeError;
 
@@ -224,6 +226,16 @@ public function testNestedDependencyResolution()
         $this->assertInstanceOf(ContainerImplementationStub::class, $class->inner->impl);
     }
 
+    public function testLazyObjects()
+    {
+        $container = new Container;
+        $container->bind(IContainerContractStub::class, ContainerImplementationStub::class);
+        $class = $container->make(ProxyDependenciesClass::class);
+        $this->assertTrue((new ReflectionClass($class))->isUninitializedLazyObject($class));
+        $class->stubby;
+        $this->assertFalse((new ReflectionClass($class))->isUninitializedLazyObject($class));
+    }
+
     public function testContainerIsPassedToResolvers()
     {
         $container = new Container;
@@ -1217,3 +1229,13 @@ public function __construct()
         $this->userId = $_SERVER['__withFactory.userId'];
     }
 }
+
+#[Proxy]
+class ProxyDependenciesClass
+{
+    public function __construct(
+        public IContainerContractStub $stubby
+    ) {
+        //dd('i have been constructed!');
+    }
+}