Tutorials 3 min de leitura

Erro de arquivo incompatível no WordPress 

Por Golam Mostafa • Feb 16, 2024
Escrito por uma pessoa

Se você receber o erro "Arquivo incompatível" ao instalar um arquivo ZIP do tema ou plug-in, entre em contato com o servidor para fazer upgrade do libzip. Esses temas e plugins são baixados em formato ZIP, portanto, a instalação pode falhar e o WordPress exibe um erro genérico de "arquivo incompatível".

Esse problema confundiu muitos deles na comunidade WordPress. Mas não se preocupe; estamos aqui para ajudá-lo a entender por que isso está ocorrendo e como corrigi-la.

O que está causando o erro?

A raiz do problema é como o macOS compacta os arquivos zip e como o WordPress 6.4.3 os entende quando enviados. Atualizações recentes de segurança destinadas a reforçar o procedimento de upload não involuntariamente produziram problemas com arquivos ZIP compactados do macOS, resultando na temida mensagem de erro "Arquivo incompatível".

Preocupações semelhantes já afligiram o WordPress e o WP-CLI, e o comportamento está relacionado às incompatibilidades da versão libzip do PHP.

Como corrigir erros do WordPress de arquivo incompatível?

Esse problema será resolvido no WordPress versão 6.4.4, porém até então, você pode instalar o plugin “Force usando pclzip” e todas as instalações ZIP funcionarão corretamente.

Estamos seguindo algumas etapas para resolver esse erro de arquivo incompatível do site WordPress.

1. Extraia o arquivo zip e comprima novamente.

Suponha que você seja um cliente que fez uma compra ou baixou um arquivo de produto e que enfrenta o problema. Nesse caso, você pode extrair o arquivo zip que baixou e compactar o diretório/pasta principal novamente. Estamos seguindo duas maneiras para usuários de Windows e Mac.

Usuários do Windows: usando o Windows File Explorer

  1. clique com o botão direito O plugin principal ou a pasta do tema.
  2. selecionar Enviar para > pasta compactada (zipada).
  3. Use-o para fazer o upload.

Após o zipping novamente do seu arquivo no Windows, tente o procedimento de upload no seu site WordPress para confirmar que o problema de “arquivo incompatível” não aparece. Se o problema persistir, pode ser causado por algo diferente da técnica de geração do arquivo ZIP, como permissões de arquivo, configurações do servidor ou um problema específico com a instalação do WordPress.

Usuários do macOS: use a linha de comando para compactação

Em vez de usar a opção de "compactar" do macOS, comprima a pasta do plugin usando o terminal. Veja como:

zip -r my-plugin.zip my-plugin/

Esse método garante compatibilidade com o processo de upload do WordPress.

2 . Adicione um filtro usando um código sem qualquer plugin

Primeiro, vá para wp-admin Painel e acesse Appearance > Theme File Editor.

2º, selecione seu tema atual

3º, clique em functions.php Arquivo e aberto ao editor

Por fim, adicione o código abaixo ao  function.php arquivo.

add_filter( 'unzip_file_use_ziparchive', '__return_false' );

Depois, adicionando o código, clique no Arquivo de atualização botão para salvar.

Agora tente fazer o upload do seu tema e do arquivo zip do plugin para instalação.

Mais informações sobre o bug no bug de arquivo incompatível no WordPress 6.4.3

Isso aconteceu devido a um bug introduzido no WordPress 6.4.3, especificamente neste conjunto de alterações: https://core.trac.wordpress.org/changeset/57388.

Há uma correção de bug e um tíquete do Core Trac a seguir sobre esse problema aqui: https://core.trac.wordpress.org/ticket/60398

Como editar arquivos wp-config.php no WordPress

next3offload

Crie melhores fluxos de trabalho no WordPress com a ThemeDev

Explore plugins, guias e ferramentas criados para empresas WordPress em crescimento.

Explorar a ThemeDev
Golam Mostafa
Escrito por

Golam Mostafa

I'm a senior plugin developer for WordPress. I have four years of experience working as a software engineer for ADB Bank, and in 2018, I started developing plugins and founded ThemeDev.

Continue a ler

Ver todos
Melhores ofertas e descontos para o Halloween Wordpress 2025
Coupon 19 min de leitura

Melhores ofertas e descontos para o Halloween Wordpress 2025

Ei, caçadores de negócios de Halloween. A temporada mais assustadora do ano de Halloween está bat...

Ler o artigo completo
Mir Mamun
Mir Mamun Oct 13, 2026
Como gerenciar e otimizar uma grande biblioteca de mídia WordPress
WordPress 11 min de leitura

Como gerenciar e otimizar uma grande biblioteca de mídia WordPress

No início, gerenciar uma mídia WordPress é simples. Você carrega algumas imagens, escreve alguma...

Ler o artigo completo
Mir Mamun
Mir Mamun Apr 23, 2026
5 melhores alternativas de mídia em nuvem em 2026
Next3 Offload 8 min de leitura

5 melhores alternativas de mídia em nuvem em 2026

Em 2026, empresas e criadores buscam as melhores alternativas de mídia na nuvem que vão além do s...

Ler o artigo completo
Mir Mamun
Mir Mamun Mar 3, 2026

Receba semanalmente dicas para crescer com WordPress

Junte-se aos leitores da ThemeDev e receba na sua caixa de entrada recursos práticos sobre WordPress, plugins e crescimento do negócio.