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ónDescripción
    7.3.0JSON_THROW_ON_ERRORflags fue añadido.
    7.2.0associative es ahora nullable.
    7.2.0JSON_INVALID_UTF8_IGNORE, y JSON_INVALID_UTF8_SUBSTITUTEflags 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

    To Top