С PHP 7 сразу на 8.4что получите и в каком порядке переезжать
PHP 7.4 давно без обновлений безопасности, а 8.4 уже несёт property hooks и асимметричную видимость. Рассказываем, что реально меняется в коде и как пройти путь без большого взрыва.
- Раздел
- PHP
- Стек
- PHP 8.4RectorPHPStanComposer
- Уровень
- Средний
- Опубликовано
- Обновлено
- Чтение
- 8 мин
- Ветка 8.4 вышла 21 ноября 2024 года и получает исправления безопасности до конца 2028.
- Главные выигрыши: match, enum, readonly, а в 8.4 property hooks и асимметричная видимость.
- Ломается в основном мягкая типизация: сравнения строк с числами и предупреждения, ставшие исключениями.
- Rector переписывает синтаксис, PHPStan ловит то, что Rector пропустил.
- Поднять PHPStan на текущем коде и зафиксировать baseline
- Обновить зависимости Composer до версий с поддержкой PHP 8
- Прогнать Rector с наборами правил под целевую версию PHP
- Перевести CI на матрицу из старой и новой версии PHP
- Переключить прод и только потом брать новые возможности 8.4
Почему пора, даже если всё работает#
Мы регулярно видим проекты, где прод крутится на PHP 7.4 и «всё нормально». Нормально до первой уязвимости: ветка 7.4 перестала получать исправления безопасности ещё в конце 2022 года, а вместе с ней устаревают и библиотеки, которые давно требуют PHP 8. Обновить пакет ради закрытия дыры становится невозможно без обновления самого языка.
По официальной таблице поддерживаемых версий на php.net ветка 8.4 вышла 21 ноября 2024 года, активную поддержку получает до 31 декабря 2026 года, а исправления безопасности до 31 декабря 2028 года. Уже вышла и 8.5 (20 ноября 2025 года). Целиться в 8.4 разумно: это зрелая ветка, под которую обновились популярные фреймворки и инструменты, а запас по безопасности у неё на два года вперёд.
Если в проекте есть код из старых заметок, например про подготовленные выражения PDO, он, скорее всего, переедет без правок: PDO и его API в восьмой ветке остались прежними, только режим исключений стал режимом по умолчанию с PHP 8.0.
Что вы получаете по версиям#
Между 7.4 и 8.4 пять минорных релизов. Мы собрали то, что сильнее всего меняет повседневный код:
| Версия | Что появилось |
|---|---|
| 8.0 | JIT, выражение match, именованные аргументы, nullsafe-оператор ?->, продвижение свойств в конструкторе, union-типы, атрибуты |
| 8.1 | enum, readonly-свойства, тип never, файберы |
| 8.2 | readonly-классы, динамические свойства объявлены устаревшими |
| 8.3 | типизированные константы классов, атрибут #[\Override], json_validate() |
| 8.4 | property hooks, асимметричная видимость, new без скобок в цепочке, array_find(), array_any(), array_all(), атрибут #[\Deprecated], ленивые объекты |
JIT заметен на вычислительных задачах, а типичное веб-приложение, которое ждёт базу и сеть, ускоряется от него скромно. Реальный выигрыш для команды в другом: код становится короче, а ошибки типов ловятся раньше. Простой роутер из нашей заметки про роутер на 40 строк, например, на match теряет половину условий.
Тот же DTO в 7.4 и в 8.4#
Лучше всего разницу видно на обычном объекте с валидацией. Так он выглядел в 7.4:
<?php
// PHP 7.4
final class Order
{
public const STATUS_NEW = 'new';
public const STATUS_PAID = 'paid';
private $status;
private $total;
public function __construct(string $status, int $total)
{
if (!in_array($status, [self::STATUS_NEW, self::STATUS_PAID], true)) {
throw new InvalidArgumentException('Unknown status');
}
$this->status = $status;
$this->total = $total;
}
public function getStatus(): string { return $this->status; }
public function getTotal(): int { return $this->total; }
}А так в 8.4:
<?php
// PHP 8.4
enum Status: string
{
case New = 'new';
case Paid = 'paid';
}
final class Order
{
public private(set) Status $status;
public int $total {
set {
if ($value < 0) {
throw new InvalidArgumentException('Negative total');
}
$this->total = $value;
}
}
public function __construct(Status $status, int $total)
{
$this->status = $status;
$this->total = $total;
}
public function pay(): void
{
$this->status = Status::Paid;
}
}
$firstPaid = array_find(
$orders,
static fn(Order $o): bool => $o->status === Status::Paid,
);
$label = new Order(Status::New, 100)->status->value;Геттеры исчезли: public private(set) разрешает читать свойство снаружи, а менять только изнутри класса. Проверка суммы живёт в хуке set и срабатывает при любом присваивании, а не только в конструкторе. Статус стал перечислением, и опечатка в строке больше не пройдёт молча. Последняя строка показывает new без внешних скобок: в 7.4 пришлось бы писать (new Order(...))->status.
Что сломается при переезде#
Синтаксис почти полностью обратно совместим, проблемы приносит смена поведения. Список того, на чём мы спотыкались чаще всего:
- Сравнение строк с числами. С 8.0 выражение
0 == 'abc'даётfalse. Код, который полагался на старое приведение, начинает ветвиться иначе без единой ошибки. - Предупреждения стали исключениями. Многие встроенные функции вместо warning бросают
TypeErrorилиValueError, и поток выполнения обрывается там, где раньше шёл дальше. - Удалённые функции.
each()иcreate_function()исчезли в 8.0, доступ к символу строки через фигурные скобки тоже. - null во встроенных функциях. С 8.1 передача
nullв непустой скалярный параметр встроенной функции даёт deprecation. В логах легаси-проекта таких строк тысячи. - Динамические свойства. С 8.2 они устарели; классу, который на них построен, нужен атрибут
#[\AllowDynamicProperties]или явные свойства. - Неявно nullable параметры. В 8.4 запись
function f(Foo $x = null)объявлена устаревшей, правильно?Foo $x = null.
Отдельно проверьте функции, работающие со строками и локалью. Мы разбирали это в заметке про slugify с кириллицей: поведение iconv с TRANSLIT зависит от окружения, и смена образа контейнера вместе с версией PHP легко меняет результат.
Порядок миграции: Rector и PHPStan#
Мы советуем не прыгать через версии вручную, а поручить механику инструментам. Последовательность, которая у нас работает:
- Подключить PHPStan на текущей версии, выбрать посильный уровень строгости и сохранить baseline (
--generate-baseline). Новые ошибки после этого видны сразу, старые не мешают. - Обновить зависимости через Composer. Пакеты, которые не поддерживают PHP 8, заменить или форкнуть, иначе дальше не пройти.
- Запустить Rector с наборами правил под целевую версию. Он заменит
switchнаmatchтам, где это безопасно, продвинет свойства в конструктор, допишет nullable-типы. - Гонять тесты в CI сразу на старой и новой версии PHP, пока прод не переключён.
- Переключить прод, а синтаксис 8.4 вроде property hooks вводить уже после, отдельными изменениями.
<?php
// rector.php
use Rector\Config\RectorConfig;
return RectorConfig::configure()
->withPaths([__DIR__ . '/src', __DIR__ . '/tests'])
// версия берётся из require.php в composer.json
->withPhpSets()
->withPreparedSets(deadCode: true, typeDeclarations: true);Запускайте сначала с --dry-run и читайте дифф. Rector хорош в механике, но не знает бизнес-смысла: превращение switch в match меняет нестрогое сравнение на строгое, и это стоит проверить глазами.
Что изменилось к 2026 году#
Путь с PHP 7 стал заметно проще, чем был два-три года назад, и вот что мы бы учли, планируя его сейчас:
- Инструменты взяли рутину на себя. Rector и PHPStan покрывают почти всю механику, и команде остаётся ревью диффов и разбор поведения, а не ручная правка тысяч строк.
- Целевая версия сдвинулась. Ещё недавно мы советовали переезжать на 8.1 или 8.2. Сейчас 8.2 доживает последние недели исправлений безопасности, поэтому прыгать нужно сразу на 8.4 или 8.5, иначе через год вы снова в той же точке.
- Экосистема ушла вперёд. Актуальные версии фреймворков и библиотек требуют восьмую ветку, а часть уже ориентируется на 8.2 и выше. Оставаясь на 7.x, проект замораживает и все зависимости.
- Новые возможности вводите постепенно. Property hooks и асимметричная видимость удобны, но переписывать на них весь код сразу не нужно. Начните с новых классов и тех мест, где и так идёт рефакторинг.
Отдельно о деплое: держите старый образ с PHP 7.4 готовым к откату, пока новая версия не отработает на проде хотя бы цикл релизов. Логи deprecation после переключения стоит не глушить, а собирать: это готовый список работы на следующую версию языка.
Если проект на CodeIgniter, сочетайте обновление языка с переездом фреймворка: об этом наш пост про переход с CodeIgniter 3 на 4. Другие заметки собраны в разделе PHP.
«Переезд с PHP 7 это не переписывание, а серия маленьких безопасных шагов, каждый из которых можно откатить.»
Главный вывод заметки


