<?php

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

declare(strict_types=1);

namespace Nette\Utils;

use Nette;


/**
 * JSON encoder and decoder.
 */
final class Json
{
    use Nette\StaticClass;

    /** @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 easier reading and clarity, $asciiSafe for ASCII output
     * and $htmlSafe for HTML escaping, $forceObjects enforces the encoding of non-associateve 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;
    }


    /**
     * Parses JSON to PHP value. The $forceArrays enforces the decoding of 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;
    }
}

.NET Framework

Project Request

ProjectC

Vehicle Maintenance

Movie Navigator

Customers Exchange

ATM

.NET Core

Mail Daemon

Custom

Buns of code

PHP

Mediabox

Loan Castle

Content Management

Laravel

Phone Check

Frontend

Forex Wall

Business projects

Certification Center

Amerikas Auto

Pet projects

Geolocation Assistant

Web Dynamics

Blackball

Good old times

DOS Clock

BrainOut

Airport Administrator

Atomizer

Mediabox