(PHP 5 >= 5.2.0, PHP 7, PECL json >= 1.2.0)
json_decode — Convertește într-o variabilă un șir reprezentat JSON
Preia un șir de caractere reprezentat JSON și îl convertește într-o variabilă PHP.
json
Șirul (string) reprezentat json
care
trebuie convertit.
Această funcție operează doar cu șiruri codificate în UTF-8.
Notă:
PHP implementează un superset al JSON, după cum este specificat în documentul original » RFC 7159.
assoc
Când este true
, obiectele JSON vor fi întoarse ca tablouri asociative;
când este false
, obiectele JSON vor fi întoarse ca obiecte.
Când este null
, obiectele JSON vor fi întoarse ca tablouri asociative sau obiecte în dependență dacă JSON_OBJECT_AS_ARRAY
este setat în options
.
depth
Limita adâncimii de imbricare specificată de utilizator.
options
Masca de biți a opțiunilor
JSON_BIGINT_AS_STRING
,
JSON_INVALID_UTF8_IGNORE
,
JSON_INVALID_UTF8_SUBSTITUTE
,
JSON_OBJECT_AS_ARRAY
,
JSON_THROW_ON_ERROR
.
Efectele acestor constante sunt descrise pe pagina
Constante JSON.
Întoarce valoarea codificată în json
cu tipul PHP
corespunzător. Valorile true
, false
și
null
sunt întoarse ca true
, false
și null
respectiv.
null
este întors dacă parametrul json
nu poate fi
decodificat sau dacă datele pentru codificare sunt mai adânci decât limita de
imbricare.
Versiune | Descriere |
---|---|
7.3.0 |
A fost adăugată valoarea JSON_THROW_ON_ERROR
a parametrului options .
|
7.2.0 |
Parametrul assoc poate fi acum nul.
|
7.2.0 |
Au fost adăugate valorile JSON_INVALID_UTF8_IGNORE și
JSON_INVALID_UTF8_SUBSTITUTE a parametrului
options .
|
7.1.0 |
O cheie JSON vidă ("") poate fi codificată într-o proprietate vidă a
obiectului în loc de a folosi o cheie cu valoarea _empty_ .
|
Example #1 Exemple json_decode()
<?php
$json = '{"a":1,"b":2,"c":3,"d":4,"e":5}';
var_dump(json_decode($json));
var_dump(json_decode($json, true));
?>
Exemplul de mai sus va afișa:
object(stdClass)#1 (5) { ["a"] => int(1) ["b"] => int(2) ["c"] => int(3) ["d"] => int(4) ["e"] => int(5) } array(5) { ["a"] => int(1) ["b"] => int(2) ["c"] => int(3) ["d"] => int(4) ["e"] => int(5) }
Example #2 Accesarea proprietăților nevalide ale unui obiect
Accesarea elementelor dintr-un obiect, care conțin caractere nepermise conform convenției de denumiri PHP (de ex. liniuța), poate fi realizată prin încapsularea denumirii elementului între paranteze figurate și apostrofuri.
<?php
$json = '{"foo-bar": 12345}';
$obj = json_decode($json);
print $obj->{'foo-bar'}; // 12345
?>
Example #3 Greșeli tipice la utilizarea json_decode()
<?php
// următoarele șiruri sunt valide în JavaScript, dar nu sunt valide în JSON
// denumirea și valoarea trebuie să fie cuprinse între ghilimele duble
// ghilimelele singulare nu sunt valide
$bad_json = "{ 'bar': 'baz' }";
json_decode($bad_json); // null
// denumirea trebuie să fie cuprinsă între ghilimele duble
$bad_json = '{ bar: "baz" }';
json_decode($bad_json); // null
// virgule în plus la sfârșit nu sunt permise
$bad_json = '{ bar: "baz", }';
json_decode($bad_json); // null
?>
Example #4 Erori la parametrul depth
<?php
// Codificarea datelor.
$json = json_encode(
array(
1 => array(
'English' => array(
'One',
'January'
),
'French' => array(
'Une',
'Janvier'
)
)
)
);
// Definirea erorilor.
$constants = get_defined_constants(true);
$json_errors = array();
foreach ($constants["json"] as $name => $value) {
if (!strncmp($name, "JSON_ERROR_", 11)) {
$json_errors[$value] = $name;
}
}
// Arată erorile pentru diferite adâncimi.
foreach (range(4, 3, -1) as $depth) {
var_dump(json_decode($json, true, $depth));
echo 'Last error: ', $json_errors[json_last_error()], PHP_EOL, PHP_EOL;
}
?>
Exemplul de mai sus va afișa:
array(1) { [1]=> array(2) { ["English"]=> array(2) { [0]=> string(3) "One" [1]=> string(7) "January" } ["French"]=> array(2) { [0]=> string(3) "Une" [1]=> string(7) "Janvier" } } } Last error: JSON_ERROR_NONE NULL Last error: JSON_ERROR_DEPTH
Example #5 json_decode() cu numere întregi mari
<?php
$json = '{"number": 12345678901234567890}';
var_dump(json_decode($json));
var_dump(json_decode($json, false, 512, JSON_BIGINT_AS_STRING));
?>
Exemplul de mai sus va afișa:
object(stdClass)#1 (1) { ["number"]=> float(1.2345678901235E+19) } object(stdClass)#1 (1) { ["number"]=> string(20) "12345678901234567890" }
Notă:
Specificația JSON nu este JavaScript, ci un subset al JavaScript.
Notă:
În cazul decodificării cu eșec funcția json_last_error() poate fi utilizată pentru a determina natura exactă a erorii.