Base di conoscenzaCentro esami
ITItaliano
Scegli la lingua13

CKTIS / PHP

Exception::getMessage — leggere il messaggio di un’eccezione

Leggi il testo di un’eccezione intercettata, distinguilo dal codice e dalla traccia dello stack e decidi cosa registrare e cosa mostrare all’utente.

Versione: PHP 8.3; extension availability may vary

Sintassi

final public function getMessage(): string

$e->getMessage()

Exception::getMessage restituisce il messaggio di un oggetto eccezione come string. È un metodo di istanza pubblico senza argomenti; final significa che le sottoclassi non possono ridefinirlo. :: identifica la classe nel nome del metodo; per chiamarlo sull’oggetto usa ->: $e->getMessage(). In PHP 8.3, chiamandolo su new \Exception() senza messaggio si ottiene la stringa vuota ''.

catch (\Exception $e) intercetta gli oggetti \Exception e quelli delle sue sottoclassi, ma non gli oggetti \Error. Per gestire entrambe le gerarchie, usa catch (\Throwable $e): anche l’interfaccia comune espone getMessage(). Questo non intercetta i normali avvisi che non vengono lanciati come oggetti. Il \ iniziale indica il nome globale anche all’interno di un namespace.

getMessage() non restituisce né il codice né la traccia dello stack; per quelli usa rispettivamente getCode() e getTrace(). Non include nemmeno il messaggio dell’eccezione precedente. Recupera l’oggetto precedente con getPrevious() e verifica che non sia null prima di chiamare getMessage() su di esso.

Non basare le decisioni del programma sul testo del messaggio. Usa invece un tipo di eccezione o un codice dal significato documentato. In produzione, non mostrare agli utenti i messaggi di eccezione senza filtrarli: possono contenere percorsi o dati sensibili. Mostra un messaggio sicuro e registra solo i dettagli diagnostici opportunamente filtrati.

Esempi

<?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";
    }
}

Risultato

Import failed
Invalid row format

La prima riga mostra il messaggio dell’eccezione intercettata. La seconda appare solo perché il codice recupera l’oggetto precedente e chiama `getMessage()` su di esso separatamente.

Lezioni correlate

  • PHP · Lezione 41 · Avanzato · Versione: 2
  • PHP · Lezione 67 · Avanzato · Versione: 2
  • PHP · Lezione 68 · Avanzato · Versione: 2
  • PHP · Lezione 69 · Avanzato · Versione: 2
  • PHP · Lezione 70 · Avanzato · Versione: 2
  • PHP · Lezione 75 · Avanzato · Versione: 2
  • PHP · Lezione 82 · Avanzato · Versione: 2
  • PHP · Lezione 20 · Intermedio · Versione: 3

Fonti