json_last_error

    (PHP 5 >= 5.3.0, PHP 7, PHP 8)

    json_last_error — Devuelve el último error ocurrido

    Descripción

    json_last_error(): int

    Devuelve el último error (si existe) que ocurrió durante la última codificación/decodificación JSON.

    Parámetros

    Esta función no tiene parámetros.

    Valores devueltos

    Devuelve un integer, que puede ser una de las siguientes constantes:

    Códigos de error de JSON
    ConstanteSignificadoDisponibilidad
    JSON_ERROR_NONENo ocurrió ningún error 
    JSON_ERROR_DEPTHSe ha excedido la profundidad máxima de la pila 
    JSON_ERROR_STATE_MISMATCHJSON con formato incorrecto o inválido 
    JSON_ERROR_CTRL_CHARError del carácter de control, posiblemente se ha codificado de forma incorrecta 
    JSON_ERROR_SYNTAXError de sintaxis 
    JSON_ERROR_UTF8Caracteres UTF-8 mal formados, posiblemente codificados de forma incorrectaPHP 5.3.3
    JSON_ERROR_RECURSIONUna o más referencias recursivas en el valor a codificarPHP 5.5.0
    JSON_ERROR_INF_OR_NAN Uno o más valores NAN o INF en el valor a codificar PHP 5.5.0
    JSON_ERROR_UNSUPPORTED_TYPESe proporcionó un valor de un tipo que no se puede codificarPHP 5.5.0
    JSON_ERROR_INVALID_PROPERTY_NAMESe dio un nombre de una propiedad que no puede ser codificadaPHP 7.0.0
    JSON_ERROR_UTF16Caracteres UTF-16 malformados, posiblemente codificados de forma incorrectaPHP 7.0.0

    Ejemplos

    Ejemplo #1 Ejemplo de json_last_error()

    <?php
    // Un string json válido
    $json[] = '{"Organización": "Equipo de documentación PHP"}';

    // Un string json no válido que causa un error de sintaxis, en este caso, se ha
    // usado ' en vez de " para entrecomillar
    $json[] = "{'Organización': 'Equipo de documentación PHP'}";


    foreach(    $json as $string) {
    echo     'Decodificando: ' . $string;
    json_decode($string);

    switch(    json_last_error()) {
    case     JSON_ERROR_NONE:
    echo     ' - Sin errores';
    break;
    case     JSON_ERROR_DEPTH:
    echo     ' - Excedido tamaño máximo de la pila';
    break;
    case     JSON_ERROR_STATE_MISMATCH:
    echo     ' - Desbordamiento de buffer o los modos no coinciden';
    break;
    case     JSON_ERROR_CTRL_CHAR:
    echo     ' - Encontrado carácter de control no esperado';
    break;
    case     JSON_ERROR_SYNTAX:
    echo     ' - Error de sintaxis, JSON mal formado';
    break;
    case     JSON_ERROR_UTF8:
    echo     ' - Caracteres UTF-8 malformados, posiblemente codificados de forma incorrecta';
    break;
    default:
    echo     ' - Error desconocido';
    break;
    }

    echo     PHP_EOL;
    }
    ?>

    El resultado del ejemplo sería:

    Decoding: {"Organización": "Equipo de documentación PHP"} - Sin errores Decoding: {'Organización': 'Equipo de documentación PHP'} - Error de sintaxis, JSON mal formado

    Ejemplo #2 json_last_error() en json_encode()

    <?php
    // Secuencia inválida UTF8
    $text = "\xB1\x31";

    $json = json_encode($text);
    $error = json_last_error();

    var_dump($json, $error === JSON_ERROR_UTF8);
    ?>

    El resultado del ejemplo sería:

    string(4) "null" bool(true)

    Ver también

    To Top