Você já instalou alguma vez o WordPress ou percebeu que na lista de arquivos da instalação do seu site existe um arquivo chamado wp-config.php? Talvez você sempre quis saber para que ele serve e se poderia ou não modificá-lo. Então, se liga que esse post é justamente sobre como editar wp-config.php no WordPress.
Quando você lê “wp-config”, o que lhe vem a mente? Como o próprio nome sugere, o wp-config.php é um arquivo de configuração que está presente no servidor de hospedagem do seu site e que faz parte do seu WordPress.
Editar wp-config.php no WordPress
Arquivo wp-config.php, O Que É?
Ao contrário dos demais arquivos de instalação do WP, o wp-config.php não vem com os arquivos do WordPress. Ele é gerado apenas quando o sistema é instalado em si, ou seja, é criado especificamente durante o processo de instalação.
É no wp-config.php que o WordPress armazena as informações de acesso e prefixo de tabelas do banco de dados. E nós precisamos passar tais informações durante o processo de instalação do WP em nosso servidor. Sem elas o seu WordPress não vai funcionar e você sempre verá a mensagem de erro “Error Establishing Database Connection”.
Além das informações de banco de dados, o wp-config.php também contém diversas outras configurações e dados de alto nível e confidenciais. Iremos falar sobre elas mais adiante!
Assim, tendo em mente a importância do wp-config.php e das informações armazenadas ali, recomendo fortemente que você não altere-o, a menos que você não tenha nenhuma outra alternativa.
No entanto, se você precisa editar o arquivo de configurações do WordPress, abaixo você verá passo a passo como fazê-lo sem quebrar ou bagunçar seu site.
Mãos à Obra
Antes de fazer qualquer manipulação e edição no wp-config.php, criar um backup do seu site WordPress é recomendável!
Então, a primeira coisa a fazer é um backup completo do sistema. Pois o wp-config.php é crucial para o funcionamento do sistema WP e qualquer erro, mesmo que pequeno, pode deixar seu site inacessível.
Você vai precisar também de um programa como o FileZilla para acesso FTP aos arquivos do site em seu servidor de hospedagem. Esse tipo de programa, chamado de FTP Client, permite a transferência de arquivos entre o seu computador e o servidor.
Além do FileZilla, você também pode utilizar algum Editor de Código que faça ligação FTP com o servidor – exemplo: AptanaStudio, DreamWeaver, dentre outros. É necessário que você tenha em mãos as informações para conexão FTP, como: host, usuário e senha. Se você tem dúvidas sobre tais dados de login FTP, peça ajuda ao seu servidor de hospedagem para obtê-las.
Utilizando o FileZilla
Para este tutorial, eu utilizarei o FileZilla para conexão ao meu servidor e um Editor de Texto, como o Notepad, para editar as informações do wp-config.php.
Então, após conectarmos ao servidor do nosso site WordPress, podemos encontrar o wp-config.php na pasta root ou raíz – isso quer dizer que vai estar entre os primeiros arquivos listados no servidor.
Perceba que no FileZilla, os arquivos do lado esquerdo são referentes as pastas do meu computador e na direita, aos arquivos e pastas do servidor de hospedagem do meu site.
Clique com o botão direito em cima do arquivo wp-config.php e escolha Baixar para fazer download. Lembre-se de na lateral esquerda, acessar a pasta ou local onde você quer que o arquivo baixado seja colocado. Assim, no momento do download o arquivo será salvo onde você estiver com acesso ativo.
Eu escolhi a pasta Desktop, que é referente a Área de Trabalho no meu computador.
Entendendo o wp-config.php
Para a gente começar, quero que você veja o código completo e padrão do wp-config.php. Você pode visualizá-lo abaixo ou clicando para ver no Git do WordPress.
|
01
02
03
04
05
06
07
08
09
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
|
<?php/** * The base configuration for WordPress * * The wp-config.php creation script uses this file during the * installation. You don't have to use the web site, you can * copy this file to "wp-config.php" and fill in the values. * * This file contains the following configurations: * * * MySQL settings * * Secret keys * * Database table prefix * * ABSPATH * * @link https://codex.wordpress.org/Editing_wp-config.php * * @package WordPress */// ** MySQL settings - You can get this info from your web host ** ///** The name of the database for WordPress */define('DB_NAME', 'database_name_here');/** MySQL database username */define('DB_USER', 'username_here');/** MySQL database password */define('DB_PASSWORD', 'password_here');/** MySQL hostname */define('DB_HOST', 'localhost');/** Database Charset to use in creating database tables. */define('DB_CHARSET', 'utf8');/** The Database Collate type. Don't change this if in doubt. */define('DB_COLLATE', '');/**#@+ * Authentication Unique Keys and Salts. * * Change these to different unique phrases! * You can generate these using the {@link https://api.wordpress.org/secret-key/1.1/salt/ WordPress.org secret-key service} * You can change these at any point in time to invalidate all existing cookies. This will force all users to have to log in again. * * @since 2.6.0 */define('AUTH_KEY', 'put your unique phrase here');define('SECURE_AUTH_KEY', 'put your unique phrase here');define('LOGGED_IN_KEY', 'put your unique phrase here');define('NONCE_KEY', 'put your unique phrase here');define('AUTH_SALT', 'put your unique phrase here');define('SECURE_AUTH_SALT', 'put your unique phrase here');define('LOGGED_IN_SALT', 'put your unique phrase here');define('NONCE_SALT', 'put your unique phrase here');/**#@-*//** * WordPress Database Table prefix. * * You can have multiple installations in one database if you give each * a unique prefix. Only numbers, letters, and underscores please! */$table_prefix = 'wp_';/** * For developers: WordPress debugging mode. * * Change this to true to enable the display of notices during development. * It is strongly recommended that plugin and theme developers use WP_DEBUG * in their development environments. * * For information on other constants that can be used for debugging, * visit the Codex. * * @link https://codex.wordpress.org/Debugging_in_WordPress */define('WP_DEBUG', false);/* That's all, stop editing! Happy blogging. *//** Absolute path to the WordPress directory. */if ( !defined('ABSPATH') ) define('ABSPATH', dirname(__FILE__) . '/');/** Sets up WordPress vars and included files. */require_once(ABSPATH . 'wp-settings.php'); |
Nos arquivos de instalação do WordPress vem um arquivo chamado wp-config-sample.php. É baseado nele que o nosso wp-config.php é gerado e tem as nossas informações de banco de dados inseridas.
Perceba que todo o código vem muito bem documentado. E que todas as configurações são definidas utilizando constantes PHP.
|
1
|
define( 'constant_name' , 'value'); |
A seguir, vou te explicar tim tim por tim tim.
Configurações MySQL
Dentro do wp-config.php a partir da seção “MySQL Settings“, nós temos as informações de conexão com o banco de dados – host, nome do banco, nome de usuário, senha, etc.
|
01
02
03
04
05
06
07
08
09
10
11
12
13
|
// ** MySQL settings - You can get this info from your web host ** ///** Nome do banco de dados */define('DB_NAME', 'database_name_here');/** usuário do banco de dados */define('DB_USER', 'username_here');/** senha do banco de dados */define('DB_PASSWORD', 'password_here');/** Nome do host */define('DB_HOST', 'localhost');/** Database Charset to use in creating database tables. */define('DB_CHARSET', 'utf8');/** The Database Collate type. Don't change this if in doubt. */define('DB_COLLATE', ''); |
Assim, se você por algum motivo precisa alterar as informações para conexão com o banco de dados do seu site, basta inserir as novas informações. Por exemplo, onde tem “database_name_here” você deve preencher com o nome do banco de dados que você quer conectar.
De modo geral, apenas o nome do banco, usuário e senha precisam ser configurados nesta parte.
Chaves de Autenticação
Authentication Keys ou Chaves de Autenticação são chaves de segurança geradas para garantir a segurança e confiabilidade do seu site WordPress. Elas são formadas por uma forte encriptação para sessões de login de usuário e cookies gerados pelo próprio sistema do WP.
|
01
02
03
04
05
06
07
08
09
10
11
12
13
14
15
16
17
18
|
/**#@+ * Authentication Unique Keys and Salts. * * Change these to different unique phrases! * You can generate these using the {@link https://api.wordpress.org/secret-key/1.1/salt/ WordPress.org secret-key service} * You can change these at any point in time to invalidate all existing cookies. This will force all users to have to log in again. * * @since 2.6.0 */define('AUTH_KEY', 'put your unique phrase here');define('SECURE_AUTH_KEY', 'put your unique phrase here');define('LOGGED_IN_KEY', 'put your unique phrase here');define('NONCE_KEY', 'put your unique phrase here');define('AUTH_SALT', 'put your unique phrase here');define('SECURE_AUTH_SALT', 'put your unique phrase here');define('LOGGED_IN_SALT', 'put your unique phrase here');define('NONCE_SALT', 'put your unique phrase here');/**#@-*/ |
Se por algum motivo você achar que as chaves geradas no momento da instalação estão comprometidas, você pode gerar novas chaves de segurança WordPress, copiar e colar.
Detalhe importante: se você alterar as Chaves de Autenticação, todos os usuários logados – inclusive o Admin, serão deslogados (logout). Sendo necessário realizar novamente o processo de login.
Prefixo para Tabelas do Banco de Dados
Logo após a área de Authentication Keys (Chaves de Autenticação), nós encontramos a seção de configuração WordPress Database Table Prefix. Em português claro, Prefixo para Tabelas de Banco de Dados WordPress.
|
1
2
3
4
5
6
7
|
/** * WordPress Database Table prefix. * * You can have multiple installations in one database if you give each * a unique prefix. Only numbers, letters, and underscores please! */$table_prefix = 'wp_'; |
Por padrão o prefixo vem configurado como wp_. Você pode mudar esse prefixo no momento da instalação do WordPress ou no wp-config.php. Entretanto, respeite o underline após o prefixo sempre! Exemplo de novo prefixo: cwp_
Se for mudar no arquivo de configuração, é necessário que as tabelas, se já existirem, tenham o prefixo que será informado – caso contrário, você vai se deparar com Erro de Banco de Dados.
É recomendado criar um prefixo personalizado para as tabelas. Isso porque dificulta a investida de hackers por meio de ataques ao seu banco de dados MySQL.
WordPress Debugging Mode
Para desenvolvedores e usuários curiosos que querem testar funções em seu WordPress, habilitar o debugging mode é interessante. Pois o debug é recomendado para testes!
Por padrão o modo de debug vem desativado, ocultando qualquer notificação que o PHP gere durante a execução do código.
Ativar o debugging mode no WordPress é muito fácil. Dentro do wp-config.php você precisa definir a respectiva constante com o valor de TRUE.
|
1
|
define('WP_DEBUG', true); |
Para desativar, não permitindo que seus visitantes e nem você visualize notificações PHP, deixe o valor da contante como FALSE.
|
1
|
define('WP_DEBUG', false); |
Configuração de Absolute Path
A última parte de configurações essenciais do wp-config.php para funcionamento do seu WordPress é a de absolute path ou caminhos absolutos.
O caminho absoluto é usado para configurar variáveis WordPress e arquivos inclusos para sua instalação. Então, aqui você não precisa mudar nada.
Dicas Práticas
Agora que você já entendeu a importância e estrutura das informações, dados e configurações dentro do wp-config.php, vou te passar algumas dicas legais que você pode querer implementar em seu site. Tudo utilizando esse arquivo de configuração.
Desabilitar Atualizações Automáticas do WordPress
O WordPress, por padrão, atualiza o sistema do seu site assim que uma nova versão do CMS é lançada. É excelente para manter o seu WP atual, com as ferramentas mais novas e tecnologias mais seguras.
No entanto, se você não tem certeza de que seus plugins e temas se manterão compatíveis com a nova atualização do WordPress, desabilitar as atualizações automáticas para o WordPress é muito interessante.
Se é isso que você quer, basta copiar e colar a linha abaixo para seu wp-config.php.
|
1
|
define( 'WP_AUTO_UPDATE_CORE', false ); |
Alterar URLs do Site
Para quando precisamos alterar as URLs do nosso site WordPress, podemos acessar em nossa Dashboard a parte de Configurações > Geral e informar o novo domínio e endereço do nosso site.
Entretanto, como que a gente faz se não temos acesso ao Painel Administrativo (Dashboard)? Precisaremos recorrer ao wp-config.php.
Assim, no código abaixo você precisa apenas adicionar a sua nova URL e salvar dentro do wp-config.php
|
1
2
|
define('WP_HOME','http://seunovosite.com.br');define('WP_SITEURL','http://seunovosite.com.br'); |
Dica importante: quando alteramos o domínio do nosso site, precisamos manter nossas regras de SEO atualizadas e pertinentes ao novo site.
Limitar Revisões para Posts
O WordPress tem um sistema inteligente para salvar automaticamente posts no momento em que estamos editando. Isso é muito útil pois permite recuperar conteúdo antigo e ainda evita perder aquilo que criamos – por algum erro que venha a ocorrer, como esquecer de clicar em “salvar” e fechar a página.
Por isso, para que seu sistema não armazene demasiadas versões, você pode definir um número para limitar as revisões para posts.
Copie e cole a linha de código abaixo, alterando apenas o número para a quantia de revisões que deseja limitar.
|
1
|
define( 'WP_POST_REVISIONS', 5 ); |
Conclusão
O wp-config.php é um arquivo fundamental para o funcionamento e segurança do seu site WordPress. As informações mais importantes do seu site – como acesso a banco de dados e chaves de autenticação, são armazenadas ali.
É fundamental o cuidado com a edição deste arquivo e também com a segurança para o acesso aos arquivos do seu WordPress.
De forma alguma é recomendado começar a manipular o wp-config.php sem antes ter um backup completo do seu site ou pelo menos, do específico arquivo que será editado.
