Los "deprecated since 8.5"-fouten op in FreeScout
Als FreeScout-functies stoppen met werken nadat je naar PHP 8.5 bent overgestapt, controleer dan het FreeScout-logboek op berichten die eindigen op is deprecated since 8.5. Elk daarvan noemt het bestand dat de oorzaak is. Werk de module of FreeScout-component bij die dat bestand bezit, leeg de cache en herstart de queue worker.
PHP 8.5 is de standaard PHP-versie op Ubuntu 26.04, dus deze fouten verschijnen vaak direct na een upgrade van het besturingssysteem.
Symptomen
FreeScout zelf laadt meestal nog wel, maar afzonderlijke functies falen:
- De Verbinding testen knop meldt dat deze een server niet kan bereiken.
- Achtergrondtaken, zoals synchroniseren, ophalen of AI-concepten maken, stoppen met het produceren van resultaten.
- Een integratie die vóór de upgrade werkte, wordt stil.
- Een instellingenpagina of actie geeft een serverfout terug.
Het verraderlijke teken is dat curl naar hetzelfde adres werkt vanaf de commandoregel van de server, terwijl de module zegt dat er geen verbinding kan worden gemaakt.
De logberichten
Open het applicatielog van FreeScout (Beheren > Logboeken > App-logboeken, of storage/logs/laravel-<date>.log op de server). PHP 8.5-deprecations zien er zo uit:
Function curl_close() is deprecated since 8.5, as it has no effect since PHP 8.0
Function imagedestroy() is deprecated since 8.5, as it has no effect since PHP 8.0
chr(): Providing a value not in-between 0 and 255 is deprecated
Using null as an array offset is deprecated, use an empty string insteadDe module voegt meestal zijn eigen context toe rond het bericht, zoals de taak of het verzoek dat is mislukt.
Waarom het gebeurt
PHP 8.5 markeert een paar oudere functies en randgevallen als verouderd. Verschillende, zoals curl_close() en imagedestroy(), doen niets meer sinds PHP 8.0, dus oudere code roept ze nog steeds aan.
In de meeste PHP-apps is een deprecation alleen een waarschuwing in het log. FreeScout behandelt elke deprecation-melding als een fout. Dus een verzoek kan met succes voltooien en vervolgens mislukken op een achtergebleven aanroep zoals curl_close(). Je URL's, API-sleutels, netwerk en PHP-extensies zijn meestal in orde.
Oplossing: werk de getroffen code bij
Vind het bestand in de logvermelding
Open het volledige logboekitem. Een pad onderModules/<Name>verwijst naar die module. Een pad onderapp/ofvendor/verwijst naar FreeScout zelf.Werk die module of FreeScout bij
Openen Beheren > Modules en installeer eventuele beschikbare updates, of controleer de site van de moduleontwikkelaar op een PHP 8.5-compatibele release. Werk voor FreeScout zelf bij naar de nieuwste release.De cache wissen en de queue-worker herstarten
Voer deze uit vanuit je FreeScout-map. De queue worker is een langlopend proces, dus het blijft de oude code draaien tot het opnieuw start.terminalphp artisan freescout:clear-cache php artisan queue:restartOpnieuw proberen wat is mislukt
Klik Verbinding testen opnieuw, herstart elke sync die is gestopt en bevestig dat nieuwe achtergrondtaken worden voltooid.
Bevestig dat het werkte
- De functie die faalde, werkt weer.
- Nieuwe logboekvermeldingen noemen niet langer
is deprecated since 8.5.
Als er nog geen update beschikbaar is
Draai FreeScout op PHP 8.4 tot de ontwikkelaar een oplossing uitbrengt. PHP 8.4 behandelt deze functies niet als verouderd, dus dezelfde code draait daar normaal.
Schakel beide PHP-versies om die FreeScout gebruikt. Beheren > Systeem toont de versie die je webserver draait. De queue worker en cron gebruiken command-line PHP, dus controleer php -v ook op de server. Herstart vervolgens PHP-FPM of je webserver, en de queue worker.
Voor de volledige verhuizing, zie FreeScout upgraden naar PHP 8.5.
ReplyRabbit en PHP 8.5