Actualizar PrestaShop de 1.7 a 8.2.4

Con esta entrada pretendemos echarte una mano con la actualización de PrestaShop desde la 1.7 hasta la última versión estable de la 8, la 8.2.4 en el momento de escribir esta entrada.

Es importante que tengas en cuenta que este proceso no es sencillo, ni está pensado para personas sin conocimientos técnicos, de programación y de PrestaShop. Es un proceso crítico que debe llevarse a cabo por profesionales.

Por qué es importante actualizar PrestaShop

PrestaShop 1.7 ha entrado en fase final de mantenimiento, lo que supone que ha dejado de recibir actualizaciones y correcciones de seguridad. Una tienda online maneja datos personales y sensibles, por lo que es importante mantener una versión actualizada que corrija todas estas posibles amenazas.

La versión de PHP es clave para la seguridad y velocidad de una tienda online.

PrestaShop 1.7 fue diseñado para versiones antiguas de PHP, llegando a funcionar como mucho con la versión 7.4, ya obsoleta desde finales de 2022. PrestaShop 8.2.4 permite trabajar con PHP 8.1, que aunque sigue siendo una versión sin soporte (desde noviembre de 2024), al menos tiene mayor seguridad y velocidad.

En la práctica esto significa menos errores en producción, mejor rendimiento del servidor y un hosting más fácil de mantener.

Tip: Aunque PrestaShop 8 no es compatible oficialmente con versiones de PHP superiores a 8.1, en ocasiones, dependiendo de la programación que se haya hecho sobre la plataforma y los módulos configurados en ella, se podría hacer que funcionara perfectamente con PHP 8.2 o 8.3. Es un proceso técnico que debe llevarse a cabo por personas expertas, ya que es un procedimiento manual y debe hacerse con mucho cuidado.

Pues vamos al lío…

Actualización paso a paso de PrestaShop

En nuestras pruebas hemos empezado desde una versión 1.7.6.2, pero estos pasos servirán para versiones anteriores y posteriores. Muy importante, siempre entre paso y paso, realizar una copia de seguridad.

Actualizaciones entre PrestaShop 1.7

Para poder actualizar a PrestaShop 8 tenemos que llegar a la última versión mayor estable de 1.7, la cual es la 1.7.8.0. Para ello iremos actualizando una a una cada versión estable de PrestaShop 1.7. Es decir, si partimos de la 1.7.6.2 tendremos que pasar por la 1.7.7.0 y la 1.7.8.0, si partimos de una 1.7.5 tendremos primeramente que pasar por la 1.7.6.0, la 1.7.7.0 para finalmente llegar a la 1.7.8.0

Pasos entre versiones 1.7

1 – Haz una copia de seguridad completa de la tienda online

2 – Desactiva la tienda desde Parámetros de la tienda configuración -> Mantenimiento

3 – Desactiva la caché desde Parámetros avanzados -> Rendimiento

4 – Accediendo vía FTP o SSH a la raíz de la tienda crea la carpeta _ACTUALIZACION y mueve a ella las siguientes carpetas:

1. app
2. config
3. docs
4. download
5. img
6. mails
7. override
8. themes

Estas carpetas contienen información y contenido único de la tienda.

5 – Crea la carpeta _BORRAR y mueve a ella todas las carpetas restantes de PrestaShop, dejando únicamente en la raíz:

1. modules
2. _ACTUALIZACION
3. otras carpetas ajenas a PrestaShop.

6 – Descarga la versión mayor de PrestaShop que corresponda. Esto lo podemos hacer desde el repositorio de versiones de PrestaShop. En esta descarga obtendremos un archivo .zip y en su interior encontraremos otro archivo .zip que se llamará prestashop.

7 – Sube y descomprime el archivo prestashop.zip en la raíz de la tienda. Si tienes acceso SSH desde la raíz puedes utilizar el comando:

unzip -o prestashop.zip

8 – Renombra la carpeta admin con el nombre que teníamos anteriormente o cualquier otro que no sea admin. Para hacerlo con SSH desde la raíz usa este comando:

mv admin admindev

9 – Copia (sobrescribiendo) las siguientes carpetas desde _ACTUALIZACION a la raíz de la tienda:

1. docs
2. download
3. img
4. mails
5. themes

Una manera rápida de hacerlo y si tienes acceso SSH es ir a la carpeta __ACTUALIZACION y ejecutar los siguientes comandos:

cp -rf docs/* ../docs
cp -rf download/* ../download
cp -rf img/* ../img
cp -rf mails/* ../mails
cp -rf themes/* ../themes

De momento las carpetas override, app y config de __ACTUALIZACION no las tocamos.

10 – Copia (sobrescribiendo) el archivo parameter.php de _ACTUALIZACION/app/config/ a la ruta raíz /app/config/ . Este archivo configura la conexión con la base de datos, Para hacerlo con SSH, ejecuta desde la carpeta _ACTUALIZACION lo siguiente:

cp -rf app/config/parameters.php ../app/config

11 – Lanza el proceso de actualización desde la carpeta install. Para lanzar este proceso hay 2 opciones:

Vía SSH (recomendado): Simplemente, desde la raíz de la tienda ejecuta el siguiente comando:

php install/upgrade/upgrade.php

Eso evitará problemas de timeouts y respuesta de servidor.

Vía Web:

1. Si tu proveedor de hosting lo permite sube primero los parámetros PHP de timeouts ymemory limit de tu plan.
2. Entra desde el navegador en la siguiente URL: https://tudominio.com/install/upgrade/upgrade.php?step=upgrade
   cambiando tudominio.com por el dominio de la tienda.

12 – Una vez finalizado el proceso anterior borra la carpeta install.

13 – Borra la carpeta var/cache desde la raíz de la tienda. Puedes utilizar el siguiente comando con SSH:

rm -rf var/cache

14 –COMPRUEBA EL FUNCIONAMIENTO. Borra cookies y caché de tu navegador y prueba el funcionamiento del panel de administración y la tienda en sí.

15 – Borra carpeta _BORRAR

16 – Ahora es momento de instalar los overrides que teníamos anteriormente y comprobar que funcionan y no devuelven ningún error. Para ello, copia sobrescribiendo la carpeta _ACTUALIZACION/override a /override. Puedes utilizar el siguiente comando desde la carpeta _ACTUALIZACION:

cp -rf override/* ../override

17 – Borra la carpeta var/cache desde la raíz de la tienda. Puedes utilizar el siguiente comando:

rm -rf var/cache

18 –COMPRUEBA EL FUNCIONAMIENTO. Borra cookies y caché del navegador, activa el modo depuración y prueba el funcionamiento de la tienda. Si recibimos algún error o warning de algún override deberemos intentar solucionarlo o eliminarlo, en cuyo caso perderemos la funcionalidad concreta que nos aportaba.

15 – Borra carpeta _ACTUALIZACION

20 – Repite este proceso por cada actualización mayor (explicado antes) hasta llegar a PrestaShop 1.7.8.0

Actualización a PrestaShop 1.8.2.0

Si has conseguido llegar a la 1.7.8.0 el siguiente punto es ya cambiar a la versión 1.8.2.0. En este paso nuestra recomendación es utilizar el módulo Update Assistance nativo de PrestaShop. Las últimas versiones de este módulo funcionan muy bien y de manera muy estable con las últimas versiones de PrestaShop. Eso sí, te aconsejamos realizar antes los siguientes pasos:

1. Realiza una copia de seguridad de toda la tienda.
2. Carga el theme classic. Muchos otros temas pueden presentar incompatibilidades durante el proceso de actualización o una vez finalizado.
3. Desactiva todos los módulos no nativos.
4. Desactiva los overrides.

Una vez se complete la actualización con éxito realiza los siguientes pasos finales:

1. Activa una versión de PHP 8: Oficialmente PrestaShop8 solo funciona con PHP8.1 o inferior. Pero es posible que tu tienda pueda funcionar correctamente con 8.2 u 8.3, lo que te daría mayor seguridad y velocidad de carga.
2. Borra la caché y cookies de tu navegador.
3. Borra la caché de PrestaShop.
4. Revisa el funcionamiento de la tienda.
5. Vuelve al theme que teníamos antes de activar classic y comprueba que todo funciona como debería. Si no es así, habrá que revisar si el theme tiene actualizaciones disponibles para poder seguir utilizándolo.
6. Activa los módulos no nativos y overrides.
7. Borra la caché de PrestaShop y comprueba que todo funciona como debería y no existe ningún error. Quizá haya módulos que se tengan que actualizar y overrides a adaptar o revisar. Esto dependerá de la configuración de tu tienda.

Esperamos que esta entrada os sea de utilidad. Y recuerda, si necesitas ayuda, siempre puedes contar con nuestro servicio de Soporte PrestaShop.

Con esto y más, tu tienda online siempre preparada.