Initial commit

kirby/src/Data/Json.php

@@ -0,0 +1,61 @@
+<?php
+
+namespace Kirby\Data;
+
+use Kirby\Exception\InvalidArgumentException;
+
+/**
+ * Simple Wrapper around json_encode and json_decode
+ *
+ * @package   Kirby Data
+ * @author    Bastian Allgeier <bastian@getkirby.com>
+ * @link      https://getkirby.com
+ * @copyright Bastian Allgeier
+ * @license   https://opensource.org/licenses/MIT
+ */
+class Json extends Handler
+{
+	/**
+	 * Converts an array to an encoded JSON string
+	 */
+	public static function encode($data, bool $pretty = false): string
+	{
+		$constants = JSON_UNESCAPED_SLASHES | JSON_UNESCAPED_UNICODE;
+
+		if ($pretty === true) {
+			$constants |= JSON_PRETTY_PRINT;
+		}
+
+		return json_encode($data, $constants);
+	}
+
+	/**
+	 * Parses an encoded JSON string and returns a multi-dimensional array
+	 */
+	public static function decode($string): array
+	{
+		if ($string === null || $string === '') {
+			return [];
+		}
+
+		if (is_array($string) === true) {
+			return $string;
+		}
+
+		if (is_string($string) === false) {
+			throw new InvalidArgumentException(
+				message: 'Invalid JSON data; please pass a string'
+			);
+		}
+
+		$result = json_decode($string, true);
+
+		if (is_array($result) === true) {
+			return $result;
+		}
+
+		throw new InvalidArgumentException(
+			message: 'JSON string is invalid'
+		);
+	}
+}