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.
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
nullin 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.
