WissensdatenbankPrüfungszentrum
DEDeutsch
Sprache wählen13

CKTIS / PHP

UnexpectedValueException

UnexpectedValueException ist eine RuntimeException für einen zur Laufzeit unerwarteten Wert, häufig die Rückgabe einer anderen Komponente.

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

Syntax

throw new UnexpectedValueException("invalid status")

UnexpectedValueException ist eine RuntimeException für einen zur Laufzeit unerwarteten Wert, häufig die Rückgabe einer anderen Komponente. Gültige JSON-Syntax garantiert keinen zulässigen Status. Das Programm prüft den dekodierten Wert ausdrücklich, sodass unbekannter Status und ungültiges JSON verschiedene Ausnahmen auslösen.

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

Beispiele

<?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;
}

Ergebnis

open
UnexpectedValueException
JsonException

Quellen