PHP 8.6: Нові функції, застарілі функції та практичний посібник з міграції
Оновіть PHP 8.6 з прикладами до і після для застарілих функцій PHP, MySQLi, mbstring, CSV, сесій та практичним чек‑листом міграції.
PHP 8.6.0 був випущений 19 листопада 2026 року. Головні функції цікаві, але для розробників, які підтримують реальні веб-сайти, найважливішим питанням часто є інше: які рядки існуючого коду почнуть видавати попередження про застарілу API, і як їх слід переписати?
Цей посібник ставить міграційну роботу на перше місце. Кожен приклад ідентифікує застарілий API, показує замінник та підкреслює, де механічний пошук-заміна був би небезпечним. Попередження про застарілість — це не те ж саме, що миттєва фатальна помилка: воно попереджає, що код потребує уваги, часто до того, як майбутня основна версія видалить API.
1. Перевірте середовище виконання перед роботою з продакшн
Виконайте ці команди в тому самій PHP-середовищі, яке обслуговує додаток (CLI та веб PHP можуть використовувати різні бінарні файли та налаштування):
php -v
php -m
php --ini
Перевірте розширення, що використовує проект, особливо mbstring, mysqli та intl. Переконайтеся, що фреймворк, CMS, розширення та хостингове середовище явно підтримують PHP 8.6; не робіть висновок про сумісність лише тому, що сайт запускається.
У стейджинговому середовищі логуйте всі помилки, утримуючи діагностичні повідомлення з публічного HTML:
<?php
error_reporting(E_ALL);
ini_set('log_errors', '1');
ini_set('display_errors', '0');
Ці налаштування середовища виконання корисні для контролированого тестування. Для довгострокових середовищ краще налаштувати логування на рівні сервера; переконайтеся, що лог помилок доступний для запису та приватний. Повідомлення Deprecated є практичним навіть тоді, коли сторінка все ще рендериться.
2. Швидка довідка: застарілі API та що використовувати замість них
| Застаріло в PHP 8.6 | Рекомендований підхід | Застереження щодо міграції |
|---|---|---|
is_integer(), is_long() |
is_int() |
Прямі аліаси |
is_double() |
is_float() |
Прямий аліас |
doubleval() |
floatval() |
Прямий аліас |
spl_object_hash() |
spl_object_id() |
Тип повернення змінюється з string на int |
mb_ereg(), mb_eregi() |
preg_match() |
Адаптуйте синтаксис патерну та Unicode-прапори |
mb_ereg_replace() |
preg_replace() |
Перевірте ескейпинг, семантику заміни та помилки |
mysqli_stmt_init() |
mysqli_prepare() |
Підготуйтеся негайно |
mysqli_get_charset() |
mysqli_character_set_name() |
Тільки якщо потрібна назва кодування |
SplFileObject::fgetcsv() |
fgetcsv() на потоці |
Перегляньте позицію потоку та налаштування CSV |
SplFileObject::fputcsv() |
fputcsv() на потоці |
Передавайте роздільник, огорнування та ескейп явно |
strcoll() |
Collator::compare() |
Вимагає intl; оберіть локаль |
SORT_LOCALE_STRING |
Collator::sort() / asort() |
Поведінка локалі може змінитися |
spl_classes() |
ReflectionExtension::getClassNames() |
Перевірте відповідне розширення |
Третій аргумент define() |
Відсутній аргумент | Старий режим без урахування регістру видалений |
return у finally |
Повернення поза finally |
Уникайте придушення винятків |
Об'єкт, переданий у array_walk() |
get_object_vars() спочатку |
Редагування за посиланням може більше не мутувати об'єкт |
metaphone() |
Підтримувана фонетична реалізація | Немає готової заміни в ядрі |
Деякі API не мають точної заміни. Правильна міграція може вимагати зміни дизайну, а не просто перейменування функції. Дивіться офіційний список застарілих функцій PHP 8.6.
3. Прості аліаси: безпечні, швидкі виправлення
До — застаріло:
<?php
if (is_integer($quantity) && is_double($price)) {
$total = doubleval($price) * $quantity;
}
Після:
<?php
if (is_int($quantity) && is_float($price)) {
$total = floatval($price) * $quantity;
}
Аліаси мають однакову семантику. Не припускайте, що is_float(40) є true: ціле число залишається цілим числом. Ця поведінка вже була присутня до міграції.
Для рядкової суми floatval() є перетворенням, а не десяткове представлення, безпечним для грошей. Зберігайте існуючу стратегію обробки грошей проекту, а не змінюйте її як частину не пов'язаного оновлення PHP.
4. Міграція регулярних виразів mbstring
Сімейство mb_ereg* застаріло, тому що його базовий регулярний двигун Oniguruma більше не підтримується. PHP рекомендує PCRE для багатьох випадків використання, але діалекти патернів не ідентичні.
До:
<?php
$isReference = mb_ereg('^[0-9]+$', $reference) !== false;
Після (тільки ASCII цифри):
<?php
$isReference = preg_match('/^[0-9]+$/D', $reference) === 1;
Тут модифікатор D робить так, що $ відповідає тільки в кінці рядка. Для Unicode-тексту використовуйте відповідний UTF-8 патерн та модифікатор u:
<?php
$isName = preg_match('/^\p{L}+(?:[ -]\p{L}+)*$/uD', $name) === 1;
До — заміна:
<?php
$clean = mb_ereg_replace('[[:space:]]+', ' ', $text);

Після — заміна:
<?php
$clean = preg_replace('/\s+/u', ' ', $text);
if ($clean === null) {
throw new RuntimeException('Regular expression failed');
}
Обидва патерни можуть відрізнятися на деяких Unicode-пробілах. Для реальних міграцій тестуйте акцентувані символи, нові рядки, невалідний UTF-8, групи захоплення та зворотні посилання на фактичних даних проекту. Не масово замінюйте кожен виклик mb_ereg без перегляду виразу.
5. MySQLi: підготовка виразу в одному кроці
До — застаріло:
<?php
$stmt = mysqli_stmt_init($mysqli);
mysqli_stmt_prepare($stmt, 'SELECT name FROM users WHERE id = ?');
mysqli_stmt_bind_param($stmt, 'i', $userId);
mysqli_stmt_execute($stmt);
Після:
<?php
$stmt = mysqli_prepare($mysqli, 'SELECT name FROM users WHERE id = ?');
mysqli_stmt_bind_param($stmt, 'i', $userId);
mysqli_stmt_execute($stmt);
З об'єктно-орієнтованим API використовуйте $mysqli->prepare($sql) замість $mysqli->stmt_init(), за яким слідує prepare(). Зберігайте свою існуючу обробку помилок та належно закривайте вирази.
Окремий API mysqli_get_charset() також застарів. Якщо потрібна лише поточна назва кодування:
<?php
$charsetName = mysqli_character_set_name($mysqli);
Це не є заміною для всіх полів старого об'єкта інформації про кодування. Якщо код залежить від метаданих колації, перевірте, що саме потрібно, і запитайте сервер відповідно.
6. CSV: заміна застарілих методів SplFileObject для CSV
CSV-специфічні методи на SplFileObject застаріли. Для нового та мігрованого коду використовуйте потокові функції fgetcsv() та fputcsv().
До:
<?php
$file = new SplFileObject($path, 'r');
while (!$file->eof()) {
$row = $file->fgetcsv();
// Process row
}
Після:
<?php
$handle = fopen($path, 'rb');
if ($handle === false) {
throw new RuntimeException('Cannot open CSV file');
}
try {
while (($row = fgetcsv($handle, 0, ',', '"', '')) !== false) {
// Process row
}
} finally {
fclose($handle);
}
Порожній аргумент ескейпу вимикає власну механіку ескейпу PHP; протестуйте цей вибір проти формату, який експортує ваша джерельна система. Перевірте порожні рядки, заголовки, роздільники, вбудовані нові рядки та кодування. Цей приклад ілюструє зміну API, а не універсальний парсер CSV.
Для запису використовуйте fputcsv($handle, $fields, ',', '"', ''). Зберігайте очікуваний діалект оригінального файлу.
7. Ідентичність об'єкта: spl_object_hash() — це не хеш вмісту
До:
<?php
$key = spl_object_hash($object);
Після:
<?php
$key = spl_object_id($object);
Замінник повертає ціле число, а не рядок. Якщо ключі серіалізуються, зберігаються в базі даних або виставляються через API, спочатку перегляньте споживачів. Жодна з функцій не створює постійний ідентифікатор між запитами, і ID можуть бути повторно використані після знищення об'єктів. Для мапи, ключованої живою ідентичністю об'єкта, розгляньте SplObjectStorage або WeakMap, залежно від вимог до часу життя.
8. Return у finally може приховувати помилки
До — застаріло та неправильне:
<?php
function loadSettings(): array
{
try {
return readSettings();
} finally {
return []; // Overrides the result and hides exceptions
}
}
Після — збереження очищення без перезапису результату:

<?php
function loadSettings(): array
{
try {
return readSettings();
} finally {
releaseTemporaryResources();
}
}
Якщо оригінальний код навмисно повертав запасний варіант, перенесіть це рішення в блок catch з явною обробкою. Не придушуйте виняток, який повинен досягти викликача.
9. Чутлива до локалі сортування та інші менш очевидні зміни
strcoll() та прапор сортування SORT_LOCALE_STRING застаріли. Рекомендована альтернатива intl — це Collator:
<?php
$collator = new Collator('fr_FR');
$names = ['Émile', 'Alice', 'Zoé'];
$collator->sort($names);
Перевірте, що intl встановлено. Чутливе до локалі сортування — це бізнес-правило: перевірте ваш очікуваний порядок, а не припускайте, що ICU та глобальна локаль процесу завжди поводяться ідентично.
Інші пункти міграції заслуговують на явну увагу:
ArrayIterator: сортування, прапори та методи серіалізації, такі якasort(),ksort(),setFlags()таserialize(), застаріли. Сортуйте базовий масив або використовуйтеArrayObject, коли його API доречний; не припускайте, що ітератор та контейнер є взаємозамінними.- Користувацькі обробники сесій: реалізуйте
create_sid()таvalidateId(), як вимагають оновлені інтерфейси/поведінка. PHP 8.6 увімкнює суворіші налаштування сесій за замовчуванням; тестуйте логін, ротацію сесій та збереження. __debugInfo(): використовуйте неперервний тип поверненняarray; поверненняnullвже було застарілим.define(): видаліть третій аргументcase_insensitive, навіть коли вінfalse.http_build_query()таarray_walk(): передача об'єктів там, де очікуються масиви, застаріла. Конвертуйте навмисно за допомогоюget_object_vars()або явно створіть потрібний масив.metaphone(): не існує вбуденої PHP-заміни. Оберіть та протестуйте підтримуваний, мовно-придатний фонетичний алгоритм.- Зарезервовані ідентифікатори: імена, такі як
let,is,readonly(функція) таnamespace(константа класу) мають нові обмеження щодо застарілість. Перейменуйте зазначені декларації обережно. - Рефлексія: перегляньте невалідні об'єкти, передані в
ReflectionProperty::setValue(), та об'єктні аргументи, надані при виклику статичних методів.
Зверніться до повного посібника з міграції для граничних випадків, не охоплених у цьому практичному виборі.
10. Пошук застарілих викликів у існуючому проекті
Почніть з інвентаризації лише для читання. На Linux або macOS:
grep -RnE --include='*.php' \
'is_integer\(|is_long\(|is_double\(|doubleval\(|spl_object_hash\(|mb_ereg\(|mb_ereg_replace\(|mysqli_stmt_init\(|mysqli_get_charset\(' \
./src
Замініть ./src на фактичну директорію. Цей текстовий пошук може знаходити коментарі або рядки, і пропускатиме динамічні виклики, простір імен аліаси та інші застарілі API. Це початкова точка, а не повний статичний аналізатор.
Для крос-платформного варіанту пошук у файлах редактора може шукати ті самі імена. Не редагуйте vendor або основні файли CMS безпосередньо: оновіть пакет верхнього рівня або надішліть патч його мейнтейнеру.
Воспроизводимая послідовність міграції
- Зафіксуйте поточну версію PHP та увімкнені розширення.
- Зробіть резервну копію файлів та бази даних; підготуйте копію для стейджингу.
- Запустіть проект під PHP 8.6 з увімкненим логуванням застарілостей.
- Інвентаризуйте попередження за файлами та рядками, потім групуйте за API.
- Виправте власний код точними змінами; оновіть сторонні залежності окремо.
- Знову запустіть модульні/інтеграційні тести та важливі користувацькі сценарії.
- Перевірте форми, логін, сесії, емейл, платежі, заплановані завдання, імпорт/експорт CSV та доступ до БД.
- Розгорніть з планом відкату; моніторте логи помилок після релізу.
Joomla та WordPress: випуск PHP 8.6 не означає, що кожна версія CMS, розширення або плагін її підтримує. Підтвердьте сумісність з точними версіями в використанні та протестуйте стейджингове середовище спочатку. Не використовуйте оновлення як причину для безпосереднього патчингу основного коду або vendor-коду.
11. Що саме нового в PHP 8.6?
Поза застарілими функціями, реліз додає декілька можливостей мови та середовища виконання:
| Функція | Практичне використання |
|---|---|
| Часткове застосування функцій | Попередньо заповніть аргументи та отримайте callable для решти |
clamp() |
Обмежте значення між мінімумом та максимумом |
\Time\Duration |
Представте пройдений час, а не календарну дату |
SortDirection |
Вираження напрямку зростання/спадання через стандартний enum |
Io\Poll |
Підтримка опитування потоків у event-loop та I/O бібліотеках |
| Значення за замовчуванням для readonly властивостей | Спростіть вибрані оголошення незмінних класів |
Невеликий, негайно корисний приклад — це clamp():
<?php
// Before PHP 8.6
$percentage = min(100, max(0, $input));
// PHP 8.6
$percentage = clamp($input, 0, 100);
Код стає легшим для читання, але пріоритет міграції все ще повинен бути тестуванням сумісності. Інші функції не є необхідними лише для того, щоб тримати існуючий додаток працюючим. Дивіться офіційне оголошення про реліз.
12. Перед перемиканням продакшн PHP версії
Створіть PHP 8.6 як контрольоване оновлення, а не як кнопку для натискання на завантаженому продакшн сервері. Розумний чек-ліст релізу: підтримувана CMS та залежності; доступні розширення; несподівана повінь застарілостей відсутня; тести проходять; перевірена поведінка БД та сесій; протестовані бекапи; та процедура відкату.
Головне: PHP 8.6 приносить корисні функції, але його застарілі API — це часто те, з чого починається робота з обслуговування. Виправте прості аліаси спочатку, потім протестуйте поведінкові міграції — особливо regex, CSV, сесії та операції, чутливі до локалі — проти реальних даних.