Baza znanjaCentar za ispite
HRHrvatski
Odaberi jezik13

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

Izvori