Guía para actualizar PrestaShop en DirectAdmin sin errores

Actualizar PrestaShop en un servidor DirectAdmin puede parecer una tarea compleja, pero siguiendo los pasos correctos y tomando las precauciones necesarias, es un proceso que cualquier administrador puede realizar sin complicaciones. Esta guía está diseñada para ayudarte a actualizar PrestaShop DirectAdmin de forma segura, minimizando riesgos y evitando errores comunes. Te explicaremos desde la preparación previa hasta la verificación final, todo con un lenguaje claro y pasos prácticos.

Preparación antes de la actualización

Antes de comenzar cualquier actualización, la preparación es clave para evitar problemas. Una actualización mal planificada puede dejar tu tienda inaccesible o perder datos importantes. Sigue estos pasos para asegurarte de que todo está listo.

Realiza una copia de seguridad completa

La regla de oro en cualquier actualización es: siempre haz una copia de seguridad. Esto incluye tanto los archivos de PrestaShop como la base de datos. En DirectAdmin, puedes hacerlo fácilmente desde el panel de control.

1. Accede a DirectAdmin con tus credenciales de administrador.
2. Ve a la sección "Backup/Transfer" o "Copias de seguridad".
3. Selecciona la opción "Crear copia de seguridad".
4. Marca las casillas de "Datos de usuario" (incluye archivos de la web) y "Bases de datos".
5. Elige un destino (por ejemplo, almacenamiento local o remoto) y haz clic en "Crear".

[WARNING] No confíes únicamente en la copia de seguridad del hosting. Descarga una copia local en tu computadora para mayor seguridad.

Verifica los requisitos del sistema

Cada versión de PrestaShop requiere una configuración específica de PHP, MySQL y otros servicios. Consulta la documentación oficial de la versión a la que deseas actualizar para conocer los requisitos. En DirectAdmin, puedes verificar la versión de PHP desde "PHP Selector" o "Configuración de PHP".

• PHP: Normalmente, PrestaShop 8.x requiere PHP 7.4 o superior (recomendado PHP 8.0+).
• MySQL: Versión 5.6 o superior, preferiblemente MariaDB 10.2+.
• Módulos PHP: Asegúrate de tener activados módulos como curl, gd, json, mbstring, openssl, pdo_mysql, zip, entre otros.

Si tu servidor no cumple los requisitos, actualiza primero el entorno. En DirectAdmin, puedes cambiar la versión de PHP por dominio desde "PHP Selector".

Desactiva la tienda y ponla en modo mantenimiento

Para evitar que los usuarios accedan durante la actualización, pon tu tienda en modo mantenimiento.

1. Accede al panel de administración de PrestaShop (por ejemplo, tudominio.com/admin1234).
2. Ve a "Parámetros de la tienda" > "Mantenimiento".
3. Activa la opción "Activar modo mantenimiento".
4. Opcionalmente, puedes añadir tu IP para seguir accediendo como administrador.

[TIP] Si no puedes acceder al panel de administración, puedes activar el modo mantenimiento editando el archivo config/defines.inc.php y cambiando _PS_MODE_DEV_ a false o directamente desde la base de datos.

Métodos para actualizar PrestaShop en DirectAdmin

Existen dos formas principales de actualizar PrestaShop: mediante el asistente de actualización automática (recomendado para la mayoría) o de forma manual. Aquí te explicamos ambas.

Actualización automática con el módulo 1-Click Upgrade

Este es el método más sencillo y seguro para la mayoría de los usuarios. PrestaShop incluye un módulo oficial llamado "1-Click Upgrade" que automatiza el proceso.

1. Descarga el módulo: Desde el panel de administración, ve a "Módulos" > "Catálogo de módulos" y busca "1-Click Upgrade". Instálalo si no lo tienes.
2. Configura el módulo: Ve a "Mejorar" > "1-Click Upgrade".
   • Selecciona la versión a la que deseas actualizar (por ejemplo, la última estable).
   • Marca la opción "Guardar copia de seguridad" (es buena práctica).
   • Elige "Actualizar".
3. Inicia la actualización: Haz clic en el botón "Actualizar PrestaShop ahora". El proceso puede tardar varios minutos, dependiendo del tamaño de tu tienda.
4. Sigue las instrucciones: El módulo te guiará paso a paso. Si aparece algún error, anótalo para solucionarlo después.

[INFO] Si el módulo no encuentra la última versión, puedes descargar el archivo de actualización manualmente desde la web de PrestaShop y subirlo al servidor.

Actualización manual paso a paso

Si el método automático falla o prefieres tener más control, puedes actualizar manualmente. Este proceso requiere más conocimientos técnicos.

1. Descarga la última versión de PrestaShop desde prestashop.com.
2. Extrae los archivos en tu computadora.
3. Sube los archivos al servidor mediante FTP o el administrador de archivos de DirectAdmin. No sobrescribas aún la carpeta config/ ni img/.
   • Conecta por FTP (por ejemplo, con FileZilla) a tu servidor.
   • Sube todos los archivos de la nueva versión a la raíz de tu tienda, excepto config/settings.inc.php y img/ (si quieres conservar imágenes personalizadas).
4. Actualiza la base de datos: Accede a tudominio.com/install/upgrade/upgrade.php para ejecutar el script de actualización de la base de datos. Si no existe, puedes usar el archivo upgrade.php incluido en el paquete.
5. Elimina la carpeta install/: Por seguridad, borra la carpeta install/ del servidor.
6. Verifica la configuración: Revisa que el archivo config/settings.inc.php tenga los datos correctos de la base de datos.

[WARNING] La actualización manual puede sobrescribir tus personalizaciones. Si has modificado archivos del núcleo (core), haz una copia de esos cambios antes de proceder.

Solución de errores comunes durante la actualización

Incluso con una buena preparación, pueden surgir errores. Aquí tienes los más frecuentes y cómo solucionarlos.

Error de incompatibilidad de PHP

Síntoma: Aparece un mensaje como "PHP version is not compatible" o "Required PHP extension missing".

Solución:

• Ve a DirectAdmin > PHP Selector y cambia la versión de PHP a una compatible (por ejemplo, 8.0 o 8.1).
• Asegúrate de que los módulos necesarios están activados. En el PHP Selector, marca las casillas de módulos como curl, gd, json, etc.

Error de tiempo de ejecución (timeout)

Síntoma: La actualización se queda colgada o muestra un error 500.

Solución:

• Aumenta el tiempo de ejecución de PHP. En DirectAdmin, puedes hacerlo editando el archivo php.ini del dominio (desde "PHP Selector" > "Editar PHP.ini"). Cambia max_execution_time a 300 o más.
• Si usas un servidor compartido, contacta al soporte para que aumenten los límites.

Error de base de datos: tabla no existe o columna duplicada

Síntoma: Mensajes como "Table 'ps_xxx' doesn't exist" o "Duplicate column name".

Solución:

• Esto suele ocurrir si la actualización se interrumpió. Restaura la copia de seguridad de la base de datos y vuelve a intentarlo.
• Si el error persiste, ejecuta manualmente las consultas SQL necesarias usando phpMyAdmin (accesible desde DirectAdmin en "phpMyAdmin").

[TIP] Si no estás seguro de qué consultas ejecutar, busca en foros de PrestaShop el error específico. La comunidad suele tener soluciones rápidas.

Error de permisos de archivos

Síntoma: "Cannot write to file" o "Permission denied".

Solución:

• En DirectAdmin, ve a "Administrador de archivos" y selecciona la carpeta raíz de tu tienda.
• Haz clic en "Cambiar permisos" y establece 755 para carpetas y 644 para archivos. Asegúrate de que el usuario del hosting (www-data o similar) tenga permisos de escritura en carpetas como cache/, log/ y config/.

Verificación post-actualización

Una vez completada la actualización, es crucial verificar que todo funciona correctamente.

Revisa la tienda en modo front-end

• Accede a tu tienda como usuario normal. Navega por categorías, productos y el proceso de compra.
• Comprueba que las imágenes se cargan, los enlaces funcionan y no hay errores 404.

Verifica el panel de administración

• Inicia sesión en el back-office.
• Revisa que todas las secciones (productos, pedidos, clientes) carguen sin problemas.
• Actualiza los módulos y temas que puedan tener versiones nuevas.

Comprueba los logs de errores

En DirectAdmin, puedes ver los logs de errores desde "Logs de errores" o en el archivo var/logs/ de PrestaShop. Busca advertencias o errores que puedan indicar problemas.

[INFO] Si ves errores de tipo "Deprecated" o "Notice", no son críticos, pero es recomendable solucionarlos para evitar problemas futuros.

Preguntas frecuentes (FAQ)

Aquí respondemos las dudas más comunes sobre la actualización PrestaShop DirectAdmin sin errores.

¿Cada cuánto debo actualizar PrestaShop?

Se recomienda actualizar a la última versión estable tan pronto como esté disponible, especialmente si incluye parches de seguridad. Revisa las actualizaciones al menos una vez al mes.

¿Puedo saltar versiones (por ejemplo, de 1.6 a 8.0)?

No es recomendable. PrestaShop admite actualizaciones secuenciales (1.6 -> 1.7 -> 8.0). Si intentas saltar, es probable que surjan errores. Usa el módulo 1-Click Upgrade que gestiona los pasos intermedios.

¿Qué hago si la actualización falla y no tengo copia de seguridad?

Si no tienes copia de seguridad, contacta al soporte de tu hosting inmediatamente. Algunos proveedores como Syspanel (accesible por puerto 2106) tienen copias automáticas. También puedes intentar restaurar desde una copia de seguridad del servidor (si existe).

¿Se pierden los módulos y temas personalizados?

Depende. Los módulos de terceros pueden no ser compatibles con la nueva versión. Antes de actualizar, verifica que tus módulos y temas sean compatibles. Si no lo son, busca actualizaciones o alternativas.

¿Cómo puedo probar la actualización en un entorno de staging?

Crea un subdominio o una copia de tu tienda en un directorio aparte (por ejemplo, tudominio.com/test). Usa una copia de la base de datos y los archivos, y realiza la actualización allí primero. Esto te permite identificar problemas sin afectar la tienda en vivo.

Consejos finales para una actualización exitosa

• Lee las notas de la versión: Antes de actualizar, revisa los cambios importantes y las posibles incompatibilidades en la web oficial de PrestaShop.
• Actualiza los módulos y temas: Después de la actualización del núcleo, actualiza todos los módulos y temas para asegurar compatibilidad.
• Mantén un registro: Anota la versión anterior, la nueva y cualquier error encontrado. Esto te ayudará en futuras actualizaciones.
• Usa herramientas de monitoreo: Configura alertas en DirectAdmin para detectar caídas o errores después de la actualización.

Siguiendo esta guía, podrás realizar una actualización PrestaShop DirectAdmin sin errores y mantener tu tienda segura y optimizada. Recuerda que la clave está en la preparación y en no saltarse pasos. Si encuentras algún problema, la comunidad de PrestaShop y el soporte de DirectAdmin son excelentes recursos. ¡Buena suerte con tu actualización!