[12.x] Add Context contextual attribute (#55760)

* Add context attribute

* Update Context.php

---------

Co-authored-by: Martin Bean <martinbean@users.noreply.github.com>
Co-authored-by: Taylor Otwell <taylor@laravel.com>

Author: martinbean

src/Illuminate/Container/Attributes/Context.php

@@ -0,0 +1,31 @@
+<?php
+
+namespace Illuminate\Container\Attributes;
+
+use Attribute;
+use Illuminate\Contracts\Container\Container;
+use Illuminate\Contracts\Container\ContextualAttribute;
+use Illuminate\Log\Context\Repository;
+
+#[Attribute(Attribute::TARGET_PARAMETER)]
+class Context implements ContextualAttribute
+{
+    /**
+     * Create a new attribute instance.
+     */
+    public function __construct(public string $key, public mixed $default = null)
+    {
+    }
+
+    /**
+     * Resolve the context value.
+     *
+     * @param  self  $attribute
+     * @param  \Illuminate\Contracts\Container\Container  $container
+     * @return mixed
+     */
+    public static function resolve(self $attribute, Container $container): mixed
+    {
+        return $container->make(Repository::class)->get($attribute->key, $attribute->default);
+    }
+}

tests/Container/ContextualAttributeBindingTest.php

@@ -11,6 +11,7 @@
 use Illuminate\Container\Attributes\Authenticated;
 use Illuminate\Container\Attributes\Cache;
 use Illuminate\Container\Attributes\Config;
+use Illuminate\Container\Attributes\Context;
 use Illuminate\Container\Attributes\CurrentUser;
 use Illuminate\Container\Attributes\Database;
 use Illuminate\Container\Attributes\Log;
@@ -28,6 +29,7 @@
 use Illuminate\Database\Eloquent\Model;
 use Illuminate\Filesystem\FilesystemManager;
 use Illuminate\Http\Request;
+use Illuminate\Log\Context\Repository as ContextRepository;
 use Illuminate\Log\LogManager;
 use Mockery as m;
 use PHPUnit\Framework\TestCase;
@@ -215,6 +217,20 @@ public function testRouteParameterAttribute()
         $container->make(RouteParameterTest::class);
     }
 
+    public function testContextAttribute(): void
+    {
+        $container = new Container;
+
+        $container->singleton(ContextRepository::class, function () {
+            $context = m::mock(ContextRepository::class);
+            $context->shouldReceive('get')->once()->with('foo', null)->andReturn('foo');
+
+            return $context;
+        });
+
+        $container->make(ContextTest::class);
+    }
+
     public function testStorageAttribute()
     {
         $container = new Container;
@@ -425,6 +441,13 @@ public function __construct(#[Config('foo')] string $foo, #[Config('bar')] strin
     }
 }
 
+final class ContextTest
+{
+    public function __construct(#[Context('foo')] string $foo)
+    {
+    }
+}
+
 final class DatabaseTest
 {
     public function __construct(#[Database('foo')] Connection $foo, #[Database('bar')] Connection $bar)