Znalostná bázaCentrum skúšok
SKSlovenčina
Vybrať jazyk13

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

Zdroje