90 lines
2.4 KiB
PHP
Executable File
90 lines
2.4 KiB
PHP
Executable File
<?php
|
|
|
|
declare(strict_types=1);
|
|
|
|
namespace Beste;
|
|
|
|
use JsonException;
|
|
use SplFileInfo;
|
|
use SplFileObject;
|
|
use Throwable;
|
|
use UnexpectedValueException;
|
|
|
|
final class Json
|
|
{
|
|
private const ENCODE_DEFAULT = JSON_UNESCAPED_SLASHES | JSON_UNESCAPED_UNICODE;
|
|
private const ENCODE_PRETTY = self::ENCODE_DEFAULT | JSON_PRETTY_PRINT;
|
|
private const DECODE_DEFAULT = JSON_BIGINT_AS_STRING;
|
|
|
|
/**
|
|
* @throws UnexpectedValueException
|
|
*
|
|
* @return ($forceArray is true ? array<mixed> : mixed)
|
|
*/
|
|
public static function decode(string $json, ?bool $forceArray = null): mixed
|
|
{
|
|
$forceArray ??= false;
|
|
$flags = $forceArray ? JSON_OBJECT_AS_ARRAY : 0;
|
|
|
|
try {
|
|
return json_decode($json, $forceArray, 512, $flags | self::DECODE_DEFAULT | JSON_THROW_ON_ERROR);
|
|
} catch (JsonException $e) {
|
|
throw new UnexpectedValueException($e->getMessage());
|
|
}
|
|
}
|
|
|
|
/**
|
|
* @param non-empty-string $path
|
|
*
|
|
* @throws UnexpectedValueException
|
|
*
|
|
* @return ($forceArray is true ? array<mixed> : mixed)
|
|
*/
|
|
public static function decodeFile(string $path, ?bool $forceArray = null): mixed
|
|
{
|
|
if (!is_readable($path)) {
|
|
throw new UnexpectedValueException("The file at '$path' is not readable");
|
|
}
|
|
|
|
if (is_dir($path)) {
|
|
throw new UnexpectedValueException("'$path' points to a directory");
|
|
}
|
|
|
|
$contents = file_get_contents($path);
|
|
|
|
if ($contents === false) {
|
|
throw new UnexpectedValueException("The file at '$path' is not readable");
|
|
}
|
|
|
|
if ($contents === '') {
|
|
throw new UnexpectedValueException("The file at '$path' is empty");
|
|
}
|
|
|
|
return self::decode($contents, $forceArray);
|
|
}
|
|
|
|
/**
|
|
* @throws UnexpectedValueException
|
|
*/
|
|
public static function encode(mixed $data, ?int $options = null): string
|
|
{
|
|
$options ??= 0;
|
|
|
|
try {
|
|
return json_encode($data, $options | self::ENCODE_DEFAULT | JSON_THROW_ON_ERROR);
|
|
} catch (JsonException $e) {
|
|
throw new UnexpectedValueException($e->getMessage());
|
|
}
|
|
}
|
|
|
|
/**
|
|
* @throws UnexpectedValueException
|
|
*/
|
|
public static function pretty(mixed $value, ?int $options = null): string
|
|
{
|
|
$options ??= 0;
|
|
|
|
return self::encode($value, $options | self::ENCODE_PRETTY);
|
|
}
|
|
}
|