Fonctions JSON
PHP Manual

json_encode

(PHP 5 >= 5.2.0, PECL json >= 1.2.0)

json_encodeRetourne le représentation JSON d'une valeur

Description

string json_encode ( mixed $value [, int $options= 0 ] )

Retourne une chaîne contenant la représentation JSON de la valeur value .

Liste de paramètres

value

La valeur à encoder. Peut être de n'importe quel type, excepté une ressource.

Cette fonction ne fonctionne qu'avec des données encodées UTF-8.

options

Masque composé des constantes JSON_HEX_QUOT, JSON_HEX_TAG, JSON_HEX_AMP, JSON_HEX_APOS, JSON_FORCE_OBJECT. Par défaut, vaut 0.

Valeurs de retour

Retourne une chaîne encodé JSON.

Historique

Version Description
5.3.0 Le paramètre options a été ajouté.
5.2.1 Ajout du support des types basiques d'encodage JSON

Exemples

Exemple #1 Exemple avec json_encode()

<?php
$arr 
= array ('a'=>1,'b'=>2,'c'=>3,'d'=>4,'e'=>5);

echo 
json_encode($arr);
?>

L'exemple ci-dessus va afficher :

{"a":1,"b":2,"c":3,"d":4,"e":5}

Exemple #2 Exemple avec json_encode() montrant toutes les options

<?php
$a 
= array('<foo>',"'bar'",'"baz"','&blong&');

echo 
"Normal : "json_encode($a), "\n";
echo 
"Tags : ",   json_encode($a,JSON_HEX_TAG), "\n";
echo 
"Apos : ",   json_encode($a,JSON_HEX_APOS), "\n";
echo 
"Quot : ",   json_encode($a,JSON_HEX_QUOT), "\n";
echo 
"Amp : ",    json_encode($a,JSON_HEX_AMP), "\n";
echo 
"Toutes : ",    json_encode($a,JSON_HEX_TAG|JSON_HEX_APOS|JSON_HEX_QUOT|JSON_HEX_AMP), "\n\n";

$b = array();

echo 
"Tableau vide sous forme de tableau : "json_encode($b), "\n";
echo 
"Tableau vide sous forme d'objet : "json_encode($bJSON_FORCE_OBJECT), "\n\n";

$c = array(array(1,2,3));

echo 
"Tableau non-associatif sous forme de tableau : "json_encode($c), "\n";
echo 
"Tableau non-associatif sous forme d'objet : "json_encode($cJSON_FORCE_OBJECT), "\n\n";
?>

L'exemple ci-dessus va afficher :

Normal : ["<foo>","'bar'","\"baz\"","&blong&"]
Tags : ["\u003Cfoo\u003E","'bar'","\"baz\"","&blong&"]
Apos : ["<foo>","\u0027bar\u0027","\"baz\"","&blong&"]
Quot : ["<foo>","'bar'","\u0022baz\u0022","&blong&"]
Amp : ["<foo>","'bar'","\"baz\"","\u0026blong\u0026"]
Toutes : ["\u003Cfoo\u003E","\u0027bar\u0027","\u0022baz\u0022","\u0026blong\u0026"]

Tableau vide sous forme de tableau : []
Tableau vide sous forme d'objet : {}

Tableau non-associatif sous forme de tableau : [[1,2,3]]
Tableau non-associatif sous forme d'objet : {"0":{"0":1,"1":2,"2":3}}

Voir aussi


Fonctions JSON
PHP Manual