Миграционный адаптер позволяет сохранить старые вызовы к базе. Но обработку ошибок, кодировки и безопасность SQL всё равно нужно проверить.
Опубликованный 24 октября технический кейс переноса 32 старых проектов на PHP 8.5 вновь привлёк внимание к совместимости mysql_* и mysqli. Предложенный подход — подключить промежуточный слой, который принимает прежние вызовы приложения и передаёт их современному драйверу. Это полезная отправная точка для разговора о миграции накопленного кода.
Расширение mysql было удалено ещё в PHP 7. Поэтому простой переход с PHP 5 на актуальную версию останавливается уже на обращении к отсутствующей функции. Пользовательский адаптер может вернуть знакомые имена и перенаправить операции в mysqli, сохранив значительную часть вызывающего кода.
Совместимость — это поведение
Замены названия функции недостаточно. Старое приложение может ожидать последнее открытое соединение, определённый тип результата, конкретное значение при ошибке или особую обработку пустой выборки. Если сохранить сигнатуру, но поменять эти ожидания, ошибка проявится уже внутри бизнес-логики.
Отдельный пример — режим ошибок mysqli. Начиная с PHP 8.1 по умолчанию включены MYSQLI_REPORT_ERROR и MYSQLI_REPORT_STRICT: многие ошибки сопровождаются исключением. Старый код нередко проверяет возвращённое false. Адаптер должен осознанно согласовать эти модели, а не превращать ошибку запроса в необработанное исключение посреди страницы.
Эмблема PHP 8.5. Современная версия среды не возвращает удалённое расширение mysql: совместимость обеспечивает код приложения.
С чего начать проверку
Сначала стоит составить перечень реально используемых mysql_* функций. Небольшому сайту может быть нужен ограниченный набор операций; сложный проект способен зависеть от поведения редко вызываемых функций. По этому перечню проще определить, что обязан поддерживать переходный слой и какие пути пока останутся несовместимыми.
Затем полезно зафиксировать результаты характерных сценариев на исходной системе: выборка без строк, неудачное подключение, ошибочный запрос, получение идентификатора вставки и работа нескольких соединений. На новой среде проверяют те же входные данные и сравнивают наблюдаемое поведение приложения. Тест только главной страницы такой проверки не заменяет.
Кодировку соединения нужно задавать явно и проверять на реальных данных: кириллице, символах вне базового набора и кавычках. Отдельного внимания требуют места, где результат запроса раньше считался ресурсом. Объект mysqli и объект результата не обязаны проходить прежние проверки типов.
Переходный слой не завершает миграцию
Адаптер решает узкую задачу взаимодействия с базой. Удалённые функции языка, изменённые правила типов и несовместимые библиотеки остаются отдельными задачами. Поэтому обещание переноса без изменения бизнес-логики нужно проверять на конкретном приложении и его зависимостях.
Сохранение старых SQL-строк также сохраняет их прежние риски. Если пользовательский ввод склеивался с запросом, новая функция-обёртка автоматически не сделает его параметризованным. После восстановления работы разумно постепенно переносить такие участки на подготовленные выражения mysqli или PDO.
Хороший результат срочной миграции — работающий сервис с понятным списком технического долга. У слоя совместимости должны быть границы, тесты и план сокращения: иначе временный мост станет ещё одной платформой, которую придётся поддерживать годами.