59 lines
1.7 KiB
PHP
59 lines
1.7 KiB
PHP
<?php
|
|
|
|
namespace Safe;
|
|
|
|
use Safe\Exceptions\JsonException;
|
|
|
|
/**
|
|
* Returns a string containing the JSON representation of the supplied
|
|
* value. If the parameter is an array or object,
|
|
* it will be serialized recursively.
|
|
*
|
|
* If a value to be serialized is an object, then by default only publicly visible
|
|
* properties will be included. Alternatively, a class may implement JsonSerializable
|
|
* to control how its values are serialized to JSON.
|
|
*
|
|
* The encoding is affected by the supplied flags
|
|
* and additionally the encoding of float values depends on the value of
|
|
* serialize_precision.
|
|
*
|
|
* @param mixed $value The value being encoded. Can be any type except
|
|
* a resource.
|
|
*
|
|
* All string data must be UTF-8 encoded.
|
|
*
|
|
* PHP implements a superset of JSON as specified in the original
|
|
* RFC 7159.
|
|
* @param int $flags Bitmask consisting of
|
|
* JSON_FORCE_OBJECT,
|
|
* JSON_HEX_QUOT,
|
|
* JSON_HEX_TAG,
|
|
* JSON_HEX_AMP,
|
|
* JSON_HEX_APOS,
|
|
* JSON_INVALID_UTF8_IGNORE,
|
|
* JSON_INVALID_UTF8_SUBSTITUTE,
|
|
* JSON_NUMERIC_CHECK,
|
|
* JSON_PARTIAL_OUTPUT_ON_ERROR,
|
|
* JSON_PRESERVE_ZERO_FRACTION,
|
|
* JSON_PRETTY_PRINT,
|
|
* JSON_UNESCAPED_LINE_TERMINATORS,
|
|
* JSON_UNESCAPED_SLASHES,
|
|
* JSON_UNESCAPED_UNICODE,
|
|
* JSON_THROW_ON_ERROR.
|
|
* The behaviour of these constants is described on the
|
|
* JSON constants page.
|
|
* @param int $depth Set the maximum depth. Must be greater than zero.
|
|
* @return string Returns a JSON encoded string on success.
|
|
* @throws JsonException
|
|
*
|
|
*/
|
|
function json_encode($value, int $flags = 0, int $depth = 512): string
|
|
{
|
|
error_clear_last();
|
|
$result = \json_encode($value, $flags, $depth);
|
|
if ($result === false) {
|
|
throw JsonException::createFromPhpError();
|
|
}
|
|
return $result;
|
|
}
|