Solução de problemas do erro 'Arquivo Incompatível' do WordPress

Se você estiver tentando carregar um tema ou plugin no WordPress, especificamente na versão 6.4.3 do WordPress, poderá encontrar um erro que diz "Arquivo Incompatível". Embora a mensagem de erro não seja muito descritiva, ela simplesmente significa que houve um problema na verificação do arquivo .zip compactado que você está tentando carregar e, portanto, o carregamento não pôde ser concluído. Esse erro geralmente ocorre quando o arquivo zip é compactado em um Mac OS usando a função de pasta compactada integrada da Apple.
Como corrigir o erro 'Arquivo Incompatível'
Comece instalando e ativando um plugin de snippet de código como o WPCode em seu site e adicione o filtro abaixo:
add_filter( 'unzip_file_use_ziparchive', '__return_false' );
Alternativamente, se você não quiser adicionar um filtro de código, pode evitar o problema renomeando o arquivo usando uma ferramenta diferente em vez da opção "Compactar" integrada do Finder do macOS. Ferramentas de terceiros como o comando zip do Terminal ou aplicativos como o Keka produzem arquivos que não acionam esse problema de validação.
Trate isso apenas como uma solução temporária. Assim que você atualizar o WordPress para a versão 6.4.4 ou posterior, remova este filtro, ele não é mais necessário e não deve ser deixado permanentemente.
Esse problema foi um bug no WordPress 6.4.3, especificamente esta alteração: https://core.trac.wordpress.org/changeset/57388.
Uma correção de bug e um ticket do trac principal estão disponíveis para resolver esse problema aqui: https://core.trac.wordpress.org/ticket/60398.
Se você estiver trabalhando com um backup do Duplicator em vez de um upload de plugin/tema, consulte Como Extrair Manualmente um Arquivo de Backup Zipado.