Você leu um tutorial que pede para você editar seu arquivo wp-config e você não tem ideia do que é? Bem, nós temos você coberto. Neste artigo, mostraremos como editar corretamente o arquivo wp-config.php no WordPress.
O que é o arquivo wp-config.php?
Como o nome sugere, é um arquivo de configuração que faz parte de todos os sites WordPress auto-hospedados .
Ao contrário de outros arquivos, o arquivo wp-config.php não vem embutido no WordPress, mas é gerado especificamente para o seu site durante o processo de instalação.
O WordPress armazena as informações do seu banco de dados no arquivo wp-config.php. Sem essas informações, seu site WordPress não funcionará e você receberá o erro ‘ erro ao estabelecer conexão com o banco de dados ‘.
Além das informações do banco de dados, o arquivo wp-config.php também contém várias outras configurações de alto nível. Vamos explicá-los mais adiante neste artigo.
Como esse arquivo contém muitas informações confidenciais, é recomendável que você não mexa com ele, a menos que não tenha outra escolha.
Mas já que você está lendo este artigo, significa que você tem que editar o arquivo wp-config.php. Abaixo estão os passos para fazê-lo sem bagunçar as coisas.
Vídeo tutorial
Inscreva-se no WPBeginner
Se você não gostar do vídeo ou precisar de mais instruções, continue lendo.
Começando
A primeira coisa que você precisa fazer é criar um backup completo do WordPress . O arquivo wp-config.php é tão crucial para um site WordPress que um pequeno erro tornará seu site inacessível.
Você precisará de um cliente FTP para se conectar ao seu site. Usuários de Windows podem instalar WinSCP ou SmartFTP e usuários de Mac podem tentar Transmit ou CyberDuck. Um cliente FTP permite transferir arquivos entre um servidor e seu computador.
Conecte-se ao seu site usando o cliente FTP . Você precisará de informações de login de FTP que você pode obter de seu host. Se você não souber suas informações de login de FTP, poderá solicitar suporte ao seu host da web.
O arquivo wp-config.php geralmente está localizado na pasta raiz do seu site com outras pastas como /wp-content/.
Basta clicar com o botão direito do mouse no arquivo e selecionar download no menu. Seu cliente FTP agora baixará o arquivo wp-config.php para o seu computador. Você pode abri-lo e editá-lo usando um programa de edição de texto simples como o Bloco de Notas ou o Text Edit.
Entendendo o arquivo wp-config.php
Antes de começar, vamos dar uma olhada no código completo do arquivo padrão wp-config.php. Você também pode ver uma amostra deste arquivo aqui .
1234567891011121314151617181920212223242526272829303132333435363738394041424344454647484950515253545556575859606162636465666768697071727374757677787980818283848586878889 | <?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’); |
Cada seção do arquivo wp-config.php está bem documentada no próprio arquivo. Quase todas as configurações aqui são definidas usando PHP Constants.
1 | define( ‘constant_name’ , ‘value’); |
Vamos dar uma olhada em cada seção no arquivo wp-config.php.
Configurações do MySQL no arquivo wp-config.php
Suas configurações de conexão de banco de dados do WordPress aparecem na seção ‘Configurações do MySQL’ do arquivo wp-config.php. Você precisará do seu host MySQL, nome do banco de dados, nome de usuário do banco de dados e senha para preencher esta seção.
123456789101112131415161718 | // ** 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’, ”); |
Você pode obter as informações do seu banco de dados do cPanel da sua conta de hospedagem na seção “bancos de dados”.
Se você não conseguir encontrar seu banco de dados do WordPress ou nome de usuário e senha do MySQL, precisará entrar em contato com seu host.
Chaves e Sais de Autenticação
Chaves e sais exclusivos de autenticação são chaves de segurança que ajudam a melhorar a segurança do seu site WordPress. Essas chaves fornecem uma criptografia forte para sessões de usuários e cookies gerados pelo WordPress. Consulte nosso guia sobre chaves de segurança do WordPress para obter mais informações.
12345678910111213141516171819 | /**#@+ * 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’); /**#@-*/ |
Você pode gerar chaves de segurança do WordPress e colá-las aqui. Isso é particularmente útil se você suspeitar que seu site WordPress pode ter sido comprometido. A alteração das chaves de segurança fará o logout de todos os usuários atualmente conectados em seu site WordPress, forçando-os a fazer login novamente.
Prefixo da tabela de banco de dados do WordPress
Por padrão, o WordPress adiciona o prefixo wp_ a todas as tabelas criadas pelo WordPress. É recomendável que você altere o prefixo da tabela de banco de dados do WordPress para algo aleatório. Isso tornará difícil para os hackers adivinharem suas tabelas do WordPress e evitará alguns ataques comuns de injeção de SQL.
1234567 | /** * 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_’; |
Observe que você não pode alterar esse valor para um site WordPress existente. Siga as instruções em nosso artigo sobre como alterar o prefixo do banco de dados do WordPress para alterar essas configurações em um site WordPress existente.
Modo de depuração do WordPress
Essa configuração é particularmente útil para usuários tentando aprender o desenvolvimento do WordPress e usuários tentando recursos experimentais. Por padrão, o WordPress oculta os avisos gerados pelo PHP ao executar o código. Basta definir o modo de depuração como verdadeiro para mostrar esses avisos. Isso fornece informações cruciais para os desenvolvedores encontrarem bugs.
1 | define(‘WP_DEBUG’, false); |
Configurações de caminho absoluto
A última parte do arquivo wp-config define o caminho absoluto que é usado para configurar as variáveis
12345 | /** 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’); |
Hacks e configurações úteis do wp-config.php
Existem algumas outras configurações do wp-config.php que podem ajudá-lo a solucionar erros e resolver muitos erros comuns do WordPress .
Alterando a porta e os soquetes do MySQL no WordPress
Se o seu provedor de hospedagem WordPress usa portas alternativas para o host MySQL, você precisará alterar seu valor DB_HOST para incluir o número da porta. Observe que esta não é uma nova linha, mas você precisa editar o valor DB_HOST existente.
1 | define( ‘DB_HOST’, ‘localhost:5067’ ); |
Não se esqueça de alterar o número da porta 5067 para qualquer número de porta fornecido pelo seu host.
Se o seu host usa soquetes e pipes para MySQL, você precisará adicioná-lo assim:
1 | define( ‘DB_HOST’, ‘localhost:/var/run/mysqld/mysqld.sock’ ); |
Alterando URLs do WordPress usando o arquivo wp-config.php
Pode ser necessário alterar os URLs do WordPress ao mover um site WordPress para um novo nome de domínio ou um novo host. Você pode alterar esses URLs visitando a página Configurações » Geral .
Você também pode alterar essas URLs usando o arquivo wp-config.php. Isso é útil se você não conseguir acessar a área de administração do WordPress devido ao erro de muitos direcionamentos . Simplesmente adicione estas duas linhas ao seu arquivo wp-config.php:
12 | define(‘WP_HOME’,’http://example.com’);define(‘WP_SITEURL’,’http://example.com’); |
Não se esqueça de substituir example.com pelo seu próprio nome de domínio. Você também precisa ter em mente que os mecanismos de pesquisa tratam www.example.com e example.com como dois locais diferentes (Veja www vs non-www – Qual é o melhor para SEO? ). Se o seu site estiver indexado com o prefixo www, você precisará adicionar seu nome de domínio de acordo.
Alterar o diretório de uploads usando wp-config.php
Por padrão, o WordPress armazena todos os seus uploads de mídia no diretório /wp-content/uploads/. Se você deseja armazenar seus arquivos de mídia em outro local, pode fazê-lo adicionando esta linha de código em seu arquivo wp-config.php.
1 | define( ‘UPLOADS’, ‘wp-content/media’ ); |
Observe que o caminho do diretório de uploads é relativo ao ABSPATH definido automaticamente no WordPress. Adicionar um caminho absoluto aqui não funcionará. Consulte o guia detalhado sobre como alterar o local de upload de mídia padrão no WordPress para obter mais informações.
Desative as atualizações automáticas no WordPress
WordPress introduziu atualizações automáticas no WordPress 3.7. Permitiu que os sites do WordPress atualizassem automaticamente quando houver uma pequena atualização disponível. Embora as atualizações automáticas sejam ótimas para segurança, mas em alguns casos elas podem quebrar um site WordPress tornando-o inacessível.
Adicionar esta única linha de código ao seu arquivo wp-config.php desativará todas as atualizações automáticas em seu site WordPress.
1 | define( ‘WP_AUTO_UPDATE_CORE’, false ); |
Veja nosso tutorial sobre como desabilitar as atualizações automáticas no WordPress para mais informações.
Limitar revisões de postagens no WordPress
O WordPress vem com salvamento automático e revisões integrados. Veja nosso tutorial sobre como desfazer alterações no WordPress com revisões de posts . No entanto, se você executar uma grande revisão do site, pode aumentar o tamanho do backup do banco de dados do WordPress.
Adicione esta linha de código ao seu arquivo wp-config.php para limitar o número de revisões armazenadas para um post.
1 | define( ‘WP_POST_REVISIONS’, 3 ); |
Substitua 3 pelo número de revisões que você deseja armazenar. O WordPress agora descartará automaticamente as revisões mais antigas. No entanto, suas revisões de postagem mais antigas ainda são armazenadas em seu banco de dados. Veja nosso tutorial sobre como excluir revisões de posts antigos no WordPress .
Esperamos que este artigo tenha ajudado você a aprender como editar o arquivo wp-config.php no WordPress e todas as coisas legais que você pode fazer com ele. Você também pode querer ver nosso artigo sobre mais de 25 truques extremamente úteis para o arquivo de funções do WordPress .
Se você gostou deste artigo, assine nosso canal do YouTube para tutoriais em vídeo do WordPress. Você também pode nos encontrar no Twitter e no Facebook .