Base de Conhecimento

wp-config.php: o que é e como editar com segurança

  • wp-config.php, wordpress, segurança, configuração, sftp
  • Usuários acharam útil: 0

Veja onde fica o arquivo de configuração do WordPress, onde colar uma linha nova, alguns ajustes da documentação, as permissões sugeridas e o que acontece ao trocar as chaves.

Por Redação Eleven Host · @robson.direitodigital · 19 de novembro de 2026 · 9 min de leitura

Arte da Eleven Host: janela de terminal com o título: wp-config.php: o que é e como editar com segurança

Capa da Redação Eleven Host para o guia: wp-config.php: o que é e como editar com segurança Arte: Eleven Host

O wp-config.php é o arquivo de configuração do WordPress: guarda os dados de acesso ao banco de dados, o prefixo das tabelas e as chaves de segurança. Para editar com segurança, faça uma cópia antes, use um editor de texto simples e acrescente linhas novas no lugar indicado.

Antes de mexer no wp-config.php, guarde uma cópia do arquivo original. A documentação do WordPress pede cópias regulares do site e que você saiba restaurá-las antes de mudar essas configurações.

O que é o wp-config.php e onde ele fica

A documentação oficial do WordPress chama o wp-config.php de um dos arquivos mais importantes da instalação. Ele fica na pasta raiz do WordPress e reúne a configuração básica do site, começando pela conexão com o banco de dados.

O arquivo não vem no pacote que você baixa. Segundo a documentação, o próprio processo de instalação do WordPress cria o wp-config.php com os dados que você informa na tela de instalação. O modelo usado nessa etapa é o wp-config-sample.php, que vem junto com o WordPress; o comentário no topo desse modelo explica que também dá para copiá-lo com o nome wp-config.php e preencher os valores à mão.

A documentação também diz que quem não é desenvolvedor dificilmente precisa editar o arquivo, a não ser seguindo orientação de um técnico ou da empresa de hospedagem.

Quem prefere um servidor virtual próprio pode olhar a VPS da Eleven Host. VPS a partir de R$ 29,90/mês no Plano Bronze; confira na loja o que cada plano inclui. Ver VPS

O que tem dentro do arquivo

O comentário de abertura do wp-config-sample.php resume o conteúdo em quatro partes: configurações do banco de dados, chaves secretas, prefixo das tabelas e o caminho da instalação (a constante ABSPATH). As constantes são linhas com define, um nome em maiúsculas e um valor; o prefixo das tabelas usa uma variável.

Dados do banco de dados

São quatro constantes: o nome do banco, o usuário, a senha e o endereço do servidor de banco. Um exemplo de linhas, com valores de mentira que você troca pelos do seu servidor:

define( 'DB_NAME', 'nome_do_banco' );

define( 'DB_USER', 'usuario_do_banco' );

define( 'DB_PASSWORD', 'sua_senha_aqui' );

define( 'DB_HOST', 'localhost' );

Pela documentação de APIs do WordPress, o valor padrão de DB_HOST é localhost e muitas vezes não precisa mudar. Já DB_CHARSET, com padrão utf8, a documentação orienta deixar como está, salvo necessidade específica.

O erro de conexão com o banco, que passa por estas linhas, tem guia próprio na base de conhecimento.

Prefixo das tabelas

A linha $table_prefix define o começo do nome de cada tabela do WordPress no banco. O padrão é wp_, e a documentação de administração diz que ele aceita só números, letras e sublinhado. A documentação explica que o prefixo serve para manter várias instalações no mesmo banco, cada uma com o seu.

Atenção a este ponto: o comentário do wp-config-sample.php avisa que trocar o prefixo depois do WordPress instalado faz o site achar que não foi instalado. Por isso, recomendamos definir o prefixo só numa instalação nova e não mudar essa linha num site que já está no ar.

Chaves e salts

São oito constantes: AUTH_KEY, SECURE_AUTH_KEY, LOGGED_IN_KEY e NONCE_KEY, mais os quatro _SALT correspondentes. A documentação de APIs diz que as quatro chaves são obrigatórias e os quatro salts são recomendados; se os salts faltarem, o WordPress gera os seus.

Como editar o wp-config.php com segurança

A documentação de APIs do WordPress é direta sobre a ferramenta: use um editor de texto simples e não um processador de texto como o Microsoft Word. A documentação de administração acrescenta dois cuidados: conferir se não sobraram espaços antes ou depois dos valores e manter as aspas simples intactas.

Recomendamos esta sequência:

  1. Faça uma cópia. Baixe o arquivo para o seu computador antes de qualquer mudança e guarde essa versão. Uma cópia completa do servidor também ajuda; veja como montar uma em Restic na VPS: backup automático do servidor.
  2. Abra o arquivo. Por SFTP, baixe, edite num editor de texto simples e envie de volta. Por SSH, use um editor de terminal dentro da pasta do WordPress. Para saber o que é um servidor desses, veja o guia de servidor VPS.
  3. Acrescente a linha no lugar certo. Veja a seção seguinte.
  4. Salve e confira. Abra o site e o painel numa aba nova. Se algo quebrar, envie de volta a cópia original.

Um exemplo de comando, rodado por SSH na pasta do WordPress, para fazer a cópia e abrir o arquivo:

cp wp-config.php ~/wp-config.php.copia

nano wp-config.php

No exemplo, a cópia vai para a pasta pessoal do usuário, fora da pasta pública do site. Recomendamos esse cuidado porque uma cópia com outro nome dentro da pasta do site pode ficar acessível pelo navegador. Confira os caminhos e o editor disponíveis no seu próprio servidor antes de rodar.

Onde colar uma linha nova

No modelo atual do WordPress, o fim do arquivo tem dois comentários: um que diz para acrescentar valores personalizados entre ele e a linha de parar de editar, e logo abaixo o That's all, stop editing!. Depois deles vem a linha que carrega o WordPress, require_once ABSPATH . 'wp-settings.php';. A documentação de administração reforça que certas configurações precisam vir antes da inclusão do wp-settings.php.

Um exemplo de trecho, com uma linha nova no lugar indicado:

/* Add any custom values between this line and the "stop editing" line. */

define( 'DISALLOW_FILE_EDIT', true );

/* That's all, stop editing! */

Em instalações antigas, o primeiro comentário pode não existir. Nesse caso, recomendamos colar a linha nova logo acima do comentário That's all, stop editing!.

Ajustes úteis no wp-config.php

Estas constantes estão na documentação do WordPress, cada uma com um exemplo.

Desligar o editor de arquivos do painel

Desliga o editor de arquivos de plugins e temas dentro do painel. Um exemplo de linha:

define( 'DISALLOW_FILE_EDIT', true );

Login e painel por conexão segura

Faz o login e a área administrativa usarem conexão segura. Recomendamos ligar só depois que o site já abre por HTTPS. Um exemplo de linha:

define( 'FORCE_SSL_ADMIN', true );

Limitar as revisões de posts

Por padrão, as revisões ficam ligadas. Com um número, o WordPress guarda no máximo aquela quantidade por post; com false, desliga. Um exemplo de linha:

define( 'WP_POST_REVISIONS', 3 );

Intervalo do salvamento automático

O editor salva um rascunho sozinho a cada 60 segundos, segundo a documentação. Para mudar o intervalo, informe os segundos. Um exemplo de linha:

define( 'AUTOSAVE_INTERVAL', 180 ); // Seconds

Prazo da lixeira

Itens na lixeira são apagados de vez depois de 30 dias, que é o padrão. O valor 0 desliga a lixeira. Um exemplo de linha:

define( 'EMPTY_TRASH_DAYS', 30 ); // 30 days

Atualizações automáticas do núcleo

Aceita três valores: 'minor', o padrão, para atualizar sozinho só as versões menores; true, para menores e maiores; e false, para desligar as atualizações automáticas do núcleo. Um exemplo de linha:

define( 'WP_AUTO_UPDATE_CORE', 'minor' );

Outros assuntos que passam pelo wp-config.php

  • Memória esgotada: o limite de memória do WordPress tem guia próprio na base de conhecimento.
  • Tela branca e erro 500: o modo de depuração é a constante WP_DEBUG, que no modelo vem como false.

Esses dois casos têm passo a passo nos guias específicos.

Como proteger o arquivo

A página de segurança do WordPress (Hardening WordPress) trata o wp-config.php em três pontos.

Permissões

Só você e o servidor web devem conseguir ler o arquivo. Segundo a página, em geral isso significa permissão 400 ou 440. Um exemplo de comando, rodado na pasta do WordPress:

chmod 440 wp-config.php

O valor certo depende de quem é o dono do arquivo e do usuário com que o servidor web roda. Confira isso no seu servidor antes de mudar e teste o site logo depois.

Bloqueio pelo servidor web

Em servidores que usam .htaccess, a página sugere colocar no topo desse arquivo um bloco que nega o acesso ao wp-config.php pelo navegador. Um exemplo de bloco:

<Files "wp-config.php">

Require all denied

</Files>

Sobre o .htaccess, veja Arquivo htaccess: o que é e como editar no site.

Mover o arquivo um nível acima

A mesma página diz que o wp-config.php pode ir para a pasta logo acima da instalação do WordPress, e que, num site instalado na raiz do espaço web, ele pode ficar fora da pasta pública. A página registra o debate: há quem diga que mover traz pouco ganho de segurança e que, feito sem cuidado, pode abrir brechas sérias; outros discordam.

Trocar as chaves e salts

O WordPress.org tem um gerador oficial de chaves, em api.wordpress.org/secret-key/1.1/salt/. Esse gerador mostra oito linhas define, já no formato do arquivo, com valores aleatórios.

Pela documentação de APIs, trocar as chaves invalida os cookies existentes, e todos os usuários conectados precisam entrar de novo. A documentação diz que dá para trocar a qualquer momento com esse objetivo.

Para trocar, substitua as oito linhas antigas pelas novas do gerador e salve. Recomendamos não copiar essas linhas para e-mail, chat ou documento compartilhado: elas são tão sensíveis quanto uma senha.

Um hábito para as próximas mudanças

Recomendamos anotar cada linha que você acrescentou ao wp-config.php e a data da mudança, para saber depois o que cada uma faz.

DNS gerenciado grátis na rede da Cloudflare para domínios registrados na Eleven Host, com painel na área do cliente. Buscar domínio

Perguntas frequentes

Onde fica o wp-config.php?

Na pasta raiz da instalação do WordPress. A página de segurança do WordPress admite também mantê-lo na pasta logo acima da instalação.

Trocar as chaves de segurança tira todo mundo do site?

Tira da conta. Pela documentação, os cookies existentes deixam de valer e os usuários precisam entrar de novo.

Posso mudar o prefixo das tabelas num site que já existe?

Só trocar a linha não resolve: o comentário do modelo do WordPress avisa que, depois da instalação, mudar o prefixo faz o site achar que não foi instalado. Recomendamos definir o prefixo só em instalações novas.

Esta resposta lhe foi útil?

Artigos Relacionados