Base de conocimientosCentro de exámenes
ESEspañol
Elegir idioma13

CKTIS / PHP

Exception::getMessage — leer el mensaje de una excepción

Lee el texto de una excepción capturada, distínguelo del código y de la traza de la pila, y decide qué registrar y qué mostrar al usuario.

Versión: PHP 8.3; extension availability may vary

Sintaxis

final public function getMessage(): string

$e->getMessage()

Exception::getMessage devuelve el mensaje de un objeto de excepción como string. Es un método de instancia público sin argumentos; final indica que las subclases no pueden sobrescribirlo. :: identifica la clase en el nombre del método; para invocarlo sobre el objeto, usa ->: $e->getMessage(). En PHP 8.3, al llamarlo sobre new \Exception() sin mensaje, devuelve la cadena vacía ''.

catch (\Exception $e) captura objetos \Exception y de sus subclases, pero no objetos \Error. Para manejar ambas jerarquías, usa catch (\Throwable $e): la interfaz común también expone getMessage(). Esto no captura las advertencias ordinarias que no se lanzan como objetos. La \ inicial selecciona el nombre global incluso dentro de un espacio de nombres.

getMessage() no devuelve el código ni la traza de la pila; para eso están getCode() y getTrace(), respectivamente. Tampoco incluye el mensaje de la excepción anterior. Recupera el objeto anterior con getPrevious() y comprueba que no sea null antes de llamar a getMessage() sobre él.

No bases las decisiones del programa en la redacción del mensaje. Usa un tipo de excepción o un código con significado documentado. En producción, no muestres mensajes de excepción sin filtrar: pueden contener rutas o datos sensibles. Muestra un mensaje seguro y registra solo los detalles de diagnóstico que se hayan filtrado adecuadamente.

Ejemplos

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

Resultado

Import failed
Invalid row format

La primera línea muestra el mensaje de la excepción capturada. La segunda solo aparece porque el código recupera el objeto anterior e invoca `getMessage()` sobre él por separado.

Lecciones relacionadas

  • PHP · Lección 41 · Avanzado · Versión: 2
  • PHP · Lección 67 · Avanzado · Versión: 2
  • PHP · Lección 68 · Avanzado · Versión: 2
  • PHP · Lección 69 · Avanzado · Versión: 2
  • PHP · Lección 70 · Avanzado · Versión: 2
  • PHP · Lección 75 · Avanzado · Versión: 2
  • PHP · Lección 82 · Avanzado · Versión: 2
  • PHP · Lección 20 · Intermedio · Versión: 3

Fuentes