Added dump and dd methods to field class

CHANGELOG.md

@@ -1,5 +1,9 @@
 # CHANGELOG
 
+## 13.5.0
+
+- Added `dump` and `dd` methods to field class
+
 ## 13.4.0
 
 - Added automatically conversion of `choices` list to associative array

composer.json

@@ -20,6 +20,7 @@
         "php": "^8.1"
     },
     "require-dev": {
+        "symfony/var-dumper": "^6.3",
         "phpunit/phpunit": "^10.1"
     },
     "minimum-stability": "dev",
@@ -40,12 +41,12 @@
             "tests/helpers.php"
         ]
     },
-    "config": {
-        "preferred-install": "dist"
+    "suggest": {
+        "symfony/var-dumper": "Required to use the dump method (^6.3)."
     },
     "extra": {
         "branch-alias": {
-            "dev-master": "13.4-dev"
+            "dev-master": "13.5-dev"
         }
     }
 }

src/Fields/Field.php

@@ -60,6 +60,16 @@ public function withSettings(array $settings): static
         return $this;
     }
 
+    public function dump(...$args)
+    {
+        dump($this->get(), ...$args);
+    }
+
+    public function dd(...$args)
+    {
+        dd($this->get(), ...$args);
+    }
+
     /** @internal */
     public function get(string|null $parentKey = null): array
     {

tests/Fields/TextTest.php

@@ -17,6 +17,7 @@
 use Extended\ACF\Fields\Text;
 use InvalidArgumentException;
 use PHPUnit\Framework\TestCase;
+use Symfony\Component\VarDumper\VarDumper;
 
 class TextTest extends TestCase
 {
@@ -144,4 +145,19 @@ public function testAppend()
         $field = Text::make('Append')->append('suffix')->get();
         $this->assertSame('suffix', $field['append']);
     }
+
+    public function testDump()
+    {
+        $log = [];
+
+        VarDumper::setHandler(function ($value) use (&$log) {
+            $log[] = $value;
+        });
+
+        Text::make('Dump')->dump(1, 2);
+
+        $this->assertSame([['label' => 'Dump', 'name' => 'dump', 'type' => 'text', 'key' => 'field_076f7d8c'], 1, 2], $log);
+
+        VarDumper::setHandler(null);
+    }
 }