PHPLIB-1183: Add benchmarks for codecs (#1146)

* Move sample data to fixtures directory

* Add benchmarks to test empty codec overhead

* Add benchmark to convert BSON structures to PHP via iteration

Author: alcaeus

benchmark/BSON/DocumentBench.php

@@ -5,6 +5,7 @@
 use MongoDB\Benchmark\BaseBench;
 use MongoDB\BSON\Document;
 use PhpBench\Attributes\BeforeMethods;
+use stdClass;
 
 use function file_get_contents;
 use function iterator_to_array;
@@ -49,6 +50,15 @@ public function benchToPHPObject(): void
         self::$document->toPHP();
     }
 
+    public function benchToPHPObjectViaIteration(): void
+    {
+        $object = new stdClass();
+
+        foreach (self::$document as $key => $value) {
+            $object->$key = $value;
+        }
+    }
+
     public function benchToPHPArray(): void
     {
         self::$document->toPHP(['root' => 'array']);

benchmark/BSON/PackedArrayBench.php

@@ -55,6 +55,15 @@ public function benchToPHPArray(): void
         self::$array->toPHP();
     }
 
+    public function benchToPHPArrayViaIteration(): void
+    {
+        $array = [];
+
+        foreach (self::$array as $key => $value) {
+            $array[$key] = $value;
+        }
+    }
+
     public function benchIteration(): void
     {
         // phpcs:ignore Generic.CodeAnalysis.EmptyStatement.DetectedForeach

benchmark/BaseBench.php

@@ -9,8 +9,8 @@
 
 abstract class BaseBench
 {
-    protected const LARGE_FILE_PATH = __DIR__ . '/data/large_doc.json';
-    protected const TWEET_FILE_PATH = __DIR__ . '/data/tweet.json';
+    protected const LARGE_FILE_PATH = __DIR__ . '/Fixtures/data/large_doc.json';
+    protected const TWEET_FILE_PATH = __DIR__ . '/Fixtures/data/tweet.json';
 
     private static ?Collection $collection;
 

benchmark/Fixtures/PassThruCodec.php

@@ -0,0 +1,47 @@
+<?php
+
+namespace MongoDB\Benchmark\Fixtures;
+
+use MongoDB\BSON\Document;
+use MongoDB\Codec\DecodeIfSupported;
+use MongoDB\Codec\DocumentCodec;
+use MongoDB\Codec\EncodeIfSupported;
+use MongoDB\Exception\UnsupportedValueException;
+
+final class PassThruCodec implements DocumentCodec
+{
+    use DecodeIfSupported;
+    use EncodeIfSupported;
+
+    /** @param mixed $value */
+    public function canDecode($value): bool
+    {
+        return $value instanceof Document;
+    }
+
+    /** @param mixed $value */
+    public function canEncode($value): bool
+    {
+        return $value instanceof Document;
+    }
+
+    /** @param mixed $value */
+    public function decode($value): Document
+    {
+        if (! $value instanceof Document) {
+            throw UnsupportedValueException::invalidDecodableValue($value);
+        }
+
+        return $value;
+    }
+
+    /** @param mixed $value */
+    public function encode($value): Document
+    {
+        if (! $value instanceof Document) {
+            throw UnsupportedValueException::invalidEncodableValue($value);
+        }
+
+        return $value;
+    }
+}

benchmark/Fixtures/ToObjectCodec.php

@@ -0,0 +1,49 @@
+<?php
+
+namespace MongoDB\Benchmark\Fixtures;
+
+use MongoDB\BSON\Document;
+use MongoDB\Codec\DecodeIfSupported;
+use MongoDB\Codec\DocumentCodec;
+use MongoDB\Codec\EncodeIfSupported;
+use MongoDB\Exception\UnsupportedValueException;
+
+use function is_object;
+
+final class ToObjectCodec implements DocumentCodec
+{
+    use DecodeIfSupported;
+    use EncodeIfSupported;
+
+    /** @param mixed $value */
+    public function canDecode($value): bool
+    {
+        return $value instanceof Document;
+    }
+
+    /** @param mixed $value */
+    public function canEncode($value): bool
+    {
+        return is_object($value);
+    }
+
+    /** @param mixed $value */
+    public function decode($value): object
+    {
+        if (! $value instanceof Document) {
+            throw UnsupportedValueException::invalidDecodableValue($value);
+        }
+
+        return $value->toPHP(['root' => 'stdClass', 'array' => 'array', 'document' => 'stdClass']);
+    }
+
+    /** @param mixed $value */
+    public function encode($value): Document
+    {
+        if (! is_object($value)) {
+            throw UnsupportedValueException::invalidEncodableValue($value);
+        }
+
+        return Document::fromPHP($value);
+    }
+}

benchmark/data/large_doc.json benchmark/Fixtures/data/large_doc.json

@@ -3,6 +3,8 @@
 namespace MongoDB\Benchmark;
 
 use Generator;
+use MongoDB\Benchmark\Fixtures\PassThruCodec;
+use MongoDB\Benchmark\Fixtures\ToObjectCodec;
 use MongoDB\BSON\Document;
 use MongoDB\Exception\InvalidArgumentException;
 use MongoDB\Model\BSONArray;
@@ -40,7 +42,7 @@ public function provideParams(): Generator
     {
         yield 'Driver default typemap' => [
             'codec' => null,
-            'typeMap' => [],
+            'typeMap' => null,
             'accessor' => 'object',
         ];
 
@@ -65,6 +67,18 @@ public function provideParams(): Generator
             'typeMap' => ['root' => 'bson'],
             'accessor' => 'bson',
         ];
+
+        yield 'Codec (pass thru)' => [
+            'codec' => new PassThruCodec(),
+            'typeMap' => null,
+            'accessor' => 'bson',
+        ];
+
+        yield 'Codec (to object)' => [
+            'codec' => new ToObjectCodec(),
+            'typeMap' => null,
+            'accessor' => 'object',
+        ];
     }
 
     #[ParamProviders('provideParams')]

benchmark/data/tweet.json benchmark/Fixtures/data/tweet.json

@@ -3,6 +3,8 @@
 namespace MongoDB\Benchmark;
 
 use Generator;
+use MongoDB\Benchmark\Fixtures\PassThruCodec;
+use MongoDB\Benchmark\Fixtures\ToObjectCodec;
 use MongoDB\BSON\Document;
 use MongoDB\Exception\InvalidArgumentException;
 use MongoDB\Model\BSONArray;
@@ -65,6 +67,18 @@ public function provideParams(): Generator
             'typeMap' => ['root' => 'bson'],
             'accessor' => 'bson',
         ];
+
+        yield 'Codec (pass thru)' => [
+            'codec' => new PassThruCodec(),
+            'typeMap' => null,
+            'accessor' => 'bson',
+        ];
+
+        yield 'Codec (to object)' => [
+            'codec' => new ToObjectCodec(),
+            'typeMap' => null,
+            'accessor' => 'object',
+        ];
     }
 
     #[ParamProviders('provideParams')]