16.2. Crear el módulo del usuario
En el Demo de usuario de ejemplo, creamos un nuevo modulo llamado User y agregamos toda la funcionalidad relacionada con el manejo de usuario y su autenticación a este modulo. Si nos resulta nuevo el concepto de módulos podemos revisar el capítulo Crear un nuevo modulo.
El módulo User tendrá muy pocas dependencias de otros módulos del sitio web. La idea detrás del modulo User es darnos una unidad reusable que podamos usar en nuestra propia aplicación web sin ningún cambio o con pocos.
Idealmente debemos poder usar el modulo User en nuestro sitio web sin ningún cambio. Pero, en la vida real probablemente tendremos que agregar algunos campos a la tabla
user, modificar el flujo de creación de un usuario modificar el algoritmo de filtro de acceso. En este caso, tendremos que adaptar el código de el modulo User para ajustarlo a nuestras necesidades.
El modulo User tendrá la siguiente estructura (ver figura 16.1):
Figura 16.1 Estructura del Módulo de Usuario
Vamos a describir rápidamente que clases tenemos dentro de nuestro directorio module.
Tenemos dos controladores:
- El UserController contendrá la funcionalidad para el manejo de usuario (añadir, editar, cambio de contraseña, etc).
- El AuthController implementará la funcionalidad de autenticación de usuario (login/logout).
Tendremos una entidad de Doctrine:
- La entidad User será usada para almacenar información sobre el usuario en la base de datos (correo electrónico, nombre completo, contraseña, etc).
Se usan cuatro formularios para capturar la información:
- El LoginForm se usa para capturar la información de autenticación (nombre de usuario y contraseña).
- El PasswordChangeForm se usa para capturar la información de cambio o reinicio de la contraseña de usuario.
- El PasswordResetForm se usa para captura el correo electrónico de la persona que olvido su contraseña y desea reiniciarla.
- El UserForm se usa para capturar la información del usuario (correo electrónico, nombre completo, contraseña, etc).
Tendremos varios servicios:
- El servicio AuthAdapter que implementa el algoritmo de autenticación. Este revisa si el nombre de usuario (dirección de correo electrónico) y la contraseña son correctas. Para ejecutar este proceso recupera la información de la base de datos.
- El servicio AuthManager ejecuta propiamente la autenticación (login/logout). Este además implementa el filtro de acceso, permitiendo o denegando el acceso a usuarios no autenticados sobre determinadas páginas web.
- El UserManager contendrá la lógica del negocio para el manejo de usuarios (añadir, editar, cambiar la contraseña).
Más controladores y servicios serán instanciados con factories. Podemos encontrar las clases factory en el subdirectorio Factory.
Dentro del directorio view, tendremos varias plantillas de vistas que imprimen el código HTML de las páginas webs presentes en la interfaz de usuario de nuestro módulo.
Como es usual, dentro del directorio config, tendremos el archivo module.config.php que contendrá las rutas y el registro para nuestros controladores y servicios. Este también contendrá la llave access_filter que define que páginas web del modulo serán accesibles por usuarios no autenticados (esta llave es leída por el servicio AuthManager).
Como puedes ver, el modulo User es un típico modulo de ZF3 con la estructura propia de un patron MVC.