<?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; } }
Name | Type | Size | Permission | Actions |
---|---|---|---|---|
ArrayHash.php | File | 1.78 KB | 0644 |
|
ArrayList.php | File | 2.54 KB | 0644 |
|
Arrays.php | File | 10.53 KB | 0644 |
|
Callback.php | File | 3.45 KB | 0644 |
|
DateTime.php | File | 2.89 KB | 0644 |
|
FileInfo.php | File | 1.26 KB | 0644 |
|
FileSystem.php | File | 9.09 KB | 0644 |
|
Finder.php | File | 12.81 KB | 0644 |
|
Floats.php | File | 2.07 KB | 0644 |
|
Helpers.php | File | 2.5 KB | 0644 |
|
Html.php | File | 19.02 KB | 0644 |
|
Image.php | File | 21.27 KB | 0644 |
|
Json.php | File | 2.22 KB | 0644 |
|
ObjectHelpers.php | File | 6.85 KB | 0644 |
|
Paginator.php | File | 4.04 KB | 0644 |
|
Random.php | File | 1.07 KB | 0644 |
|
Reflection.php | File | 8.35 KB | 0644 |
|
Strings.php | File | 21.45 KB | 0644 |
|
Type.php | File | 6.2 KB | 0644 |
|
Validators.php | File | 10.08 KB | 0644 |
|
exceptions.php | File | 775 B | 0644 |
|