Submit a Pull Request 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

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

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

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

-26

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

down

-56

Anonymous ¶

8 years ago


I am working with "Marathi Language Data" and I found that when I encoded Marathi data to json using json_encode it returned me unicode values of each character like below:

Program : 

<?php
$ar = array("word" => "धाडस");
echo json_encode($ar);
?>

Output of program is : 

{"word":"\u0927\u093e\u0921\u0938"}

This is not expected output because what I need is output as

{"word":"धाडस"}

So I used following code:

<?php
$ar = array("word" => "धाडस");
echo json_encode($ar, JSON_UNESCAPED_UNICODE);
?>

And I got the required output as :

{"word":"धाडस"}

add a note