Baza znanjaIzpitno središče
SLSlovenščina
Izberi jezik13

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

Viri