Napraw błędy "deprecated since 8.5" w FreeScout
Jeśli funkcje FreeScout przestaną działać po przejściu na PHP 8.5, sprawdź log FreeScout pod kątem komunikatów kończących się na is deprecated since 8.5. Każdy z nich wskazuje plik, który go spowodował. Zaktualizuj moduł lub komponent FreeScout, do którego należy ten plik, wyczyść pamięć podręczną i uruchom ponownie proces roboczy kolejki.
PHP 8.5 to domyślna wersja PHP w Ubuntu 26.04, więc te błędy często pojawiają się zaraz po aktualizacji systemu operacyjnego.
Objawy
Sam FreeScout zwykle nadal się ładuje, ale poszczególne funkcje zawodzą:
- Moduł Przetestuj połączenie przycisk zgłasza, że nie może połączyć się z serwerem.
- Zadania w tle, takie jak synchronizacja, pobieranie lub generowanie szkiców AI, przestają dawać wyniki.
- Integracja, która działała przed aktualizacją, przestaje odpowiadać.
- Strona ustawień lub akcja zwraca błąd serwera.
Zdradliwym znakiem jest to, że curl do tego samego adresu działa z wiersza poleceń serwera, podczas gdy moduł zgłasza, że nie może się połączyć.
Komunikaty dziennika
Otwórz log aplikacji FreeScout (Zarządzaj > Dzienniki > Dzienniki aplikacji, lub storage/logs/laravel-<date>.log na serwerze). Przestarzałości PHP 8.5 wyglądają tak:
Function curl_close() is deprecated since 8.5, as it has no effect since PHP 8.0
Function imagedestroy() is deprecated since 8.5, as it has no effect since PHP 8.0
chr(): Providing a value not in-between 0 and 255 is deprecated
Using null as an array offset is deprecated, use an empty string insteadModuł zwykle dodaje własny kontekst wokół wiadomości, taki jak zadanie lub żądanie, które zawiodło.
Dlaczego to się dzieje
PHP 8.5 deprecjonuje kilka starszych funkcji i przypadków brzegowych. Kilka z nich, takich jak curl_close() oraz imagedestroy(), nic nie robią od PHP 8.0, więc starszy kod nadal je wywołuje.
W większości aplikacji PHP deprecation to tylko ostrzeżenie w logu. FreeScout traktuje każde ostrzeżenie o deprecation jako błąd. Żądanie może więc zakończyć się pomyślnie, a potem niepowodzeniem na pozostałym wywołaniu, takim jak curl_close(). Twoje adresy URL, klucze API, sieć i rozszerzenia PHP są zwykle w porządku.
Poprawka: zaktualizuj dotknięty kod
Znajdź plik we wpisie logu
Otwórz pełny wpis dziennika. Ścieżka w sekcjiModules/<Name>wskazuje na ten moduł. Ścieżka podapp/lubvendor/wskazuje na sam FreeScout.Zaktualizuj ten moduł lub FreeScout
Otwórz Zarządzaj > Moduły i zainstaluj wszelkie dostępne aktualizacje, lub sprawdź witrynę dewelopera modułu pod kątem wydania zgodnego z PHP 8.5. Dla samego FreeScout zaktualizuj do najnowszego wydania.Wyczyść pamięć podręczną i uruchom ponownie proces roboczy kolejki
Uruchom je z katalogu FreeScout. Worker kolejki jest procesem długotrwałym, więc działa na starym kodzie aż do ponownego uruchomienia.terminalphp artisan freescout:clear-cache php artisan queue:restartPonów to, co się nie powiodło
Kliknij Przetestuj połączenie ponownie, uruchom ponownie każdą synchronizację, która się zatrzymała, i potwierdź, że nowe zadania w tle się kończą.
Potwierdź, że zadziałało
- Funkcja, która zawiodła, znów działa.
- Nowe wpisy w dzienniku nie wspominają już
is deprecated since 8.5.
Jeśli aktualizacja nie jest jeszcze dostępna
Uruchom FreeScout na PHP 8.4, dopóki deweloper nie wyda poprawki. PHP 8.4 nie traktuje tych funkcji jako przestarzałych, więc ten sam kod działa tam normalnie.
Przełącz obie wersje PHP używane przez FreeScout. Zarządzaj > System pokazuje wersję uruchomioną przez Twój serwer WWW. Worker kolejki i cron używają PHP z wiersza poleceń, więc sprawdź php -v również na serwerze. Następnie uruchom ponownie PHP-FPM lub serwer WWW oraz proces roboczy kolejki.
Pełny przewodnik przenoszenia znajdziesz w Uaktualnianie FreeScout do PHP 8.5.
ReplyRabbit i PHP 8.5