Article
Migrating Zend Framework 3 to Laminas
ZF3→Laminas cutover using laminas-migration with backup, excludes, optional keep-locked-versions caution, and test gates.
ZF3 component apps usually migrate cleanly when Composer is healthy and modules are explicit. Follow official steps; treat --keep-locked-versions as a caution path, not the default.
composer global require laminas/laminas-migration
cd /path/to/zf3-app
git checkout -b chore/laminas-migration
laminas-migration migrate -e data -e data/cache
composer install
vendor/bin/phpunit
If you used --keep-locked-versions, diff composer.json, restore project-level constraints, remove packages that were not direct requirements, then composer update --lock—as described in the Laminas migration docs.
Flagships: complete ZF→Laminas guide, tooling reference. PHP upgrades: PHP 7→8 checklist.
Related tools
- Composer.json Validator Validate composer.json structure and common mistakes without running composer install.
- Legacy PHP Risk Checker Paste PHP source for a static scan that classifies removed APIs, deprecated calls, and security-sensitive leg…
- PHP Deprecated Checker Find deprecated functions and patterns in pasted PHP to prioritize modernization work.
- PHP Environment Compare Compare two PHP environment summaries to find directive and extension mismatches.
- PHP Modernization Roadmap Build an ordered migration stage list from your PHP version, framework, Composer, database API, and deploymen…
- PHP Version Compatibility Checker Scan pasted PHP for version-sensitive syntax and APIs to plan upgrades across PHP releases.
Related reading
- Migrating Zend Framework to Laminas (Complete Guide) Deep, verified migration from ZF2/ZF3 (and Apigility/Expressive) to Laminas using laminas-migration: Composer…
- Zend Framework 1 and PHP 8: Compatibility Reality Check ZF1 is not covered by laminas-migration like ZF2/ZF3. Unverified “PHP 8 compatible” claims, typical breakages…
- Zend Framework History: ZF1, ZF2, ZF3, and Laminas A maintainer-focused timeline of Zend Framework major generations and why Laminas is the official open-source…
- Zend Framework 3 Components Inventory List the zendframework/zend-* components you actually use so Laminas migration and PHP upgrades stay proporti…
- Composer Practices for Zend Framework 3 Apps Lockfiles, platform config, abandoned zendframework packages, and safe preparation for laminas-migration.