json.php

См. документацию.

<?php
 
namespace Bitrix\Main\Web;
 
use Bitrix\Main\ArgumentException;
use JsonException;
 
class Json
{
    public const DEFAULT_OPTIONS = JSON_HEX_TAG | JSON_HEX_AMP | JSON_HEX_APOS | JSON_HEX_QUOT | JSON_UNESCAPED_UNICODE | JSON_INVALID_UTF8_SUBSTITUTE;

    public static function encode($data, $options = null)
    {
        if ($options === null)
        {
            $options = self::DEFAULT_OPTIONS;
        }
 
        try
        {
            $res = json_encode($data, $options | JSON_THROW_ON_ERROR);
        }
        catch (JsonException $e)
        {
            self::checkException($e, $options);
        }
 
        return $res;
    }

    public static function decode($data)
    {
        try
        {
            $res = json_decode($data, true, 512, JSON_THROW_ON_ERROR);
        }
        catch (JsonException $e)
        {
            self::checkException($e);
        }
 
        return $res;
    }
 
    public static function validate(string $data): bool
    {
        // On PHP 8.3 replace to
        // return json_validate($data);
 
        try
        {
            if ($data === 'null') // consistency with json_validate
            {
                return true;
            }
 
            return json_decode(json: $data, associative: true, flags: JSON_THROW_ON_ERROR) !== null;
        }
        catch (JsonException)
        {
            return false;
        }
    }

    protected static function convertData($data)
    {
        return $data;
    }

    protected static function checkException(JsonException $exception, $options = 0)
    {
        $e = $exception->getCode();
 
        if ($e == JSON_ERROR_UTF8 && ($options & JSON_PARTIAL_OUTPUT_ON_ERROR))
        {
            return;
        }
 
        $message = sprintf('%s [%d]', $exception->getMessage(), $e);
        self::throwException($message);
    }

    protected static function throwException($e)
    {
        throw new ArgumentException('JSON error: ' . $e, 'data');
    }
}