json_last_error_msg
Judy
Fonctions JSON
PHP Manual

# json_last_error

(PHP 5 >= 5.3.0)

json_last_error — Retourne la dernière erreur JSON

### Description

int json_last_error ( void )

json_last_error() retourne la dernière erreur, s'il y en a eu, survenue lors de la dernière opération d'encodage/décodage JSON.

### Liste de paramètres

Cette fonction ne contient aucun paramètre.

### Valeurs de retour

Retourne une des constantes suivantes :

Codes d'erreur JSON
Constante | Signification | Disponibilité
--- | --- | ---
`JSON_ERROR_NONE` | Aucune erreur n'est survenue |
`JSON_ERROR_DEPTH` | La profondeur maximale de la pile a été atteinte |
`JSON_ERROR_STATE_MISMATCH` | JSON invalide ou mal formé |
`JSON_ERROR_CTRL_CHAR` | Erreur lors du contrôle des caractères ; probablement un encodage incorrect |
`JSON_ERROR_SYNTAX` | Erreur de syntaxe |
`JSON_ERROR_UTF8` | Caractères UTF-8 malformés, possiblement mal encodés | PHP 5.3.3

### 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 Exemple avec json_last_error() et 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)

### 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

json_last_error_msg
Judy
Fonctions JSON
PHP Manual