WissensdatenbankPrüfungszentrum
DEDeutsch
Sprache wählen13

CKTIS / PHP

RuntimeException

RuntimeException beschreibt einen erst zur Laufzeit erkennbaren Fehler, etwa ein unerwartetes Stromende.

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

Syntax

throw new RuntimeException("missing header")

RuntimeException beschreibt einen erst zur Laufzeit erkennbaren Fehler, etwa ein unerwartetes Stromende. Sie erbt von Exception und kann Meldung, Code und vorheriges Throwable tragen. Eine Bibliotheksfunktion mit Rückgabe false erzeugt sie nicht automatisch. Das Beispiel übersetzt das Stromende ausdrücklich und erhält eine gültige Leerzeile.

function headerLine($stream): string {
    $line = fgets($stream);
    if ($line === false) { throw new RuntimeException("missing header", 7); }
    return rtrim($line, "\r\n");
}
$f = fopen("php://memory", "w+"); fwrite($f, "\n"); rewind($f);
echo json_encode(headerLine($f)), PHP_EOL;
try { headerLine($f); }
catch (RuntimeException $e) { echo $e->getCode(), " ", $e->getMessage(); }
fclose($f);
""
7 missing header

Beispiele

<?php
function headerLine($stream): string {
    $line = fgets($stream);
    if ($line === false) { throw new RuntimeException("missing header", 7); }
    return rtrim($line, "\r\n");
}
$f = fopen("php://memory", "w+"); fwrite($f, "\n"); rewind($f);
echo json_encode(headerLine($f)), PHP_EOL;
try { headerLine($f); }
catch (RuntimeException $e) { echo $e->getCode(), " ", $e->getMessage(); }
fclose($f);

Ergebnis

""
7 missing header

Quellen