[12.x] Add support for Enums in Translator replacements (#58048)

Author: hosni

src/Illuminate/Translation/Translator.php

@@ -12,6 +12,8 @@
 use Illuminate\Support\Traits\ReflectsClosures;
 use InvalidArgumentException;
 
+use function Illuminate\Support\enum_value;
+
 class Translator extends NamespacedItemResolver implements TranslatorContract
 {
     use Macroable, ReflectsClosures;
@@ -285,8 +287,10 @@ protected function makeReplacements($line, array $replace)
                 continue;
             }
 
-            if (is_object($value) && isset($this->stringableHandlers[get_class($value)])) {
-                $value = call_user_func($this->stringableHandlers[get_class($value)], $value);
+            if (is_object($value)) {
+                $value = isset($this->stringableHandlers[get_class($value)])
+                    ? call_user_func($this->stringableHandlers[get_class($value)], $value)
+                    : enum_value($value);
             }
 
             $shouldReplace[':'.Str::ucfirst($key)] = Str::ucfirst($value ?? '');

tests/Translation/Fixtures/Enums/Bar.php

@@ -0,0 +1,8 @@
+<?php
+
+namespace Illuminate\Tests\Translation\Fixtures\Enums;
+
+enum Bar: int
+{
+    case Thirteen = 13;
+}

tests/Translation/Fixtures/Enums/Baz.php

@@ -0,0 +1,8 @@
+<?php
+
+namespace Illuminate\Tests\Translation\Fixtures\Enums;
+
+enum Baz: string
+{
+    case February = 'February';
+}

tests/Translation/Fixtures/Enums/Foo.php

@@ -0,0 +1,8 @@
+<?php
+
+namespace Illuminate\Tests\Translation\Fixtures\Enums;
+
+enum Foo
+{
+    case Hosni;
+}

tests/Translation/TranslationTranslatorTest.php

@@ -5,6 +5,9 @@
 use Illuminate\Contracts\Translation\Loader;
 use Illuminate\Support\Carbon;
 use Illuminate\Support\Collection;
+use Illuminate\Tests\Translation\Fixtures\Enums\Bar;
+use Illuminate\Tests\Translation\Fixtures\Enums\Baz;
+use Illuminate\Tests\Translation\Fixtures\Enums\Foo;
 use Illuminate\Translation\MessageSelector;
 use Illuminate\Translation\Translator;
 use Mockery as m;
@@ -283,6 +286,35 @@ public function testGetJsonReplacesWithStringable()
         );
     }
 
+    public function testGetJsonReplacesWithEnums()
+    {
+        $t = new Translator($this->getLoader(), 'en');
+        $t->getLoader()
+            ->shouldReceive('load')
+            ->once()
+            ->with('en', '*', '*')
+            ->andReturn([
+                'string_backed_enum' => 'Laravel 12 was released in :month 2025',
+                'int_backed_enum' => 'Stay tuned for Laravel v:version',
+                'unit_enum' => ':person gets excited about every new Laravel release',
+            ]);
+
+        $this->assertSame(
+            'Laravel 12 was released in February 2025',
+            $t->get('string_backed_enum', ['month' => Baz::February])
+        );
+
+        $this->assertSame(
+            'Stay tuned for Laravel v13',
+            $t->get('int_backed_enum', ['version' => Bar::Thirteen])
+        );
+
+        $this->assertSame(
+            'Hosni gets excited about every new Laravel release',
+            $t->get('unit_enum', ['person' => Foo::Hosni])
+        );
+    }
+
     public function testTagReplacements()
     {
         $t = new Translator($this->getLoader(), 'en');