19 листопада - день релізу PHP 8.6, і сторінка релізу на php.net уже підсумовує, з чим приходить нова версія. Ми двічі писали про неї заздалегідь - у серпні і у вересні, тож тут не переказуємо все наново, а збираємо підсумок дня релізу: що остаточно увійшло, що з'явилося в списку з того часу і що це означає для Laravel-проєктів.
На момент написання останнім тегом у php-src був php-8.6.0RC7, а сама сторінка релізу ще мала позначку «буде випущено 19 листопада», тож фінальний тег і збірки з'являться протягом дня.
Шість головних можливостей
- Часткове застосування функцій (Partial Function Application). Частину аргументів передаєте одразу, а замість решти ставите
? або ..., і отримуєте замикання. Функція викликається лише тоді, коли передано решту аргументів.
- Клас
Time\Duration - проміжок часу «як на секундомірі», незалежний від дат і часових поясів, з наносекундною точністю і діапазоном понад 250 років. Призначений для таймаутів і замірів часу.
- Polling API у просторі імен
Io\Poll: епоха stream_select() з його типовою межею в 1024 з'єднання закінчується, бо новий API сам обирає epoll, kqueue, event ports або WSAPoll. Це фундамент для ReactPHP та AMPHP, а не новий async у застосунковому коді.
clamp() - тримає значення в межах діапазону і працює з будь-якими порівнюваними значеннями.
- Енум
SortDirection з випадками Ascending і Descending - спільний тип для бібліотек замість суміші SORT_ASC, рядків і власних енумів.
- Значення за замовчуванням для readonly-властивостей. У серпневому огляді ми писали, що RFC ще на голосуванні і закладатися на нього зарано. Тепер це факт: значення за замовчуванням вважається ініціалізацією, тож конструктор його вже не перезапише.
Найкраще нові можливості видно разом. Приклад зі сторінки релізу - експоненційна затримка між повторними спробами, де Duration, min() і часткове застосування працюють у парі:
use Time\Duration;
function backoff(Duration $baseDelay, Duration $step, int $attempt): void
{
$delay = $baseDelay->add($step->multiplyBy(2 ** $attempt));
// Duration можна порівнювати, тож min() працює напряму
$delay = min($delay, Duration::fromSeconds(30));
time_nanosleep($delay->seconds, $delay->nanoseconds);
}
$waitBeforeRetry = backoff(
Duration::fromSeconds(1),
Duration::fromMilliseconds(100),
attempt: ?,
);
$waitBeforeRetry($attempt);
Порівняйте з версією для PHP 8.5, де все в мікросекундах і тримається на коментарі «всі затримки в мікросекундах» та usleep(min($delay, 30_000_000)).
Що ще потрапило в реліз
Окрім головної шістки, список змін вийшов довшим, ніж виглядав восени:
- Обробка помилок потоків: через опцію контексту
error_mode операції з потоками можуть кидати StreamException замість попереджень. Помилки приходять як об'єкти StreamError з випадком енума StreamErrorCode, іменем обгортки і шляхом. Кінець епохи @file_get_contents() і error_get_last().
- Атрибут
#[\Override] тепер можна ставити на константи класу і випадки енумів.
- Властивості об'єктів, збережених у константах, можна змінювати напряму:
Config::DEFAULTS->timeout = 30.
- Класи
Uri\Rfc3986\UriBuilder і Uri\WhatWg\UrlBuilder для збирання URI з частин.
- Sodium отримав постквантову інкапсуляцію ключів (X-Wing і ML-KEM-768), TLS-потоки - відновлення сесій і 0-RTT у TLS 1.3.
mysqli::quote_string() за аналогією з PDO::quote(), а повідомлення про помилки JSON тепер вказують місце помилки у вхідних даних.
- Продуктивність:
array_map() з first-class callable або частковим застосуванням компілюється в цикл, швидші printf() і кодування JSON, кешування замикань без стану.
Зміни поведінки, які легко проґавити
Депрекейти видно в логах, а от ці зміни не попереджають - код просто поводиться інакше:
trim(), ltrim() і rtrim() тепер за замовчуванням зрізають ще й символ form feed (\f);
fclose(), file_put_contents() і copy() повертають false, якщо не вдалося скинути буфер або закрити потік, - раніше збій тихо ігнорувався;
- багато функцій кидають
ValueError на значення поза діапазоном, невалідні прапорці або рядки з NUL-байтами замість тихого обрізання;
- дефолти сесій стали безпечнішими:
session.use_strict_mode і session.cookie_httponly увімкнені, session.cookie_samesite дорівнює Lax.
Останній пункт ми докладно розбирали у серпні. Для Laravel він менш болючий, ніж для «голого» PHP: фреймворк веде сесії власним менеджером і сам виставляє атрибути cookie з config/session.php, а не покладається на session.* з php.ini. Перевіряти варто ті частини проєкту, що працюють з нативними session_start() - старі вставки, сторонні SDK.
Серед нових депрекейтів, яких не було в наших попередніх оглядах, - функції регулярних виразів mbstring (mb_ereg(), mb_split() та інші): бібліотеку Oniguruma більше не підтримують, тож заміна - PCRE з модифікатором u. А власні обробники сесій, які не реалізують і create_sid(), і validateId(), тепер теж депрекейт. Повний перелік - у посібнику з міграції.
Що з Laravel
Офіційно Laravel 13 на PHP 8.6 ще не тестується: у workflow тестів гілки 13.x матриця - PHP 8.3, 8.4 і 8.5. Роботу над підтримкою веде чернетка PR #61771 «Experimental supports for PHP 8.6» від crynobone з команди Laravel, відкрита з кінця вересня. З її опису видно, де саме фреймворк зачіпає реліз:
- заміна задепрекейтених
SORT_LOCALE_STRING і strcoll();
- виправлення в компоненті валідації, пов'язане з новою поведінкою
trim();
- депрекейти в залежностях:
guzzlehttp/promises використовував is як ім'я класу (виправлено в 3.1.0), opis/json-schema викликає spl_object_hash(), а ably/ably-php повертає значення з конструктора - на момент написання ці два ще не виправлені.
Депрекейт - не помилка, і застосунок на PHP 8.6 запуститься. Але якщо ваш PHPUnit або Pest налаштований падати на депрекейтах, а E_DEPRECATED не вимкнений у логах продакшну, зустріч з 8.6 буде шумною саме через сторонні пакети.
Коли оновлюватися
Для продакшну розумно дочекатися двох речей: релізу Laravel з офіційною підтримкою PHP 8.6 і першого патч-релізу 8.6.x. Нульова версія мажорного релізу PHP - це нормально, але навіщо бути першим, хто знайде її баги на живому трафіку.
А от що варто зробити вже зараз:
- додати PHP 8.6 у матрицю CI як необов'язкову (
continue-on-error) - побачите депрекейти і падіння до того, як вони стануть вашою проблемою;
- прогнати Rector і PHPStan: аліаси на кшталт
is_integer() і doubleval(), spl_object_hash() і return у finally ловляться автоматично;
- пошукати в коді
mb_ereg, mb_split і trim( там, де вхідні дані можуть містити керівні символи;
- оновити залежності і подивитися, які пакети з
composer.lock ще сиплять депрекейтами на 8.6.
Нові можливості в коді проєкту, що мусить працювати і на 8.5, поки лише в мріях. Але бібліотекам і внутрішнім пакетам, які можуть підняти мінімальну версію, Duration і часткове застосування дадуть найбільше вже в найближчі місяці.