Оновлення 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-застосунків реєструють попередження про застарілість і продовжують роботу. 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, вебсервер і воркер черги.