Os erros em seu site WordPress podem retardar seu trabalho e criar sérios inconvenientes tanto para você quanto para seus usuários. Por exemplo, a mensagem “A Instalação Falhou: Não foi possível criar diretório” (installation failed: could not create directory) pode impedir que você forneça um recurso ou funcionalidade chave.

Felizmente, resolver este erro é bastante simples. Ajustando apenas algumas configurações, você pode facilmente colocar seu plugin ou tema WordPress em funcionamento num piscar de olhos.

Neste post, vamos discutir o que causa esse erro e outras questões relacionadas a ele. Em seguida, nós o acompanharemos por três métodos para resolver a mensagem “A Instalação Falhou: Não foi possível criar diretório”, para que você possa completar sua instalação ou atualização.

Vamos começar!

O que causa o Erro “A Instalação Falhou: Não foi possível criar diretório” no WordPress

Existem três situações primárias em que você pode encontrar a “A Instalação Falhou: Não foi possível criar diretório” no WordPress:

  1. Ao instalar um tema ou plugin através do seu dashboard do WordPress
  2. Durante um tema padrão ou atualização de plugins
  3. Ao tentar fazer upload de arquivos para o diretório de conteúdo do wp no seu servidor

A causa raiz do problema é a mesma em cada cenário. No entanto, vamos dar uma olhada em cada uma dessas situações por sua vez.

Instalando um Novo Tema ou Plugin em Seu Site

Seu site WordPress é composto de dois componentes: um banco de dados e vários arquivos que são armazenados em um servidor em ‘diretórios’. Quando você usa o WordPress admin para adicionar um tema ou plugin ao seu site, ele tem que criar um novo diretório no qual salvar seus arquivos.

No entanto, se o plugin ou tema que você está tentando instalar não tiver permissão para escrever no diretório raiz do seu site, ele não será capaz de completar esta tarefa. É quando você verá um erro como “A Instalação Falhou: Não foi possível criar diretório”.

Este erro é a forma do seu servidor dizer que você não está autorizado a fazer alterações nos arquivos do seu site, adicionando o plugin ou tema em questão. Em geral, este é um problema que geralmente ocorre em novos sites WordPress.

É importante notar que existe uma causa semelhante, menos comum, para este erro. Se o seu servidor estiver ficando sem espaço em disco para armazenar os arquivos do seu site, ele pode mostrar essa mesma mensagem porque não tem espaço para o novo plugin ou tema. Leia este guia para verificar o uso do disco no WordPress.

Isto pode ser devido a arquivos de backup antigos não serem apagados ou pode acontecer porque . Neste último caso, você vai querer procurar fazer um upgrade para outro pacote de hospedagem que forneça mais armazenamento.

Atualização de um Tema ou Plugin Existente

Às vezes, ao tentar atualizar um tema ou plugin do WordPress que já está instalado em seu site, você pode ver um erro muito semelhante ao que descrevemos acima. Este normalmente lerá “Update failed: could not create directory”.

Este problema ocorre pelas mesmas razões que o erro “Installation failed could not create directory”. Ao atualizar um plugin ou tema do WordPress, o WordPress precisa reescrever seus arquivos no servidor de seu site. Se suas permissões estiverem incorretas ou não houver espaço livre suficiente, o processo não será capaz de acessar os arquivos corretos ou fazer upload de novos.

Como a causa destas duas questões é a mesma, as soluções também são idênticas. Qualquer um dos métodos para resolver o erro “A Instalação Falhou: Não foi possível criar diretório” listados abaixo também deve funcionar para uma atualização paralisada.

Upload de arquivos para o diretório de wp-content

As permissões de arquivo do servidor são um recurso de segurança que os provedores de hospedagem colocam em prática para evitar que partes não autorizadas façam alterações no seu site ou roubem informações confidenciais.

No entanto, eles podem, às vezes, bloquear você fora dos seus próprios arquivos, se eles não estiverem configurados corretamente.

É por isso que, se você tentar contornar o erro “A Instalação Falhou: Não foi possível criar diretório” em seu painel do WordPress carregando os arquivos do plugin ou do tema diretamente para o diretório de conteúdo wp em seu servidor, você provavelmente ainda vai encontrar o mesmo problema. O erro ocorre devido a um problema com o seu servidor, não com a sua instalação do WordPress.

Esta edição também pode se estender ao seu subdiretório wp-content/uploads, onde todos os seus arquivos de mídia são armazenados. Adicionar imagens, vídeos ou outros conteúdos similares ao seu site, salvando-os no seu servidor, segue o mesmo processo da instalação de um novo plugin ou tema.

Se você não tem permissão para escrever em seu diretório raiz, o upload de conteúdo para wp-content/uploads ainda produzirá o erro que temos discutido. Para corrigir isso, você precisará ajustar as configurações do seu servidor, como descreveremos em breve.

Diagnosticando o Erro “A Instalação Falhou: Não foi possível criar diretório” no WordPress (2 Métodos)

A boa notícia sobre este erro é que é relativamente fácil de corrigir. Na maioria das vezes, corrigir suas permissões vai esclarecer tudo direito. Antes de começar a trabalhar nessa solução, no entanto, você pode querer ter certeza de que ela pode realmente resolver o seu problema.

A seguir, delineamos dois métodos para determinar se o seu site está sofrendo um erro relacionado às permissões.

1. Use a Ferramenta de Saúde do Site WordPress

O WordPress 5.2 introduziu a ferramenta Site Health. Ele contém uma grande quantidade de informações valiosas relativas ao seu site WordPress, como resultados de testes de desempenho, verificações de segurança e dados de configuração do WordPress.

Você pode acessá-lo navegando para Ferramentas > Saúde do site no seu painel do WordPress. Para verificar as suas definições de permissões de arquivo, você vai querer clicar na guia Info:

A ferramenta WordPress Site Health
A ferramenta WordPress Site Health

Em seguida, vá até a última seção, que deve ser rotulada como Permissões do Sistema de Arquivos:

Permissões do Sistema de Arquivos
A guia Informações de saúde do site WordPress

Aqui você verá uma lista dos principais arquivos WordPress, incluindo os diretórios de plugins e temas. Idealmente, todos eles serão listados como “Escrevíveis”:

Sistemas de Arquivo Graváveis
A verificação de permissões do sistema de arquivos de saúde do site WordPress

Caso suas permissões não estejam configuradas corretamente, você verá “Não escrevível” listado ao lado das pastas problemáticas. Se este for o caso, você saberá que precisa corrigir suas permissões de arquivo.

2. Verifique o Registo de Erros do Seu Servidor

Outra opção é verificar o log de erros do seu servidor. Este pode ser um método mais eficiente, pois exibirá quaisquer erros que tenham ocorrido, e não apenas permissões de arquivo incorretas. Você deve ser capaz de acessar seus logs através da sua conta de hospedagem.

Se você é um cliente Kinsta, você pode entrar no seu painel MyKinsta e clicar em Sites na barra lateral:

painel MyKinsta
Painel MyKinsta

Selecione o nome do site que está sofrendo o erro “Instalação falhou: não foi possível criar diretório”. Em seguida, selecione a guia Logs:

Visualizador de registo de erros da conta MyKinsta
Visualizador de registo de erros da conta MyKinsta

A partir do menu suspenso, certifique-se de que o arquivo error.log está selecionado. Aqui, você deve ser capaz de ver quaisquer erros recentes que tenham ocorrido em seu servidor, incluindo permissões de arquivo incorretas ou armazenamento insuficiente, qualquer um dos quais pode estar causando o erro de instalação.

Se você vir um erro relevante listado, você pode corrigir as suas permissões de arquivo ou considerar atualizar o seu plano de hospedagem conforme necessário.

Como Corrigir o Erro “A Instalação Falhou: Não foi possível criar diretório” no WordPress

Se as configurações de permissões do seu site estão causando a “A Instalação Falhou: Não foi possível criar diretório”, você pode resolvê-lo redefinindo-as. Para fazer isso, você precisa se conectar ao seu servidor via File Transfer Protocol (FTP), usando um cliente FTP.

Sempre que você fizer alterações nos arquivos do seu site, é aconselhável criar um backup primeiro, para o caso de algo dar errado e você precisar restaurar seu site. Em seguida, recolha as suas credenciais FTP da sua conta de alojamento.

Como cliente Kinsta, você pode fazer isso acessando a guia Informações do seu site no painel do MyKinsta:

informação de kinsta ftp
Aceder às credenciais FTP do site no MyKinsta

Depois, abra o FileZilla (ou outro cliente) e introduza os seus dados. Você estará conectado ao seu servidor, onde você deve ver uma pasta chamada public_html. Clique duas vezes sobre ele para ver seus arquivos WordPress:

public_html via FTP
Acesso ao diretório public_html via FTP

Depois disso, selecione as pastas marcadas wp_content, wp_includes, e wp_admin. Clique com o botão direito do mouse sobre eles e escolha File Permissions:

permissões de arquivo via FTP
Selecionando a opção de permissões de arquivo via FTP

Você deve ver uma janela que contém um punhado de configurações:

permissões correctas dos ficheiros via FTP
Definir as permissões correctas dos ficheiros via FTP

Verifique se as opções aqui estão definidas com os seguintes valores:

  • Permissão do proprietário: Ler, Escrever, Executar.
  • Permissões de Grupo: Ler, Executar.
  • Permissões Públicas: Ler, Executar.
  • Valor numérico: 755.
  • Enforcar em subdiretórios.
  • Aplicar apenas aos directórios.

Clique no botão OK para fechar a janela. Agora volte ao seu site e tente instalar ou atualizar o plugin/tema novamente.

Vale notar que alguns provedores de hospedagem, incluindo aqueles que usam o cPanel, têm suas próprias ferramentas que você pode usar sem ter que se preocupar com o FTP?SFTP. Muitas vezes você pode encontrar esta ferramenta fazendo login na sua conta de hospedagem, navegando até o site que está sofrendo o erro e procurando por um Gerenciador de Arquivos.

Resumo

Os plugins e temas do seu site WordPress fornecem funcionalidades importantes para você e seus usuários. Encontrar um erro ao tentar instalar ou atualizar alguém pode jogar uma chave inglesa nos seus planos e atrasar o seu progresso.

Para determinar se um problema de permissão de arquivo está causando um erro de instalação de plugin ou tema no seu site, você pode usar a ferramenta Site Health ou verificar o log de erros do seu servidor. Depois disso, redefinir suas permissões usando FTP/SFTP deve levar apenas alguns minutos.