Upgradegids Magento 2.4.9: PHP 8.5, Symfony 7.4 en wat er breekt

Magento Open Source en Adobe Commerce 2.4.9 is de nieuwste versielijn, met de langste looptijd: Adobe noemt reguliere support tot 31 mei 2029. Voor merchants op 2.4.6 of 2.4.7 is dit het logische doel.

Het is ook een zwaardere upgrade dan een gewone patch. Verschillende dependencies die al jaren meegingen zijn vervangen, de minimale PHP-versie is omhooggegaan en sommige infrastructuuronderdelen zijn veranderd. Deze gids beschrijft wat er veranderd is, wat vaak breekt en een stapsgewijs upgradeproces dat je op je eigen webshop kunt afstemmen.

Wat er veranderd is in 2.4.9

PHP 8.5, en PHP 8.2 en 8.3 vervallen

Volgens de release notes van Adobe voor 2.4.9 wordt PHP 8.5 volledig ondersteund. PHP 8.4 is alleen toegestaan voor upgradedoeleinden en wordt niet aanbevolen voor productie. PHP 8.2 en 8.3 worden niet meer ondersteund. Draaien je servers nu op 8.2 of 8.3, dan hoort de PHP-upgrade bij dit project en is het geen apart project.

Symfony 7.4 LTS

Alle Symfony-dependencies gaan naar Symfony 7.4 LTS. Symfony 7 voegde strengere typedeclaraties toe en veranderde methodesignatures. Elke eigen class die een Symfony-component uitbreidt, moet worden nagelopen. Het meest voorkomende geval zijn CLI-commando's: eigen bin/magento commando's breiden Symfony\Component\Console\Command\Commanduit, en hun signatures van configure() en execute() moeten overeenkomen met de nieuwe parent.

// Symfony 7 expects an int return type on execute()
protected function execute(InputInterface $input, OutputInterface $output): int
{
    // ...
    return Command::SUCCESS;
}

Laminas MVC vervangen door een eigen MVC-implementatie

Adobe heeft de verouderde Laminas MVC-laag vervangen door een eigen MVC-implementatie van Magento. De meeste webshopcode raakt Laminas MVC nooit direct, maar sommige oudere extensies en maatwerkmodules importeren Laminas-classes voor requestafhandeling, routing of HTTP-responses. Doorzoek je codebase op die imports voordat je begint.

Zend_Cache vervangen door Symfony Cache

Het verouderde Zend_Cache-onderdeel maakt plaats voor Symfony Cache. Volgens Adobe blijven bestaande cache-backends ondersteund en zijn er geen wijzigingen in integraties nodig. Eigen cache-backends of code die Zend_Cache-classes direct aanroept, moet je nog steeds testen.

Andere wijzigingen die upgrades raken

• WYSIWYG-editor: TinyMCE is vervangen door HugeRTE, omdat de support voor TinyMCE 5 en 6 is gestopt. Extensies die de editor aanpassen, moeten worden gecontroleerd.
• OAuth: de OAuth-bibliotheek van een derde partij is vervangen door eigen PHP-functies.
• JWT-framework: bijgewerkt naar de nieuwste hoofdversie.
• Tweefactorauthenticatie: admins hoeven nu nog maar één provider in te stellen in plaats van elke ingeschakelde provider.
• JavaScript-bibliotheken: jQuery UI, jQuery Validate, Less.js, Underscore.js, Chart.js en andere zijn bijgewerkt, wat gevolgen kan hebben voor maatwerkthema's.

CAPTCHA verplicht bij het aanmaken van accounts via de API

Staat CAPTCHA of reCAPTCHA aan voor het formulier Account aanmaken op de storefront, dan dwingt 2.4.9 nu dezelfde validatie af bij het aanmaken van klantaccounts via REST en GraphQL. reCAPTCHA-validatie is ook toegevoegd aan verschillende GraphQL-mutations, waaronder updateCustomer.

Dit sluit een veelgebruikte route voor bot-aanmeldingen af. Het breekt ook headless frontends, mobiele apps en integraties die klantaccounts via de API aanmaken zonder een CAPTCHA-token mee te sturen. Test die flows expliciet.

Systeemvereisten

De tabel hieronder volgt de release notes van Adobe voor 2.4.9 en de pagina met systeemvereisten op het moment van schrijven. Controleer altijd de actuele pagina met systeemvereisten voordat je infrastructuurwijzigingen bestelt, want Adobe werkt die bij elke patch bij.

Twee punten vallen op. Adobe merkt op dat de support voor MySQL 8.0 op 30 april 2026 is gestopt. En de on-premises tabel voor 2.4.9 noemt Valkey in plaats van Redis voor caching en sessies, dus plan die overstap als je nog Redis gebruikt.

Stapsgewijs upgradeproces

1. Audit code en extensies

Begin met een inventarisatie, want hier gaat de meeste tijd in zitten.

# list installed third-party modules
bin/magento module:status --enabled | grep -v "^Magento_"

# find code that touches replaced components
grep -rn "Laminas\\\\Mvc\|Zend_Cache\|Symfony\\\\Component\\\\Console" app/code vendor/<your-vendors>

Controleer per extensie of de leverancier een versie heeft uitgebracht die compatibel is met 2.4.9 en PHP 8.5. Verwijder modules die je niet meer gebruikt. Elke verwijderde module is er één minder om te testen.

2. Richt een stagingomgeving in die de nieuwe stack nabootst

Bouw staging op PHP 8.5, OpenSearch 3, MySQL 8.4 of MariaDB 11.8/12.x en Valkey. Laad een recente kopie van de productiedata. Door code en infrastructuur samen te upgraden op staging zie je echte problemen vroeg.

3. Maak een back-up en zet maintenance mode aan

bin/magento maintenance:enable
mysqldump --single-transaction --routines --triggers dbname > pre-249.sql
tar -czf pre-249-code.tgz app composer.json composer.lock

4. Werk de Composer-requirements bij

Voor Magento Open Source:

composer require-commerce magento/product-community-edition 2.4.9 --no-update
composer update

Gebruik voor Adobe Commerce magento/product-enterprise-edition. Het commando require-commerce komt uit de composer-root-update-plugin van Adobe en past de root-dependencies voor je aan. Reken bij de eerste run op conflicten. Los die op door extensies te upgraden, niet door oudere constraints af te dwingen.

5. Voer de upgrade uit en bouw opnieuw

bin/magento setup:upgrade
bin/magento setup:di:compile
bin/magento setup:static-content:deploy -f
bin/magento indexer:reindex
bin/magento cache:flush
bin/magento maintenance:disable

Los compileerfouten eerst op. Afwijkende signatures ten opzichte van Symfony 7.4 en ontbrekende Laminas-classes komen meestal hier boven water.

Veelvoorkomende fouten na de Composer-stap

• Declaration must be compatible with Symfony\Component\…: een eigen class overschrijft een Symfony-methode met een oude signature. Voeg de parameter- en returntypes toe die de parent nu declareert.
• Class “Laminas\Mvc\…” not found: een module is nog afhankelijk van Laminas MVC. Werk de extensie bij of refactor de code naar de eigen request- en responseclasses van Magento.
• Composer-conflicten over de PHP-versie: de composer.json van een extensie beperkt PHP tot een versie onder 8.5. Kijk of de leverancier een nieuwere release heeft voordat je een fork overweegt.
• Editorvelden in de admin blijven leeg: een module past de TinyMCE-configuratie aan, die onder HugeRTE niet meer geldt.

Leg elke fix vast in je repository met een duidelijke commitmessage. Bij de productierun wil je dat dezelfde reeks zonder handmatige aanpassingen schoon doorloopt.

6. Test wat het snelst breekt

• De checkout van begin tot eind, met elke betaalmethode en vervoerder.
• Klantregistratie via de storefront, de mobiele app en elke headless frontend.
• Eigen CLI-commando's en cronjobs.
• CMS-bewerking in de admin, nu met HugeRTE.
• Integraties met ERP, PIM en marketplaces, inclusief integraties op basis van OAuth.
• Zoekresultaten en gelaagde navigatie op OpenSearch 3.

7. Installeer de nieuwste beveiligingspatches

Een verse 2.4.9-installatie is niet automatisch up-to-date. In september 2026 bracht Adobe de APSB26-138-update uit en, los daarvan, de APSB26-146-hotfix voor de actief misbruikte CVE-2026-75650 (StyleSmuggler). De hotfix zit niet in de geïsoleerde septemberpatch, dus installeer beide voordat je live gaat.

8. Plan de overstap op productie

Oefen de deployment op staging met tijdmeting, bepaal een rollbackpunt en plan de release in een rustig moment. Houd de eerste dagen de foutlogs, de conversieratio en mislukte betalingen goed in de gaten.

Veelgestelde vragen

Hoe lang wordt Magento 2.4.9 ondersteund?

De pagina met uitgebrachte versies van Adobe noemt reguliere support voor 2.4.9 tot 31 mei 2029. De versie is uitgebracht op 12 mei 2026.

Kan ik 2.4.9 op PHP 8.3 draaien?

Nee. Volgens de release notes van Adobe worden PHP 8.2 en 8.3 niet meer ondersteund. PHP 8.5 wordt volledig ondersteund, en 8.4 is alleen toegestaan voor upgradedoeleinden.

Werken mijn extensies op 2.4.9?

Alleen testen geeft zekerheid. Het meeste risico lopen extensies die Symfony-classes uitbreiden, Laminas MVC direct gebruiken, de WYSIWYG-editor aanpassen of klanten aanmaken via de API.

Kan ik beter naar 2.4.8 gaan omdat dat minder ingrijpend is?

2.4.8 wordt ondersteund tot 31 mei 2028, een jaar korter dan 2.4.9. Doe je toch al een grote upgrade, dan voorkom je met 2.4.9 meestal dat je kort daarna nog een frameworkmigratie moet doen.

Bronnen

• Release notes van Adobe Commerce 2.4.9
• Release notes van Magento Open Source 2.4.9
• Uitgebrachte versies en supportdata van Adobe Commerce
• Systeemvereisten van Adobe Commerce
• Beveiligingsupdate beschikbaar voor Adobe Commerce, APSB26-138
• Kritieke beveiligingsupdate voor Adobe Commerce, APSB26-146