Corrigir erros "deprecated since 8.5" no FreeScout
Se os recursos do FreeScout pararem de funcionar após você migrar para o PHP 8.5, verifique o log do FreeScout em busca de mensagens terminando em is deprecated since 8.5. Cada um nomeia o arquivo que o causou. Atualize o módulo ou componente do FreeScout que possui esse arquivo, limpe o cache e reinicie o worker da fila.
O PHP 8.5 é a versão padrão do PHP no Ubuntu 26.04, então esses erros costumam aparecer logo após uma atualização do sistema operacional.
Sintomas
O próprio FreeScout geralmente ainda carrega, mas recursos individuais falham:
- O Testar conexão botão informa que não consegue alcançar um servidor.
- Tarefas em segundo plano, como sincronização, busca ou geração de rascunhos por IA, param de produzir resultados.
- Uma integração que funcionava antes da atualização fica silenciosa.
- Uma página de configurações ou ação retorna um erro de servidor.
O sinal revelador é que curl para o mesmo endereço funciona a partir da linha de comando do servidor, enquanto o módulo diz que não consegue conectar.
As mensagens de log
Abra o log de aplicação do FreeScout (Gerenciar > Logs > App Logs, ou storage/logs/laravel-<date>.log no servidor). As depreciações do PHP 8.5 se parecem com isto:
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 insteadO módulo geralmente adiciona seu próprio contexto em torno da mensagem, como o trabalho ou a solicitação que falhou.
Por que acontece
O PHP 8.5 descontinua algumas funções e casos extremos mais antigos. Várias, como curl_close() e imagedestroy(), não fazem nada desde o PHP 8.0, então o código mais antigo ainda as chama.
Na maioria dos apps PHP, uma depreciação é apenas um aviso no log. O FreeScout trata cada aviso de depreciação como erro. Então uma requisição pode ser concluída com sucesso e depois falhar em uma chamada residual como curl_close(). Suas URLs, chaves de API, rede e extensões PHP geralmente estão corretas.
Correção: atualize o código afetado
Encontre o arquivo na entrada de log
Abra a entrada completa do log. Um caminho emModules/<Name>aponta para esse módulo. Um caminho emapp/ouvendor/aponta para o próprio FreeScout.Atualize esse módulo ou o FreeScout
Abrir Gerenciar > Módulos e instale quaisquer atualizações disponíveis, ou verifique o site do desenvolvedor do módulo para uma versão compatível com PHP 8.5. Para o próprio FreeScout, atualize para a versão mais recente.Limpe o cache e reinicie o worker da fila
Execute estes comandos a partir do diretório do FreeScout. O worker da fila é um processo de longa duração, então ele mantém o código antigo até reiniciar.terminalphp artisan freescout:clear-cache php artisan queue:restartTentar novamente o que falhou
Clique Testar conexão novamente, execute novamente qualquer sincronização que parou e confirme que novos trabalhos em segundo plano são concluídos.
Confirme se funcionou
- O recurso que falhou volta a funcionar.
- Novas entradas de log não mencionam mais
is deprecated since 8.5.
Se nenhuma atualização estiver disponível ainda
Execute o FreeScout no PHP 8.4 até o desenvolvedor lançar uma correção. O PHP 8.4 não trata essas funções como obsoletas, então o mesmo código é executado normalmente nele.
Alterne as duas versões do PHP que o FreeScout usa. Gerenciar > Sistema mostra a versão que seu servidor web executa. O worker da fila e o cron usam o PHP de linha de comando, então verifique php -v no servidor também. Depois reinicie o PHP-FPM ou o seu servidor web, e o worker da fila.
Para a mudança completa, consulte Atualizando o FreeScout para PHP 8.5.
ReplyRabbit e PHP 8.5