Manual Técnico AppSennovaLab
Documentación Técnica del Archivo SiteController.php
Información General
¿Para qué es?
El archivo SiteController.php es el controlador principal de la aplicación Sennovalab, que maneja las funcionalidades básicas del sitio web como autenticación, registro de usuarios y páginas estáticas.
Definición de la Carpeta
Ubicación: appSennovalab/controllers/SiteController.php
Contexto: Se encuentra en la carpeta controllers siguiendo la estructura MVC (Modelo-Vista-Controlador) de Yii2.
Propósito
Gestionar las acciones principales del sitio web, incluyendo:
- Autenticación de usuarios
- Registro de nuevos usuarios
- Gestión de contraseñas
- Verificación de correo electrónico
- Renderizado de páginas estáticas
Funciones Principales
behaviors()
- Propósito: Define los filtros de control de acceso y verbos HTTP
- Configuraciones:
- Control de acceso para logout y signup
- Restricciones de métodos HTTP
actionIndex()
- Propósito: Muestra la página principal
- Retorno: Vista ‘index’
actionLogin()
- Propósito: Maneja el proceso de inicio de sesión
- Funcionalidad: Valida credenciales y establece la sesión
actionSignup()
- Propósito: Gestiona el registro de nuevos usuarios
- Funcionalidad: Procesa el formulario de registro y envía email de verificación
actionContact()
- Propósito: Gestiona el formulario de contacto
- Funcionalidad: Envía emails al administrador
Gestión de Contraseñas
actionRequestPasswordReset()actionResetPassword()- Propósito: Manejo de recuperación de contraseñas
Verificación de Email
actionVerifyEmail()actionResendVerificationEmail()- Propósito: Gestiona la verificación de correos electrónicos
Dependencias
use appSennovalab\models\ResendVerificationEmailForm;use appSennovalab\models\VerifyEmailForm;use common\models\LoginForm;use appSennovalab\models\PasswordResetRequestForm;use appSennovalab\models\ResetPasswordForm;use appSennovalab\models\SignupForm;use appSennovalab\models\ContactForm;Notas Adicionales
- El controlador implementa medidas de seguridad mediante filtros de acceso
- Utiliza el sistema de flash messages de Yii2 para comunicación con el usuario
- Implementa verificación de correo electrónico en dos pasos
- Los mensajes de error están en español e inglés
- Incluye protección CSRF para formularios
- Implementa manejo de excepciones para tokens inválidos
Esta documentación proporciona una visión general del controlador principal del sitio. Cada acción está diseñada para manejar una funcionalidad específica mientras mantiene las mejores prácticas de seguridad y usabilidad de Yii2.