Add PHPBench tool and first benchmark example

composer.json

@@ -163,6 +163,9 @@
         "test": [
             "tools/phpunit/vendor/bin/phpunit"
         ],
+        "test:benchmark": [
+            "tools/phpbench/vendor/bin/phpbench run --report=default"
+        ],
         "test:mutation": [
             "tools/infection/vendor/bin/infection -j2"
         ],

phpbench.json

@@ -0,0 +1,6 @@
+{
+  "$schema": "./tools/phpbench/vendor/phpbench/phpbench/phpbench.schema.json",
+  "runner.bootstrap": "vendor/autoload.php",
+  "runner.path": "src/core/etl/tests/Flow/ETL/Tests/Benchmark/",
+  "runner.progress": "dots"
+}

src/core/etl/tests/Flow/ETL/Tests/Benchmark/Row/Reference/Expression/AddJsonBench.php

@@ -0,0 +1,43 @@
+<?php declare(strict_types=1);
+
+namespace Flow\ETL\Tests\Benchmark\Row\Reference\Expression;
+
+use function Flow\ETL\DSL\lit;
+use function Flow\ETL\DSL\ref;
+use Flow\ETL\DSL\From;
+use Flow\ETL\DSL\To;
+use Flow\ETL\Flow;
+use Flow\ETL\Memory\ArrayMemory;
+use PhpBench\Attributes\Iterations;
+use PhpBench\Attributes\Revs;
+
+final class AddJsonBench
+{
+    #[Revs(100)]
+    #[Iterations(5)]
+    public function benchAddingJson() : void
+    {
+        (new Flow())
+            ->read(
+                From::array([['id' => 1, 'array' => ['a' => 1, 'b' => 2, 'c' => 3]]])
+            )
+            ->withEntry('array', ref('array')->arrayMerge(lit(['d' => 4])))
+            ->write(To::memory(new ArrayMemory()))
+            ->run();
+    }
+
+    #[Revs(100)]
+    #[Iterations(5)]
+    public function benchAddingJsonStringIntoExistingReference() : void
+    {
+        (new Flow())
+            ->read(
+                From::array([['id' => 1, 'array' => ['a' => 1, 'b' => 2, 'c' => 3]]])
+            )
+            ->withEntry('json', lit('{"d": 4}'))
+            ->withEntry('array', ref('array')->arrayMerge(ref('json')->jsonDecode()))
+            ->drop('json')
+            ->write(To::memory(new ArrayMemory()))
+            ->run();
+    }
+}

tools/phpbench/.gitignore

@@ -0,0 +1 @@
+vendor

tools/phpbench/composer.json

@@ -0,0 +1,10 @@
+{
+  "name": "flow-php/etl-tools",
+  "description": "Flow PHP ETL - Tools",
+  "require-dev": {
+    "phpbench/phpbench": "^1.2"
+  },
+  "config": {
+    "allow-plugins": false
+  }
+}