CKTIS / PHP
Exception::getMessage — прочитане на съобщението на изключение
Прочети текста на прихванато изключение, разграничи го от кода и стека на извикванията и реши какво да запишеш в журнала и какво да покажеш на потребителя.
Версия: PHP 8.3; extension availability may vary
Синтаксис
final public function getMessage(): string
$e->getMessage()Exception::getMessage връща съобщението на обекта на изключението като низ (string). Това е публичен метод на обект, който не приема аргументи; final означава, че подкласовете не могат да го предефинират. :: посочва класа в името на метода; за извикване върху обекта използвай ->: $e->getMessage(). В PHP 8.3 извикването върху new \Exception() без съобщение връща празния низ ''.
catch (\Exception $e) прихваща обекти от клас \Exception и неговите подкласове, но не и обекти \Error. За обработка на двете йерархии използвай catch (\Throwable $e): общият интерфейс също предоставя getMessage(). Това не прихваща обичайните предупреждения, които не се хвърлят като обекти. Началният \ указва глобалното име дори в пространство от имена.
getMessage() не връща кода или стека на извикванията; за тях използвай съответно getCode() и getTrace(). Методът не включва и съобщението на предишното изключение. Вземи предишния обект чрез getPrevious() и провери дали резултатът е различен от null, преди да извикаш getMessage() върху него.
Не обвързвай логиката на програмата с формулировката на съобщението. Използвай тип на изключението или код с документирано значение. В продукционна среда не показвай необработените съобщения на потребителите: те може да съдържат пътища или чувствителни данни. Покажи безопасно съобщение и записвай в журнала само подходящо филтрирани диагностични данни.
Примери
<?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";
}
}Резултат
Import failed Invalid row format
Първият ред показва съобщението на прихванатото изключение. Вторият се извежда само защото кодът взема предишния обект и отделно извиква `getMessage()` върху него.
Свързани уроци
- PHP · Урок 41 · Напреднало · Версия: 2
- PHP · Урок 67 · Напреднало · Версия: 2
- PHP · Урок 68 · Напреднало · Версия: 2
- PHP · Урок 69 · Напреднало · Версия: 2
- PHP · Урок 70 · Напреднало · Версия: 2
- PHP · Урок 75 · Напреднало · Версия: 2
- PHP · Урок 82 · Напреднало · Версия: 2
- PHP · Урок 20 · Средно · Версия: 3