Pavol Rašev
Prijímam nové projekty
Blog

Upgrade PrestaShopu 1.7 na 8 alebo 9: čo sa pokazí a ako to zistiť vopred

Najprv upgrade z 1.7 na 8 a až potom, ako samostatný krok, na 9: neexistuje verzia PHP, na ktorej by bežala 1.7.8 aj 9. Samotné jadro sa aktualizuje celkom ľahko. Kazia sa moduly, overrides a zvyšky okolo neho, a väčšinou potichu. Preto to treba odhaliť na kópii obchodu, nie na ostrom e-shope.

PrestaShop 1.7 na 9 v dvoch krokoch PrestaShop 1.7.8 beží na PHP 7.1 až 7.4 a na 8.2 sa aktualizuje na PHP 7.4. Po prepnutí servera na PHP 8.1 sa 8.2 aktualizuje na 9, ktorá potrebuje PHP 8.1 alebo novšie. Žiadna verzia PHP nespustí 1.7.8 aj 9, preto je priamy skok prečiarknutý. PrestaShop 1.7 na 9 v dvoch krokoch Cestu určuje verzia PHP, nie PrestaShop na PHP 7.4 na PHP 8.1+ 1.7.8 PHP 7.1 až 7.4 Symfony 3.4 8.2 PHP 7.2.5 až 8.1 tu prepnúť PHP 9 PHP 8.1 a novšie Symfony 6.4 žiadne PHP nespustí 1.7.8 aj 9 pavolrasev.com

Pri upgrade PrestaShopu samotné jadro zvyčajne nezlyhá. A to vidím stále dokola. Upgrade jadra je skript, ktorý už prebehol v tisíckach obchodov a väčšinou funguje. Bolí všetko okolo neho: moduly, overrides, skok na novšie PHP a kópie, ktoré si človek pre istotu urobí.

Cestu určuje PHP, nie PrestaShop

PrestaShop 1.7 dostáva od vydania verzie 8.0 v októbri 2022 už len bezpečnostné opravy (takzvaná rozšírená podpora) a PrestaShop vtedy oznámil, že aj tie skončia s vydaním 9.0. Verzia 9.0 vyšla 10. júna 2025. Ak teda koncom roka 2026 stále beží váš e-shop na 1.7, beží na verzii, ktorú už nikto neopravuje.

Prvá vec, na ktorú sa treba pozrieť, preto nie je PrestaShop. Je to verzia PHP u vášho hostingu, lebo každá rada PrestaShopu podporuje iný rozsah:

Verzia Podporované PHP Odporúčané Symfony
1.7.8 7.1 až 7.4 7.4 3.4
8.0 až 8.2 7.2.5 až 8.1 8.1 4.4
9.0 8.1 až 8.4 8.4 6.4
9.1 8.1 až 8.5 8.5 6.4

Porovnajte prvý a tretí riadok. Neexistuje verzia PHP, na ktorej by bežala 1.7.8 aj 9. Update Assistant (oficiálny modul na upgrade, technicky autoupgrade, kedysi „1-Click Upgrade“) síce vie podľa dokumentácie posunúť akýkoľvek obchod na 1.7 na vyššiu verziu, ale počas upgradu musí obchod bežať na PHP, ktorému rozumie stará aj nová verzia. V praxi sú to teda dve cesty: 1.7.8 na PHP 7.4 hore na 8.2, potom prepnúť server na PHP 8.1 alebo novšie a až potom 8.2 na 9. Ja by som medzi nimi nechal pár týždňov, počas ktorých obchod normálne beží, lebo každý z tých krokov pokazí niečo iné.

Stĺpec Symfony vás zaujíma, ak máte moduly na mieru s vlastnými stránkami v administrácii. Pri prechode z 1.7 na 8 ide Symfony z 3.4 na 4.4. Z 8 na 9 ide zo 4.4 na 6.4 a to je väčší skok: controllery v administrácii musia byť služby, $this->get() v controlleri prestane fungovať a z jadra zmizli Guzzle a Swift Mailer. Ako potichu sa takéto veci menia, ukazuje drobnosť z Matrace Lema: composer.lock v koreni obchodu dodnes uvádza Symfony 3.4.49, kým v priečinku vendor, ktorý naozaj beží, je 4.4.51. Ten súbor nikto nečíta, takže si to nikto nevšimol.

Čo sa pokazilo pri skutočnom upgrade z 1.7.8 na 8.2.3

Matrace Lema predáva matrace na mieru. Na 8.2.3 som obchod dostal koncom januára 2026, stále s kúpenou témou, na ktorej bežal na 1.7. Dnes má 23 súborov v overrides, okolo 200 priečinkov s modulmi a sadu mojich vlastných modulov, z ktorých jeden posiela každú objednávku do firemného ERP.

Samotný upgrade jadra prebehol na dva behy Update Assistanta. 16. januára urobil úplnú zálohu obchodu, vtedy ešte na 1.7.8.7, a posunul ho na 1.7.8.11. 30. januára ho vzal z 1.7.8.11 na 8.2.3. Log z toho druhého behu je krátky: od prepnutia obchodu do údržby o 18:23:04 po hlášku „Shop updated to 8.2.3“ o 18:24:07 uplynula zhruba minúta a databázová časť medzi tým spustila 184 dotazov z upgrade súborov verzií 8.0.0 až 8.2.2.

SQL a PHP upgrade súbory vo vnútri Update Assistanta, krok po kroku z 1.7.8.0 na 8.2.2, sú najlepšia dokumentácia verzie 8.0, akú poznám. Pár vecí z nich sa niekoho dotkne:

  • 8.0 odstraňuje z kombinácií stĺpce quantity a location, z objednávok stĺpec shipping_number, z dopravcov daňové pravidlo a celú funkciu sledovania referrerov.
  • 8.1.3 zmení pri všetkých produktoch a kombináciách minimálne množstvo 0 na 1.
  • 8.1.7 prevedie 36 textových stĺpcov, medzi nimi popisy produktov, na MEDIUMTEXT.

Ak niektorý váš modul, export alebo report číta jeden z odstránených stĺpcov priamym SQL dotazom, skončí chybou „unknown column“. To je aspoň hlasné.

Tá istá zmena na strane PHP je tichšia. PrestaShop 8.0 odstránil Order::$shipping_number, ktorý bol označený ako zastaraný už od verzie 1.5, a číslo zásielky je teraz pri dopravcovi objednávky. Kód písaný pre 1.7 ho často stále číta takto:

if (!empty($order->shipping_number)) {
    $poznamka = $carrierName . ' ' . $order->shipping_number;
}

Na 8.x táto vlastnosť už neexistuje, takže empty() vráti true a vetva sa nikdy nevykoná. Žiadna chyba, žiadny riadok v logu. Ak modul číslo zásielky potrebuje, $order->getShippingNumber() ho prečíta zo správneho miesta.

Preto modulu neverím len preto, že sa nainštaluje a otvorí sa jeho nastavenie. V kóde každého modulu, na ktorom e-shop stojí, treba vyhľadať, čo zoznam zmien verzie 8.0 odstránil: shipping_number, Tools::jsonEncode, Tools::jsonDecode, quantity pri Combination. S grep je to na desať minút.

PHP 8 navyše robí z upozornení pády. Blogový modul v obchode mal štyri drobné chyby. Na PHP 7.4 z nich boli upozornenia (notices), ktoré nikto nevidel. Na PHP 8 sa z jednej stal TypeError: Cannot access offset of type string on string a každá stránka so štítkom a každý archív blogu vracali chybu 500. Ďalšia chyba nechávala prázdne názvy článkov na stránkach kategórií. Google tie stránky prechádza, či ich vaši zákazníci navštevujú, alebo nie. Moduly tretích strán písané pre 1.7 boli písané pre PHP 7 a ich chyby nájde skok na novšie PHP, nie nová verzia PrestaShopu.

Potom overrides. Update Assistant má voľbu vypnúť počas aktualizácie všetky overrides a jeho dokumentácia ju odporúča, aby nevznikali konflikty. V tomto obchode jeden z 23 overrides nahrádza URL dispatcher PrestaShopu. Pochádza z modulu na „pekné URL“, ktorý odstraňuje z adries ID, a závisí od neho každá adresa kategórie a produktu, ktorú má Google v indexe. Ďalšie pridal modul na súhlas s cookies, modul s darčekom zadarmo a dva moduly s captchou. Vypnúť ich všetky na pár minút aktualizácie je v poriadku, ak viete, ktoré hneď potom zapnúť a otestovať. Pred upgradom si ich preto spíšte: z override/classes a override/controllers vidno, čo ktorý nahrádza, a komentár nad každou metódou prezradí, ktorý modul ju tam dal.

Po upgrade som moduly ďalej nasadzoval nahrávaním súborov. Trikrát mi niečo „lokálne fungovalo a na produkcii nie“ a trikrát to bola tá istá príčina: súbory boli nové, ale PrestaShop nikdy nespustil upgrade skripty modulu, takže chýbali hooky, ktoré registrujú. Raz to bol prepínač vlastných rozmerov na stránke produktu, najdôležitejší prvok celého obchodu. Keď dnes niečo funguje na testovacej kópii a na produkcii nie, ako prvé neporovnávam kód, ale zoznam hookov, na ktoré je každý modul zaregistrovaný.

Jeden z najhorších problémov vznikol z kópie urobenej pre istotu: úplnej zálohy starej témy, ponechanej v themes/. Modul na e-mailové šablóny si ju vybral ako cieľ, nové e-maily k objednávkam zapisoval do zálohy a zákazníkom chodili ďalej tie staré, kým som neprišiel na to prečo. Nie je to chyba PrestaShopu. Je to presne ten typ kópie, ktorý ľudia okolo upgradu urobia a potom na ňu zabudnú.

Pokračovanie na 9

Ostrý obchod z 8 na 9 som zatiaľ neaktualizoval. Moja skúsenosť s PrestaShopom 9 je z Vlnkova, obchodu, ktorý som presťahoval zo Shoptetu a od začiatku staval na 9.1. Túto časť teda berte ako to, čo by som kontroloval, nie ako príbeh.

Prechod na PHP je povinný: 9 potrebuje aspoň 8.1. Téma je tu väčšia otázka ako pri 8. Classic je v 9.0 stále predvolená téma a nová téma Hummingbird je voliteľná, no zoznam zmien 9.0 zasahuje priamo do šablón. Napríklad obrázok výrobcu je teraz pole s viacerými veľkosťami namiesto jednej URL a stránky kategórie, výrobcu, dodávateľa a predajne dostávajú údaje o obrázkoch v novom formáte. Child téma Classicu s pár úpravami to prežije. Silno upravená kúpená téma potrebuje, aby jej autor vydal verziu pre 9, a to si overte skôr, než začnete čokoľvek plánovať.

Najviac času stojí pri 9 vlastná administrácia, kvôli Symfony 6.4. A jedna vec, ktorá ma vo Vlnkove zaskočila, so zoznamom zmien nesúvisí vôbec: modul, ktorý si nesie vlastný priečinok vendor, môže nahradiť knižnicu, ktorú používa jadro. Ten môj omylom obsahoval závislosti PHPUnitu, medzi nimi novší nikic/php-parser, a keďže Composer dáva autoloader modulu pred autoloader jadra, stránka Moduly v administrácii spadla s hláškou Attempted to call an undefined method named "create" of class "PhpParser\ParserFactory". Stack trace pritom ukazoval na úplne iný modul. Ak sa po inštalácii alebo aktualizácii modulu pokazí nejaká stránka v administrácii, pozrite sa, aké knižnice si ten modul pribalil.

Čo dodávatelia od 9 čakajú, sa dá vyčítať aj z ich kódu. Modul na recenzie v Matrace Lema obsahuje „balík kompatibility s PrestaShop 9“, ktorý znovu implementuje Tools::displayPrice(), Tools::encrypt() a pár ďalších. Keď to dodávateľ napíše, vlastne vám hovorí, ktoré volania hľadať vo zvyšných moduloch.

Môj kontrolný zoznam pred upgradom

Nič z toho nepotrebuje mňa. Potrebuje to kópiu obchodu a jeden deň.

  1. Spíšte si inventár. Verzia PrestaShopu, verzia PHP, téma (kúpená, child téma Classicu alebo na mieru), každý zapnutý neštandardný modul s verziou a autorom a každý súbor v override/. Označte tie, ktoré sa dotýkajú peňazí alebo adries: platby, doprava, faktúry, exporty do ERP alebo účtovníctva, prepisovanie URL, presmerovania.
  2. Každému autorovi modulu položte jednu otázku: ktorá verzia podporuje PrestaShop 8 (alebo 9) a PHP 8.1? Keď neodpovie, aj to je odpoveď. Rátajte s tým, že modul nahradíte.
  3. V moduloch na mieru vyhľadajte, čo zoznam zmien cieľovej verzie odstránil. Pre 8.0: shipping_number, Tools::jsonEncode, Tools::jsonDecode, quantity a location pri kombináciách. Pre 9.0: $this->get( v controlleroch administrácie, Guzzle, Swift Mailer.
  4. Naplánujte cestu cez PHP. Upgrade z 1.7.8 robte na PHP 7.4. Na PHP 8.1 prepnite až na verzii 8.x a obchod nechajte nejaký čas bežať, než začnete myslieť na 9. Opýtajte sa hostingu, či sa dá PHP prepnúť pre jeden web a ako rýchlo sa dá vrátiť späť.
  5. Pripravte testovaciu kópiu na rovnakej verzii PHP ako produkcia, s kópiou skutočnej databázy, a celý upgrade urobte najprv tam. Čítajte PHP error log, nie len stránky. Upozornenia na 7.4 sú chyby 500 na 8.x.
  6. Otestujte, čo zarába peniaze a čo vidí Google: objednávku s každou platobnou metódou a každým dopravcom, objednávku so zľavou, PDF faktúru, e-maily, ktoré dostane zákazník, export do ERP alebo účtovníctva, vzorku adries produktov, kategórií a CMS stránok (nesmú sa zmeniť), sitemapu a stránky, ktoré navštevujú len roboty, napríklad štítky a archívy blogu.
  7. Po ostrom upgrade porovnajte registrácie hookov medzi testovacou kópiou a produkciou, zapnite overrides, ktoré potrebujete, a potom zálohu zmažte alebo zamknite: leží v {admin}/autoupgrade/backup a obsahuje heslo k databáze aj údaje všetkých zákazníkov. Overte, že sa k nej z webu nedá dostať.

Obchod z toho vyšiel na PrestaShope 8.2.3 a keď bola platforma aktuálna, mohla začať práca na rýchlosti a novej téme: mobilný PageSpeed stúpol zo zhruba 40 na viac ako 90, podrobnosti sú v prípadovej štúdii.

Ak váš obchod stále beží na 1.7, alebo ste na 8 a premýšľate, čo s ním urobí 9, môžem tento zoznam prejsť na kópii vášho obchodu a povedať vám, čo sa pokazí, skôr než na to prídu zákazníci: ktoré moduly aktualizovať, nahradiť alebo vyhodiť, čo robia overrides a ako dlho bude obchod v režime údržby. To väčšinou rozhodne, či upgrade zaberie víkend, alebo mesiac. Prvý odhad je zadarmo, keď sa pozriem do obchodu. Ako u mňa prebieha upgrade PrestaShopu, alebo mi rovno pošlite adresu obchodu a zoznam modulov, začnem tam.

Zdroje