Adds support for Sandbox API root

Author: olance

CHANGELOG.md

@@ -1,6 +1,12 @@
 CHANGELOG
 =========
 
+v0.0.4
+------
+
+* Adds support for Sandbox API root
+
+
 v0.0.3
 ------
 

autoload.php

@@ -2,6 +2,10 @@
 /**
  * From https://www.php-fig.org/psr/psr-4/examples/.
  */
+
+// Load helper functions that are not provided by classes
+require_once './src/lib/array.php';
+
 spl_autoload_register(function ($class) {
     // project-specific namespace prefix
     $prefix = 'Alma\\API\\';

composer.json

@@ -21,6 +21,9 @@
   "autoload": {
     "psr-4": {
       "Alma\\API\\": "src/"
-    }
+    },
+    "files": [
+      "src/lib/array.php"
+    ]
   }
 }

src/Client.php

@@ -45,7 +45,8 @@ class DependenciesError extends \Exception
 
 class Client implements LoggerAwareInterface
 {
-    const API_URL = 'https://api.getalma.eu';
+    const LIVE_API_URL = 'https://api.getalma.eu';
+    const SANDBOX_API_URL = 'https://api.sandbox.getalma.eu';
 
     protected $context;
 
@@ -93,8 +94,8 @@ public function __construct($api_key, $options = array())
             throw new ParamsError('An API key is required to instantiate new Alma\Client');
         }
 
-        $options = array_merge(array(
-            'api_root' => self::API_URL,
+        $options = alma_array_merge_recursive(array(
+            'api_root' => array(TEST_MODE => self::SANDBOX_API_URL, LIVE_MODE => self::LIVE_API_URL),
             'force_tls' => 2,
             'mode' => LIVE_MODE,
             'logger' => new NullLogger(),

src/lib/array.php

@@ -0,0 +1,41 @@
+<?php
+
+// https://secure.php.net/manual/en/function.array-merge-recursive.php#104145
+// Addition: will automatically discard null values
+function alma_array_merge_recursive() {
+
+    if ( func_num_args() < 2 ) {
+        trigger_error( __FUNCTION__ . ' needs two or more array arguments', E_USER_WARNING );
+
+        return null;
+    }
+    $arrays = func_get_args();
+    $merged = array();
+    while ( $arrays ) {
+        $array = array_shift( $arrays );
+        if ( $array === null ) {
+            continue;
+        }
+        if ( ! is_array( $array ) ) {
+            trigger_error( __FUNCTION__ . ' encountered a non array argument', E_USER_WARNING );
+
+            return null;
+        }
+        if ( ! $array ) {
+            continue;
+        }
+        foreach ( $array as $key => $value ) {
+            if ( is_string( $key ) ) {
+                if ( is_array( $value ) && array_key_exists( $key, $merged ) && is_array( $merged[ $key ] ) ) {
+                    $merged[ $key ] = call_user_func( __FUNCTION__, $merged[ $key ], $value );
+                } else {
+                    $merged[ $key ] = $value;
+                }
+            } else {
+                $merged[] = $value;
+            }
+        }
+    }
+
+    return $merged;
+}