Helper de errores reutilizable en PHP

Contenido del curso

Introducción

Bases de un Framework

Refactorización

Acciones restantes

Estructura correcta de archivos

Seguridad

Flujo completo del sistema

Tomar examen

Cursos Empresas Blog Live Conf Eventos Precios

0:008:05

Helper de errores reutilizable en PHP

Curso de PHP Avanzado

Clase 30 de 33

Clase 30 / 33

Recursos

Si trabajas con formularios en PHP y quieres mostrar errores de validación sin repetir lógica en cada vista, un helper de sesiones flash es la solución. Aquí te muestro cómo encapsular el manejo de sesiones, crear funciones reutilizables y dejar tu código más declarativo y profesional.

¿Por qué usar un helper para el sistema de sesiones?

La idea es simple: escribir menos y mostrar más. En lugar de instanciar la clase de sesiones cada vez que necesitas guardar o leer un mensaje flash, centralizas el acceso en una función global que devuelve directamente una instancia de la clase.

Esto evita repetir bloques if en cada vista y mejora la legibilidad. Cuando lees helperSesiones()->getFlash('errores', []) entiendes la intención sin pensar en cómo se construye internamente.

¿Qué es un helper en PHP? Es una función global que envuelve lógica repetitiva para que la llames desde cualquier parte del proyecto sin instanciar clases manualmente.

¿Necesito un patrón Singleton aquí?

No. Aunque el editor sugiera un patrón parecido al de base de datos, la clase de sesiones solo encapsula el arreglo global $_SESSION. Como ese arreglo ya es único en la petición, basta con retornar una instancia nueva cada vez. El estado vive en la sesión, no en el objeto.

¿Cómo guardar e imprimir errores con getFlash y setFlash?

En la acción del controlador guardas los errores con setFlash('errores', $errores). En la vista los recuperas con getFlash('errores', []), pasando un arreglo vacío como valor por defecto para evitar errores cuando no hay nada almacenado.

El flujo queda así:

El sistema de validación detecta errores y los guarda en sesión.
La vista los obtiene con el helper.
Tras leerlos, se eliminan automáticamente para que no persistan en la siguiente petición.

Probado en el navegador, al enviar el formulario con datos inválidos los mensajes aparecen y desaparecen correctamente al recargar.

¿Cómo crear un helper errores que devuelva HTML reutilizable?

Repetir el foreach que arma la lista de errores en cada formulario es ruido innecesario. Mejor encapsulas esa construcción en un helper llamado errores() que retorne el HTML listo.

La lógica interna sigue estos pasos:

Recuperar los errores desde el helper de sesiones con getFlash.
Inicializar una variable $html con la apertura de la lista, por ejemplo '<ul>'.
Recorrer los errores con un foreach y concatenar cada <li> usando .=.
Cerrar la etiqueta </ul> y retornar la cadena completa.

Un detalle típico al escribir esto: si olvidas el punto y coma al final de una línea dentro del foreach, PHP lanza un error de sintaxis. Revisa siempre el cierre de cada instrucción.

Una vez funciona, basta con llamar <?= errores() ?> en cualquier formulario, ya sea de creación, edición o login. Una sola línea sustituye todo el bloque condicional anterior.

¿Cómo concateno HTML en una variable PHP? Usa el operador .= dentro de un bucle. Por ejemplo: $html .= "<li>{$error}</li>";. Así sumas contenido sin sobrescribir lo anterior.

¿Cómo agregar un método remove al sistema de sesiones?

Para cerrar sesión o limpiar datos puntuales, conviene añadir un método remove en la clase de sesiones. En lugar de hacer unset($_SESSION['user']) en distintos archivos, escribes $this->remove('user') y centralizas la lógica.

En el sistema de autenticación, guardar al usuario también se vuelve más limpio:

Antes: asignación directa al arreglo global de sesión.
Ahora: sesiones()->set('user', $datosUsuario).
Para cerrar sesión: sesiones()->remove('user').

Probado el flujo completo, iniciar sesión con credenciales válidas funciona, la navegación mantiene el estado y cerrar sesión elimina al usuario sin tocar $_SESSION directamente.

¿Por qué este código se considera más profesional?

Porque es declarativo: cada línea expresa qué quieres lograr, no cómo se hace por debajo. sesiones()->set(...) o errores() se leen casi como lenguaje natural. Quien revise el proyecto entiende la intención sin abrir la clase base.

Esa es la diferencia entre código que funciona y código que comunica.

¿Qué falta resolver con la función old?

La función old, que recuerda los valores escritos en un formulario tras un error de validación, sigue dependiendo de una variable predefinida. Necesita migrar al mismo sistema de sesiones flash que ya implementaste para los errores.

El reto queda abierto: aplica la misma lógica de getFlash y setFlash para que old recupere los datos del último envío y los muestre en los inputs. ¿Cómo lo resolverías tú? Cuéntame en los comentarios cómo estructurarías el helper antes de ver la siguiente clase.

Resumen

¿Por qué usar un helper para el sistema de sesiones?

Esto evita repetir bloques if en cada vista y mejora la legibilidad. Cuando lees helperSesiones()->getFlash('errores', []) entiendes la intención sin pensar en cómo se construye internamente.

¿Qué es un helper en PHP? Es una función global que envuelve lógica repetitiva para que la llames desde cualquier parte del proyecto sin instanciar clases manualmente.

¿Necesito un patrón Singleton aquí?

¿Cómo guardar e imprimir errores con getFlash y setFlash?

El flujo queda así:

El sistema de validación detecta errores y los guarda en sesión.
La vista los obtiene con el helper.
Tras leerlos, se eliminan automáticamente para que no persistan en la siguiente petición.

Probado en el navegador, al enviar el formulario con datos inválidos los mensajes aparecen y desaparecen correctamente al recargar.

¿Cómo crear un helper errores que devuelva HTML reutilizable?

Repetir el foreach que arma la lista de errores en cada formulario es ruido innecesario. Mejor encapsulas esa construcción en un helper llamado errores() que retorne el HTML listo.

La lógica interna sigue estos pasos:

Recuperar los errores desde el helper de sesiones con getFlash.
Inicializar una variable $html con la apertura de la lista, por ejemplo '<ul>'.
Recorrer los errores con un foreach y concatenar cada <li> usando .=.
Cerrar la etiqueta </ul> y retornar la cadena completa.

Un detalle típico al escribir esto: si olvidas el punto y coma al final de una línea dentro del foreach, PHP lanza un error de sintaxis. Revisa siempre el cierre de cada instrucción.

Una vez funciona, basta con llamar <?= errores() ?> en cualquier formulario, ya sea de creación, edición o login. Una sola línea sustituye todo el bloque condicional anterior.

¿Cómo concateno HTML en una variable PHP? Usa el operador .= dentro de un bucle. Por ejemplo: $html .= "<li>{$error}</li>";. Así sumas contenido sin sobrescribir lo anterior.

¿Cómo agregar un método remove al sistema de sesiones?

En el sistema de autenticación, guardar al usuario también se vuelve más limpio:

Antes: asignación directa al arreglo global de sesión.
Ahora: sesiones()->set('user', $datosUsuario).
Para cerrar sesión: sesiones()->remove('user').

Probado el flujo completo, iniciar sesión con credenciales válidas funciona, la navegación mantiene el estado y cerrar sesión elimina al usuario sin tocar $_SESSION directamente.

¿Por qué este código se considera más profesional?

Esa es la diferencia entre código que funciona y código que comunica.

¿Qué falta resolver con la función old?

Introducción

Portafolio en PHP puro sin frameworks

Estructura web básica con PHP y Git

Vistas parciales en PHP sin repetir código

Menú moderno en PHP con Tailwind CSS

Menú activo dinámico con PHP y CSS

Front controller y rutas en PHP

Conexión a MySQL con PDO y consultas dinámicas en PHP

Bases de un Framework

Centralización de conexiones a bases de datos en PHP con PDO

Encadenamiento de métodos en PHP con PDO

Validación de formularios PHP con POST

Clase de validación reutilizable para formularios en PHP

Refactorización

Cómo refactorizar una clase Validator en PHP

Archivos sueltos a controladores en PHP

Conexión de rutas con controladores en PHP

Clase de rutas en PHP con GET y POST

Acciones restantes

Rota DELETE para eliminar registros no CRUD

Formulario de edición precargado desde base de datos

Actualizar registros con PUT en Laravel

Estructura correcta de archivos

Configuración de autocarga con Composer en proyectos PHP

Creación y uso de helpers en PHP para código más legible

Helpers PHP para config, DB y redireccionamiento

Seguridad

Primer middleware PHP para proteger rutas

Refactorización de middleware con clases e interfaces en PHP

Vista de inicio de sesión con PHP y control de acceso

Lógica real de login con base de datos

Cifrado de contraseñas y gestión de sesiones en PHP

Flujo completo del sistema

Separa la autenticación del controlador PHP

Redirección automática después de enviar formularios

Clase SessionManager para mensajes flash en PHP

Helper de errores reutilizable en PHP

Integración de funciones con sistema de sesiones en PHP

Sistema de redirecciones con mensajes en PHP

Middleware para proteger rutas de usuarios logueados en PHP

Helper de errores reutilizable en PHP