Технологическая отрасль

PHP 8.6: Новые функции, устаревшие функции и практическое руководство по миграции

PHP 8.6: New Features, Deprecated Functions, and a Practical Migration Guide

Обновите до PHP 8.6 с примерами до и после для устаревших функций PHP, MySQLi, mbstring, CSV, сессий и практическим чеклистом миграции.

PHP 8.6.0 был выпущен 19 ноября 2026 года. Главные нововведения интересны, но для разработчиков, поддерживающих реальные сайты, часто задача в том, чтобы какие строки существующего кода начнут выводить уведомления об устаревании, и как их следует переписать?

В этом руководстве сначала отводится место работы по миграции. В каждом примере идентифицируется устаревший API, показывается замена и отмечается, где механическая поисковая замена может быть опасной. Уведомление об устаревании не то же самое, что немедленная фатальная ошибка: оно предупреждает, что коду требуется внимание, часто до того, как в будущей крупной версии удалит API.

PHP 8.6 migration path: inventory, staging, logs, fixes and regression tests

1. Проверьте среду выполнения перед работой с production

Выполните эти команды в том же PHP-окружении, которое обслуживает приложение (CLI и веб-PHP могут использовать разные бинарные файлы и настройки):

php -v
php -m
php --ini

Проверьте расширения, используемые проектом, особенно mbstring, mysqli и intl. Убедитесь, что фреймворк, CMS, расширения и среда размещения явно поддерживают PHP 8.6; не считайте совместимость установленной лишь потому, что сайт запущен.

В staging-окружении включите логирование всех ошибок, при этом не выводя диагностические сообщения в публичный HTML:

<?php
error_reporting(E_ALL);
ini_set('log_errors', '1');
ini_set('display_errors', '0');

Эти настройки runtime полезны для контролируемого теста. Предпочтите настраивать логирование на уровне сервера для долгоживущих окружений; убедитесь, что журнал ошибок доступен для записи и является приватным. Сообщение 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() on a stream Пересмотрите позицию потока и настройки CSV
SplFileObject::fputcsv() fputcsv() on a stream Передайте разделитель, enclosure и escape явно
strcoll() Collator::compare() Требуется intl; выберите локаль
SORT_LOCALE_STRING Collator::sort() / asort() Поведение локали может измениться
spl_classes() ReflectionExtension::getClassNames() Проверьте подходящее расширение
Third argument of define() Omit the argument The old case-insensitive mode is gone
return in finally Return outside finally Avoid suppressing exceptions
Object passed to array_walk() get_object_vars() first By-reference edits may no longer mutate the object
metaphone() A maintained phonetic implementation No drop-in core replacement

Некоторые 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);
Illustration of the article's main concept

После — замена:

<?php
$clean = preg_replace('/\s+/u', ' ', $text);
if ($clean === null) {
    throw new RuntimeException('Regular expression failed');
}

Эти два шаблона могут различаться в отношении некоторых пробелов Unicode. Для реальных миграций тестируйте символы с диакритическими знаками, переводы строк, недопустимый UTF-8, группы захвата и обратные ссылки на реальные данные проекта. Не заменяйте все вызовы mb_ereg без проверки выражения.

5. MySQLi: подготовьте statement за один шаг

До — устаревший:

<?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(). Сохраняйте существующую обработку ошибок и корректно закрывайте statements.

Отдельный API mysqli_get_charset() также устарел. Если нужно только текущее имя кодовой страницы:

<?php
$charsetName = mysqli_character_set_name($mysqli);

Это не замена для всех полей старого объекта информации о кодовой странице. Если код зависит от метаданных collation, изучите, что ему действительно нужно, и соответствующим образом запросите сервер.

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);
}

Пустой аргумент escape отключает проприетарный механизм escape PHP; проверьте это решение на соответствие формату, который экспортирует источник. Проверьте пустые строки, заголовки, разделители, встроенные переводы строк и кодировку. Этот пример иллюстрирует изменение API, а не универсальный CSV-парсер.

Для записи используйте fputcsv($handle, $fields, ',', '"', ''). Сохраняйте ожидаемый диалект исходного файла.

7. Object identity: spl_object_hash() — это не хэш содержимого

До:

<?php
$key = spl_object_hash($object);

После:

<?php
$key = spl_object_id($object);

Замена возвращает integer, а не строку. Если ключи сериализуются, хранятся в базе данных или доступны через API, прежде проверьте потребителей. Ни одна из функций не создаёт постоянный идентификатор между запросами, и идентификаторы могут повторно использоваться после уничтожения объектов. Для map, индексированного по живой идентичности объекта, рассмотрите SplObjectStorage или WeakMap в зависимости от требований к времени жизни.

8. Return в finally может скрывать ошибки

До — устаревший и вводящий в заблуждение:

<?php
function loadSettings(): array
{
    try {
        return readSettings();
    } finally {
        return []; // Overrides the result and hides exceptions
    }
}

После — сохранять cleanup без переопределения результата:

Technical workflow illustration
<?php
function loadSettings(): array
{
    try {
        return readSettings();
    } finally {
        releaseTemporaryResources();
    }
}

Если исходный код намеренно возвращал fallback, перенесите это решение в блок 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 подходит; не предполагайте, что итератор и контейнер взаимозаменяемы.
  • Custom session handlers: реализуйте create_sid() и validateId(), как требуют обновлённые интерфейсы/поведение. PHP 8.6 включает более строгие настройки сессий; протестируйте вход, rotation сессии и persistence.
  • __debugInfo(): используйте non-nullable возвращаемый тип array; возвращать null уже было deprecated.
  • define(): удалите третий аргумент case_insensitive, даже если он false.
  • http_build_query() and array_walk(): передача объектов туда, где ожидаются arrays, устарела. Конвертируйте осознанно с помощью get_object_vars() или явно создайте нужный массив.
  • metaphone(): нет эквивалентной встроенной замены PHP. Выберите и протестируйте поддерживаемый язык соответствующий фонетический алгоритм.
  • Reserved identifiers: имена, такие как let, is, readonly (function) и namespace (class constant), имеют новые ограничения устаревания. Видоизменяйте затронутые объявления осторожно.
  • Reflection: проверьте недопустимые объекты, переданные в ReflectionProperty::setValue(), и объектные аргументы, передаваемые при вызове static methods.

Обратитесь к полному руководству по миграции для edge cases, не рассмотренных в этом практическом руководстве.

10. Поиск устаревших вызовов в существующем проекте

Начните с read-only inventory. В 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 на реальный каталог. Этот текстовый поиск может соответствовать комментариям или строкам и не найдёт dynamic calls, namespaced aliases и другие устаревшие API. Это отправная точка, не полноценный статический анализатор.

Для кроссплатформенного варианта можно использовать Find in Files в редакторе. Не редактируйте vendor или CMS core файлы напрямую: обновьте upstream package или отправьте patch его maintainer.

A safe PHP 8.6 migration workflow with staging, log review and regression testing

A reproducible migration sequence

  1. Record the current PHP version and enabled extensions.
  2. Back up files and database; prepare a staging copy.
  3. Run the project under PHP 8.6 with deprecation logging enabled.
  4. Inventory warnings by file and line, then group by API.
  5. Fix first-party code with targeted changes; update third-party dependencies separately.
  6. Rerun unit/integration tests and important user journeys.
  7. Check forms, login, sessions, email, payments, scheduled jobs, CSV import/export and database access.
  8. Deploy with a rollback plan; monitor error logs after release.

Joomla and WordPress: PHP 8.6 being released does not mean every CMS version, extension or plugin supports it. Confirm compatibility with the exact versions in use and test a staging environment first. Do not use the upgrade as a reason to patch core or vendor code directly.

11. What is actually new in PHP 8.6?

Beyond deprecations, the release adds several language and runtime features:

Feature Practical use
Partial function application Pre-fill arguments and obtain a callable for the remaining ones
clamp() Constrain a value between a minimum and maximum
\Time\Duration Represent elapsed time rather than a calendar date
SortDirection Express ascending/descending direction through a standard enum
Io\Poll Support stream polling in event-loop and I/O libraries
Defaults for readonly properties Simplify selected immutable class declarations

A small, immediately useful example is clamp():

<?php
// Before PHP 8.6
$percentage = min(100, max(0, $input));

// PHP 8.6
$percentage = clamp($input, 0, 100);

The code is easier to read, but the migration priority should still be compatibility testing. The other features are not necessary just to keep an existing application working. See the official release announcement.

12. Before you switch the production PHP version

Treat PHP 8.6 as a controlled upgrade, not a button to click on a busy production server. A sensible release checklist is: supported CMS and dependencies; available extensions; no unexpected deprecation flood; tests passing; verified database and session behavior; tested backups; and a rollback procedure.

Bottom line: PHP 8.6 brings useful features, but its deprecations are often where maintenance work begins. Fix the straightforward aliases first, then test behavioral migrations—especially regex, CSV, sessions and locale-sensitive operations—against real data.

Official sources