Обновление FreeScout до PHP 8.5 (контрольный список Ubuntu 26.04)
Прежде чем переводить FreeScout на PHP 8.5, убедитесь, что FreeScout и каждый используемый модуль его поддерживают, затем проверьте расширения PHP, перезапустите воркер очереди и следите в журнале за deprecated since 8.5 сообщения. Ubuntu 26.04 по умолчанию устанавливает PHP 8.5, поэтому обновление операционной системы часто является причиной изменения.
Это важнее для FreeScout, чем для большинства PHP-приложений, из-за того, как FreeScout обрабатывает уведомления об устаревании.
Почему PHP 8.5 может ломать модули FreeScout
Каждый выпуск PHP объявляет устаревшими некоторые старые функции. PHP 8.5 объявляет устаревшими несколько функций, которые ничего не делали с PHP 8.0, включая curl_close(), imagedestroy(), и xml_parser_free(). Он также объявляет устаревшими некоторые граничные случаи, такие как использование null как ключ массива или передача chr() значение вне диапазона от 0 до 255.
Большинство PHP-приложений регистрируют deprecation и продолжают работу. FreeScout превращает каждое уведомление об устаревании в ошибку, поэтому один оставшийся вызов останавливает запрос или фоновую задачу, которая его встретила. Модуль может выглядеть установленным и исправным, хотя каждое его подключение завершается сбоем.
Если вы видите эти ошибки после обновления, Исправление ошибок "deprecated since 8.5" во FreeScout описывает, как найти и исправить модуль, который за это отвечает.
Перед обновлением
- Проверьте поддержку: прочитайте примечания к выпуску FreeScout и системные требования для PHP 8.5 и убедитесь, что у каждого установленного модуля есть выпуск, совместимый с PHP 8.5.
- Сначала обновите модули: установите эти обновления, пока вы всё ещё на текущей версии PHP, чтобы каждый модуль был готов до перехода.
- Резервная копия: сделайте копию каталога FreeScout, базы данных и ваших файлов конфигурации PHP.
- Тестируйте на копии: если можете, сначала выполните обновление на промежуточной копии службы поддержки.
После обновления
Проверьте версию PHP, на которой работает FreeScout
Открыть Управление > Система. Он показывает версию PHP, которую использует ваш веб-сервер, и перечисляет расширения PHP, необходимые FreeScout, отмечая любые отсутствующие.Сопоставьте PHP командной строки
Запуститьphp -vна сервере. Обработчик очереди иschedule:runcron использует PHP командной строки, который может отличаться от версии веб-сервера. Оба должны работать на одной версии с одинаковыми расширениями.Переустановите расширения и настройки
Новая версия PHP поставляется с собственными пакетами расширений иphp.iniфайлы. Установите расширения Управление > Система помечает как отсутствующие, затем повторно применяет пользовательские настройки, такие какupload_max_filesizeиpost_max_size.Настройте веб-сервер на новый PHP
Если вы используете PHP-FPM, убедитесь, что ваш веб-сервер использует сокет или службу PHP 8.5 FPM, затем перезапустите PHP-FPM и веб-сервер.Очистите кэши и перезапустите обработчик очереди
Запускайте их из каталога FreeScout, чтобы ни один процесс не продолжал работать со старым кодом:терминалphp artisan freescout:clear-cache php artisan queue:restart
Что проверить в логах
Открыть Управление > Журналы > Журналы приложения после некоторого времени использования службы поддержки. Ищите:
is deprecated since 8.5, который указывает на модуль или файл, ещё не готовый к PHP 8.5.Providing a value not in-between 0 and 255 is deprecated, изchr()вызовов.Using null as an array offset is deprecated.
Каждая запись называет файл. Путь под Modules/<Name> сообщает вам, какой модуль требует обновления.
Проверьте функции, которые создают исходящие подключения, потому что они отказывают первыми: получение почты, провайдеры ИИ, источники знаний и интеграции, такие как Linear, Jira, Slack или коннекторы магазинов. Где модуль предлагает Проверить подключение кнопка, используйте её.
Если что-то сломается
Верните FreeScout на PHP 8.4, пока ждёте обновлений. PHP 8.4 не считает эти функции устаревшими, поэтому тот же код работает там нормально. Переключите и веб-сервер, и PHP командной строки, затем перезапустите PHP-FPM, веб-сервер и обработчик очереди.