CKTIS / PHP
Exception::getMessage — het bericht van een uitzondering lezen
Lees het bericht van een opgevangen uitzondering, houd het gescheiden van de foutcode en stacktrace en bepaal wat je logt en wat je aan de gebruiker toont.
Versie: PHP 8.3; extension availability may vary
Syntax
final public function getMessage(): string
$e->getMessage()Exception::getMessage geeft het bericht van een uitzonderingsobject terug als string. Het is een openbare instantiemethode zonder argumenten. Door final kunnen subklassen de methode niet overschrijven. :: geeft de klasse aan in de methodenaam; de aanroep op het object gebruikt ->: $e->getMessage(). In PHP 8.3 geeft de aanroep op new \Exception() zonder bericht de lege tekenreeks '' terug.
catch (\Exception $e) vangt objecten van \Exception en de subklassen ervan op, maar geen \Error-objecten. Gebruik catch (\Throwable $e) voor beide hiërarchieën: ook de gedeelde interface biedt getMessage(). Dit vangt geen gewone waarschuwingen op die niet als object worden geworpen. De voorafgaande \ verwijst ook binnen een naamruimte naar de globale naam.
getMessage() geeft niet de code of de stacktrace terug; gebruik daarvoor respectievelijk getCode() en getTrace(). Het bericht van de vorige uitzondering is ook niet inbegrepen. Haal het vorige object op met getPrevious() en controleer of het resultaat niet null is voordat je daarop getMessage() aanroept.
Laat de programmalogica niet afhangen van de formulering van het bericht. Gebruik in plaats daarvan een uitzonderingstype of een code met een gedocumenteerde betekenis. Toon in productie geen ongefilterde uitzonderingsberichten: ze kunnen paden of gevoelige gegevens bevatten. Toon een veilig bericht en log alleen diagnostische details waaruit gevoelige gegevens zijn verwijderd.
Voorbeelden
<?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";
}
}Resultaat
Import failed Invalid row format
De eerste regel toont het bericht van de opgevangen uitzondering. De tweede verschijnt alleen omdat de code het vorige object ophaalt en daarop apart `getMessage()` aanroept.
Gerelateerde lessen
- PHP · Les 41 · Gevorderd · Versie: 2
- PHP · Les 67 · Gevorderd · Versie: 2
- PHP · Les 68 · Gevorderd · Versie: 2
- PHP · Les 69 · Gevorderd · Versie: 2
- PHP · Les 70 · Gevorderd · Versie: 2
- PHP · Les 75 · Gevorderd · Versie: 2
- PHP · Les 82 · Gevorderd · Versie: 2
- PHP · Les 20 · Gemiddeld · Versie: 3