primo commit

libraries/vendor/joomla/input/src/Json.php

@@ -0,0 +1,69 @@
+<?php
+
+/**
+ * Part of the Joomla Framework Input Package
+ *
+ * @copyright  Copyright (C) 2005 - 2022 Open Source Matters, Inc. All rights reserved.
+ * @license    GNU General Public License version 2 or later; see LICENSE
+ */
+
+namespace Joomla\Input;
+
+/**
+ * Joomla! Input JSON Class
+ *
+ * This class decodes a JSON string from the raw request data and makes it available via the standard Input interface.
+ *
+ * @since  1.0
+ */
+class Json extends Input
+{
+    /**
+     * The raw JSON string from the request.
+     *
+     * @var    string
+     * @since  1.0
+     */
+    private $raw;
+
+    /**
+     * Constructor.
+     *
+     * @param   array|null  $source   Source data (Optional, default is the raw HTTP input decoded from JSON)
+     * @param   array       $options  Array of configuration parameters (Optional)
+     *
+     * @since   1.0
+     */
+    public function __construct($source = null, array $options = [])
+    {
+        if ($source === null) {
+            $this->raw = file_get_contents('php://input');
+
+            // This is a workaround for where php://input has already been read.
+            // See note under php://input on https://www.php.net/manual/en/wrappers.php.php
+            if (empty($this->raw) && isset($GLOBALS['HTTP_RAW_POST_DATA'])) {
+                $this->raw = $GLOBALS['HTTP_RAW_POST_DATA'];
+            }
+
+            $source = json_decode($this->raw, true);
+
+            if (!\is_array($source)) {
+                $source = [];
+            }
+        }
+
+        parent::__construct($source, $options);
+    }
+
+    /**
+     * Gets the raw JSON string from the request.
+     *
+     * @return  string  The raw JSON string from the request.
+     *
+     * @since   1.0
+     */
+    public function getRaw()
+    {
+        return $this->raw;
+    }
+}