CKTIS / PHP
Exception::getMessage — čitanje poruke iznimke
Pročitaj tekst uhvaćene iznimke, razlikuj ga od koda i traga stoga te odluči što zapisati u dnevnik, a što prikazati korisniku.
Verzija: PHP 8.3; extension availability may vary
Sintaksa
final public function getMessage(): string
$e->getMessage()Exception::getMessage vraća poruku objekta iznimke kao string. To je javna metoda instance bez argumenata; final znači da je podklase ne mogu nadjačati. Oznaka :: navodi klasu u nazivu metode; na objektu je pozovi operatorom ->: $e->getMessage(). U PHP-u 8.3 poziv na new \Exception() bez poruke vraća prazan niz znakova ''.
catch (\Exception $e) hvata objekte klase \Exception i njezinih podklasa, ali ne objekte \Error. Za obradu obiju hijerarhija upotrijebi catch (\Throwable $e): zajedničko sučelje također nudi getMessage(). To ne hvata obična upozorenja koja se ne bacaju kao objekti. Početni \ upućuje na globalni naziv i unutar imenskog prostora.
getMessage() ne vraća kod ni trag stoga; za njih upotrijebi getCode() odnosno getTrace(). Ne uključuje ni poruku prethodne iznimke. Dohvati prethodni objekt pomoću getPrevious() i provjeri da rezultat nije null prije nego što na njemu pozoveš getMessage().
Nemoj temeljiti odluke u programu na tekstu poruke. Upotrijebi tip iznimke ili kod s dokumentiranim značenjem. U produkciji korisnicima ne prikazuj neobrađene poruke iznimki: mogu sadržavati putanje ili osjetljive podatke. Prikaži sigurnu poruku i u dnevnik zapisuj samo prikladno očišćene dijagnostičke podatke.
Primjeri
<?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
Prvi redak prikazuje poruku uhvaćene iznimke. Drugi se ispisuje samo zato što kôd dohvaća prethodni objekt i na njemu zasebno poziva `getMessage()`.
Povezane lekcije
- PHP · Lekcija 41 · Napredno · Verzija: 2
- PHP · Lekcija 67 · Napredno · Verzija: 2
- PHP · Lekcija 68 · Napredno · Verzija: 2
- PHP · Lekcija 69 · Napredno · Verzija: 2
- PHP · Lekcija 70 · Napredno · Verzija: 2
- PHP · Lekcija 75 · Napredno · Verzija: 2
- PHP · Lekcija 82 · Napredno · Verzija: 2
- PHP · Lekcija 20 · Srednje · Verzija: 3