Ret "deprecated since 8.5"-fejl i FreeScout
Hvis FreeScout-funktioner holder op med at virke, efter du skifter til PHP 8.5, skal du tjekke FreeScout-loggen for meddelelser, der slutter med is deprecated since 8.5. Hver af dem angiver den fil, der forårsagede den. Opdater det modul eller den FreeScout-komponent, der ejer den fil, tøm cachen, og genstart kø-workeren.
PHP 8.5 er standard PHP-versionen på Ubuntu 26.04, så disse fejl vises ofte lige efter en opgradering af operativsystemet.
Symptomer
FreeScout indlæses normalt stadig, men enkelte funktioner fejler:
- Et moduls Test forbindelse knappen rapporterer, at den ikke kan nå en server.
- Baggrundsjob, såsom synkronisering, hentning eller AI-udkast, holder op med at give resultater.
- En integration, der virkede før opgraderingen, går i stå.
- En indstillingsside eller handling returnerer en serverfejl.
Det afslørende tegn er, at curl til samme adresse virker fra serverens kommandolinje, mens modulet siger, at det ikke kan forbinde.
Logbeskederne
Åbn FreeScouts applikationslog (Administrer > Logs > App Logs, eller storage/logs/laravel-<date>.log på serveren). PHP 8.5-forældelser ser sådan ud:
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 insteadModulet tilføjer normalt sin egen kontekst omkring meddelelsen, såsom det job eller den anmodning, der fejlede.
Hvorfor det sker
PHP 8.5 forældede nogle ældre funktioner og kanttilfælde. Flere, såsom curl_close() og imagedestroy(), har ikke gjort noget siden PHP 8.0, så ældre kode kalder dem stadig.
I de fleste PHP-apps er en deprecation kun en advarsel i loggen. FreeScout behandler hver deprecation-notice som en fejl. Så en anmodning kan gennemføres med succes og derefter fejle på et efterladt kald som curl_close(). Dine URL'er, API-nøgler, netværk og PHP-udvidelser er normalt i orden.
Ret: opdater den berørte kode
Find filen i logposten
Åbn den fulde logpost. En sti underModules/<Name>peger på det modul. En sti underapp/ellervendor/peger på FreeScout selv.Opdater det modul eller FreeScout
Åbn Administrer > Moduler og installer eventuelle tilgængelige opdateringer, eller tjek moduludviklerens websted for en PHP 8.5-kompatibel udgivelse. For FreeScout selv skal du opdatere til den nyeste udgivelse.Ryd cachen, og genstart kø-workeren
Kør disse fra din FreeScout-mappe. Køarbejderen er en langvarig proces, så den beholder den gamle kode, indtil den genstarter.terminalphp artisan freescout:clear-cache php artisan queue:restartPrøv igen med det, der fejlede
Klik Test forbindelse igen, genkør enhver synkronisering, der stoppede, og bekræft, at nye baggrundsjob fuldføres.
Bekræft, at det virkede
- Funktionen, der fejlede, virker igen.
- Nye logposter nævner ikke længere
is deprecated since 8.5.
Hvis der ikke er nogen opdatering tilgængelig endnu
Kør FreeScout på PHP 8.4, indtil udvikleren udgiver en rettelse. PHP 8.4 behandler ikke disse funktioner som forældede, så den samme kode kører normalt der.
Skift begge PHP-versioner, som FreeScout bruger. Administrer > System viser den version, din webserver kører. Køarbejderen og cron bruger kommandolinje-PHP, så tjek php -v på serveren også. Genstart derefter PHP-FPM eller din webserver og kø-workeren.
For den fulde flytning, se Opgradering af FreeScout til PHP 8.5.
ReplyRabbit og PHP 8.5