(PHP 5 >= 5.3.0)
json_last_error — Retourne la dernière erreur JSON
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.
Cette fonction ne contient aucun paramètre.
Retourne une des constantes suivantes :
| 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 |
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)