O arquivo wp-config.php é o cérebro de configuração do WordPress: um único arquivo PHP na raiz da instalação que define o acesso ao banco de dados, chaves de segurança e constantes de ambiente. Aprender a editar arquivo wp config com segurança evita a maioria dos erros graves que chegam ao suporte. Antes de tocar nele, você precisa de um backup completo e de um editor de código que não corrompa a estrutura PHP. Este guia mostra o caminho completo, do acesso por SFTP até a correção da tela branca, com as constantes que realmente importam no dia a dia. Para o panorama geral da plataforma, veja também os tutoriais de WordPress da FULL.

O que é o wp-config.php e por que editar com cuidado

O wp-config.php é o arquivo de configuração central do WordPress, gerado na instalação e responsável por conectar o site ao banco de dados MySQL. Ele fica na raiz pública (a mesma pasta de wp-load.php e wp-settings.php) e carrega antes de qualquer plugin ou tema. É por isso que editar arquivo wp config exige cuidado: um erro de sintaxe aqui não gera aviso amigável, derruba o site inteiro.

Diferente do functions.php do tema, que pertence ao tema ativo, o wp-config.php sobrevive a trocas de tema e atualizações do core. Ele guarda as quatro constantes de conexão (DB_NAME, DB_USER, DB_PASSWORD, DB_HOST), as chaves de autenticação (SALTS) e o prefixo de tabelas. Por concentrar dados sensíveis, ele também é alvo recorrente de ataque, e proteger esse arquivo de configuração faz parte de qualquer rotina de segurança.

Tabela de referência rápida das constantes do wp-config.php

Antes de editar arquivo wp config, vale conhecer as seis constantes que concentram a maioria das edições. Conhecer o valor padrão e o efeito de cada uma evita tentativa e erro: uma constante mal definida, como WP_MEMORY_LIMIT abaixo do necessário, derruba plugins pesados com erro de memória esgotada. A tabela abaixo resume o que cada linha controla e quando mexer nela.

Cada valor da tabela vai dentro de uma chamada define(), sempre acima da linha de parada do arquivo, como o próximo passo a passo detalha.

Editar arquivo wp config em 6 passos pelo SFTP

Editar arquivo wp config com segurança leva cerca de 10 minutos e segue uma ordem fixa: backup, acesso, edição, validação e teste. O erro mais comum no suporte é colar código no lugar errado do arquivo, abaixo da linha que manda parar de editar. Os seis passos abaixo cobrem o caminho completo por SFTP, o método mais confiável porque preserva permissões e codificação do arquivo, ao contrário do copia e cola pelo navegador.

Passo 1: Faça um backup completo antes de tudo

Antes de qualquer edição, gere um backup completo do WordPress incluindo arquivos e banco de dados. Um backup do wp-config.php sozinho não basta: se a edição quebrar o carregamento, você quer poder restaurar o estado anterior em minutos. Plugins como UpdraftPlus ou um snapshot da hospedagem resolvem isso. Sem backup, um ponto e vírgula errado vira horas de recuperação manual.

Passo 2: Acesse o servidor por SFTP

Conecte ao servidor com um cliente SFTP como Filezilla, usando host, usuário, senha e porta 22. O SFTP é preferível ao FTP comum porque criptografa a transferência das credenciais. Na raiz do site (geralmente public_html ou www), localize o arquivo wp-config.php. Quem não tem acesso SFTP pode usar o gerenciador de arquivos do cPanel ou do painel da hospedagem.

Passo 3: Baixe e abra o arquivo em um editor de código

Baixe uma cópia do wp-config.php para o computador e abra em um editor de código puro como VS Code, Notepad++ ou Sublime Text. Nunca use Word ou editores de texto rico: eles inserem aspas tipográficas e caracteres invisíveis que quebram o PHP. O editor de código também numera as linhas, o que facilita localizar a linha de parada exata onde suas edições devem ficar.

Passo 4: Adicione ou altere as constantes com define()

Toda configuração nova entra como uma linha define('NOME', valor); colocada acima do comentário que diz para parar de editar. Por exemplo, define('WP_MEMORY_LIMIT', '256M'); aumenta a memória disponível. Respeite as aspas simples em strings e o ponto e vírgula no fim de cada linha. Valores booleanos como true e números não levam aspas. Uma linha sem ponto e vírgula derruba o site.

Passo 5: Salve respeitando a linha de parada

O wp-config.php tem um comentário fixo: /<em> That's all, stop editing! Happy publishing. </em>/. Qualquer constante colada abaixo dessa linha é ignorada pelo WordPress, porque o arquivo wp-settings.php já carregou o ambiente. Salve o arquivo mantendo a codificação UTF-8 sem BOM. No editor, confirme que não há tag de fechamento ?> extra no final, já que ela causa o erro de “headers already sent”.

Passo 6: Envie de volta e teste o site

O último passo de editar arquivo wp config é subir o arquivo editado para o servidor por SFTP, substituindo o original. Abra o site em uma aba anônima e teste a página inicial, o painel /wp-admin e uma página interna. Esse teste final de editar arquivo wp config confirma que a constante foi lida. Se algo quebrar, o backup do Passo 1 permite reverter na hora. Confirmar a edição em ambiente anônimo evita ser enganado por cache do navegador mostrando a versão antiga.

Edição por cPanel ou por plugin: Quando usar cada via

Nem todo mundo tem acesso SFTP, e o WordPress oferece dois caminhos alternativos para editar arquivo wp config. O gerenciador de arquivos do cPanel abre o wp-config.php direto no navegador, sem baixar nada, ideal para uma alteração rápida de uma constante. Plugins de gerenciamento, por outro lado, oferecem uma interface visual para mexer em constantes comuns sem tocar no código.

Quem prefere editar arquivo wp config sem linha de comando costuma escolher o cPanel. A via do cPanel tende a ser segura para edições pontuais, mas o editor embutido é menos confiável que um editor de código local para arquivos longos. Na maioria dos casos de suporte, recomendar o SFTP reduz o risco de salvar com codificação errada. Já a edição por plugin adiciona uma camada de software entre você e o arquivo: prática para iniciantes, porém menos transparente quando algo dá errado. Para acessos de emergência sem painel, dominar comandos de SFTP continua sendo o caminho mais resiliente.

Erros comuns ao editar arquivo wp config e como corrigir

O erro mais frequente após editar arquivo wp config é a tela branca da morte, causada quase sempre por sintaxe PHP inválida. Um ponto e vírgula faltando, uma aspa não fechada ou uma tag ?> extra fazem o PHP parar de interpretar o arquivo, e o WordPress devolve uma página em branco sem mensagem. A correção é restaurar o backup ou reabrir o arquivo e revisar a última linha alterada.

Outro problema recorrente é o erro de conexão com o banco de dados, que aparece quando DB_HOST, DB_USER ou DB_PASSWORD foram alterados por engano. Para diagnosticar quebras silenciosas, ative define('WP_DEBUG', true); temporariamente: o WordPress passa a registrar erros em wp-content/debug.log. Já o erro de memória esgotada some ao subir WP_MEMORY_LIMIT, desde que o plano de hospedagem permita esse teto.

Boas práticas de segurança ao mexer no wp-config.php

Editar arquivo wp config com segurança não termina ao salvar: como ele concentra as credenciais do banco e as chaves de autenticação, protegê-lo é tão importante quanto editá-lo direito. Ajustar as permissões de arquivos do WordPress para 600 ou 640 impede que outros usuários do servidor leiam o conteúdo. Em servidores Apache, mover o arquivo um nível acima da raiz pública reduz a superfície de exposição.

Reforçar o .htaccess para bloquear o acesso direto ao wp-config.php é uma camada adicional contra leitura por URL. Adicionar define('DISALLOW_FILE_EDIT', true); desativa o editor de código do painel, o que limita o estrago caso uma conta de administrador seja comprometida. Essas medidas integram qualquer rotina de proteção de site WordPress; o tema de blindar o próprio arquivo é tratado em detalhe no guia de proteger o wp-config no WordPress. Se a edição deixou permissões erradas, o passo a passo de corrigir erro de permissões de arquivos recoloca tudo no lugar.

Acelere o WordPress com o plano certo da FULL

Editar o wp-config.php resolve configuração, mas performance e segurança contínuas dependem das ferramentas certas. O plano PRO da FULL custa R$849 e dá acesso a 17 plugins premium (WP Rocket, All in One Security, Perfmatters e outros) com ativação em 1 clique. Para quem gerencia vários sites, isso sai por cerca de R$85 por site, valor que a gente vê no suporte ser menor do que comprar cada licença avulsa. Veja os detalhes em FULL.services/planos e ative tudo sem mexer no código de cada site.

Legenda: a constante deve ficar acima do comentário “stop editing”, senão o WordPress a ignora.

Perguntas frequentes sobre editar o wp-config.php

Próximos passos para configurar o WordPress com segurança

Saber editar arquivo wp config coloca no seu controle a camada mais profunda de configuração do WordPress, do ajuste de memória ao log de depuração. A regra de ouro é sempre fazer backup antes, editar por SFTP em um editor de código puro e manter as constantes acima da linha de parada. Com isso, a maioria dos erros graves deixa de acontecer. Para continuar aprendendo WordPress do básico ao avançado, o FULL Academy reúne tutoriais, guias e reviews em um só lugar.