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