PHP 8.6 добавил clamp(), Duration и частичное применение функций

19 ноября вышел PHP 8.6: в языке появились частичное применение функций и clamp(), а при переходе проверьте сессии и обработку ошибок.
PHP 8.6 добавил clamp(), Duration и частичное применение функций

Проект PHP выпустил PHP 8.6 19 ноября 2026 года. Главные новинки: частичное применение функций, clamp(), класс Time\Duration, значения по умолчанию у readonly-свойств и API Io\Poll. Кроме того, в релизе ужесточили настройки сессий по умолчанию.

Перед обновлением проверьте работу с файлами и некорректными аргументами: некоторые функции теперь сообщают об ошибках, которые раньше оставались незамеченными.

Что изменилось в PHP 8.6

  • Частичное применение позволяет заранее задать часть аргументов функции и получить замыкание для остальных.
  • clamp() ограничивает значение заданными границами, а Time\Duration хранит интервал с точностью до наносекунды.
  • readonly-свойствам можно задавать значения по умолчанию. API Io\Poll отслеживает события множества потоков.
  • По умолчанию включены строгий режим сессий и HttpOnly для их куки, а SameSite установлен в Lax.
  • Исправления безопасности для PHP 8.2 заканчиваются 31 декабря 2026 года.

Как частично применить функцию

В PHP 8.6 вызов с ? вместо аргумента возвращает замыкание, которое можно вызвать позже с недостающими значениями. По описанию синтаксиса, замыкание сохраняет имена и типы оставшихся параметров.

Например, этот код оставит в массиве версии не ниже 8.6:

        // PHP 8.6
$versions = ['8.4', '8.6', '8.7'];
$result = array_filter($versions, version_compare(?, '8.6', '>='));
// Результат: элементы со значениями '8.6' и '8.7'
    

Параметр на месте ? становится обязательным. Многоточие ... обозначает остальные аргументы и сохраняет их значения по умолчанию. Синтаксис работает с функциями, методами, замыканиями и вызываемыми объектами.

На странице выпуска описана и оптимизация array_map(): подходящие вызовы с частичным применением или ссылкой на функцию компилируются в цикл. При strict_types=1 или передаче нескольких массивов эта оптимизация не действует.

Как ограничить значение с помощью clamp()

Функция clamp($value, $min, $max) возвращает исходное значение, если оно попадает в заданные границы. За пределами диапазона она возвращает соответствующую границу.

        // PHP 8.6
var_dump(clamp(-10, 0, 100)); // int(0)
var_dump(clamp(50, 0, 100));  // int(50)
var_dump(clamp(110, 0, 100)); // int(100)
    

По RFC функции, сравнения идут по обычным правилам PHP. Если нижняя граница больше верхней или одна из границ равна NAN, возникает ValueError.

Новое имя занято в глобальном пространстве имён. Перед переходом найдите собственные объявления clamp() без учёта регистра и с необязательным &:

        grep -rniE 'function[[:space:]]+&?[[:space:]]*clamp[[:space:]]*\(' src/ vendor/
    

Замените пути на каталоги проекта. Глобальную функцию придётся переименовать или перенести в пространство имён.

Зачем нужен Time\Duration

Класс Time\Duration описывает длительность независимо от календаря и часового пояса. В RFC среди сценариев названы тайм-ауты, задержки и измерение прошедшего времени.

Интервал создают через Duration::fromSeconds(30) или Duration::fromMilliseconds(500). Экземпляры можно сравнивать и использовать в вычислениях.

Точность класса достигает наносекунды. Максимальная длительность зависит от платформы: около 292 лет на 64-битных и около 68 лет на 32-битных системах; при переполнении возникает исключение.

Что изменилось для readonly-свойств

В PHP 8.6 значение по умолчанию можно указать прямо в объявлении readonly-свойства. Как объясняет RFC, такое значение считается инициализацией, поэтому конструктор его уже не перезапишет.

        // PHP 8.6
readonly class ParserConfig
{
    public string $format = 'json';
}

$config = new ParserConfig();
echo $config->format; // json
    

Раньше значение задавали в конструкторе. Новая запись упрощает объявление свойств интерфейса, доступных только для чтения.

Для каких задач предназначен Io\Poll

API Io\Poll отслеживает события потоков через механизмы операционной системы. Автор RFC задумал его как основу для библиотек событийного ввода-вывода и сервисов с множеством соединений.

На Linux используется epoll, на BSD и macOS — kqueue, на Solaris и illumos — event ports, на Windows — WSAPoll. Для остальных POSIX-систем есть запасной poll.

В API входят класс Io\Poll\Context и перечисление Io\Poll\Event.

Как работают ошибки потоков

Операции с потоками теперь можно перевести в режим StreamErrorMode::Exception: вместо предупреждений они бросают StreamException (RFC). У объектов StreamError, которые возвращает getErrors(), свойство code содержит вариант перечисления StreamErrorCode.

Что проверить перед переходом

В руководстве по миграции собраны изменения, способные затронуть существующий код. Начните проверку с сессий, аргументов функций и записи файлов.

  • Сессии. Включены session.use_strict_mode и session.cookie_httponly, а session.cookie_samesite установлен в Lax. Проверьте JavaScript, который читает куки сессии, и сценарии с межсайтовыми POST-запросами.
  • Обработчики сессий. Пользовательские обработчики без обоих методов create_sid() и validateId() объявлены устаревшими, указано на странице выпуска.
  • Нулевой байт. Функции вроде file_exists(), is_file(), filesize(), getenv(), putenv() и parse_str() теперь выбрасывают ValueError при нулевом байте в аргументе. Раньше они возвращали false или тихо обрезали строку.
  • Сбои записи. fclose(), file_put_contents() и copy() теперь возвращают false при сбое сброса буфера или закрытия потока. Проверяйте возвращаемое значение, чтобы не пропустить ошибку.
  • Другие изменения. trim() по умолчанию удаляет и символ перевода страницы \f; preg_grep() при ошибке PCRE возвращает false вместо части массива.

Список устаревших возможностей включает return внутри finally, возврат значения из __construct() и __destruct(), а также mb_ereg(), mb_split() и spl_object_hash().

Устаревшим также объявлено использование let и is в именах классов, функций и констант. Чтобы найти предупреждения, запустите тесты на PHP 8.6 с error_reporting=E_ALL и проверьте журнал.

Перед выпуском обновления отдельно проверьте сессии и запись файлов на тестовом окружении, а также совместимость зависимостей. Альтернативы пакетам, которые не поддерживают 8.6, можно поискать в подборке библиотек PHP.

Когда заканчивается поддержка предыдущих версий

По календарю PHP, ветка получает два года активной поддержки и ещё два года исправлений критических проблем безопасности.

Ветка Активная поддержка до Исправления безопасности до
PHP 8.2 31 декабря 2024 года 31 декабря 2026 года
PHP 8.3 31 декабря 2025 года 31 декабря 2027 года
PHP 8.4 31 декабря 2026 года 31 декабря 2028 года
PHP 8.5 31 декабря 2027 года 31 декабря 2029 года
PHP 8.6 31 декабря 2028 года 31 декабря 2030 года

Ближайший срок касается PHP 8.2: 31 декабря 2026 года заканчиваются исправления безопасности. В октябре проект уже закрывал две критические уязвимости PHP.

Источники

По теме

Комментарии