FIX: Upd json conversion

Author: phphleb

HlebBootstrap.php

@@ -109,7 +109,7 @@ public function __construct(?string $publicPath = null, array $config = [], ?Log
 
         // The current version of the framework.
         // Текущая версия фреймворка.
-        \defined('HLEB_CORE_VERSION') or \define('HLEB_CORE_VERSION', '2.1.19');
+        \defined('HLEB_CORE_VERSION') or \define('HLEB_CORE_VERSION', '2.1.20');
 
         $this->logger = $logger;
 

HttpMethods/Specifier/DataType.php

@@ -166,11 +166,17 @@ public function asPositiveFloat(int $precision = 5, int $mode = PHP_ROUND_HALF_U
      * The value of $default is assumed to be a safe value.
      * If there is no value, you can also set the exception class $exc, which is called
      * instead of the default value; if true, the standard error class will be called.
+     * (!) Is not suitable for producing a valid JSON string, as it escapes consecutive double quotes.
+     * To get the original JSON string, you can use value(), and to convert it
+     * to an array with escaped values, use asArray().
      *
      * Возвращает значение приведенное к типу `string`, если значение не существует - возвращает $default.
      * Предполагается, что значением $default является безопасное значение.
      * При отсутствии значения также можно задать класс исключения $exc, вызываемый вместо
      * дефолтного значения; при true будет вызван стандартный класс ошибки.
+     * (!) Не подходит для получения валидной JSON-строки, так как экранирует двойные кавычки подряд.
+     * Для получения оригинальной JSON-строки можно использовать value(),
+     * а преобразованный в массив c экранированными значениями - asArray().
      */
     public function asString(string|null $default = null, bool|string $exc = false): string|null
     {
@@ -238,7 +244,7 @@ public function asArray(array $default = [], bool|string $exc = false): array
             (\str_starts_with(\ltrim($this->value), '{') || \str_starts_with(\ltrim($this->value), '['))
         ) {
             try {
-                $value = \json_decode(\trim($value), true, JSON_THROW_ON_ERROR);
+                $value = \json_decode(\trim($value), true, 512, JSON_THROW_ON_ERROR);
             } catch (\JsonException) {
             }
             if (!\is_array($value)) {

Init/Review/basic.php

@@ -210,7 +210,7 @@ function env_array(string $name, #[SensitiveParameter] array $default): array
                 return $default;
             }
             if (str_starts_with($env, '{') && str_ends_with($env,'}')) {
-                return json_decode($env, true, JSON_THROW_ON_ERROR);
+                return json_decode($env, true, 512, JSON_THROW_ON_ERROR);
             }
             throw new RuntimeException("The value of the environment variable `{$name}` is expected to be an JSON string!");
         }

Main/Console/Specifiers/LightDataType.php

@@ -152,11 +152,17 @@ public function asPositiveFloat(int $precision = 5, int $mode = PHP_ROUND_HALF_U
      * The value of $default is assumed to be a safe value.
      * If there is no value, you can also set the exception class $exc, which is called
      *  instead of the default value; if true, the standard error class will be called.
+     * (!) Is not suitable for producing a valid JSON string, as it escapes consecutive double quotes.
+     * To get the original JSON string, you can use value(), and to convert it
+     * to an array with escaped values, use asArray().
      *
      * Возвращает значение приведенное к типу `string`, если значение не существует - возвращает $default.
      * Предполагается, что значением $default является безопасное значение.
      * При отсутствии значения также можно задать класс исключения $exc, вызываемый вместо
      * дефолтного значения; при true будет вызван стандартный класс ошибки.
+     * (!) Не подходит для получения валидной JSON-строки, так как экранирует двойные кавычки подряд.
+     * Для получения оригинальной JSON-строки можно использовать value(),
+     * а преобразованный в массив c экранированными значениями - asArray().
      */
     public function asString(string|null $default = null, bool|string $exc = false): string|null
     {
@@ -219,7 +225,7 @@ public function asArray(array $default = [], bool|string $exc = false): array
         ) {
             $value = $this->value;
             try {
-                $value = \json_decode(\trim($value), true, JSON_THROW_ON_ERROR);
+                $value = \json_decode(\trim($value), true, 512, JSON_THROW_ON_ERROR);
             } catch (\JsonException) {
             }
             if (!\is_array($value)) {