Manejo de errores en PHP: try/catch y técnicas avanzadas

Introducción: Por qué el manejo de errores es la base del código PHP robusto

Cada desarrollador de PHP se enfrenta a errores. Ya sea una entrada de usuario incorrecta, una base de datos inaccesible o una falla inesperada de una API — sin un manejo adecuado de errores, la aplicación se convierte en una estructura frágil que puede "caerse" en cualquier momento. El manejo de errores en PHP no es solo una forma de evitar la pantalla blanca de la muerte (WSOD), sino un principio fundamental para crear aplicaciones web estables, seguras y mantenibles.

En este artículo, analizaremos todos los aspectos del manejo de errores en PHP: desde el mecanismo básico try/catch hasta la creación de excepciones personalizadas y estrategias avanzadas de logging. Aprenderá cómo convertir el caos de errores en un proceso manejable y predecible.

Fundamentos: try, catch, finally y throw

Bloque try/catch — la primera línea de defensa

El mecanismo de excepciones en PHP se basa en la construcción try/catch. El código que puede causar un error se coloca dentro del bloque try. Si ocurre una excepción en él, la ejecución pasa inmediatamente al bloque catch, donde se maneja el error.

<?phptry {    $file = fopen('important_data.txt', 'r');    if (!$file) {        throw new Exception('No se pudo abrir el archivo');    }    // Trabajar con el archivo    fclose($file);} catch (Exception $e) {    echo 'Error: ' . $e->getMessage();}?>

Es importante entender: no todos los errores en PHP son excepciones. Las advertencias estándar (warning) y las notificaciones (notice) no generan excepciones automáticamente. Para interceptarlas se requiere una configuración especial (ver la sección "Técnicas avanzadas").

Bloque finally — ejecución garantizada

El bloque finally se ejecuta siempre, independientemente de si se lanzó una excepción o no. Es el lugar ideal para liberar recursos: cerrar archivos, conexiones a la base de datos o liberar memoria.

<?phpfunction processData($data) {    $connection = null;    try {        $connection = new PDO('mysql:host=localhost;dbname=test', 'user', 'pass');        // Ejecutar consultas        return $connection->query($data);    } catch (PDOException $e) {        // Registramos el error        error_log('DB Error: ' . $e->getMessage());        return false;    } finally {        // Cerramos la conexión en cualquier caso        if ($connection) {            $connection = null;        }    }}?>

Operador throw — creamos nuestras propias excepciones

Con throw puede generar excepciones en cualquier punto del código. Esto permite crear escenarios de error claros y predecibles.

<?phpfunction validateAge($age) {    if (!is_numeric($age)) {        throw new InvalidArgumentException('La edad debe ser un número');    }    if ($age < 0 || $age > 150) {        throw new OutOfRangeException('La edad está fuera del rango permitido');    }    return true;}

try {    validateAge('abc');} catch (InvalidArgumentException $e) {    echo 'Error de validación: ' . $e->getMessage();} catch (OutOfRangeException $e) {    echo 'Rango inválido: ' . $e->getMessage();}?>

Clases de excepción personalizadas

Las clases de excepción estándar (Exception, RuntimeException, InvalidArgumentException) cubren muchos escenarios, pero para proyectos complejos es mejor crear jerarquías de excepción propias. Esto mejora la legibilidad del código y simplifica la depuración.

Creación de una clase de excepción personalizada

<?phpclass DatabaseException extends Exception {    private $queryString;        public function __construct($message, $query = '', $code = 0, Throwable $previous = null) {        $this->queryString = $query;        parent::__construct($m