CKTIS / PHP
Exception::getMessage — získanie správy výnimky
Prečítaj text zachytenej výnimky, odlíš ho od kódu a výpisu zásobníka volaní a rozhodni, čo zapísať do denníka a čo zobraziť používateľovi.
Verzia: PHP 8.3; extension availability may vary
Syntax
final public function getMessage(): string
$e->getMessage()Exception::getMessage vracia správu objektu výnimky ako string. Je to verejná inštančná metóda bez argumentov; final znamená, že ju podtriedy nemôžu prepísať. Zápis :: označuje triedu v názve metódy; na objekte ju volaj pomocou ->: $e->getMessage(). V PHP 8.3 vráti volanie na new \Exception() bez správy prázdny reťazec ''.
catch (\Exception $e) zachytí objekty triedy \Exception a jej podtried, ale nie objekty \Error. Pre obe hierarchie použi catch (\Throwable $e): spoločné rozhranie tiež poskytuje getMessage(). Bežné upozornenia, ktoré sa nevyhadzujú ako objekty, sa takto nezachytia. Úvodné \ odkazuje na globálny názov aj vnútri menného priestoru.
getMessage() nevracia kód ani výpis zásobníka volaní; na to slúžia getCode() a getTrace(). Neobsahuje ani správu predchádzajúcej výnimky. Predchádzajúci objekt získaj pomocou getPrevious() a pred volaním getMessage() na tomto objekte over, že výsledok nie je null.
Nezakladaj rozhodovanie programu na znení správy. Použi typ výnimky alebo kód s dokumentovaným významom. V produkčnom prostredí nezobrazuj používateľom nespracované správy výnimiek: môžu obsahovať cesty alebo citlivé údaje. Zobraz bezpečnú správu a do denníka zapisuj len vhodne očistené diagnostické údaje.
Príklady
<?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";
}
}Výsledok
Import failed Invalid row format
Prvý riadok obsahuje správu zachytenej výnimky. Druhý sa vypíše len preto, že kód získa predchádzajúci objekt a samostatne na ňom zavolá `getMessage()`.
Súvisiace lekcie
- PHP · Lekcia 41 · Pokročilá · Verzia: 2
- PHP · Lekcia 67 · Pokročilá · Verzia: 2
- PHP · Lekcia 68 · Pokročilá · Verzia: 2
- PHP · Lekcia 69 · Pokročilá · Verzia: 2
- PHP · Lekcia 70 · Pokročilá · Verzia: 2
- PHP · Lekcia 75 · Pokročilá · Verzia: 2
- PHP · Lekcia 82 · Pokročilá · Verzia: 2
- PHP · Lekcia 20 · Stredne pokročilá · Verzia: 3