Migrating to PHP 8.4 on Magento: the checklist

All articles
Magento: Versions & Security

Migrating to PHP 8.4 on Magento: the checklist

With Magento 2.4.9, PHP 8.2 is retired: the new version requires PHP 8.4 or 8.5. Here is the step-by-step checklist to migrate your store safely, from third-party modules to a rollback plan.

Migrating to PHP 8.4 on Magento: the checklist

With the arrival of Magento 2.4.9 (GA on 12 May 2026), support for PHP 8.2 is dropped: the new release requires PHP 8.4 or 8.5. Updating the interpreter is not a minor technical detail, it is a mandatory step to stay current. Here is a practical checklist to tackle it without surprises.

Why upgrade PHP

Staying on an unsupported PHP version exposes your store to real risks:

  • Security: end-of-life versions no longer receive security patches, leaving vulnerabilities open to attack.
  • Performance: every new PHP major brings engine optimizations, with faster response times and lower memory usage.
  • Support: only supported versions get bugfixes; falling behind means losing compatibility with new modules and with Magento itself.

Check third-party module compatibility

The first step is to map every installed extension and confirm it declares support for PHP 8.4. Open each module's composer.json and check the constraint in the require section under php. Abandoned or vendor-stale modules are the main obstacle to a clean migration: they must be updated, replaced or removed.

Audit third-party extensions and the theme

It is not only functional modules: your theme and minor libraries can also use deprecated syntax. Run a static analysis of your custom code with a PHP compatibility tool and fix every warning before touching production.

Common PHP 8.4 deprecations

  • Undeclared dynamic properties on classes (already deprecated since 8.2).
  • Optional parameters declared before required ones in method signatures.
  • Improper use of null in arguments of internal functions.

Update with the right composer require

Update dependencies in a controlled way, for example composer require magento/product-community-edition 2.4.9 --no-update followed by composer update, resolving conflicts one at a time. Avoid blind upgrades: every constraint must be understood and validated.

Test on staging and plan the rollback

Never migrate straight to production. Replicate your environment on staging with PHP 8.4, run setup:upgrade, recompile and test the full flow (checkout, payments, admin area). Always prepare a rollback plan: database and code backups, plus the ability to revert to the previous version within minutes if something goes wrong.

Need a hand?

Migrating to PHP 8.4 is the perfect opportunity to secure and speed up your store. If you want to tackle it with an experienced partner, the Shine Software team is here to plan and manage the upgrade end-to-end.

Michelangelo Turillo
Michelangelo Turillo
Shine Software

Founder di Shine Software. Da oltre 12 anni progetta e sviluppa e-commerce Magento con AI integrata, hosting gestito e soluzioni su misura per le PMI italiane ed estere.

My Cart
Consulting