Resumen - Validador de formularios

Parte de la sección Programación Orientada a Objetos del Journey de PHP de Coddy — lección 69 de 91.

Desafío

Fácil

Vamos a construir un validador de formularios de registro de usuario que recopile errores de validación y los informe todos a la vez, en lugar de detenerse en el primer problema. Así es como funciona la validación de formularios en el mundo real: los usuarios quieren ver todos los problemas con su envío, no corregirlos uno por uno.

Organizarás tu código en cuatro archivos:

ValidationException.php — Crea una clase base ValidationException que extienda de Exception. Esta servirá como la clase padre para todas las excepciones relacionadas con la validación.
Exceptions.php — Incluye el archivo ValidationException y crea tres clases de excepción específicas que extiendan de ValidationException:
- RequiredFieldException — Acepta un nombre de campo en su constructor y pasa el mensaje "[fieldName] is required" al padre
- InvalidEmailException — Acepta una cadena de correo electrónico en su constructor y pasa el mensaje "'[email]' is not a valid email" al padre
- MinLengthException — Acepta un nombre de campo y una longitud mínima (int) en su constructor y pasa el mensaje "[fieldName] must be at least [minLength] characters" al padre
FormValidator.php — Incluye el archivo Exceptions y crea una clase FormValidator con estos métodos de validación:
- validateRequired(?string $value, string $fieldName): string — Lanza RequiredFieldException si el valor es nulo o está vacío (después de usar trim), de lo contrario devuelve el valor con trim aplicado
- validateEmail(string $email): string — Lanza InvalidEmailException si el correo electrónico no es válido (usa filter_var con FILTER_VALIDATE_EMAIL), de lo contrario devuelve el correo electrónico
- validateMinLength(string $value, string $fieldName, int $minLength): string — Lanza MinLengthException si la longitud de la cadena es menor que el mínimo, de lo contrario devuelve el valor
main.php — Incluye el archivo FormValidator. Recibirás tres entradas: un nombre de usuario, un correo electrónico y una contraseña.
Crea un FormValidator y un array vacío para recopilar los mensajes de error. Valida cada campo en un bloque try-catch separado:
- Valida que el nombre de usuario sea obligatorio (required)
- Valida que el correo electrónico sea obligatorio primero, luego valida que tenga un formato de correo electrónico válido
- Valida que la contraseña sea obligatoria primero, luego valida que tenga una longitud mínima de 8 caracteres
Al capturar una ValidationException, añade su mensaje a tu array de errores en lugar de detener la ejecución.

Después de todas las validaciones, si hay errores, imprime cada mensaje de error en su propia línea. Si no hay errores, imprime "Registration successful".

Este patrón de recopilar todos los errores antes de informarlos es esencial para una buena experiencia de usuario. Tu jerarquía de excepciones facilita la captura de todos los problemas de validación con un solo bloque catch, manteniendo al mismo tiempo tipos de excepción específicos para diferentes fallos de validación.

Pruébalo tú mismo

<?php
require_once 'FormValidator.php';

// Leer entradas
$username = trim(fgets(STDIN));
$email = trim(fgets(STDIN));
$password = trim(fgets(STDIN));

// Crear una instancia de FormValidator
$validator = new FormValidator();

// Crear un array vacío para recopilar mensajes de error
$errors = [];

// TODO: Validar el nombre de usuario como obligatorio en un bloque try-catch
// Capturar ValidationException y añadir su mensaje al array $errors

// TODO: Validar el correo electrónico como obligatorio primero, luego validarlo como un formato de correo válido
// Usar un bloque try-catch y añadir cualquier mensaje de error al array $errors

// TODO: Validar la contraseña como obligatoria primero, luego validar una longitud mínima de 8 caracteres
// Usar un bloque try-catch y añadir cualquier mensaje de error al array $errors

// TODO: Después de todas las validaciones:
// - Si hay errores, imprimir cada mensaje de error en su propia línea
// - Si no hay errores, imprimir "Registration successful"

?>