Oppgradere FreeScout til PHP 8.5 (sjekkliste for Ubuntu 26.04)
Før du flytter FreeScout til PHP 8.5, bekreft at FreeScout og hver modul du kjører støtter det, sjekk deretter PHP-utvidelser, start køarbeideren på nytt og følg med i loggen etter deprecated since 8.5 meldinger. Ubuntu 26.04 installerer PHP 8.5 som standard, så en operativsystemoppgradering er ofte det som utløser endringen.
Dette betyr mer for FreeScout enn for de fleste PHP-apper, på grunn av hvordan FreeScout håndterer avviklingsvarsler.
Hvorfor PHP 8.5 kan ødelegge FreeScout-moduler
Hver PHP-utgivelse avvikler noen eldre funksjoner. PHP 8.5 avvikler flere funksjoner som ikke har gjort noe siden PHP 8.0, inkludert curl_close(), imagedestroy(), og xml_parser_free(). Det avvikler også noen kanttilfeller, som å bruke null som en array-nøkkel eller sende chr() en verdi utenfor 0 til 255.
De fleste PHP-apper logger en utfasingsadvarsel og fortsetter. FreeScout gjør hver utfasingsvarsel om til en feil, så et enkelt gjenværende kall stopper forespørselen eller bakgrunnsjobben som traff det. En modul kan se installert og sunn ut mens hver tilkobling den gjør, feiler.
Hvis du ser disse feilene etter oppgradering, Fiks "deprecated since 8.5"-feil i FreeScout går gjennom hvordan du finner og retter modulen som er ansvarlig.
Før du oppgraderer
- Sjekk støtte: les FreeScouts utgivelsesnotater og systemkrav for PHP 8.5, og bekreft at hver installert modul har en PHP 8.5-kompatibel utgivelse.
- Oppdater moduler først: installer disse oppdateringene mens du fortsatt er på din nåværende PHP-versjon, slik at hver modul er klar før flyttingen.
- Sikkerhetskopier: ta en kopi av FreeScout-katalogen, databasen og PHP-konfigurasjonsfilene dine.
- Test på en kopi: hvis du kan, kjør oppgraderingen på en testkopi av helpdesken først.
Etter at du oppgraderer
Sjekk PHP-versjonen FreeScout kjører
Åpne Administrer > System. Den viser PHP-versjonen webserveren din bruker og lister opp PHP-utvidelsene FreeScout trenger, og flagger eventuelle som mangler.Match kommandolinje-PHP-en
Kjørphp -vpå serveren. Køarbeideren ogschedule:runcron bruker kommandolinje-PHP, som kan avvike fra webserverens versjon. Begge må kjøre samme versjon med samme utvidelser.Reinstaller utvidelser og innstillinger
En ny PHP-versjon kommer med sine egne utvidelsespakker ogphp.inifiler. Installer utvidelsene Administrer > System markerer som manglende, og bruk deretter egendefinerte innstillinger på nytt somupload_max_filesizeogpost_max_size.Pek webserveren mot den nye PHP-versjonen
Hvis du bruker PHP-FPM, bekreft at webserveren din bruker PHP 8.5 FPM-socketen eller -tjenesten, og start deretter PHP-FPM og webserveren på nytt.Tøm cacher og start køarbeideren på nytt
Kjør disse fra FreeScout-katalogen din slik at ingen prosess fortsetter å kjøre gammel kode:terminalphp artisan freescout:clear-cache php artisan queue:restart
Hva du bør sjekke i loggene
Åpne Administrer > Logger > Applogger etter å ha brukt helpdesken en stund. Søk etter:
is deprecated since 8.5, som peker til en modul eller fil som ennå ikke er klar for PHP 8.5.Providing a value not in-between 0 and 255 is deprecated, frachr()kall.Using null as an array offset is deprecated.
Hver oppføring navngir filen. En sti under Modules/<Name> forteller deg hvilken modul som trenger en oppdatering.
Test funksjonene som lager utgående tilkoblinger, fordi disse feiler først: henting av e-post, AI-leverandører, kunnskapskilder og integrasjoner som Linear, Jira, Slack eller butikkoblinger. Der en modul tilbyr en Test tilkobling knappen, bruk den.
Hvis noe går i stykker
Flytt FreeScout tilbake til PHP 8.4 mens du venter på oppdateringer. PHP 8.4 behandler ikke disse funksjonene som utdaterte, så den samme koden kjører normalt der. Bytt både webserveren og kommandolinje-PHP-en, og start deretter PHP-FPM, webserveren og køarbeideren på nytt.