Jetez un œil à la gestion des erreurs JSON dans la nouvelle version de PHP 7.3

Contexte

Dans PHP V7.2 actuellement stable, si vous souhaitez déterminer que le JSON n'est pas valide, vous devez utiliser la vérification de la fonction json_last_error() :

>>> json_decode("{");
=> null
>>> json_last_error();
=> 4
>>> json_last_error() === JSON_ERROR_NONE
=> false
>>> json_last_error_msg()
=> "Syntax error"

Par exemple, ici dans Larave se trouve une vérification pour s'assurer que l'appel de l'encodage JSON ne provoque pas d'erreur :

// Once we get the encrypted value we'll go ahead and base64_encode the input
// vector and create the MAC for the encrypted value so we can then verify
// its authenticity. Then, we'll JSON the data into the "payload" array.
$json = json_encode(compact('iv', 'value', 'mac'));
if (json_last_error() !== JSON_ERROR_NONE) {
    throw new EncryptException('Could not encrypt the data.');
}
return base64_encode($json);

Nous pouvons au moins déterminer s'il y a une erreur dans l'encodage/décodage JSON, mais c'est un peu lourd, lève une exception, émet un code d'erreur et un message d'erreur.

Bien que vous disposiez déjà d'options pour capturer et traiter JSON, voyons ce que la nouvelle version peut faire de manière intéressante !

Lancement de drapeaux d'erreur dans PHP 7.3

Avec le nouveau drapeau d'option JSON_THROW_ON_ERROR, il est possible de réécrire ce bloc de code pour utiliser try/catch.

Peut-être quelque chose comme ceci :

use JsonException;
try {
    $json = json_encode(compact('iv', 'value', 'mac'), JSON_THROW_ON_ERROR);
    return base64_encode($json);
} catch (JsonException $e) {
    throw new EncryptException('Could not encrypt the data.', 0, $e);
}

Je pense que ce nouveau style est particulièrement utile pour le code utilisateur lorsque vous recevez des données JSON au lieu de rechercher json_last_error() et les options correspondantes, l'encodage JSON et le décodage peut tirer parti des gestionnaires d'erreurs.

Cette fonction json_decode() prend quelques paramètres et ressemblera à PHP 7.3 et versions antérieures. Si vous souhaitez profiter de la gestion des erreurs :

use JsonException;
try {
    return json_decode($jsonString, $assoc = true, $depth = 512, JSON_THROW_ON_ERROR);
} catch (JsonException $e) {
    // Handle the JSON Exception
}
// Or even just let it bubble up...
/** 
 * Decode a JSON string into an array
 *
 * @return array
 * @throws JsonException
 */
function decode($jsonString) {
    return json_decode($jsonString, $assoc = true, $depth = 512, JSON_THROW_ON_ERROR);
}

Récupérez le code d'erreur. et message d'erreur

Auparavant, vous receviez des codes d'erreur et des messages JSON en utilisant la fonction suivante :

// Error code
json_last_error();
// Human-friendly message
json_last_error_msg();

Si vous utilisez le nouveau JSON_THROW_ON_ERROR, ici voici comment utiliser le code et recevoir des nouvelles :

try {
    return json_decode($jsonString, $assoc = true, $depth = 512, JSON_THROW_ON_ERROR);
} catch (JsonException $e) {
    $e->getMessage(); // like json_last_error_msg()
    $e->getCode(); // like json_last_error()
}