Base de connaissancesCentre d’examen
FRFrançais
Choisir la langue13

CKTIS / PHP

UnexpectedValueException

UnexpectedValueException est une RuntimeException pour une valeur inattendue à l’exécution, souvent renvoyée par un autre composant.

Version : PHP 8.4; repository runtime, production runtime not attested

Syntaxe

throw new UnexpectedValueException("invalid status")

UnexpectedValueException est une RuntimeException pour une valeur inattendue à l’exécution, souvent renvoyée par un autre composant. Une syntaxe JSON valide ne garantit pas un statut autorisé. La vérification explicite de la valeur décodée distingue un statut inconnu d’une erreur de décodage JSON.

function status(string $json): string {
    $value = json_decode($json, true, 512, JSON_THROW_ON_ERROR);
    if (!in_array($value, ["open", "closed"], true)) {
        throw new UnexpectedValueException("invalid status");
    }
    return $value;
}
foreach (['"open"', '"other"', '{'] as $raw) {
    try { echo status($raw); } catch (UnexpectedValueException|JsonException $e) { echo get_class($e); }
    echo PHP_EOL;
}
open
UnexpectedValueException
JsonException

Exemples

<?php
function status(string $json): string {
    $value = json_decode($json, true, 512, JSON_THROW_ON_ERROR);
    if (!in_array($value, ["open", "closed"], true)) {
        throw new UnexpectedValueException("invalid status");
    }
    return $value;
}
foreach (['"open"', '"other"', '{'] as $raw) {
    try { echo status($raw); } catch (UnexpectedValueException|JsonException $e) { echo get_class($e); }
    echo PHP_EOL;
}

Résultat

open
UnexpectedValueException
JsonException

Sources