PHPTime

Что нового в 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.0match, union types, именованные аргументы, ?->, атрибутыЗавершена
8.1Перечисления, readonly-свойства, intersection types, FibersЗавершена
8.2Readonly-классы, DNF-типы, SensitiveParameterИсправления безопасности до 31 декабря 2026 года
8.3json_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
<?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
<?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; // paid

Readonly-свойство можно прочитать после инициализации, а повторное присваивание вызовет Error. Если в свойстве лежит изменяемый объект, его методы по-прежнему могут менять внутреннее состояние. Для хранения даты, которая должна остаться прежней, используйте DateTimeImmutable.

Пересечение типов Countable&Iterator требует, чтобы объект реализовывал оба интерфейса. Объединение Countable|Iterator принимает объект с любым из них. В PHP 8.1 также появились Fibers для приостановки и возобновления выполнения. Асинхронный ввод-вывод при этом зависит от используемой библиотеки и её цикла событий.

PHP 8.2: readonly-классы и динамические свойства

Модификатор readonly на классе распространяется на все его свойства. Они должны быть типизированы. Это удобно для объектов, которые передают уже разобранные данные между слоями приложения.

PHP
<?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
<?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
<?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
<?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
<?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. Срок удаления конкретной возможности определяется отдельно.

  1. Проверьте среду. Сверьте версию PHP и набор расширений у веб-приложения, CLI, фоновых обработчиков и задач по расписанию. Они могут отличаться даже на одном сервере.
  2. Проверьте зависимости. Сверьте ограничение require.php в Composer, возможное переопределение config.platform.php и требования пакетов к расширениям. Запустите composer check-platform-reqs в целевой среде.
  3. Пройдите основные сценарии. На тестовом окружении включите E_ALL, проверьте логи веб-запросов и воркеров. Особое внимание уделите гидрации объектов, сериализации, сравнению строк с числами и обработке входного JSON.
  4. Разбирайте входные значения явно. Добавляйте declare(strict_types=1) в новые файлы и типизируйте интерфейсы приложения. Для скалярных аргументов пользовательских функций строгий режим определяется файлом вызова. Параметры HTTP и переменные окружения всё равно нужно разобрать, проверить и преобразовать на входе.
  5. Соблюдайте заявленный минимум. Если приложение или библиотека поддерживает 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 оценивайте по документации и тестам для этой версии.

Справка по теме

Ещё в разделе «Справочник PHP»

PHP-FPM и nginx: настройка связки

Настройте связку nginx и PHP-FPM для PHP 8.3–8.5. Примеры конфигурации через Unix-сокет и TCP, правила маршрутизации и диагностика ошибок 403, 404, 502 и 504.

9 мин

Ассоциативные и многомерные массивы в PHP

Как создавать ассоциативные и многомерные массивы в PHP, читать вложенные данные, получать ключи и значения через array_keys() и array_values().

10 мин

Вывод ошибок в PHP: display_errors, error_reporting и логи

Как включить вывод ошибок PHP через display_errors и ini_set, настроить error_reporting и error_log, найти логи и разобраться с deprecated в PHP 8.3–8.5.

9 мин

Дата и время в PHP: date, DateTime и часовые пояса

Как получить текущую дату и время в PHP, настроить часовой пояс, разобрать строку и отформатировать дату с date(), strtotime() и DateTimeImmutable.

8 мин