json_decode

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

json_decodeDecodifica un string de JSON

Descripción

json_decode(
    string $json,
    ?bool $associative = null,
    int $depth = 512,
    int $flags = 0
): mixed

Convierte un string codificado en JSON a una variable de PHP.

Parámetros

json

El string de json a decodificar.

Esta función sólo trabaja con string codificados en UTF-8.

Nota:

PHP implementa un superconjunto de JSON tal como se especifica en la » RFC 7159 original.

associative

Cuando es true, los objects JSON devueltos serán convertidos a array asociativos, cuando es false los objects JSON devueltos serán convertidos a objects. Cuando es null, los objects JSON serán convertidos a array asociativos u objects dependiendo de si JSON_OBJECT_AS_ARRAY es establecida en los flags

depth

Profundidad máxima de anidamiento de la estructura que se decodifica.

flags

Máscara de bit de JSON_BIGINT_AS_STRING, JSON_INVALID_UTF8_IGNORE, JSON_INVALID_UTF8_SUBSTITUTE, JSON_OBJECT_AS_ARRAY, JSON_THROW_ON_ERROR. El comportamiento de estas constantes está descrito en la pagina de JSON constants.

Valores devueltos

Devuelve el valor codificado en json en un tipo de PHP apropiado. Los valores true, false y null son devueltos como true, false y null respectivamente. null es devuelto si el parámetro json no se puede decodificar o si los datos codificados son más profundos que el límite de recursividad.

Historial de cambios

Versión Descripción
7.3.0 JSON_THROW_ON_ERROR flags fue añadido.
7.2.0 associative es ahora nullable.
7.2.0 JSON_INVALID_UTF8_IGNORE, y JSON_INVALID_UTF8_SUBSTITUTE flags fueron añadidas.
7.1.0 Un clave JSON vacia ("") puede ser codificada en la propiedad del object vacio en lugar de usar una clave con valor_empty_.

Ejemplos

Ejemplo #1 Ejemplos de 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));

?>

El resultado del ejemplo serí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)
}

Ejemplo #2 Acceder a propiedades de objeto no válidas

Se puede acceder a elementos de un objeto que contienen caracteres no permitidos por la convención de nombres de PHP (p.ej., el guión) encapsulando el nombre del elemento entre llaves y apóstrofe.

<?php

$json
= '{"foo-bar": 12345}';

$obj = json_decode($json);
print
$obj->{'foo-bar'}; // 12345

?>

Ejemplo #3 Errores comunes al usar json_decode()

<?php

// los siguientes string son válidos en JavaScript pero no en JSON

// el nombre y el valor deben estar entre comillas dobles
// las comillas simples no son válidas
$bad_json = "{ 'bar': 'baz' }";
json_decode($bad_json); // null

// el nombre debe estar entre comillas dobles
$bad_json = '{ bar: "baz" }';
json_decode($bad_json); // null

// las comas finales no están permitidas
$bad_json = '{ bar: "baz", }';
json_decode($bad_json); // null

?>

Ejemplo #4 Errores con depth

<?php
// Codificar los datos con una profundidad máxima de 4 (array -> array -> array -> string)
$json = json_encode(
array(
1 => array(
'English' => array(
'One',
'January'
),
'French' => array(
'Une',
'Janvier'
)
)
)
);

// Mostrar los errores para diferentes profundidades.
var_dump(json_decode($json, true, 4));
echo
'Último error: ', json_last_error_msg(), PHP_EOL, PHP_EOL;
var_dump(json_decode($json, true, 3));
echo
'Último error: ', json_last_error_msg(), PHP_EOL, PHP_EOL;
?>

El resultado del ejemplo serí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"
    }
  }
}
Ultimo error: No error

NULL
Ultimo error: Maximum stack depth exceeded

Ejemplo #5 json_decode() de enteros grandes

<?php
$json
= '{"number": 12345678901234567890}';

var_dump(json_decode($json));
var_dump(json_decode($json, false, 512, JSON_BIGINT_AS_STRING));

?>

El resultado del ejemplo sería:

object(stdClass)#1 (1) {
  ["number"]=>
  float(1.2345678901235E+19)
}
object(stdClass)#1 (1) {
  ["number"]=>
  string(20) "12345678901234567890"
}

Notas

Nota:

La especificación de JSON no es JavaScript, pero sí un subconjunto de JavaScript.

Nota:

En el caso de ocurrir un error durante la decodificación, se puede usar json_last_error() para determinar la naturaleza exacta del mismo.

Ver también