Uaktualnianie FreeScout do PHP 8.5 (lista kontrolna Ubuntu 26.04)
Przed przeniesieniem FreeScout na PHP 8.5 potwierdź, że FreeScout i każdy używany moduł go obsługują, następnie sprawdź rozszerzenia PHP, uruchom ponownie workera kolejki i obserwuj log pod kątem deprecated since 8.5 wiadomości. Ubuntu 26.04 domyślnie instaluje PHP 8.5, więc aktualizacja systemu operacyjnego często wywołuje tę zmianę.
Ma to większe znaczenie dla FreeScout niż dla większości aplikacji PHP, ze względu na sposób, w jaki FreeScout obsługuje powiadomienia o wycofaniu.
Dlaczego PHP 8.5 może psuć moduły FreeScout
Każde wydanie PHP deprecjonuje niektóre starsze funkcje. PHP 8.5 deprecjonuje kilka funkcji, które nic nie robią od PHP 8.0, w tym curl_close(), imagedestroy(), oraz xml_parser_free(). Deprecjonuje również niektóre przypadki brzegowe, takie jak używanie null jako klucz tablicy lub przekazywanie chr() wartość spoza zakresu 0 do 255.
Większość aplikacji PHP rejestruje deprecację i działa dalej. FreeScout zamienia każde ostrzeżenie o deprecacji w błąd, więc pojedyncze pozostałe wywołanie zatrzymuje żądanie lub zadanie w tle, które je napotkało. Moduł może wyglądać na zainstalowany i sprawny, podczas gdy każde jego połączenie kończy się niepowodzeniem.
Jeśli widzisz te błędy po aktualizacji, Napraw błędy "deprecated since 8.5" w FreeScout przeprowadza przez znalezienie i naprawienie odpowiedzialnego modułu.
Przed aktualizacją
- Sprawdź wsparcie: przeczytaj informacje o wydaniu FreeScout i wymagania systemowe dla PHP 8.5 oraz potwierdź, że każdy zainstalowany moduł ma wydanie zgodne z PHP 8.5.
- Najpierw zaktualizuj moduły: zainstaluj te aktualizacje, gdy nadal używasz bieżącej wersji PHP, aby każdy moduł był gotowy przed przeniesieniem.
- Kopia zapasowa: zrób kopię katalogu FreeScout, bazy danych i plików konfiguracyjnych PHP.
- Przetestuj na kopii: jeśli możesz, najpierw uruchom aktualizację na kopii testowej help desku.
Po aktualizacji
Sprawdź wersję PHP, na której działa FreeScout
Otwórz Zarządzaj > System. Pokazuje wersję PHP używaną przez Twój serwer WWW i wyświetla rozszerzenia PHP wymagane przez FreeScout, oznaczając wszelkie brakujące.Dopasuj PHP wiersza poleceń
Uruchomphp -vna serwerze. Proces roboczy kolejki ischedule:runcron używa PHP z wiersza poleceń, który może różnić się od wersji serwera WWW. Oba muszą działać na tej samej wersji z tymi samymi rozszerzeniami.Przeinstaluj rozszerzenia i ustawienia
Nowa wersja PHP ma własne pakiety rozszerzeń iphp.inipliki. Zainstaluj rozszerzenia Zarządzaj > System oznacza jako brakujące, a następnie ponownie zastosuj ustawienia niestandardowe, takie jakupload_max_filesizeorazpost_max_size.Wskaż serwerowi WWW nowy PHP
Jeśli używasz PHP-FPM, potwierdź, że Twój serwer WWW używa gniazda lub usługi PHP 8.5 FPM, a następnie uruchom ponownie PHP-FPM i serwer WWW.Wyczyść pamięci podręczne i uruchom ponownie proces roboczy kolejki
Uruchom je z katalogu FreeScout, aby żaden proces nie działał na starym kodzie:terminalphp artisan freescout:clear-cache php artisan queue:restart
Co sprawdzić w logach
Otwórz Zarządzaj > Dzienniki > Dzienniki aplikacji po pewnym czasie korzystania z help desku. Wyszukaj:
is deprecated since 8.5, który wskazuje moduł lub plik, który nie jest jeszcze gotowy na PHP 8.5.Providing a value not in-between 0 and 255 is deprecated, zchr()wywołań.Using null as an array offset is deprecated.
Każdy wpis podaje nazwę pliku. Ścieżka w Modules/<Name> informuje, który moduł wymaga aktualizacji.
Przetestuj funkcje, które wykonują połączenia wychodzące, ponieważ one zawodzą jako pierwsze: pobieranie poczty, dostawcy AI, źródła wiedzy i integracje takie jak Linear, Jira, Slack lub konektory sklepów. Gdy moduł oferuje Przetestuj połączenie przycisku, użyj go.
Jeśli coś się zepsuje
Przywróć FreeScout do PHP 8.4, czekając na aktualizacje. PHP 8.4 nie traktuje tych funkcji jako przestarzałych, więc ten sam kod działa tam normalnie. Przełącz zarówno serwer WWW, jak i PHP wiersza poleceń, a następnie uruchom ponownie PHP-FPM, serwer WWW i worker kolejki.