FreeScout auf PHP 8.5 upgraden (Ubuntu 26.04 Checkliste)
Bevor Sie FreeScout auf PHP 8.5 umstellen, bestätigen Sie, dass FreeScout und jedes von Ihnen betriebene Modul dies unterstützen, prüfen Sie dann die PHP-Erweiterungen, starten Sie den Queue-Worker neu und beobachten Sie das Log auf deprecated since 8.5 Nachrichten. Ubuntu 26.04 installiert standardmäßig PHP 8.5, sodass ein Betriebssystem-Upgrade oft der Auslöser für die Änderung ist.
Dies ist bei FreeScout wichtiger als bei den meisten PHP-Apps, wegen der Art, wie FreeScout Deprecation-Hinweise behandelt.
Warum PHP 8.5 FreeScout-Module beschädigen kann
Jede PHP-Version stuft einige ältere Funktionen als veraltet ein. PHP 8.5 stuft mehrere Funktionen als veraltet ein, die seit PHP 8.0 nichts mehr bewirkt haben, darunter curl_close(), imagedestroy(), und xml_parser_free(). Es veraltet auch einige Sonderfälle, wie die Verwendung von null als Array-Schlüssel oder beim Übergeben von chr() ein Wert außerhalb von 0 bis 255.
Die meisten PHP-Apps protokollieren eine Deprecation und machen weiter. FreeScout macht aus jeder Deprecation-Warnung einen Fehler, sodass ein einziger verbliebener Aufruf die Anfrage oder den Hintergrundjob stoppt, der ihn ausgelöst hat. Ein Modul kann installiert und gesund aussehen, während jede von ihm hergestellte Verbindung fehlschlägt.
Wenn Sie diese Fehler nach dem Upgrade sehen, Fehler "deprecated since 8.5" in FreeScout beheben führt durch das Finden und Beheben des verantwortlichen Moduls.
Vor dem Upgrade
- Support prüfen: Lesen Sie die Versionshinweise und Systemanforderungen von FreeScout für PHP 8.5 und bestätigen Sie, dass jedes installierte Modul eine PHP 8.5-kompatible Version hat.
- Aktualisieren Sie zuerst die Module: installieren Sie diese Updates, solange Sie noch auf Ihrer aktuellen PHP-Version sind, damit jedes Modul vor dem Wechsel bereit ist.
- Sichern: Erstellen Sie eine Kopie des FreeScout-Verzeichnisses, der Datenbank und Ihrer PHP-Konfigurationsdateien.
- Auf einer Kopie testen: führen Sie das Upgrade wenn möglich zuerst auf einer Staging-Kopie des Helpdesks durch.
Nach dem Upgrade
Die PHP-Version prüfen, unter der FreeScout läuft
Öffnen Verwalten > System. Es zeigt die PHP-Version, die Ihr Webserver verwendet, und listet die PHP-Erweiterungen auf, die FreeScout benötigt, wobei fehlende markiert werden.Das PHP der Befehlszeile abgleichen
Ausführenphp -vauf dem Server. Der Queue-Worker und dieschedule:runCron die PHP-Version der Kommandozeile, die sich von der des Webservers unterscheiden kann. Beide müssen dieselbe Version mit denselben Erweiterungen ausführen.Erweiterungen und Einstellungen neu installieren
Eine neue PHP-Version bringt eigene Erweiterungspakete undphp.iniDateien. Installieren Sie die Erweiterungen Verwalten > System markiert als fehlend und wenden Sie dann benutzerdefinierte Einstellungen wieupload_max_filesizeundpost_max_size.Den Webserver auf das neue PHP umstellen
Wenn Sie PHP-FPM verwenden, bestätigen Sie, dass Ihr Webserver den PHP 8.5 FPM-Socket oder -Dienst verwendet, und starten Sie dann PHP-FPM und den Webserver neu.Caches leeren und den Queue-Worker neu starten
Führe diese aus deinem FreeScout-Verzeichnis aus, damit kein Prozess alten Code weiterlaufen lässt:Terminalphp artisan freescout:clear-cache php artisan queue:restart
Was in den Logs zu prüfen ist
Öffnen Verwalten > Protokolle > App-Protokolle nachdem Sie das Helpdesk eine Weile genutzt haben. Suchen Sie nach:
is deprecated since 8.5, der auf ein Modul oder eine Datei verweist, die noch nicht PHP 8.5-kompatibel ist.Providing a value not in-between 0 and 255 is deprecated, vonchr()Aufrufe.Using null as an array offset is deprecated.
Jeder Eintrag nennt die Datei. Ein Pfad unter Modules/<Name> zeigt Ihnen, welches Modul ein Update benötigt.
Testen Sie die Funktionen, die ausgehende Verbindungen herstellen, denn diese schlagen zuerst fehl: Abrufen von E-Mails, KI-Anbieter, Wissensquellen und Integrationen wie Linear, Jira, Slack oder Shop-Connectoren. Wo ein Modul eine Verbindung testen Schaltfläche, verwenden Sie sie.
Wenn etwas kaputtgeht
Stellen Sie FreeScout auf PHP 8.4 zurück, während Sie auf Updates warten. PHP 8.4 behandelt diese Funktionen nicht als veraltet, sodass derselbe Code dort normal läuft. Wechseln Sie sowohl den Webserver als auch das PHP der Befehlszeile und starten Sie dann PHP-FPM, den Webserver und den Queue-Worker neu.