json_last_error

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

    json_last_error — Retourne la dernière erreur JSON

    Description

    json_last_error(): int

    Retourne la dernière erreur, s'il y en a eu, survenue lors de la dernière opération d'encodage/décodage JSON, qui n'a pas spécifié JSON_THROW_ON_ERROR.

    Liste de paramètres

    Cette fonction ne contient aucun paramètre.

    Valeurs de retour

    Retourne une des constantes suivantes :

    Codes d'erreur JSON
    ConstanteSignificationDisponibilité
    JSON_ERROR_NONEAucune erreur n'est survenue 
    JSON_ERROR_DEPTHLa profondeur maximale de la pile a été atteinte 
    JSON_ERROR_STATE_MISMATCHJSON invalide ou mal formé 
    JSON_ERROR_CTRL_CHARErreur lors du contrôle des caractères ; probablement un encodage incorrect 
    JSON_ERROR_SYNTAXErreur de syntaxe 
    JSON_ERROR_UTF8Caractères UTF-8 malformés, possiblement mal encodés 
    JSON_ERROR_RECURSIONUne ou plusieurs références récursives sont présentes dans la valeur à encoder 
    JSON_ERROR_INF_OR_NAN Une ou plusieurs valeurs NAN ou INF sont présentes dans la valeurs à encoder.  
    JSON_ERROR_UNSUPPORTED_TYPEUne valeur d'un type qui ne peut être encodée a été fournie 
    JSON_ERROR_INVALID_PROPERTY_NAMEUn nom de propriété qui ne peut pas être encodé a été donné 
    JSON_ERROR_UTF16Caractères UTF-16 mal formés, probablement mal encodé 

    Exemples

    Exemple #1 Exemple avec json_last_error()

    <?php
    // Une chaîne JSON valide
    $json[] = '{"Organisation": "Équipe de Documentation PHP"}';

    // Une chaîne json invalide qui va générer une erreur de syntaxe,
    // ici, utilisation de ' au lieu de "
    $json[] = "{'Organisation': 'Équipe de Documentation PHP'}";

    foreach (    $json as $string) {
    echo     'Décodage : ' . $string;
    json_decode($string);

    switch (    json_last_error()) {
    case     JSON_ERROR_NONE:
    echo     ' - Aucune erreur';
    break;
    case     JSON_ERROR_DEPTH:
    echo     ' - Profondeur maximale atteinte';
    break;
    case     JSON_ERROR_STATE_MISMATCH:
    echo     ' - Inadéquation des modes ou underflow';
    break;
    case     JSON_ERROR_CTRL_CHAR:
    echo     ' - Erreur lors du contrôle des caractères';
    break;
    case     JSON_ERROR_SYNTAX:
    echo     ' - Erreur de syntaxe ; JSON malformé';
    break;
    case     JSON_ERROR_UTF8:
    echo     ' - Caractères UTF-8 malformés, probablement une erreur d\'encodage';
    break;
    default:
    echo     ' - Erreur inconnue';
    break;
    }

    echo     PHP_EOL;
    }
    ?>

    L'exemple ci-dessus va afficher :

    Décodage : {"Organisation": "Équipe de Documentation PHP"} - Aucune erreur Décodage : {'Organisation': 'Équipe de Documentation PHP'} - Erreur de syntaxe ; JSON malformé

    Exemple #2 json_last_error() avec json_encode()

    <?php
    // Une séquence UTF8 invalide
    $text = "\xB1\x31";

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

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

    L'exemple ci-dessus va afficher :

    string(4) "null" bool(true)

    Exemple #3 json_last_error() et JSON_THROW_ON_ERROR

    <?php
    // Une séquence UTF8 invalide qui cause JSON_ERROR_UTF8
    json_encode("\xB1\x31");

    // Ceci ne produit pas une erreur JSON
    json_encode('okay', JSON_THROW_ON_ERROR);

    // L'état d'erreur global n'a pas été modifié par le json_encode() ci-dessus
    var_dump(json_last_error() === JSON_ERROR_UTF8);
    ?>

    L'exemple ci-dessus va afficher :

    bool(true)

    Voir aussi

    • json_last_error_msg() - Retourne le message de la dernière erreur survenue lors de l'appel à la fonction json_encode() ou json_decode()
    • json_decode() - Décode une chaîne JSON
    • json_encode() - Retourne la représentation JSON d'une valeur
    To Top