Actualitzar PrestaShop sense trencar mòduls, tema ni comandes

Actualitzar PrestaShop és una tasca que moltes botigues ajornen fins que alguna cosa les obliga, normalment perquè l'allotjament retira una versió de PHP o perquè una passarel·la de pagament deixa de funcionar. Com més s'espera, més gran és el salt i més peces poden fallar alhora. En aquesta guia repassem què cal revisar abans de començar i en quin ordre fer-ho perquè la botiga continuï cobrant comandes.

Què suposa actualitzar PrestaShop segons el salt de versió

El risc depèn molt de la distància entre la versió que tens i la de destinació. A grans trets hi ha tres tipus de salt:

• Pedaç dins de la mateixa versió menor, per exemple entre dues 8.2.x: corregeix errors i vulnerabilitats. Sol donar pocs problemes, però també es prova.
• Versió menor dins de la mateixa branca, com de la 8.1 a la 8.2: pot canviar hooks, plantilles del back office i alguna dependència.
• Canvi de branca, de la 1.7 a la 8 o de la 8 a la 9: canvien els requisits de PHP i components interns, i és on més pateixen els mòduls i temes antics.

La branca 9 es va publicar el 2025, es basa en Symfony 6.4 i ja té diverses versions menors. Porta a més un tema nou, Hummingbird, que a la 9.0 no era el tema per defecte. Mentrestant, la branca 8.2 ha continuat rebent versions de seguretat, així que quedar-se a la 8.2 actualitzada és una opció raonable mentre prepares el salt.

El mòdul oficial d'actualització, Update Assistant (abans conegut com a 1-Click Upgrade), treballa amb botigues a partir de la 1.7. Que el mòdul permeti un salt gran no garanteix que els teus mòduls i el teu tema l'aguantin. Si vens de la 1.7, sovint compensa passar primer a la 8, estabilitzar la botiga i després plantejar la 9. Si la instal·lació arrossega massa pedaços, valora també muntar una instal·lació neta i migrar-hi les dades.

PHP i servidor: el requisit que decideix l'ordre

Cada versió de PrestaShop funciona amb un rang concret de PHP, i aquest rang marca l'ordre dels passos. Segons la documentació oficial:

• PrestaShop 1.7.8 funciona fins a PHP 7.4, que és la versió recomanada per a aquesta branca, i no admet PHP 8.
• PrestaShop 8.0 a 8.2 admet des de PHP 7.2 fins a PHP 8.1.
• La branca 9 exigeix com a mínim PHP 8.1, i la versió màxima admesa varia segons la versió menor.

Això obliga a anar per graons. Una botiga a la 1.7.8 amb PHP 7.4 actualitza primer a la 8.x sense tocar PHP, després puja PHP a la 8.1 i només llavors es pot plantejar la 9. El problema més habitual és el contrari: l'allotjament canvia la versió de PHP pel seu compte i la botiga deixa de carregar. Abans de començar, consulta la taula de compatibilitat de la versió exacta de destinació i confirma amb el teu proveïdor d'allotjament quines versions de PHP i de MySQL o MariaDB pots fer servir i quan canvien.

Revisa també els mòduls de pagament que venen xifrats. Alguns només funcionen amb les versions de PHP per a les quals el fabricant els va preparar, i fallen tan bon punt canvies el PHP encara que PrestaShop sigui compatible.

Inventari de mòduls, overrides i tema

Abans de tocar res, fes una llista del que hi ha instal·lat. És la part més avorrida i la que més problemes evita.

Mòduls

Per a cada mòdul, actiu o desactivat, anota:

• D'on ve: Addons, un altre marketplace o desenvolupament propi.
• Versió instal·lada i si existeix una versió compatible amb la de destinació.
• Data de la seva última actualització i si l'autor encara respon.
• Si algú encara el fa servir.

Els que ningú no fa servir es desinstal·len abans d'actualitzar. Els abandonats obliguen a decidir entre substituir-los, adaptar-los o reescriure'ls; a mòdul PrestaShop propi o comprat expliquem com valorar-ho.

Overrides

A la carpeta override hi ha les classes i els controladors del nucli que algun mòdul, o algú a mà, ha sobreescrit. Després d'una actualització la classe original pot canviar mentre l'override continua executant el codi vell, i el resultat són errors difícils de rastrejar. Revisa quins overrides hi ha, quin mòdul els va crear i si avui existeix un hook que permeti fer el mateix. Els overrides que no pertanyen a cap mòdul són els més perillosos, perquè ningú no recorda per què hi són. Substituir-los per un mòdul PrestaShop a mida que faci servir hooks sol ser la sortida més estable.

Tema

Comprova si el tema és un tema fill o si es va modificar directament, quines plantilles de mòduls sobreescriu i si l'autor ofereix una versió per a la branca de destinació. Un tema pensat per a la 1.7 pot funcionar a la 8 amb ajustos i necessitar bastant més feina a la 9.

Còpia de seguretat i entorn de proves

L'actualització s'assaja sencera en una còpia abans de tocar la botiga real. Perquè l'assaig serveixi:

• Fes una còpia dels fitxers i de la base de dades i comprova que es pot restaurar, restaurant-la precisament a l'entorn de proves.
• Munta la còpia amb les mateixes versions de PHP i de base de dades que tindrà producció després d'actualitzar.
• Protegeix l'entorn amb contrasenya i deixa'l fora de l'índex dels cercadors.
• Desactiva a la còpia els correus a clients, posa les passarel·les en mode de proves i desconnecta o redirigeix als seus entorns de prova l'ERP, el magatzem i els transportistes.

Aquest últim punt s'oblida sovint. Una còpia connectada a l'ERP real pot crear comandes duplicades o enviar correus a clients que no han comprat res. Si la teva instal·lació és multibotiga, afegeix-hi les comprovacions que expliquem a PrestaShop multibotiga sense canvis creuats.

Ordre dels passos per actualitzar a producció

Quan l'assaig a la còpia surt net, es repeteix a producció amb aquest ordre:

• Documenta cada error de l'assaig i com es va resoldre, per aplicar les mateixes correccions.
• Actualitza els mòduls que tinguin una versió compatible amb la versió actual i amb la de destinació.
• Tria una franja de poca activitat, avisa l'equip i congela els canvis de catàleg i de preus.
• Activa el mode manteniment i fes una còpia final just abans de començar.
• Executa l'actualització amb Update Assistant, des del tauler o des de la línia d'ordres. En botigues amb molt de catàleg la línia d'ordres evita dependre dels límits de temps del navegador.
• Canvia la versió de PHP si aquest graó ho requereix.
• Buida la memòria cau, revisa els overrides i aplica les correccions anotades.
• Fes les proves de comanda abans de treure el mode manteniment.

Decideix el dia abans, amb calma, fins a quina hora es continua intentant i en quin moment es restaura la còpia.

Proves de comanda després d'actualitzar

Que la portada carregui diu poc de l'estat de la botiga. Abans d'obrir, comprova que s'hi pot comprar i que la comanda arriba on ha d'arribar. Com a mínim, prova:

• Alta de client, inici de sessió i recuperació de contrasenya.
• Cistella amb un producte amb combinacions i amb un descompte aplicat.
• Cada transportista actiu, amb un parell d'adreces diferents.
• Cada mètode de pagament, en mode de proves o amb una compra real d'import baix que després reemborses.
• Correu de confirmació, factura en PDF i canvis d'estat de la comanda.
• Enviament de la comanda a l'ERP o al magatzem, si hi ha aquesta connexió.
• Cercador, filtres de categoria i pàgines de producte amb més trànsit.
• Al back office, edició d'un producte, creació d'una comanda manual i les importacions habituals.

Durant els dies següents, revisa els registres d'errors de PHP i de PrestaShop. Molts errors només apareixen amb una combinació concreta de cistella o amb un mòdul que s'executa de nit.

Checklist abans d'actualitzar PrestaShop

• Versió actual i versió de destinació decidides, amb el graó intermedi si cal.
• Versions de PHP i de base de dades confirmades amb l'allotjament per a cada graó.
• Inventari de mòduls amb la seva compatibilitat, i els que sobren desinstal·lats.
• Overrides revisats, amb el seu origen i la seva alternativa.
• Compatibilitat del tema confirmada amb el seu autor o provada a la còpia.
• Còpia restaurada i entorn de proves aïllat de clients, pagaments i ERP.
• Assaig complet documentat.
• Franja horària, responsable i punt de tornada enrere acordats.
• Llista de proves de comanda preparada.

Si un mòdul del qual depèn la venda no té una versió compatible, ajorna el canvi de branca, continua aplicant els pedaços de seguretat de la teva branca actual i resol aquest mòdul primer. Si prefereixes que algú faci l'inventari i l'assaig amb tu, a manteniment PrestaShop comencem per aquest diagnòstic abans de tocar la botiga.