php-upgrade

Guide PHP version upgrades with Rector, PHPCompatibility, and php-parallel-lint.

20|1|Updated Feb 26, 2026
One-click install
npx skills add https://github.com/krzysztofsurdy/code-virtuoso --skill php-upgrade
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: php-upgrade
Source: https://github.com/krzysztofsurdy/code-virtuoso/tree/main/skills/playbooks/php-upgrade
Command: npx skills add https://github.com/krzysztofsurdy/code-virtuoso --skill php-upgrade

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

This Skill provides a structured, step-by-step playbook to upgrade PHP versions, ensuring compatibility and minimizing breakage.

Core Features & Use Cases

  • Version-by-Version Upgrades: Guides users through upgrading one minor PHP version at a time (e.g., 8.1 -> 8.2).
  • Automated Refactoring: Leverages Rector for automated code transformations.
  • Compatibility Auditing: Uses PHPCompatibility and php-parallel-lint to identify and fix issues.
  • Use Case: When you need to upgrade your project from PHP 8.2 to PHP 8.4, this Skill will guide you through auditing, automating fixes with Rector, updating dependencies, and testing.

Quick Start

Use the php-upgrade skill to upgrade your project from PHP 8.2 to PHP 8.3.

Frequently Asked Questions about php-upgrade

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I upgrade PHP versions systematically without breaking my application?

To upgrade PHP versions without breakage, follow a systematic process of auditing code compatibility, automating refactoring with Rector, and updating dependencies one minor version at a time to minimize failures.

What tools automate PHP compatibility checks and refactoring during an upgrade?

PHPCompatibility and php-parallel-lint identify compatibility issues, while Rector automates code transformations to ensure a smooth PHP version upgrade path across your codebase.

Can I upgrade directly from PHP 8.0 to PHP 8.4 in one step?

You should upgrade PHP one minor version at a time, such as 8.1 to 8.2. This step-by-step approach isolates compatibility issues and applies automated refactoring accurately.

What is the best way to handle deprecated features when upgrading to a newer PHP version?

Handle deprecated features by auditing code with PHPCompatibility, applying automated refactoring using Rector, and running comprehensive tests between each minor PHP version upgrade.

Do I need to update my project dependencies when upgrading PHP versions?

Yes, updating dependencies is a required step in the PHP upgrade process. Ensure all packages support the target PHP version to prevent compatibility conflicts and runtime errors.