Controleer vóór een PHP-wijziging de PHP-versie en de overige afhankelijkheden voor de exacte doelrelease van uw Magento- of Adobe Commerce-installatie, en vergelijk die met de geteste combinaties in de systeemeisentabel van Adobe. Maak daarnaast een overzicht van editie, huidige en doelversie, hosting, extensies, maatwerk en externe koppelingen, zodat duidelijk is welke onderdelen de wijziging raakt.
Waarom de exacte release telt
Adobe ondersteunt alleen de PHP-combinaties die in de systeemeisentabel staan. Die tabel noemt combinaties per exacte release. Zo staat 2.4.9 vermeld met PHP 8.5 en 2.4.8-p5 en -p4 met PHP 8.4 en 8.3. Voor 2.4.7-p10 en -p9 noemt de tabel PHP 8.3 en 8.2.
Dit is geen algemene regel voor elke patchrelease. Controleer daarom de exacte patchrelease én de installatievorm. Security patch releases met een -pN-suffix kunnen bovendien niet-achterwaartscompatibele wijzigingen bevatten.
Installatievorm en editie
Adobe beschrijft aparte upgradepaden voor Composer- en on-premises-installaties, Cloud en Git-installaties. Een werkwijze voor een Composer-installatie is dus geen universeel stappenplan. Ook verschillen de productpakketten tussen Magento Open Source en Adobe Commerce. De voorbereidingslijst van Adobe noemt onder meer cron, bestandsrechten, de Composer-updateplugin en de zoekmachine. Controleer per installatie welke punten gelden.
Bruikbare stappen
- Inventarisatie: Leg editie en installatiemethode, softwarepakketversie, handmatige patches of Composer-patchconfiguratie en het deploymentlog bij elkaar. Ontbrekende gegevens blijven onbekend. Vul ze dus niet in op basis van aannames.
- Afhankelijkheden vergelijken: Leg de doel-PHP-versie naast de geteste combinatie voor uw exacte release. Neem extensies, maatwerk en integraties mee, want Adobe noemt die als factoren bij de upgrade-inspanning.
- Voorbereiding met de beheerder: Laat een passende proefomgeving, een volledig herstelbaar back-upplan en een terugzetbesluit voorbereiden. Een back-up van alleen composer.json is geen complete back-up.
- Procedure plannen: De upgradeprocedure van Adobe omvat onder meer onderhoudsmodus, afstemming van cron en queueconsumers, een back-up van composer.json en een controle van de storefront achteraf.
- Testen op de proefomgeving: Laat zoeken, categorie- en productpagina's, winkelmand, checkout en betaalmethoden, orderberichten, bestaande koppelingen, beheer en geplande taken controleren. Leg per controle het verwachte en het werkelijke resultaat vast.
- Wijzigingen vastleggen: Registreer per wijziging de bron, de datum, de verantwoordelijke en het bewijs van testen of terugzetten.
Veelgestelde vragen
Geldt een PHP-combinatie voor alle patchreleases van dezelfde versie? Nee. De tabel noemt combinaties per exacte release. Kijk dus naar uw specifieke patchrelease.
Kan ik het Cloud-stappenplan gebruiken voor een Composer-installatie? Adobe beschrijft aparte paden per installatievorm. Instructies voor Cloud-infrastructuur gelden niet automatisch voor andere installaties.
Moet ik vooraf losse patches toepassen? De Quality Patches Tool toont beschikbare patches met hun status. Adobe waarschuwt dat veel individuele patches de complexiteit vergroten en upgraden moeilijker kunnen maken. Gebruik de tool daarom in deze fase alleen voor inventarisatie.
Crydogs biedt onderhoud, upgrades, bugfixes, beveiligingspatches en hosting voor bestaande Magento-webshops. Achter de dienst zit Magento-ervaring sinds 2008, eerder bekend als Magento-shops.be. Wij combineren dit met GEO, SEO, branding en websiteontwikkeling. Neem contact op via https://crydogs.com/#contact.
Bekijk onze Magento-dienst voor onderhoud, upgrades en hosting. Doe een vrijblijvende aanvraag.
