Atualizando o FreeScout para PHP 8.5 (checklist do Ubuntu 26.04)
Antes de migrar o FreeScout para o PHP 8.5, confirme que o FreeScout e todos os módulos que você usa o suportam, depois verifique as extensões do PHP, reinicie o worker da fila e acompanhe o log em busca de deprecated since 8.5 mensagens. O Ubuntu 26.04 instala o PHP 8.5 por padrão, então uma atualização do sistema operacional costuma ser o que desencadeia a mudança.
Isso importa mais para o FreeScout do que para a maioria dos aplicativos PHP, por causa de como o FreeScout lida com avisos de descontinuação.
Por que o PHP 8.5 pode quebrar módulos do FreeScout
Cada versão do PHP descontinua algumas funções mais antigas. O PHP 8.5 descontinua várias funções que não fazem nada desde o PHP 8.0, incluindo curl_close(), imagedestroy(), e xml_parser_free(). Também descontinua alguns casos extremos, como usar null como chave de array ou passando chr() um valor fora de 0 a 255.
A maioria dos apps PHP registra uma depreciação e continua. O FreeScout transforma cada aviso de depreciação em erro, então uma única chamada remanescente interrompe a requisição ou o trabalho em segundo plano que a encontrou. Um módulo pode parecer instalado e saudável enquanto toda conexão que ele faz falha.
Se você vir esses erros após a atualização, Corrigir erros "deprecated since 8.5" no FreeScout explica como encontrar e corrigir o módulo responsável.
Antes de atualizar
- Verifique o suporte: leia as notas de versão e os requisitos de sistema do FreeScout para PHP 8.5, e confirme que cada módulo instalado tem uma versão compatível com PHP 8.5.
- Atualize os módulos primeiro: instale essas atualizações enquanto ainda estiver na sua versão atual do PHP, para que todos os módulos estejam prontos antes da migração.
- Faça backup: faça uma cópia do diretório do FreeScout, do banco de dados e dos seus arquivos de configuração do PHP.
- Teste em uma cópia: se possível, execute a atualização primeiro em uma cópia de teste do help desk.
Depois de atualizar
Verifique a versão do PHP em que o FreeScout é executado
Abrir Gerenciar > Sistema. Ele mostra a versão do PHP que seu servidor web usa e lista as extensões PHP de que o FreeScout precisa, sinalizando qualquer uma que esteja faltando.Combine o PHP da linha de comando
Executarphp -vno servidor. O worker da fila e oschedule:runo cron usa o PHP da linha de comando, que pode ser diferente da versão do servidor web. Ambos devem executar a mesma versão com as mesmas extensões.Reinstalar extensões e configurações
Uma nova versão do PHP vem com seus próprios pacotes de extensão ephp.iniarquivos. Instale as extensões Gerenciar > Sistema marca como ausente e depois reaplica configurações personalizadas comoupload_max_filesizeepost_max_size.Aponte o servidor web para o novo PHP
Se você usar PHP-FPM, confirme que seu servidor web usa o socket ou serviço do PHP 8.5 FPM, depois reinicie o PHP-FPM e o servidor web.Limpe os caches e reinicie o worker da fila
Execute estes comandos a partir do diretório do FreeScout para que nenhum processo continue executando código antigo:terminalphp artisan freescout:clear-cache php artisan queue:restart
O que verificar nos logs
Abrir Gerenciar > Logs > App Logs depois de usar o help desk por um tempo. Pesquise por:
is deprecated since 8.5, que aponta para um módulo ou arquivo que ainda não está pronto para PHP 8.5.Providing a value not in-between 0 and 255 is deprecated, dechr()chamadas.Using null as an array offset is deprecated.
Cada entrada nomeia o arquivo. Um caminho em Modules/<Name> informa qual módulo precisa de atualização.
Teste os recursos que fazem conexões de saída, porque estes falham primeiro: busca de e-mails, provedores de IA, fontes de conhecimento e integrações como Linear, Jira, Slack ou conectores de loja. Quando um módulo oferece um Testar conexão botão, use-o.
Se algo quebrar
Volte o FreeScout para o PHP 8.4 enquanto espera por atualizações. O PHP 8.4 não trata essas funções como depreciadas, então o mesmo código roda normalmente nele. Troque tanto o servidor web quanto o PHP da linha de comando, depois reinicie o PHP-FPM, o servidor web e o worker da fila.