Edit Report a Bug

예약 상수

이 확장은 다음의 상수들을 정의합니다. 이 확장을 PHP에 내장했거나, 실행시에 동적으로 읽어들일 경우에만 사용할 수 있습니다.

다음 상수들은 json_last_error()에서 반환하는 오류 형식을 나타냅니다.

JSON_ERROR_NONE (integer)

오류가 발생하지 않음. PHP 5.3.0 이후 버전에서 사용가능함.

JSON_ERROR_DEPTH (integer)

허용된 최대 스택 깊이를 초과함. PHP 5.3.0 이후 버전에서 사용가능함.

JSON_ERROR_STATE_MISMATCH (integer)

언더플로 또는 모드 불일치가 발생함. PHP 5.3.0 이후 버전에서 사용가능함.

JSON_ERROR_CTRL_CHAR (integer)

제어 문자 오류, 잘못 인코드되었을 수 있음. PHP 5.3.0 이후 버전에서 사용가능함.

JSON_ERROR_SYNTAX (integer)

문법 오류. PHP 5.3.0 이후 버전에서 사용가능함.

JSON_ERROR_UTF8 (integer)

잘못된 형식의 UTF-8 문자들임, 정확하지 못한 인코드가 문제일 수 있슴. 이 상수는 PHP 5.3.1 버전에서 사용가능함.

JSON_ERROR_RECURSION (integer)

The object or array passed to json_encode() include recursive references and cannot be encoded. If the JSON_PARTIAL_OUTPUT_ON_ERROR option was given, NULL will be encoded in the place of the recursive reference.

This constant is available as of PHP 5.5.0.

JSON_ERROR_INF_OR_NAN (integer)

The value passed to json_encode() includes either NAN or INF. If the JSON_PARTIAL_OUTPUT_ON_ERROR option was given, 0 will be encoded in the place of these special numbers.

This constant is available as of PHP 5.5.0.

JSON_ERROR_UNSUPPORTED_TYPE (integer)

A value of an unsupported type was given to json_encode(), such as a resource. If the JSON_PARTIAL_OUTPUT_ON_ERROR option was given, NULL will be encoded in the place of the unsupported value.

This constant is available as of PHP 5.5.0.

다음 상수들은 json_encode()에서 옵션값을 설정하기 위해 결합될 수 있습니다.

JSON_HEX_TAG (integer): < 와 >은 모두 \u003C 와 \u003E으로 변환됩니다. PHP 5.3.0 이후 버전에서 사용가능함.
JSON_HEX_AMP (integer): &는 모두 \u0026으로 변환됩니다. Available since PHP 5.3.0.
JSON_HEX_APOS (integer): '(작은따옴표)는 모두 \u0027으로 변환됩니다. PHP 5.3.0 이후 버전에서 사용가능함.
JSON_HEX_QUOT (integer): "(큰따옴표)는 모두 \u0022으로 변환됩니다. PHP 5.3.0 이후 버전에서 사용가능함.
JSON_FORCE_OBJECT (integer): Outputs an object rather than an array when a non-associative array is used. Especially useful when the recipient of the output is expecting an object and the array is empty. Available since PHP 5.3.0.
JSON_NUMERIC_CHECK (integer): Encodes numeric strings as numbers. Available since PHP 5.3.3.
JSON_BIGINT_AS_STRING (integer): Encodes large integers as their original string value. Available since PHP 5.4.0.
JSON_PRETTY_PRINT (integer): Use whitespace in returned data to format it. Available since PHP 5.4.0.
JSON_UNESCAPED_SLASHES (integer): Don't escape /. Available since PHP 5.4.0.
JSON_UNESCAPED_UNICODE (integer): Encode multibyte Unicode characters literally (default is to escape as \uXXXX). Available since PHP 5.4.0.

add a note

User Contributed Notes 7 notes

down

majid4466 at gmail dot com ¶

7 years ago


To get a really clean json string use these three constants like so:

<?php
$array = ['€', 'http://example.com/some/cool/page', '337'];
$bad   = json_encode($array); 
$good  = json_encode($array,  JSON_UNESCAPED_UNICODE | JSON_UNESCAPED_SLASHES | JSON_NUMERIC_CHECK);

// $bad would be  ["\u20ac","http:\/\/example.com\/some\/cool\/page","337"]
// $good would be ["€","http://example.com/some/cool/page",337]
?>

down

nikospapoutsis ¶

1 year ago


Be EXTREMELY cautious when using the code majid4466 at gmail dot com provided, or JSON_NUMERIC_CHECK in general.

For example, in php 7.4 and 8.1 with precision: 14 and serialize_precision: -1 we get:

<?php
$array = ['€', 55.6666666666666666, 'http://example.com/some/cool/page', '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_CHECK);

["\u20ac",55.666666666666664,"http:\/\/example.com\/some\/cool\/page","000337","55.6666666666666666"]
// in $case1, both euro sign and the url change but we also lost a digit in our unquoted float (due to precision)

["€",55.666666666666664,"http://example.com/some/cool/page","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 precision)

["€",55.666666666666664,"http://example.com/some/cool/page",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 zeros too

Also, note that in php 5.x you will probably get some different but equally wrong results as default values may be different and some functions have changed internally as well.

down

Yzmir Ramirez ¶

9 years ago


If you curious of the numeric values of the constants, as of JSON 1.2.1, the constants 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_CHECK => 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_BIGINT_AS_STRING => 2

down

ASchmidt at Anamera dot net ¶

5 years ago


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 make 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_ZERO_FRACTION+JSON_UNESCAPED_UNICODE );
?>

Or, if you have large arrays and are concerned about the overhead of object casting, you could append a "null" value beyond the size of the array, which will force the array to become associative:

<?php
$beyond = count( $array ) + 1;
if ( !array_key_exists( $beyond, $array) )
     $array[ $beyond ] = NULL;
$json = json_encode( $array, JSON_PRESERVE_ZERO_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.

down

JuanP ¶

8 years ago


Updated format values list:

    JSON_HEX_TAG => 1
    JSON_HEX_AMP => 2
    JSON_HEX_APOS => 4
    JSON_HEX_QUOT => 8
    JSON_FORCE_OBJECT => 16
    JSON_NUMERIC_CHECK => 32
    JSON_UNESCAPED_SLASHES => 64
    JSON_PRETTY_PRINT => 128
    JSON_UNESCAPED_UNICODE => 256
    JSON_PARTIAL_OUTPUT_ON_ERROR => 512
    JSON_PRESERVE_ZERO_FRACTION => 1024

down

-3

Anonymous ¶

5 years ago


flags JSON_NUMERIC_CHECK and JSON_PRESERVE_ZERO_FRACTION are broken in php 7+ — json_encode((float)8.8) returns "8.8000000000000007", and json_encode((float)8.8, JSON_NUMERIC_CHECK) and json_encode((float)8.8, JSON_PRESERVE_ZERO_FRACTION) return "8.8000000000000007" too.

the only way to fix this is setting "serialize_precision = -1" in php.ini

down

-28

on5wis at mac dot com ¶

9 years ago


since json_encode expects a UTF-8 string there is no need to encode the € symbol.

I suggest you try to echo : json_encode('€');
It gives: "\u20ac"
I'm running PHP 5.6.5 on the CLI, on MacOS X 10.10

add a note