From craft-workspace-webconsulting-skills
Upgrades TYPO3 extensions to newer LTS versions (v11→v12, v12→v13, v13→v14) using Extension Scanner, Rector, Fractor, PHPStan. Fixes deprecated APIs, compatibility issues, and third-party dependencies.
npx claudepluginhub dirnbauer/webconsulting-skillsThis skill uses the workspace's default tool permissions.
Systematic framework for upgrading TYPO3 extensions to newer LTS versions.
assets/fractor.phpassets/phpstan.neonassets/phpunit.xmlassets/rector.phpreferences/api-changes.mdreferences/dual-compatibility.mdreferences/multi-version-worktrees.mdreferences/pre-upgrade.mdreferences/real-world-patterns.mdreferences/third-party-dependency-upgrades.mdreferences/toolchain-output.mdreferences/troubleshooting.mdreferences/upgrade-v11-to-v12.mdreferences/upgrade-v12-to-v13.mdreferences/upgrade-v13-to-v14.mdreferences/verification.mdAutomates TYPO3 v14 PHP code upgrades using Rector refactoring rules, level sets, and migration workflows. Use for TYPO3 upgrades, rector runs, refactoring, deprecations.
Guides step-by-step PHP upgrades from 8.0 to 8.4+ using Rector for refactoring, PHPCompatibility for audits, and strategies for deprecations, extensions, and testing.
Modernizes PHP apps to 8.1+ with strict types, enums, DTOs, readonly properties, property hooks; configures PHPStan, Rector, PHP-CS-Fixer for type safety and PSR compliance.
Share bugs, ideas, or general feedback.
Systematic framework for upgrading TYPO3 extensions to newer LTS versions. Extension code only -- NOT for project/core upgrades.
| Tool | Purpose | Files |
|---|---|---|
| Extension Scanner | Diagnose deprecated APIs | TYPO3 Backend |
| Rector | Automated PHP migrations | .php |
| Fractor | Non-PHP migrations | FlexForms, TypoScript, YAML, Fluid |
| PHPStan | Static analysis | .php |
references/pre-upgrade.md)composer.json constraints for target versionreferences/third-party-dependency-upgrades.md)rector process --dry-run then review and applyfractor process --dry-run then review and applyphp-cs-fixer fixphpstan analyse against each supported dependency version and fix errorsphpunit and fix testsreferences/verification.md)Do NOT blindly apply Rector/Fractor if dual-version compatibility is needed, tests are missing, changes are unclear, or complex APIs (DBAL, Extbase) are affected. Instead: apply specific rules manually, test between each change.
When composer.json widens constraints to a new major version: enumerate API usages, cross-reference the new version's API, flag interface/concrete-only methods, verify mocks against all supported versions, use adapter pattern for signature differences, run PHPStan against each major version. See references/third-party-dependency-upgrades.md.
rector process --dry-run && rector process # PHP migrations
fractor process --dry-run && fractor process # Non-PHP migrations
php-cs-fixer fix && phpstan analyse && phpunit # Quality checks
Config templates in assets/: rector.php, fractor.php, phpstan.neon, phpunit.xml, .php-cs-fixer.php
| Reference | Use when... |
|---|---|
references/pre-upgrade.md | Starting an upgrade: planning checklist, version audit, risk assessment |
references/api-changes.md | Checking deprecated/removed APIs by TYPO3 version |
references/upgrade-v11-to-v12.md | Upgrading from TYPO3 v11 to v12 |
references/upgrade-v12-to-v13.md | Upgrading from TYPO3 v12 to v13 |
references/upgrade-v13-to-v14.md | Upgrading from TYPO3 v13 to v14 |
references/dual-compatibility.md | Maintaining dual compatibility (v12 + v13) |
references/real-world-patterns.md | Looking for real-world migration examples |
references/toolchain-output.md | Understanding Rector/Fractor dry-run output |
references/troubleshooting.md | Rector broke code, PHPStan errors, test failures |
references/third-party-dependency-upgrades.md | Upgrading non-TYPO3 dependencies (major version bumps, adapter patterns) |
references/verification.md | Checking success criteria and real-world testing |
references/multi-version-worktrees.md | Per-LTS worktree layout, backport workflow, cross-version CI matrix |
This skill is based on the excellent work by Netresearch DTT GmbH.
Original repository: https://github.com/netresearch/typo3-extension-upgrade-skill
Copyright (c) Netresearch DTT GmbH — Methodology and best practices (MIT / CC-BY-SA-4.0)
Special thanks to Netresearch DTT GmbH for their generous open-source contributions to the TYPO3 community, which helped shape this skill collection. Adapted by webconsulting.at for this skill collection