Просмотр архива ROTOR 14.1.1


<?php declare(strict_types=1);

/**
 * This file is part of the Nette Framework (https://nette.org)
 * Copyright (c) 2004 David Grudl (https://davidgrudl.com)
 */

namespace NetteUtils;

use Nette;
use function defined, is_int, json_decode, json_encode, json_last_error, json_last_error_msg;
use const JSON_BIGINT_AS_STRING, JSON_FORCE_OBJECT, JSON_HEX_AMP, JSON_HEX_APOS, JSON_HEX_QUOT, JSON_HEX_TAG, JSON_OBJECT_AS_ARRAY, JSON_PRESERVE_ZERO_FRACTION, JSON_PRETTY_PRINT, JSON_UNESCAPED_SLASHES, JSON_UNESCAPED_UNICODE;


/**
 * JSON encoder and decoder.
 */
final class Json
{
    use NetteStaticClass;

    /** @deprecated use Json::decode(..., forceArrays: true) */
    public const FORCE_ARRAY = JSON_OBJECT_AS_ARRAY;

    /** @deprecated use Json::encode(..., pretty: true) */
    public const PRETTY = JSON_PRETTY_PRINT;

    /** @deprecated use Json::encode(..., asciiSafe: true) */
    public const ESCAPE_UNICODE = 1 << 19;


    /**
     * Converts value to JSON format. Use $pretty for formatted output, $asciiSafe for ASCII-only output,
     * $htmlSafe for HTML-safe output, and $forceObjects to encode non-associative arrays as objects.
     * @throws JsonException
     */
    public static function encode(
        mixed $value,
        bool|int $pretty = false,
        bool $asciiSafe = false,
        bool $htmlSafe = false,
        bool $forceObjects = false,
    ): string
    {
        if (is_int($pretty)) { // back compatibility
            $flags = ($pretty & self::ESCAPE_UNICODE ? 0 : JSON_UNESCAPED_UNICODE) | ($pretty & ~self::ESCAPE_UNICODE);
        } else {
            $flags = ($asciiSafe ? 0 : JSON_UNESCAPED_UNICODE)
                | ($pretty ? JSON_PRETTY_PRINT : 0)
                | ($forceObjects ? JSON_FORCE_OBJECT : 0)
                | ($htmlSafe ? JSON_HEX_AMP | JSON_HEX_APOS | JSON_HEX_QUOT | JSON_HEX_TAG : 0);
        }

        $flags |= JSON_UNESCAPED_SLASHES
            | (defined('JSON_PRESERVE_ZERO_FRACTION') ? JSON_PRESERVE_ZERO_FRACTION : 0); // since PHP 5.6.6 & PECL JSON-C 1.3.7

        $json = json_encode($value, $flags);
        if ($error = json_last_error()) {
            throw new JsonException(json_last_error_msg(), $error);
        }

        return $json;
    }


    /**
     * Decodes a JSON string to a PHP value. Use $forceArrays to decode objects as arrays.
     * @throws JsonException
     */
    public static function decode(string $json, bool|int $forceArrays = false): mixed
    {
        $flags = is_int($forceArrays) // back compatibility
            ? $forceArrays
            : ($forceArrays ? JSON_OBJECT_AS_ARRAY : 0);
        $flags |= JSON_BIGINT_AS_STRING;

        $value = json_decode($json, flags: $flags);
        if ($error = json_last_error()) {
            throw new JsonException(json_last_error_msg(), $error);
        }

        return $value;
    }
}