[5.x] Add ability to get raw array directly from Values object (#13318)

Author: andjsch

src/Fields/Values.php

@@ -79,6 +79,14 @@ public function raw($key)
         return $value instanceof Value ? $value->raw() : $value;
     }
 
+    public function toRawArray(): array
+    {
+        return
+            $this->getIterator()
+                ->mapWithKeys(fn ($value, $key) => [$key => $value instanceof Value ? $value->raw() : $value])
+                ->toArray();
+    }
+
     public function __isset($key)
     {
         return $this->offsetExists($key);

tests/Fields/ValuesTest.php

@@ -186,6 +186,20 @@ public function raw_values()
         $this->assertNull($values->raw('missing'));
     }
 
+    #[Test]
+    public function to_raw_array()
+    {
+        $values = new Values([
+            'alfa' => 'bravo',
+            'charlie' => $value = new Value('delta', null, $this->fieldtype),
+        ]);
+
+        $this->assertEquals([
+            'alfa' => 'bravo',
+            'charlie' => 'delta',
+        ], $values->toRawArray());
+    }
+
     #[Test]
     #[DataProvider('queryBuilderProvider')]
     public function it_gets_a_query($builder)