FreeScout upgraden naar PHP 8.5 (checklist voor Ubuntu 26.04)
Voordat je FreeScout naar PHP 8.5 verplaatst, bevestig dat FreeScout en elke module die je draait dit ondersteunen, controleer dan PHP-extensies, herstart de queue-worker en houd het log in de gaten voor deprecated since 8.5 berichten. Ubuntu 26.04 installeert standaard PHP 8.5, dus een upgrade van het besturingssysteem is vaak de oorzaak van de wijziging.
Dit is belangrijker voor FreeScout dan voor de meeste PHP-apps, vanwege hoe FreeScout omgaat met deprecation-meldingen.
Waarom PHP 8.5 FreeScout-modules kan breken
Elke PHP-release markeert sommige oudere functies als verouderd. PHP 8.5 markeert verschillende functies als verouderd die sinds PHP 8.0 niets meer deden, waaronder curl_close(), imagedestroy(), en xml_parser_free(). Het verouderd ook enkele randgevallen, zoals het gebruik van null als array-sleutel of het doorgeven van chr() een waarde buiten 0 tot 255.
De meeste PHP-apps loggen een deprecation en gaan door. FreeScout maakt van elke deprecation-melding een fout, dus één achtergebleven aanroep stopt het verzoek of de achtergrondtaak die erdoor werd geraakt. Een module kan geïnstalleerd en gezond lijken terwijl elke verbinding die hij maakt mislukt.
Als je deze fouten ziet na het upgraden, Los "deprecated since 8.5"-fouten op in FreeScout loopt door het vinden en oplossen van de verantwoordelijke module.
Voordat je upgradet
- Controleer ondersteuning: lees de release notes en systeemvereisten van FreeScout voor PHP 8.5 en bevestig dat elke geïnstalleerde module een PHP 8.5-compatibele release heeft.
- Werk eerst modules bij: installeer die updates terwijl je nog op je huidige PHP-versie zit, zodat elke module klaar is voor de overstap.
- Back-up: maak een kopie van de FreeScout-map, de database en je PHP-configuratiebestanden.
- Testen op een kopie: voer de upgrade indien mogelijk eerst uit op een stagingkopie van de helpdesk.
Nadat je hebt geüpgraded
Controleer de PHP-versie waarop FreeScout draait
Openen Beheren > Systeem. Het toont de PHP-versie die je webserver gebruikt en vermeldt de PHP-extensies die FreeScout nodig heeft, en markeert eventuele ontbrekende.Match de command-line PHP
Uitvoerenphp -vop de server. De queue worker en deschedule:runcron gebruikt command-line PHP, dat kan afwijken van de versie van de webserver. Beide moeten dezelfde versie met dezelfde extensies draaien.Extensies en instellingen opnieuw installeren
Een nieuwe PHP-versie komt met eigen extensiepakketten enphp.inibestanden. Installeer de extensies Beheren > Systeem markeert als ontbrekend en past vervolgens aangepaste instellingen opnieuw toe, zoalsupload_max_filesizeenpost_max_size.Wijs de webserver naar de nieuwe PHP
Als je PHP-FPM gebruikt, controleer dan of je webserver de PHP 8.5 FPM-socket of -service gebruikt, en herstart daarna PHP-FPM en de webserver.Caches wissen en de queue-worker herstarten
Voer deze uit vanuit je FreeScout-map zodat geen enkel proces oude code blijft draaien:terminalphp artisan freescout:clear-cache php artisan queue:restart
Wat te controleren in de logs
Openen Beheren > Logboeken > App-logboeken na een tijdje de helpdesk te hebben gebruikt. Zoek naar:
is deprecated since 8.5, dat verwijst naar een module of bestand dat nog niet PHP 8.5-gereed is.Providing a value not in-between 0 and 255 is deprecated, vanchr()aanroepen.Using null as an array offset is deprecated.
Elke vermelding noemt het bestand. Een pad onder Modules/<Name> vertelt je welke module een update nodig heeft.
Test de functies die uitgaande verbindingen maken, want deze falen het eerst: e-mail ophalen, AI-providers, kennisbronnen en integraties zoals Linear, Jira, Slack of winkelconnectors. Waar een module een Verbinding testen knop, gebruik deze.
Als er iets kapotgaat
Zet FreeScout terug naar PHP 8.4 terwijl je op updates wacht. PHP 8.4 behandelt deze functies niet als verouderd, dus dezelfde code draait daar normaal. Schakel zowel de webserver als de command-line PHP om en herstart vervolgens PHP-FPM, de webserver en de queue worker.