CKTIS / PHP
Exception::getMessage — branje sporočila izjeme
Preberi besedilo prestrežene izjeme, loči ga od kode in sledi sklada ter se odloči, kaj zapisati v dnevnik in kaj prikazati uporabniku.
Različica: PHP 8.3; extension availability may vary
Sintaksa
final public function getMessage(): string
$e->getMessage()Exception::getMessage vrne sporočilo objekta izjeme kot string. To je javna metoda primerka brez argumentov; final pomeni, da je podrazredi ne morejo prepisati. Zapis :: označuje razred v imenu metode; na objektu jo pokliči z ->: $e->getMessage(). V PHP 8.3 klic na new \Exception() brez sporočila vrne prazen niz ''.
catch (\Exception $e) prestreže objekte razreda \Exception in njegovih podrazredov, ne pa objektov \Error. Za obravnavo obeh hierarhij uporabi catch (\Throwable $e): skupni vmesnik prav tako ponuja getMessage(). Tako ne prestrežeš običajnih opozoril, ki niso vržena kot objekti. Začetni \ označuje globalno ime tudi znotraj imenskega prostora.
getMessage() ne vrne kode niti sledi sklada; zanju uporabi getCode() oziroma getTrace(). Prav tako ne vključi sporočila prejšnje izjeme. Prejšnji objekt pridobi z getPrevious() in pred klicem getMessage() na njem preveri, da rezultat ni null.
Odločitev programa ne opiraj na besedilo sporočila. Uporabi tip izjeme ali kodo z dokumentiranim pomenom. V produkciji uporabnikom ne prikazuj neobdelanih sporočil izjem: lahko vsebujejo poti ali občutljive podatke. Prikaži varno sporočilo in v dnevnik zapisuj le ustrezno očiščene diagnostične podatke.
Primeri
<?php
try {
$cause = new \Exception('Invalid row format');
throw new \Exception('Import failed', previous: $cause);
} catch (\Exception $e) {
echo $e->getMessage(), "\n";
$previous = $e->getPrevious();
if ($previous !== null) {
echo $previous->getMessage(), "\n";
}
}Rezultat
Import failed Invalid row format
V prvi vrstici je sporočilo prestrežene izjeme. Druga se izpiše le zato, ker koda pridobi prejšnji objekt in na njem posebej pokliče `getMessage()`.
Povezane lekcije
- PHP · Lekcija 41 · Napredna · Različica: 2
- PHP · Lekcija 67 · Napredna · Različica: 2
- PHP · Lekcija 68 · Napredna · Različica: 2
- PHP · Lekcija 69 · Napredna · Različica: 2
- PHP · Lekcija 70 · Napredna · Različica: 2
- PHP · Lekcija 75 · Napredna · Različica: 2
- PHP · Lekcija 82 · Napredna · Različica: 2
- PHP · Lekcija 20 · Srednja · Različica: 3