options_merge function

Author: WyriHaximus

composer.json

@@ -1,6 +1,8 @@
 {
   "name": "api-clients/foundation",
   "license": "MIT",
+  "minimum-stability": "dev",
+  "prefer-stable": true,
   "authors": [
     {
       "name": "Cees-Jan Kiewiet",
@@ -27,7 +29,10 @@
   "autoload": {
     "psr-4": {
       "ApiClients\\Foundation\\": "src/"
-    }
+    },
+    "files": [
+      "src/functions_include.php"
+    ]
   },
   "autoload-dev": {
     "psr-4": {

composer.lock

@@ -0,0 +1,64 @@
+<?php declare(strict_types=1);
+
+namespace ApiClients\Foundation;
+
+/**
+ * @param array $base
+ * @param array $options
+ * @return array
+ */
+function options_merge(array $base, array $options): array
+{
+    $merge = true;
+    foreach ($base as $key => $value) {
+        if (is_numeric($key)) {
+            $merge = false;
+        }
+    }
+    foreach ($options as $name => $option) {
+        if (is_numeric($name)) {
+            $merge = false;
+        }
+    }
+
+    if ($merge === false) {
+        $new = [];
+
+        foreach ($base as $key => $value) {
+            if (in_array($value, $new)) {
+                continue;
+            }
+            $new[] = $value;
+        }
+        foreach ($options as $name => $option) {
+            if (in_array($option, $new)) {
+                continue;
+            }
+            $new[] = $option;
+        }
+
+        return $new;
+    }
+
+    foreach ($base as $key => $value) {
+        if (!isset($options[$key])) {
+            continue;
+        }
+
+        $option = $options[$key];
+        unset($options[$key]);
+
+        if (is_array($value) && is_array($option)) {
+            $base[$key] = options_merge($value, $option);
+            continue;
+        }
+
+        $base[$key] = $option;
+    }
+
+    foreach ($options as $name => $option) {
+        $base[$name] = $option;
+    }
+
+    return $base;
+}

src/functions.php

@@ -0,0 +1,9 @@
+<?php declare(strict_types=1);
+
+namespace ApiClients\Foundation;
+
+// @codeCoverageIgnoreStart
+if (!function_exists('ApiClients\Foundation\options_merge')) {
+    require __DIR__ . '/functions.php';
+}
+// @codeCoverageIgnoreEnd

src/functions_include.php

@@ -0,0 +1,93 @@
+<?php declare(strict_types=1);
+
+namespace ApiClients\Tests\Foundation;
+
+use ApiClients\Tools\TestUtilities\TestCase;
+use function ApiClients\Foundation\options_merge;
+
+final class FunctionsTest extends TestCase
+{
+    public function optionsProvider()
+    {
+        yield [
+            [],
+            [],
+            [],
+        ];
+
+        yield [
+            [],
+            ['foo' => 'bar'],
+            ['foo' => 'bar'],
+        ];
+
+        yield [
+            [],
+            [
+                'foo' => 'bar',
+                'middleware' => [],
+            ],
+            [
+                'foo' => 'bar',
+                'middleware' => [],
+            ],
+        ];
+
+        yield [
+            [
+                'middleware' => [
+                    'foo',
+                ],
+            ],
+            [
+                'foo' => 'bar',
+                'middleware' => [
+                    'bar',
+                ],
+            ],
+            [
+                'middleware' => [
+                    'foo',
+                    'bar',
+                ],
+                'foo' => 'bar',
+            ],
+        ];
+
+        yield [
+            [
+                'middleware' => [
+                    'foo',
+                    'bar',
+                ],
+            ],
+            [
+                'foo' => 'bar',
+                'middleware' => [
+                    'bar',
+                ],
+            ],
+            [
+                'middleware' => [
+                    'foo',
+                    'bar',
+                ],
+                'foo' => 'bar',
+            ],
+        ];
+    }
+
+    /**
+     * @dataProvider optionsProvider
+     */
+    public function testOptionsMerge(array $base, array $options, array $expected)
+    {
+        self::assertSame(
+            $expected,
+            options_merge(
+                $base,
+                $options
+            )
+        );
+    }
+}