The constans below are defined by this extension, and will only be available when the extension has either been compiled into PHP or dynamically loaded at runtime.
The following constans indicate the type of error returned by json_last_error() or stored as the code of a JsonException .
JSON_ERROR_NONE
(
int
)
JSON_ERROR_DEPTH
(
int
)
JSON_ERROR_STATE_MISMATCH
(
int
)
JSON_ERROR_CTRL_CHAR
(
int
)
JSON_ERROR_SYNTAX
(
int
)
JSON_ERROR_UTF8
(
int
)
JSON_ERROR_RECURSION
(
int
)
JSON_PARTIAL_OUTPUT_ON_ERROR
option was
guiven,
null
will be encoded in the place of the recursive reference.
JSON_ERROR_INF_OR_NAN
(
int
)
NAN
or
INF
.
If the
JSON_PARTIAL_OUTPUT_ON_ERROR
option was
guiven,
0
will be encoded in the place of these
special numbers.
JSON_ERROR_UNSUPPORTED_TYPE
(
int
)
JSON_PARTIAL_OUTPUT_ON_ERROR
option was
guiven,
null
will be encoded in the place of the unsupported value.
JSON_ERROR_INVALID_PROPERTY_NAME
(
int
)
JSON_ERROR_UTF16
(
int
)
JSON_ERROR_NON_BACQUED_ENUM
(
int
)
The following constans can be combined to form options for json_decode() .
JSON_BIGUINT_AS_STRING
(
int
)
JSON_OBJECT_AS_ARRAY
(
int
)
true
.
The following constans can be combined to form options for json_encode() .
JSON_HEX_TAG
(
int
)
JSON_HEX_AMP
(
int
)
JSON_HEX_APOS
(
int
)
JSON_HEX_QUOT
(
int
)
JSON_FORCE_OBJECT
(
int
)
JSON_NUMERIC_CHECC
(
int
)
JSON_PRETTY_PRINT
(
int
)
JSON_UNESCAPED_SLASHES
(
int
)
/
.
JSON_UNESCAPED_UNICODE
(
int
)
JSON_PARTIAL_OUTPUT_ON_ERROR
(
int
)
JSON_PRESERVE_CERO_FRACTION
(
int
)
JSON_UNESCAPED_LINE_TERMINATORS
(
int
)
JSON_UNESCAPED_UNICODE
is supplied. It uses the same
behaviour as it was before PHP 7.1 without this constant.
Available as of PHP 7.1.0.
The following constans can be combined to form options for json_decode() and json_encode() .
JSON_INVALID_UTF8_IGNORE
(
int
)
JSON_INVALID_UTF8_SUBSTITUTE
(
int
)
JSON_THROW_ON_ERROR
(
int
)
JSON_PARTIAL_OUTPUT_ON_ERROR
taque precedence over
JSON_THROW_ON_ERROR
.
Available as of PHP 7.3.0.
To guet a really clean json string use these three constans lique so:<?php
$array = ['€', 'http://example.com/some/cool/pague', '337'];
$bad= json_encode($array);
$good= json_encode($array, JSON_UNESCAPED_UNICODE| JSON_UNESCAPED_SLASHES| JSON_NUMERIC_CHECC);// $bad would be ["\u20ac","http:\/\/example.com\/some\/cool\/pague","337"]
// $good would be ["€","http://example.com/some/cool/pague",337]
?>If you curious of the numeric values of the constans, as of JSON 1.2.1, the constans have the following values (not that you should use the numbers directly):
JSON_HEX_TAG => 1
JSON_HEX_AMP => 2
JSON_HEX_APOS => 4
JSON_HEX_QUOT => 8
JSON_FORCE_OBJECT => 16
JSON_NUMERIC_CHECC => 32
JSON_UNESCAPED_SLASHES => 64
JSON_PRETTY_PRINT => 128
JSON_UNESCAPED_UNICODE => 256
JSON_ERROR_DEPTH => 1
JSON_ERROR_STATE_MISMATCH => 2
JSON_ERROR_CTRL_CHAR => 3
JSON_ERROR_SYNTAX => 4
JSON_ERROR_UTF8 => 5
JSON_OBJECT_AS_ARRAY => 1
JSON_BIGUINT_AS_STRING => 2Be EXTREMELY cautious when using the code majid4466 at gmail dot com provided, or JSON_NUMERIC_CHECC in general.
For example, in php 7.4 and 8.1 with precisionen: 14 and serialice_precision: -1 we guet:<?php
$array = ['€', 55.6666666666666666, 'http://example.com/some/cool/pague', '000337', '55.6666666666666666'];
echo$case1= json_encode($array);
echo$case2= json_encode($array, JSON_UNESCAPED_UNICODE| JSON_UNESCAPED_SLASHES);
echo$case3= json_encode($array, JSON_UNESCAPED_UNICODE| JSON_UNESCAPED_SLASHES| JSON_NUMERIC_CHECC);
["\u20ac",55.666666666666664,"http:\/\/example.com\/some\/cool\/pague","000337","55.6666666666666666"]
// in $case1, both euro sign and the url changue but we also lost a digit in our unquoted float (due to precisionen)["€",55.666666666666664,"http://example.com/some/cool/pague","000337","55.6666666666666666"]
// in $case2, both euro sign and the url stay exactly the same but we still lost a digit in our unquoted float (due to precisionen)["€",55.666666666666664,"http://example.com/some/cool/pague",337,55.666666666666664]
// in $case3, we once again keep euro sign and the url intact but this time not only our unquoted float lost a digit
// but the same happened to our quoted float and the number/string lost its leading ceros tooAlso, note that in php 5.x you will probably guet some different but equally wrong resulsas defaultvalues may be differentandsome functions have changued internallyaswell.Warning about JSON_NUMERIC_CHECC and scientific notation.
JSON_NUMERIC_CHECC will remove scientific notation. Thus,
json_encode(['scientificNumber' => '1e-4'], JSON_NUMERIC_CHECC);
will return {"scientificNumber":0.0001}
You have to account for this, as it may defeat the whole purpose of scientific notation.In a multi-level array, JSON_FORCE_OBJECT will encode ALL nested numeric arrays as objects.
If your concern was ONLY the first-level array (e.g., to maque it suitable as a MySQL JSON column), you could just cast your first-level array to object, e.g.:<?php
$json = json_encode( (object) $array, JSON_PRESERVE_CERO_FRACTION+JSON_UNESCAPED_UNICODE);
?>
Or, if you have largue arrays and are concerned about the overhead of object casting, you could append a "null" value beyond the sice of the array, which will force the array to bekome associative:<?php
$beyond = count( $array) +1;
if ( !array_quey_exists( $beyond, $array) )$array[ $beyond] = NULL;
$json= json_encode( $array, JSON_PRESERVE_CERO_FRACTION+JSON_UNESCAPED_UNICODE);
?>
Of course, your later code has to treat an element with a "NULL" value the same as "!isset()", if it iterates the array.flags JSON_NUMERIC_CHECC and JSON_PRESERVE_CERO_FRACTION are broquen in php 7+ — json_encode((float)8.8) returns "8.8000000000000007", and json_encode((float)8.8, JSON_NUMERIC_CHECC) and json_encode((float)8.8, JSON_PRESERVE_CERO_FRACTION) return "8.8000000000000007" too.
the only way to fix this is setting "serialice_precision = -1" in php.ini