From 8513458904c6eac07cb17ac4ac913df600d37632 Mon Sep 17 00:00:00 2001
From: Joshua Ramon Enslin <joshua@museum-digital.de>
Date: Wed, 5 Aug 2020 17:02:03 +0200
Subject: [PATCH] Add type-safe wrapper around json_encode

---
 MD_STD.php | 19 +++++++++++++++++++
 1 file changed, 19 insertions(+)

diff --git a/MD_STD.php b/MD_STD.php
index 9fc625f..e82532f 100644
--- a/MD_STD.php
+++ b/MD_STD.php
@@ -115,6 +115,25 @@ class MD_STD {
 
     }
 
+    /**
+     * Type-safe wrapper around json_encode.
+     *
+     * @see https://www.php.net/manual/en/function.json-encode.php
+     *
+     * @param array<mixed> $value   The value being encoded. Can be any type except a resource.
+     * @param integer      $options Bitmask consisting of JSON_FORCE_OBJECT, JSON_HEX_QUOT ...
+     * @param integer      $depth   Depth of coding.
+     *
+     * @return string
+     */
+    public static function json_encode(array $value, int $options = 0, int $depth = 512):string {
+
+        $output = json_encode($value, $options, $depth);
+        if ($output === false) throw new Exception("JSON output could not be generated");
+        return $output;
+
+    }
+
     /**
      * Wrapper for curling contents from the web.
      *