# json_decode

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

json_decode — Decodifica 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

- json_encode() - Retorna la representación JSON del valor dado
- json_last_error() - Devuelve el último error ocurrido