ventas_php/php8-migration/plan-ejecucion.md

Plan de Migración PHP 8 - Archivos y Cambios Específicos

Requisitos Adicionales del Cliente

Configuración Segura con .env

• Migrar toda configuración sensible a archivo .env
• Eliminar credenciales de bases de datos del código
• Usar empresaId del usuario para determinar conexión

Arquitectura Multi-Empresa

• Los usuarios tienen campo empresaId en su registro
• La conexión a BD debe seleccionarse dinámicamente por empresaId
• No debe existir información de bases de datos fuera del .env

Archivos Creados para la Migración

1. /php8-migration/analisis-sistema.md

• Análisis general del sistema
• Identificación de estructura y componentes
• Evaluación de librerías utilizadas

2. /php8-migration/reporte-problemas.md

• Reporte detallado de incompatibilidades
• Priorización de problemas
• Estimación de tiempos y riesgos

3. /php8-migration/ejemplo-db-mysqli.php

• Ejemplo de migración de MySQL a MySQLi
• Código compatible con PHP 8

4. /php8-migration/ejemplo-env-config.php

• Ejemplo de configuración con archivo .env
• Gestión multi-empresa basada en usuario

Cambios Críticos Requeridos

Nivel URGENTE - Configuración y Base de Datos

1. Migrar a Configuración .env

Archivo: config.php (eliminar completamente)

• Eliminar todas las credenciales del código
• Crear archivo .env con variables seguras
• Implementar clase Config para gestión centralizada
• Impacto: Seguridad y mantenibilidad

2. Implementar Conexión Multi-Empresa

Archivos: classes/db.class.php, classes/util.class.php

• Reemplazar 13 funciones mysql_ por mysqli**
• Implementar gestión de empresas basada en empresaId del usuario
• Crear DatabaseManager para conexiones dinámicas
• Impacto: Sistema completo sin base de datos

3. Actualizar Lógica de Selección de BD

Archivos: 100+ archivos con $_SESSION['empresaId']

• Reemplazar SQL_DATABASE2.$empresaId por conexión dinámica
• Usar DatabaseManager para obtener conexión específica
• Impacto: Funcionalidad multi-empresa completa

Nivel ALTO - Funciones Eliminadas

1. classes/util.class.php:575 - ereg_replace() → preg_replace()
2. ajax/cuentas-pagar.php:18 - split() → explode()
3. ajax/evaluar-pedidos.php:160,360 - split() → explode()
4. 7 archivos con each() - Reemplazar por foreach
5. 4 archivos con create_function() - Reemplazar por funciones anónimas

Nivel MEDIO - Sintaxis

1. 100+ ocurrencias de $string{index} → $string[index]
2. 98+ ocurrencias de list() incorrecto → sintaxis moderna
3. Múltiples asignaciones por referencia → revisión y limpieza

Estructura de Archivos de Migración

php8-migration/
├── analisis-sistema.md          # Análisis general
├── reporte-problemas.md         # Problemas identificados
├── ejemplo-db-mysqli.php        # Ejemplo de migración DB
├── ejemplo-env-config.php       # Ejemplo configuración .env
├── .env.example                 # Plantilla archivo .env
├── plan-ejecucion.md            # Plan actualizado (este archivo)
└── archivos-criticos.txt        # Lista de archivos críticos

Recomendaciones de Seguridad

Antes de Cualquier Cambio:

1. ✅ Backup completo del sistema
2. ✅ Crear entorno de prueba aislado
3. ✅ Documentar versión actual funcional
4. ✅ Lista de todos los usuarios y procesos activos

Durante la Migración:

1. ✅ Cambiar un módulo a la vez
2. ✅ Probar cada cambio inmediatamente
3. ✅ Mantener log detallado de modificaciones
4. ✅ No aplicar cambios a producción sin pruebas

Después de Cada Cambio:

1. ✅ Ejecutar pruebas unitarias
2. ✅ Verificar funcionalidad completa
3. ✅ Comprobar rendimiento
4. ✅ Validar que no hay regresiones

Próximos Pasos Sugeridos

1. Aprobación del plan: Revisar y aprobar este análisis
2. Preparación del entorno: Configurar entorno de pruebas
3. Backup completo: Realizar backup integral del sistema
4. Migración fase 1: Actualizar capa de base de datos (MySQL → MySQLi)
5. Migración fase 2: Reemplazar funciones eliminadas
6. Migración fase 3: Actualizar sintaxis
7. Pruebas finales: Validación completa del sistema

Estado Actual

• ❌ NO COMPATIBLE con PHP 8
• ⚠️ Requiere migración completa antes de actualizar PHP
• 🔴 Alto riesgo de pérdida total de funcionalidad
• 📋 Plan detallado disponible para ejecución

ADVERTENCIA: No actualizar la versión de PHP sin completar todos los cambios de migración.