Como corrigir Could not create directory no WordPress
O que é o erro Could not create directory?
O WordPress precisa criar pastas em disco para instalar e atualizar plugins, temas e para descompactar pacotes na pasta wp-content/upgrade. Quando o usuário do PHP que roda o WordPress não tem permissão de escrita no diretório de destino, a função de criação de pasta falha e o painel mostra Could not create directory. O erro é de permissão de arquivo, não de banco de dados: o site continua no ar, mas instalações, atualizações e às vezes uploads param porque o WordPress não consegue gravar no disco.
Como identificar
- Mensagem “Could not create directory.” ao instalar ou atualizar um plugin ou tema pelo painel.
- Em sites em português, a mensagem “Não foi possível criar o diretório.”.
- A atualização para na tela do instalador, sem concluir, e o plugin fica numa versão antiga.
- O caminho citado na mensagem aponta para wp-content/upgrade, wp-content/plugins ou wp-content/uploads.
Como prevenir
- Mantenha wp-content e subpastas em 755 e arquivos em 644 após qualquer migração ou restauração de backup
- Ao mover arquivos por SSH como root, sempre reaplique o dono correto com chown ao terminar
- Acompanhe a cota de disco da hospedagem para o servidor nunca ficar sem espaço para criar pastas
Causa
- Pasta wp-content (ou wp-content/upgrade) sem permissão de escrita para o usuário do PHP, geralmente em 644 quando deveria estar 755.
- Dono dos arquivos diferente do usuário que roda o PHP/Apache, comum após restaurar backup ou migrar de servidor por SSH como root.
- Pasta wp-content/upgrade ausente, que o WordPress usa como área temporária para descompactar pacotes.
- Cota de disco da hospedagem esgotada, impedindo a criação de qualquer novo diretório.
- Regra de open_basedir ou de jail do servidor restringindo onde o PHP pode gravar.
Como resolver
- Identifique a pasta citada no erro: leia o caminho na mensagem Could not create directory. Quase sempre é wp-content/upgrade, wp-content/plugins ou wp-content/uploads. É essa pasta que precisa ficar gravável.
- Ajuste a permissão da pasta para 755: no cliente FTP ou no gerenciador de arquivos da hospedagem, defina a permissão da pasta wp-content e das subpastas para 755 e os arquivos para 644. Esse é o padrão recomendado pelo WordPress.
- Crie a pasta wp-content/upgrade se faltar: via FTP, confira se existe a pasta wp-content/upgrade. Se não existir, crie manualmente com permissão 755. O WordPress usa essa pasta para descompactar as atualizações.
- Corrija o dono dos arquivos via SSH: se você tem acesso SSH, ajuste o dono de wp-content para o usuário do servidor web. Em muitas hospedagens é www-data; em painéis cPanel costuma ser o usuário da conta. Use o comando abaixo com o usuário correto.
chown -R www-data:www-data wp-content find wp-content -type d -exec chmod 755 {} ; find wp-content -type f -exec chmod 644 {} ; - Teste a instalação de novo: volte ao painel e tente instalar ou atualizar o plugin novamente. Se o erro persistir, confira a cota de disco e o open_basedir com a hospedagem.
# Via SSH na raiz do site: corrige dono e permissoes do wp-content.
# Troque www-data pelo usuario do seu servidor web (ex.: o usuario da conta no cPanel).
chown -R www-data:www-data wp-content
# Pastas em 755, arquivos em 644 (padrao recomendado pelo WordPress):
find wp-content -type d -exec chmod 755 {} ;
find wp-content -type f -exec chmod 644 {} ;
# Garante a pasta de atualizacao usada pelo instalador:
mkdir -p wp-content/upgrade && chmod 755 wp-content/upgradePerguntas frequentes
Por que o WordPress precisa criar diretórios?
Qual permissão devo dar à pasta wp-content?
O erro apareceu depois de restaurar um backup. Por quê?
Posso usar 777 para resolver de vez?
Não tenho acesso SSH. Dá para resolver só por FTP?
Ajustei tudo e o erro continua. O que mais checar?
Como corrigir o loop Update WordPress Database
O loop Update WordPress Database acontece quando o WordPress pede para atualizar o banco a cada visita e a tela nunca é superada, mesmo depois de clicar no botão. Em geral é causado por cache servindo a tela antiga ou por um descompasso na versão do banco que a rotina de atualização não consegue gravar.
Como corrigir o editor de blocos (Gutenberg) que não carrega
Quando o Gutenberg não carrega, o editor de blocos abre em branco, fica girando ou cai para o Editor Clássico. A causa quase sempre é um erro de JavaScript: cache antigo, minificação que quebra os scripts do editor ou conflito com outro plugin/tema que interrompe a carga da interface.
Como corrigir widgets que desapareceram após atualização
Widgets que desapareceram no WordPress após uma atualização costumam ser efeito da tela de widgets em blocos, introduzida no WordPress 5.8. Os widgets continuam no banco; o que muda é a interface, e às vezes um tema FSE remove de vez as áreas de widget clássicas.
Como corrigir permalinks retornando 404
Permalinks retornando 404 é quando só a página inicial abre e todos os posts e páginas internas dão erro 404. Quase sempre as regras de reescrita do WordPress foram perdidas ou o .htaccess ficou sem as linhas que traduzem as URLs amigáveis para o WordPress.
Como corrigir o botão Adicionar Mídia que não funciona
Quando o botão Adicionar Mídia não funciona, ele para de abrir a janela da biblioteca ao ser clicado. Na quase totalidade dos casos é um conflito de JavaScript causado por um plugin, um tema ou um cache que interrompe o carregamento dos scripts da tela de edição.
Como corrigir mídia que não faz upload no WordPress
Quando o upload de mídia no WordPress falha, a imagem ou arquivo não chega à Biblioteca de Mídia. As causas mais comuns são permissões erradas na pasta wp-content/uploads, o limite de tamanho de upload do servidor abaixo do arquivo enviado, ou memória PHP insuficiente para processar a imagem.
