(PHP 5 >= 5.3.0, PHP 7)
json_last_error — Retourne la dernière erreur JSON
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.
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 |
JSON_ERROR_RECURSION |
Une ou plusieurs références récursives sont présentes dans la valeur à encoder | PHP 5.5.0 |
JSON_ERROR_INF_OR_NAN |
Une ou plusieurs valeurs
NAN
ou INF
sont présentes dans la valeurs à encoder.
|
PHP 5.5.0 |
JSON_ERROR_UNSUPPORTED_TYPE |
Une valeur d'un type qui ne peut être encodée a été fournie | PHP 5.5.0 |
JSON_ERROR_INVALID_PROPERTY_NAME |
Un nom de propriété qui ne peut pas être encodé a été donné | PHP 7.0.0 |
JSON_ERROR_UTF16 |
Charactères UTF-16 mal formés, probablement mal encodé | PHP 7.0.0 |
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)