fix: Serialize native PHP enums with name and value instead of opaque 'Object' string (#2038)

Co-authored-by: Claude Opus 4.6 (1M context) <noreply@anthropic.com>

Author: jarstelfox

src/Serializer/AbstractSerializer.php

@@ -139,6 +139,10 @@ protected function serializeRecursively($value, int $_depth = 0)
                     return $this->formatDate($value);
                 }
 
+                if ($value instanceof \UnitEnum) {
+                    return $this->serializeValue($value);
+                }
+
                 if ($this->serializeAllObjects || ($value instanceof \stdClass)) {
                     return $this->serializeObject($value, $_depth);
                 }
@@ -247,8 +251,13 @@ protected function serializeValue($value)
 
         if ($value instanceof \UnitEnum) {
             $reflection = new \ReflectionObject($value);
+            $enumValue = $reflection->getName() . '::' . $value->name;
+
+            if ($value instanceof \BackedEnum) {
+                return 'Enum ' . $enumValue . '(' . $value->value . ')';
+            }
 
-            return 'Enum ' . $reflection->getName() . '::' . $value->name;
+            return 'Enum ' . $enumValue;
         }
 
         if (\is_object($value)) {

tests/Serializer/AbstractSerializerTest.php

@@ -66,6 +66,56 @@ public function testEnumsAreNames(): void
         $this->assertSame('Enum Sentry\Tests\Serializer\SerializerTestEnum::CASE_NAME', $result);
     }
 
+    /**
+     * @requires PHP >= 8.1
+     */
+    public function testBackedEnumsIncludeValue(): void
+    {
+        $serializer = $this->createSerializer();
+        $input = SerializerTestBackedEnum::CASE_NAME;
+        $result = $this->invokeSerialization($serializer, $input);
+
+        $this->assertSame('Enum Sentry\Tests\Serializer\SerializerTestBackedEnum::CASE_NAME(case_value)', $result);
+    }
+
+    /**
+     * @requires PHP >= 8.1
+     *
+     * @dataProvider serializeAllObjectsDataProvider
+     */
+    public function testEnumsAreNotSerializedAsObjects(bool $serializeAllObjects): void
+    {
+        $serializer = $this->createSerializer();
+
+        if ($serializeAllObjects) {
+            $serializer->setSerializeAllObjects(true);
+        }
+
+        $input = SerializerTestEnum::CASE_NAME;
+        $result = $this->invokeSerialization($serializer, $input);
+
+        $this->assertSame('Enum Sentry\Tests\Serializer\SerializerTestEnum::CASE_NAME', $result);
+    }
+
+    /**
+     * @requires PHP >= 8.1
+     *
+     * @dataProvider serializeAllObjectsDataProvider
+     */
+    public function testBackedEnumsAreNotSerializedAsObjects(bool $serializeAllObjects): void
+    {
+        $serializer = $this->createSerializer();
+
+        if ($serializeAllObjects) {
+            $serializer->setSerializeAllObjects(true);
+        }
+
+        $input = SerializerTestBackedEnum::CASE_NAME;
+        $result = $this->invokeSerialization($serializer, $input);
+
+        $this->assertSame('Enum Sentry\Tests\Serializer\SerializerTestBackedEnum::CASE_NAME(case_value)', $result);
+    }
+
     public static function objectsWithIdPropertyDataProvider(): array
     {
         return [

tests/Serializer/SerializerTestBackedEnum.php

@@ -0,0 +1,10 @@
+<?php
+
+declare(strict_types=1);
+
+namespace Sentry\Tests\Serializer;
+
+enum SerializerTestBackedEnum: string
+{
+    case CASE_NAME = 'case_value';
+}