TYPO3 Extension Upgrade

Systematic framework for upgrading TYPO3 extensions to newer LTS versions.

Scope: Extension code upgrades only. NOT for TYPO3 project/core upgrades.

Upgrade Toolkit

Planning Phase (Required)

Before ANY code changes for major upgrades (PHP version drops, TYPO3 major versions):

1. List all files with hardcoded versions (composer.json, CI, Docker, Rector)
2. Document scope - how many places need changes?
3. Present plan to user for approval
4. Track progress with todo list

See references/pre-upgrade.md for detailed planning checklist.

Generic Upgrade Workflow

1. Complete planning phase (above)
2. Create feature branch (verify git clean)
3. Update composer.json constraints for target version
4. Run rector process --dry-run → review → apply
5. Run fractor process --dry-run → review → apply
6. Run php-cs-fixer fix
7. Run phpstan analyse → fix errors
8. Run phpunit → fix tests
9. Test in target TYPO3 version(s)

Quick Commands

./vendor/bin/rector process --dry-run && ./vendor/bin/rector process
./vendor/bin/fractor process --dry-run && ./vendor/bin/fractor process
./vendor/bin/php-cs-fixer fix && ./vendor/bin/phpstan analyse && ./vendor/bin/phpunit

Configuration Templates

Copy from assets/ and adjust for target version:

• rector.php, fractor.php, phpstan.neon, phpunit.xml, .php-cs-fixer.php

References

TYPO3 Changelogs

Success Criteria

• rector/fractor --dry-run show no changes
• phpstan analyse passes
• All tests pass
• Extension works in target TYPO3 version

Contributing: https://github.com/netresearch/typo3-extension-upgrade-skill