Uppgradera FreeScout till PHP 8.5 (checklista för Ubuntu 26.04)
Innan du flyttar FreeScout till PHP 8.5, bekräfta att FreeScout och varje modul du kör stöder det, kontrollera sedan PHP-tillägg, starta om köarbetaren och håll utkik i loggen efter deprecated since 8.5 meddelanden. Ubuntu 26.04 installerar PHP 8.5 som standard, så en operativsystemuppgradering är ofta det som utlöser ändringen.
Detta är viktigare för FreeScout än för de flesta PHP-appar, på grund av hur FreeScout hanterar föråldringsmeddelanden.
Varför PHP 8.5 kan bryta FreeScout-moduler
Varje PHP-version avskriver vissa äldre funktioner. PHP 8.5 avskriver flera funktioner som inte har gjort något sedan PHP 8.0, inklusive curl_close(), imagedestroy(), och xml_parser_free(). Det avskriver även vissa kantfall, såsom att använda null som en array-nyckel eller skicka chr() ett värde utanför 0 till 255.
De flesta PHP-appar loggar en föråldringsvarning och fortsätter. FreeScout gör varje föråldringsvarning till ett fel, så ett enda kvarvarande anrop stoppar den begäran eller bakgrundsjobb som träffade det. En modul kan se installerad och frisk ut medan varje anslutning den gör misslyckas.
Om du ser dessa fel efter uppgraderingen, Åtgärda "deprecated since 8.5"-fel i FreeScout går igenom hur du hittar och åtgärdar modulen som är ansvarig.
Innan du uppgraderar
- Kontrollera support: läs FreeScouts versionsinformation och systemkrav för PHP 8.5 och bekräfta att varje installerad modul har en PHP 8.5-kompatibel version.
- Uppdatera moduler först: installera dessa uppdateringar medan du fortfarande är på din nuvarande PHP-version, så att varje modul är redo före flytten.
- Säkerhetskopiera: ta en kopia av FreeScout-katalogen, databasen och dina PHP-konfigurationsfiler.
- Testa på en kopia: om du kan, kör uppgraderingen på en stagingkopia av helpdesken först.
Efter uppgraderingen
Kontrollera vilken PHP-version FreeScout kör
Öppna Hantera > System. Det visar den PHP-version din webbserver använder och listar de PHP-tillägg FreeScout behöver, och flaggar eventuella som saknas.Matcha kommandorads-PHP
Körphp -vpå servern. Köarbetaren ochschedule:runcron använder kommandorads-PHP, vilket kan skilja sig från webbserverns version. Båda måste köra samma version med samma tillägg.Installera om tillägg och inställningar
En ny PHP-version kommer med sina egna tilläggspaket ochphp.inifiler. Installera tilläggen Hantera > System markerar som saknade och tillämpar sedan anpassade inställningar igen såsomupload_max_filesizeochpost_max_size.Peka webbservern mot den nya PHP-versionen
Om du använder PHP-FPM, bekräfta att din webbserver använder PHP 8.5 FPM-socketen eller -tjänsten och starta sedan om PHP-FPM och webbservern.Rensa cachar och starta om köarbetaren
Kör dessa från din FreeScout-katalog så att ingen process fortsätter köra gammal kod:terminalphp artisan freescout:clear-cache php artisan queue:restart
Vad man ska kontrollera i loggarna
Öppna Hantera > Loggar > Apploggar efter att ha använt helpdesken ett tag. Sök efter:
is deprecated since 8.5, som pekar på en modul eller fil som ännu inte är redo för PHP 8.5.Providing a value not in-between 0 and 255 is deprecated, frånchr()anrop.Using null as an array offset is deprecated.
Varje post namnger filen. En sökväg under Modules/<Name> talar om vilken modul som behöver en uppdatering.
Testa funktionerna som gör utgående anslutningar, eftersom dessa misslyckas först: hämtning av e-post, AI-leverantörer, kunskapskällor och integrationer som Linear, Jira, Slack eller butiksanslutningar. Där en modul erbjuder en Testa anslutning knappen, använd den.
Om något går sönder
Flytta tillbaka FreeScout till PHP 8.4 medan du väntar på uppdateringar. PHP 8.4 behandlar inte dessa funktioner som föråldrade, så samma kod körs normalt där. Byt både webbservern och kommandorads-PHP, starta sedan om PHP-FPM, webbservern och köarbetaren.