Что нового в PHP 8.x: от 8.0 до 8.5
В PHP 8 появились объединения типов, именованные аргументы и match, а следующие выпуски добавили enum, readonly, хуки свойств и оператор pipe. Ниже — примеры для каждой версии, ошибки, которые всплывают при обновлении, и чек-лист для перехода на PHP 8.3–8.5.
PHP 8.x: различия версий и сроки поддержки
Обозначения PHP 8.x и PHP 8 x относятся к ветке PHP 8. Вторая цифра задаёт минимальную версию, на которой можно использовать конкретный синтаксис. Например, match работает с PHP 8.0, enum — с 8.1, а хуки свойств — с 8.4. Если библиотека заявляет поддержку PHP 8.3, файл с хуками вызовет ошибку разбора при загрузке на этой версии.
| Версия | Что появилось | Поддержка на конец 2026 года |
|---|---|---|
| 8.0 | match, union types, именованные аргументы, ?->, атрибуты | Завершена |
| 8.1 | Перечисления, readonly-свойства, intersection types, Fibers | Завершена |
| 8.2 | Readonly-классы, DNF-типы, SensitiveParameter | Исправления безопасности до 31 декабря 2026 года |
| 8.3 | json_validate(), #[Override], типизированные константы класса | Исправления безопасности |
| 8.4 | Хуки свойств, отдельная видимость записи, array_find() | Активная поддержка до 31 декабря 2026 года |
| 8.5 | Оператор |>, array_first() и array_last(), расширение URI | Активная поддержка |
На конец 2026 года для нового приложения разумно выбирать PHP 8.5, если его поддерживают зависимости и нужные расширения. PHP 8.4 подходит, когда проекту требуется время на проверку 8.5. PHP 8.3 остаётся поддерживаемой веткой с исправлениями безопасности.
PHP 8.0: match, типы и именованные аргументы
Объединение int|string разрешает передать значение любого из двух типов. match возвращает значение, сравнивает варианты строго и выполняет только подходящую ветку. Если совпадения нет и ветка default отсутствует, PHP выбрасывает UnhandledMatchError.
<?php
declare(strict_types=1);
function statusLabel(int|string $status): string
{
// Число 200 и строка '200' совпадают с разными вариантами.
return match ($status) {
200 => 'Готово',
'200' => 'Строковый код',
404 => 'Не найдено',
default => 'Неизвестный статус',
};
}
echo statusLabel(status: '200'); // Строковый кодИменованные аргументы помогают читать вызов с несколькими необязательными параметрами. У публичной функции имя параметра становится частью API для таких вызовов. Если переименовать $status в $code, вызов statusLabel(status: '200') завершится ошибкой.
Оператор ?-> прерывает цепочку, когда слева находится null. Например, $order->customer?->email вернёт null, если покупателя нет. Используйте его там, где отсутствие объекта допустимо по модели данных. В PHP 8.0 также появились атрибуты для метаданных и сокращённое объявление свойств через параметры конструктора.
Типичная ошибка при переносе. PHP 8 изменил нестрогое сравнение числа со строкой, которая не является числовой. Выражение 0 == 'abc' теперь возвращает false. При миграции проверьте сравнения входных данных и вызовы in_array(). Если важно совпадение типов, используйте === и in_array($value, $allowed, true).
PHP 8.1: enum, readonly-свойства и пересечения типов
enum задаёт конечный набор значений. Перечисление с базовым типом string или int удобно хранить в базе и передавать через API. На входе tryFrom() возвращает null для неизвестного значения, а from() в таком случае выбрасывает ValueError.
<?php
declare(strict_types=1);
enum OrderStatus: string
{
case New = 'new';
case Paid = 'paid';
}
final class Order
{
public function __construct(public readonly OrderStatus $status) {}
}
// Проверяем строку на границе приложения.
$status = OrderStatus::tryFrom('paid')
?? throw new InvalidArgumentException('Неизвестный статус заказа');
$order = new Order($status);
echo $order->status->value; // paidReadonly-свойство можно прочитать после инициализации, а повторное присваивание вызовет Error. Если в свойстве лежит изменяемый объект, его методы по-прежнему могут менять внутреннее состояние. Для хранения даты, которая должна остаться прежней, используйте DateTimeImmutable.
Пересечение типов Countable&Iterator требует, чтобы объект реализовывал оба интерфейса. Объединение Countable|Iterator принимает объект с любым из них. В PHP 8.1 также появились Fibers для приостановки и возобновления выполнения. Асинхронный ввод-вывод при этом зависит от используемой библиотеки и её цикла событий.
PHP 8.2: readonly-классы и динамические свойства
Модификатор readonly на классе распространяется на все его свойства. Они должны быть типизированы. Это удобно для объектов, которые передают уже разобранные данные между слоями приложения.
<?php
declare(strict_types=1);
readonly class PageRequest
{
public function __construct(public int $page, public int $limit) {}
}
// После создания параметры страницы доступны только для чтения.
$request = new PageRequest(page: 2, limit: 20);
echo ($request->page - 1) * $request->limit; // 20Типичная ошибка при обновлении. Присваивание $object->emali = $email обычному классу без такого свойства создаёт динамическое свойство и выдаёт E_DEPRECATED. Проверьте опечатки и гидраторы, которые присваивают полям значения по ключам входного массива. Для фиксированной структуры объявите свойства, а для произвольных ключей подойдёт массив. У stdClass динамические свойства по-прежнему разрешены. В readonly-классе попытка создать такое свойство вызывает Error.
DNF-типы позволяют объединять пересечения с другими типами. Например, (Countable&Iterator)|null принимает либо объект с обоими интерфейсами, либо null. Атрибут #[\SensitiveParameter] скрывает значение параметра в трассировке стека. При явной записи значения в лог атрибут его не маскирует.
PHP 8.3: проверка JSON, Override и типы констант
json_validate() проверяет синтаксис JSON без построения PHP-массива или объекта. Функция подходит, когда нужно проверить строку перед сохранением или пересылкой. Если данные нужны сразу, декодируйте строку один раз с JSON_THROW_ON_ERROR и обработайте JsonException на границе приложения.
<?php
declare(strict_types=1);
$body = '{"limit": 20}';
// Нужна только проверка синтаксиса, без декодирования.
var_dump(json_validate($body)); // true
var_dump(json_validate('{"limit": }')); // falseКорректный JSON может содержать null, строку или число. Если API ожидает объект с целочисленным полем limit, после декодирования отдельно проверьте структуру и тип поля.
<?php
declare(strict_types=1);
interface Exporter
{
public function format(): string;
}
final class CsvExporter implements Exporter
{
public const string FORMAT = 'csv';
// PHP проверит, что метод объявлен в интерфейсе или родительском классе.
#[\Override]
public function format(): string
{
return self::FORMAT;
}
}
echo (new CsvExporter())->format(); // csv#[Override] особенно полезен при рефакторинге методов родительского класса. Если исходный метод переименуют и переопределение потеряет связь с ним, PHP сообщит об ошибке при загрузке класса. Типизированная константа позволяет сразу закрепить ожидаемый тип значения.
PHP 8.4: хуки свойств, видимость записи и поиск в массиве
Хуки get и set позволяют вычислять значение при чтении или обрабатывать его при записи. В примере значение хранится в свойстве $email, а хук удаляет пробелы по краям. public private(set) разрешает читать свойство снаружи и оставляет право записи самому классу.
<?php
declare(strict_types=1);
final class Contact
{
public private(set) string $email {
set (string $value) {
$value = trim($value);
if (filter_var($value, FILTER_VALIDATE_EMAIL) === false) {
throw new InvalidArgumentException('Некорректный email');
}
$this->email = $value;
}
}
public function __construct(string $email)
{
// Присваивание из конструктора тоже вызывает хук.
$this->email = $email;
}
}
echo (new Contact(' user@example.test '))->email;Типичная ошибка. Внешнее присваивание в $contact->email вызовет Error, поскольку запись закрыта. Если проект использует ORM или сериализатор, проверьте, как он заполняет объект с хуками и ограниченной видимостью записи, включая обход конструктора.
array_find() возвращает первое значение, подходящее под условие, или null. array_find_key() возвращает его ключ и помогает различить найденный элемент со значением null и отсутствие совпадения. Для проверки условий на массиве есть array_any() и array_all().
При переходе на PHP 8.4 исправьте неявно nullable-параметры. Объявление function render(string $title = null) устарело. Запишите function render(?string $title = null), если null допустим по контракту. Просмотрите также типы параметров в интерфейсах и методах их реализаций.
PHP 8.5: оператор pipe и функции для краёв массива
Оператор |> передаёт результат слева единственным аргументом вызываемому выражению справа. Он удобен для последовательных преобразований, когда каждый шаг обрабатывает результат предыдущего. Если функции нужны дополнительные параметры, задайте их в стрелочной функции.
<?php
declare(strict_types=1);
// Убираем пробелы, меняем ASCII-регистр и добавляем префикс.
$label = ' php 8.5 '
|> trim(...)
|> strtoupper(...)
|> (static fn (string $value): string => 'Версия: ' . $value);
echo $label; // Версия: PHP 8.5Типичная ошибка. Запись $value |> trim() пытается вызвать trim() без аргументов. Запись trim(...) создаёт вызываемый объект для передачи в pipe. Для Unicode-текста используйте mb_strtoupper() из расширения mbstring и при необходимости явно укажите кодировку.
array_first() и array_last() читают первое и последнее значения в порядке массива, сохраняя его внутренний указатель. Например, array_first([10 => 'new', 20 => 'paid']) вернёт 'new'. Пустой массив даёт null. Если null допустим как значение элемента, проверяйте пустоту отдельно через $items === [].
Расширение URI добавляет классы Uri\Rfc3986\Uri и Uri\WhatWg\Url. Выбирайте класс в соответствии с правилами разбора, которых ждёт приложение. Если разобранный адрес используется для исходящего сетевого запроса, допустимые схемы и хосты проверяются отдельно.
PHP 9 и чек-лист перехода на PHP 8.3–8.5
При подготовке к PHP 9 ориентируйтесь на фактические сообщения об устаревании и документацию целевой версии. E_DEPRECATED даёт повод исправить вызов или обновить зависимость уже в PHP 8.x. Срок удаления конкретной возможности определяется отдельно.
- Проверьте среду. Сверьте версию PHP и набор расширений у веб-приложения, CLI, фоновых обработчиков и задач по расписанию. Они могут отличаться даже на одном сервере.
- Проверьте зависимости. Сверьте ограничение
require.phpв Composer, возможное переопределениеconfig.platform.phpи требования пакетов к расширениям. Запуститеcomposer check-platform-reqsв целевой среде. - Пройдите основные сценарии. На тестовом окружении включите
E_ALL, проверьте логи веб-запросов и воркеров. Особое внимание уделите гидрации объектов, сериализации, сравнению строк с числами и обработке входного JSON. - Разбирайте входные значения явно. Добавляйте
declare(strict_types=1)в новые файлы и типизируйте интерфейсы приложения. Для скалярных аргументов пользовательских функций строгий режим определяется файлом вызова. Параметры HTTP и переменные окружения всё равно нужно разобрать, проверить и преобразовать на входе. - Соблюдайте заявленный минимум. Если приложение или библиотека поддерживает PHP 8.3, прогоняйте тесты на 8.3 и на целевой версии обновления. Синтаксис 8.4 и 8.5 вводите после поднятия минимальной версии. Перед переключением production проверьте запуск приложения и обработчиков очередей на собранном окружении.
Частые вопросы
Какую версию PHP 8 выбрать в конце 2026 года?
Для нового проекта выбирайте PHP 8.5, если зависимости и расширения совместимы. Для действующего приложения PHP 8.4 подойдёт как промежуточная цель, пока вы проверяете совместимость с 8.5. PHP 8.3 продолжает получать исправления безопасности.
Можно ли обновиться сразу с PHP 8.1 до PHP 8.5?
Да. Проверьте требования зависимостей, изучите изменения совместимости во всех промежуточных версиях и прогоните приложение на PHP 8.5. Отдельно проверьте динамические свойства, неявно nullable-параметры и запуск фоновых задач.
Нужно ли ждать PHP 9, чтобы обновить приложение?
Обновить приложение до поддерживаемой версии PHP 8.x можно сейчас. Исправляйте предупреждения об устаревании в своём коде и обновляйте зависимости. Совместимость с PHP 9 оценивайте по документации и тестам для этой версии.