silverstripe-3-to-4-upgrade
Installation
SKILL.md
Silverstripe 3 to 4 Upgrade Skill
Repeatable workflow for upgrading legacy Silverstripe 3 projects to Silverstripe 4. Based on the successful migration of Iatric Manufacturing, this guide details the exact steps, architectural shifts, and critical gotchas when moving to the SS4 framework.
Upgrade Phases (Summary)
| Phase | Key Actions |
|---|---|
| 1. Assessment | Package audit (git diff branch-1 -- composer.json) · spin up legacy ddev instance · plan block-to-elemental migration |
| 2. Architecture | Move mysite to app, introduce public directory |
| 3. Dependencies | Update composer.json to ^4.0, update PHP constraints |
| 4. Namespaces | Apply PSR-4 namespaces, remap config class names |
| 5. DB Preflight Fixes | Clear __TEMP__ table collisions and FULLTEXT indices |
| 6. Data Migration | Run file migration, Elemental tasks, and custom SQL |
| 7. Templates | Fix HomePage resolution, update $Link to $URL |
| 8. Build & Verify | dev/build flush=1, QA frontend and admin |
| 9. Code Quality & CI | PHPCS, PHPStan, PHPUnit, GitHub Actions |