php-upgrade
Installation
SKILL.md
PHP Version Upgrade
Upgrade one minor version at a time and never skip versions. Each step surfaces deprecations that become errors in the next release. Every upgrade follows the same cycle: audit, automate, test, deploy.
Core Principles
| Principle | Meaning |
|---|---|
| Changelog first | Before each hop, fetch the official php.net migration guide for that hop. Never rely on a static list in this skill or in model memory |
| One version at a time | Upgrade 8.2 -> 8.3 -> 8.4 -> 8.5 in sequence. Skipping versions makes it impossible to isolate breakage |
| Fix deprecations before upgrading | Deprecations in version N become errors in version N+1, so treat them as mandatory fixes |
| Automate first, manual second | Run Rector and PHPCompatibility before touching code by hand. They catch 80%+ of required changes |
| Prove it with tests | An upgrade is not complete until the test suite passes on the target version |
| Pin your platform | Set config.platform.php in composer.json to match your lowest deployment target |