Opgradering af FreeScout til PHP 8.5 (Ubuntu 26.04-tjekliste)
Før du flytter FreeScout til PHP 8.5, skal du bekræfte, at FreeScout og alle moduler, du kører, understøtter det, derefter kontrollere PHP-udvidelser, genstarte kø-workeren og holde øje med loggen for deprecated since 8.5 meddelelser. Ubuntu 26.04 installerer PHP 8.5 som standard, så en opgradering af operativsystemet er ofte det, der udløser ændringen.
Dette betyder mere for FreeScout end for de fleste PHP-apps på grund af måden, FreeScout håndterer forældelsesmeddelelser på.
Hvorfor PHP 8.5 kan ødelægge FreeScout-moduler
Hver PHP-udgivelse forælder nogle ældre funktioner. PHP 8.5 forælder flere funktioner, der ikke har gjort noget siden PHP 8.0, herunder curl_close(), imagedestroy(), og xml_parser_free(). Den forældet også nogle kanttilfælde, såsom brug af null som en array-nøgle eller videregivelse af chr() en værdi uden for 0 til 255.
De fleste PHP-apps logger en deprecation og fortsætter. FreeScout gør hver deprecation-notice til en fejl, så et enkelt tilbageværende kald stopper den anmodning eller baggrundsopgave, der ramte det. Et modul kan se installeret og sundt ud, mens hver forbindelse, det opretter, fejler.
Hvis du ser disse fejl efter opgradering, Ret "deprecated since 8.5"-fejl i FreeScout gennemgår hvordan du finder og retter det modul, der er ansvarligt.
Før du opgraderer
- Tjek support: læs FreeScouts release notes og systemkrav for PHP 8.5, og bekræft at hvert installeret modul har en PHP 8.5-kompatibel udgivelse.
- Opdater moduler først: installer disse opdateringer, mens du stadig er på din nuværende PHP-version, så hvert modul er klar før flytningen.
- Sikkerhedskopier: tag en kopi af FreeScout-mappen, databasen og dine PHP-konfigurationsfiler.
- Test på en kopi: hvis du kan, skal du køre opgraderingen på en staging-kopi af helpdesken først.
Efter du opgraderer
Tjek den PHP-version, FreeScout kører
Åbn Administrer > System. Den viser den PHP-version, din webserver bruger, og lister de PHP-udvidelser, FreeScout kræver, og markerer dem, der mangler.Match kommandolinjens PHP
Kørphp -vpå serveren. Kø-workeren ogschedule:runcron bruge kommandolinje-PHP, som kan afvige fra webserverens version. Begge skal køre samme version med samme udvidelser.Geninstaller udvidelser og indstillinger
En ny PHP-version kommer med sine egne udvidelsespakker ogphp.inifiler. Installer udvidelserne Administrer > System markerer som manglende og anvender derefter brugerdefinerede indstillinger igen såsomupload_max_filesizeogpost_max_size.Peg webserveren mod den nye PHP
Hvis du bruger PHP-FPM, skal du bekræfte, at din webserver bruger PHP 8.5 FPM-socketen eller -tjenesten, og derefter genstarte PHP-FPM og webserveren.Ryd caches, og genstart kø-workeren
Kør disse fra din FreeScout-mappe, så ingen proces fortsætter med at køre gammel kode:terminalphp artisan freescout:clear-cache php artisan queue:restart
Hvad du skal kontrollere i logfilerne
Åbn Administrer > Logs > App Logs efter at have brugt supportsystemet et stykke tid. Søg efter:
is deprecated since 8.5, som peger på et modul eller en fil, der endnu ikke er klar til PHP 8.5.Providing a value not in-between 0 and 255 is deprecated, frachr()kald.Using null as an array offset is deprecated.
Hver post angiver filen. En sti under Modules/<Name> fortæller dig, hvilket modul der skal opdateres.
Test de funktioner, der opretter udgående forbindelser, fordi de fejler først: hentning af mail, AI-udbydere, videnkilder og integrationer som Linear, Jira, Slack eller butiksconnectors. Hvor et modul tilbyder en Test forbindelse knap, brug den.
Hvis noget går i stykker
Flyt FreeScout tilbage til PHP 8.4, mens du venter på opdateringer. PHP 8.4 behandler ikke disse funktioner som deprecated, så den samme kode kører normalt der. Skift både webserveren og kommandolinjens PHP, og genstart derefter PHP-FPM, webserveren og queue-workeren.