Baza wiedzyCentrum egzaminacyjne
PLPolski
Wybierz język13

CKTIS / PHP

RuntimeException

RuntimeException opisuje awarię ujawnioną podczas działania, np. niespodziewany koniec strumienia.

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

Składnia

throw new RuntimeException("missing header")

RuntimeException opisuje awarię ujawnioną podczas działania, np. niespodziewany koniec strumienia. Dziedziczy po Exception i może nieść komunikat, kod i poprzedni Throwable. Funkcja biblioteczna zwracająca false sama nie tworzy wyjątku. Przykład jawnie zamienia koniec strumienia na błąd i zachowuje poprawną pustą linię.

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

Przykłady

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

Wynik

""
7 missing header

Źródła