Article

PHP Version Migration Center

Maps from EOL PHP 5.x through supported PHP 8.2–8.5 branches, with checklists, removed APIs, and scanners for real codebases.

This center organizes PHP runtime upgrades the way production teams actually ship them: inventory first, remove dead APIs, climb a tested version ladder, then harden Composer and CI. It is not a marketing timeline of “new features”—it is a routing desk for maintainers who inherited FPM pools still pinned to abandoned branches.

Supported PHP branches (verified 2026-08-09)

Per php.net/supported-versions.php, currently supported release lines are:

  • PHP 8.2 — security support until 2026-12-31
  • PHP 8.3 — security support until 2027-12-31
  • PHP 8.4 — active support until 2026-12-31
  • PHP 8.5 — active support until 2027-12-31

PHP 5.x, 7.x, 8.0, and 8.1 are end of life. Treat them as incident risk, not “stable enough.” Do not invent undocumented branches beyond what php.net publishes.

Choose a migration path

Tools before you rewrite architecture

Run scanners early so fatals are not discovered on the production cutover night:

Pair findings with the PHP Errors encyclopedia when CI surfaces signatures such as mysql_connect removed or dynamic property deprecations.

Recommended sequencing

  1. Freeze a reproducible inventory (SAPI, extensions, Composer platform, cron entry points).
  2. Eliminate removed APIs that hard-fail on the next major.
  3. Raise CI to the target minor with E_ALL and fail on deprecations in staging.
  4. Soak under load, then cut FPM/CLI images together so CLI workers do not lag the web pool.

Related reading