Actualización segura de PrestaShop en DirectAdmin

Actualizar PrestaShop desde DirectAdmin puede parecer una tarea compleja, pero con una guía paso a paso y las herramientas adecuadas, es un proceso seguro que no debería afectar tus datos si se realiza correctamente. En este artículo, te explicaré cómo hacerlo de forma manual y a través de herramientas como Softaculous o mediante línea de comandos, siempre priorizando la integridad de tu base de datos, productos, clientes y configuración.

Antes de empezar: preparación esencial

Antes de tocar cualquier archivo, es vital que realices una copia de seguridad completa de tu tienda. Esto incluye tanto los archivos del sitio (carpeta pública de PrestaShop) como la base de datos MySQL. Sin una copia de seguridad, cualquier error durante la actualización podría dejarte sin tienda.

Haz una copia de seguridad en DirectAdmin

Accede a DirectAdmin con tus credenciales de hosting. Normalmente es algo como tudominio.com:2222.
Ve a la sección "Backup / Restore" (Copia de seguridad / Restaurar).
Selecciona "Create Backup" (Crear copia de seguridad).
Marca las opciones:
- Full Backup (Copia completa): Incluye archivos y bases de datos.
- Save to home directory (Guardar en el directorio personal).
Haz clic en "Create Backup". Este proceso puede tardar varios minutos. Una vez terminado, descarga el archivo .tar.gz generado a tu computadora por seguridad.

[WARNING] ¡No subestimes la copia de seguridad! Si algo sale mal, este archivo es tu única red de seguridad. Guárdalo en un lugar externo (nube, disco duro) antes de continuar.

Método 1: Actualizar PrestaShop desde DirectAdmin usando Softaculous (Recomendado)

Si tu hosting incluye Softaculous (un instalador de aplicaciones), esta es la forma más sencilla y visual de actualizar PrestaShop. Softaculous se encarga de la mayoría de las tareas automáticas.

Pasos para la actualización con Softaculous

Ingresa a DirectAdmin y busca el icono de "Softaculous" (normalmente en la sección "Software" o "Extra Features").
Dentro de Softaculous, ve a la pestaña "Instalaciones actuales" (o "Current Installations").
Busca tu instalación de PrestaShop en la lista. Verás su versión actual.
Haz clic en el icono de "Actualizar" (suele ser una flecha verde o el texto "Upgrade").
Softaculous te mostrará la versión disponible más reciente. Revisa la sección "Elegir versión" y selecciona la nueva versión.
IMPORTANTE: Marca la opción "Realizar copia de seguridad de los archivos y la base de datos antes de actualizar". Esto añade una capa extra de seguridad.
Haz clic en "Actualizar" (o "Upgrade"). El proceso comenzará y podrás ver el progreso en pantalla.

[TIP] Softaculous suele tardar entre 2 y 5 minutos. No cierres la ventana del navegador hasta que veas el mensaje de éxito.

Método 2: Actualizar PrestaShop desde DirectAdmin manualmente (paso a paso)

Si prefieres un control total o tu hosting no tiene Softaculous, puedes hacerlo manualmente. Sigue estos pasos con cuidado:

Paso 1: Descarga la última versión de PrestaShop

Ve al sitio oficial de PrestaShop (prestashop.com) y descarga la versión completa (no la de actualización incremental) en formato .zip.
Descomprime el archivo en tu computadora. Obtendrás una carpeta con el nombre prestashop o similar.

Paso 2: Sube los archivos nuevos a través de DirectAdmin

En DirectAdmin, ve a "File Manager" (Administrador de archivos).
Navega a la carpeta donde está instalado tu PrestaShop (normalmente public_html o tu-dominio.com).
Selecciona todos los archivos y carpetas existentes de tu PrestaShop (excepto la carpeta config y el archivo settings.inc.php si lo ves, aunque no siempre está visible). No borres nada todavía.
Sube el nuevo archivo .zip de PrestaShop a la carpeta raíz de tu instalación (la misma donde están los archivos viejos).
Una vez subido, haz clic derecho sobre el archivo .zip y selecciona "Extract" (Extraer). Elige sobrescribir archivos cuando te lo pregunte.

[WARNING] No borres la carpeta config ni el archivo settings.inc.php porque contienen la configuración de conexión a tu base de datos. Si los sobrescribes, perderás la conexión.

Paso 3: Ejecuta el script de actualización

Abre tu navegador y escribe la URL de tu tienda seguida de /install/upgrade/upgrade.php. Por ejemplo: tudominio.com/install/upgrade/upgrade.php.
Si todo está correcto, verás una pantalla de bienvenida del actualizador. Haz clic en "Next" (Siguiente).
El sistema verificará los requisitos. Si hay algún error (como permisos de archivos), te lo indicará. Corrige los errores y vuelve a intentar.
Acepta los términos y condiciones y haz clic en "Next".
El proceso de actualización comenzará. Verás una barra de progreso y mensajes como "Actualizando base de datos...". No interrumpas el proceso.
Al finalizar, verás un mensaje de éxito. Elimina la carpeta /install de tu servidor por seguridad. Puedes hacerlo desde el File Manager de DirectAdmin.

Paso 4: Verifica tu tienda

Accede a tu tienda (tudominio.com) y comprueba que todo funciona: productos, categorías, carrito, etc.
Entra al back office (tudominio.com/adminXXXX) y verifica que el panel de administración carga correctamente.

[INFO] Si ves errores de base de datos, puede que necesites regenerar el caché. Ve a "Parámetros Avanzados" > "Rendimiento" y limpia la caché.

Método 3: Actualizar PrestaShop usando SSH (para usuarios avanzados)

Si tienes acceso a la terminal de tu servidor (SSH), puedes actualizar más rápido. Este método es útil si gestionas varios sitios o necesitas automatizar procesos.

Pasos para la actualización por SSH

Conéctate a tu servidor mediante SSH. Usa un cliente como PuTTY (Windows) o la terminal (Mac/Linux). Tus credenciales SSH suelen ser las mismas que las de DirectAdmin, pero con un puerto diferente (normalmente 22).
Navega a la carpeta de tu tienda:
```
cd /home/usuario/domains/tudominio.com/public_html
```
(Reemplaza usuario y tudominio.com con tus datos).
Descarga la última versión de PrestaShop directamente desde el servidor:
```
wget https://www.prestashop.com/download/latest/prestashop.zip
```
Descomprime el archivo:
```
unzip -o prestashop.zip
```
La opción -o sobrescribe archivos sin preguntar.
Elimina el archivo zip para ahorrar espacio:
```
rm prestashop.zip
```
Ejecuta el actualizador desde el navegador (como en el paso 3 del método manual). Ve a tudominio.com/install/upgrade/upgrade.php.
Elimina la carpeta /install una vez terminado:
```
rm -rf install
```

[WARNING] Si usas Syspanel (antes HestiaCP), el puerto SSH por defecto es el 2106. Conéctate así: ssh usuario@tudominio.com -p 2106. En Syspanel, la carpeta de tu dominio suele estar en /home/usuario/web/tudominio.com/public_html.

Errores comunes y cómo solucionarlos

Error de memoria PHP (Allowed memory size)

Si ves "Fatal error: Allowed memory size of...", necesitas aumentar el límite de memoria.

Solución: Edita el archivo php.ini (si tienes acceso) o añade esta línea en el archivo .htaccess de la raíz de tu tienda:
```
php_value memory_limit 256M
```
Guarda el archivo y vuelve a intentar la actualización.

Error de tiempo de ejecución (Maximum execution time)

Si el script se detiene por tiempo excedido:

Solución: En el mismo .htaccess, añade:
```
php_value max_execution_time 300
```

Error "No se puede conectar a la base de datos"

Esto suele ocurrir si sobrescribiste el archivo app/config/parameters.php.

Solución: Restaura el archivo parameters.php desde tu copia de seguridad. Si no lo tienes, revisa el archivo config/settings.inc.php (en versiones antiguas) para obtener los datos de conexión.

Error "Página en blanco" después de la actualización

Solución: Habilita la visualización de errores. Edita el archivo config/defines.inc.php y cambia define('_PS_MODE_DEV_', false); a define('_PS_MODE_DEV_', true);. Esto te mostrará el error específico. No olvides volver a ponerlo en false después.

Preguntas frecuentes (FAQ)

¿Puedo actualizar PrestaShop desde DirectAdmin sin perder mis productos?

Sí, siempre que la actualización se realice correctamente y no borres la base de datos. Los productos, clientes, pedidos y configuraciones se almacenan en la base de datos, que no se modifica durante la actualización (solo se añaden o modifican tablas).

¿Qué hago si la actualización se queda atascada?

Espera al menos 10 minutos. Si no avanza, cierra la ventana, limpia la caché del navegador y vuelve a ejecutar upgrade.php. Si sigue sin funcionar, restaura desde tu copia de seguridad.

¿Necesito desactivar la tienda antes de actualizar?

No es obligatorio, pero es recomendable ponerla en modo mantenimiento para que los clientes no vean errores durante el proceso. En el back office, ve a "Parámetros de la tienda" > "Mantenimiento" y actívalo.

¿Puedo saltar varias versiones a la vez?

No es recomendable. Lo mejor es actualizar de una versión a la siguiente (por ejemplo, de 1.7.8 a 1.7.9, luego a 1.7.10). Si saltas muchas versiones, pueden ocurrir conflictos en la base de datos. Consulta la documentación oficial de PrestaShop para rutas de actualización seguras.

¿Softaculous borra mis datos?

No, Softaculous solo actualiza los archivos del núcleo de PrestaShop. Tus datos (productos, clientes, etc.) permanecen intactos. Además, si marcas la opción de copia de seguridad, tendrás un respaldo extra.

Consejos finales para una actualización exitosa

Revisa los requisitos del sistema de la nueva versión de PrestaShop (versión de PHP, MySQL, etc.). Puedes verlos en el sitio oficial.
Actualiza los módulos y temas después de la actualización del núcleo. Los módulos incompatibles pueden causar errores.
Prueba la tienda en un entorno de desarrollo si es posible. Algunos hosting permiten crear una copia de prueba.
No te olvides de limpiar la carpeta /install después de actualizar. Es un agujero de seguridad muy conocido.

Actualizar PrestaShop desde DirectAdmin es un proceso que, con paciencia y siguiendo estos pasos, cualquier persona puede realizar. Recuerda: la copia de seguridad es tu mejor amiga. Si algo sale mal, siempre puedes restaurar y empezar de nuevo. ¡Buena suerte con tu tienda!