: 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) */ 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); } }