{"id":246,"date":"2026-05-11T07:00:47","date_gmt":"2026-05-11T10:00:47","guid":{"rendered":"https:\/\/www.portanova.com.br\/?p=1"},"modified":"2026-05-21T20:25:38","modified_gmt":"2026-05-21T23:25:38","slug":"wp-config-guide","status":"publish","type":"post","link":"https:\/\/www.portanova.com.br\/notebook\/wp-config-guide\/","title":{"rendered":"[WP] Guia Completo: arquivo wp-config no WordPress"},"content":{"rendered":"<h1>\ud83d\udcd8 Guia Completo: O arquivo <code>wp-config.php<\/code> no WordPress<\/h1>\n<p>O arquivo <code>wp-config.php<\/code> \u00e9 o cora\u00e7\u00e3o da configura\u00e7\u00e3o do seu site WordPress. Ele fica na pasta raiz da instala\u00e7\u00e3o e cont\u00e9m informa\u00e7\u00f5es essenciais como a conex\u00e3o com o banco de dados, chaves de seguran\u00e7a, configura\u00e7\u00f5es de desempenho, seguran\u00e7a e, no caso de uma rede Multisite, as diretrizes para gerenciar v\u00e1rios sites.<\/p>\n<p><strong>Importante:<\/strong> Este guia \u00e9 <strong>did\u00e1tico<\/strong>. Os valores mostrados s\u00e3o <strong>modelos<\/strong> (ex: <code>MODELO_<\/code>). Nunca copie exemplos diretamente para seu site real \u2013 use os dados fornecidos pelo seu servidor de hospedagem e gere chaves de seguran\u00e7a \u00fanicas.<\/p>\n<hr \/>\n<h2>\ud83d\udcc4 Estrutura b\u00e1sica do <code>wp-config.php<\/code> (modelo did\u00e1tico)<\/h2>\n<pre><code>&lt;?php\r\n\/**\r\n * Arquivo de configura\u00e7\u00e3o do WordPress\r\n *\r\n * Define as configura\u00e7\u00f5es principais do site:\r\n * - conex\u00e3o com o banco de dados\r\n * - chaves de seguran\u00e7a\r\n * - prefixo das tabelas\r\n * - modo de depura\u00e7\u00e3o\r\n * - op\u00e7\u00f5es especiais (Multisite, cron, etc.)\r\n *\/\r\n\r\n\/\/ ===============================================\r\n\/\/ 1. CONEX\u00c3O COM O BANCO DE DADOS\r\n\/\/ ===============================================\r\n\/\/ Esses dados s\u00e3o fornecidos pelo seu servi\u00e7o de hospedagem.\r\n\/\/ Mantenha sua senha em segredo!\r\n\r\ndefine( 'DB_NAME',     'MODELO_NOME_DO_BANCO' );      \/\/ Nome do banco de dados\r\ndefine( 'DB_USER',     'MODELO_USUARIO_DO_BANCO' );   \/\/ Usu\u00e1rio do banco de dados\r\ndefine( 'DB_PASSWORD', 'MODELO_SENHA_DO_BANCO' );     \/\/ Senha do banco de dados\r\ndefine( 'DB_HOST',     'MODELO_HOST_DO_BANCO' );      \/\/ Geralmente 'localhost'\r\ndefine( 'DB_CHARSET',  'utf8' );                     \/\/ Conjunto de caracteres\r\ndefine( 'DB_COLLATE',  '' );                         \/\/ Collation (deixe vazio)\r\n\r\n\/\/ ===============================================\r\n\/\/ 2. PREFIXO DAS TABELAS\r\n\/\/ ===============================================\r\n\/\/ Evita conflitos se voc\u00ea tiver mais de um WordPress no mesmo banco.\r\n\/\/ No Multisite, o prefixo \u00e9 combinado com o ID do blog (ex: wp_2_posts)\r\n$table_prefix = 'MODELO_PREFIXO_';   \/\/ Exemplo: 'wp_'\r\n\r\n\/\/ ===============================================\r\n\/\/ 3. CHAVES DE SEGURAN\u00c7A (SALTS)\r\n\/\/ ===============================================\r\n\/\/ Protegem os cookies de login. Gere valores \u00fanicos em:\r\n\/\/ https:\/\/api.wordpress.org\/secret-key\/1.1\/salt\/\r\n\/\/ NUNCA use \"frase_\u00fanica_aqui\" em produ\u00e7\u00e3o.\r\n\r\ndefine('AUTH_KEY',         'MODELO_frase_\u00fanica_aqui');\r\ndefine('SECURE_AUTH_KEY',  'MODELO_frase_\u00fanica_aqui');\r\ndefine('LOGGED_IN_KEY',    'MODELO_frase_\u00fanica_aqui');\r\ndefine('NONCE_KEY',        'MODELO_frase_\u00fanica_aqui');\r\ndefine('AUTH_SALT',        'MODELO_frase_\u00fanica_aqui');\r\ndefine('SECURE_AUTH_SALT', 'MODELO_frase_\u00fanica_aqui');\r\ndefine('LOGGED_IN_SALT',   'MODELO_frase_\u00fanica_aqui');\r\ndefine('NONCE_SALT',       'MODELO_frase_\u00fanica_aqui');\r\n\r\n\/\/ ===============================================\r\n\/\/ 4. MODO DE DEPURA\u00c7\u00c3O (DEBUG)\r\n\/\/ ===============================================\r\n\/\/ Ative apenas em ambiente de desenvolvimento.\r\n\/\/ Em produ\u00e7\u00e3o, mantenha false.\r\ndefine('WP_DEBUG', false);\r\n\r\n\/\/ ===============================================\r\n\/\/ 5. CONFIGURA\u00c7\u00d5ES CUSTOMIZADAS\r\n\/\/ ===============================================\r\n\/\/ Nesta se\u00e7\u00e3o voc\u00ea pode adicionar suas pr\u00f3prias constantes.\r\n\/\/ Exemplo: ativar Multisite, aumentar mem\u00f3ria, desativar cron, etc.\r\n\/\/\r\n\/* Add any custom values between this line and the \"stop editing\" line. *\/\r\n\r\n\/\/ -------------- SUAS CONFIGURA\u00c7\u00d5ES AQUI --------------\r\n\/\/ define( 'WP_ALLOW_MULTISITE', true );\r\n\/\/ define( 'WP_MEMORY_LIMIT', '256M' );\r\n\/\/ define( 'DISABLE_WP_CRON', true );\r\n\/\/ -----------------------------------------------------\r\n\r\n\/* That's all, stop editing! Happy publishing. *\/\r\n\r\n\/\/ ===============================================\r\n\/\/ 6. CARREGAMENTO DO WORDPRESS\r\n\/\/ ===============================================\r\n\/\/ N\u00e3o altere as linhas abaixo \u2013 elas carregam o sistema.\r\nif ( ! defined( 'ABSPATH' ) ) {\r\n    define( 'ABSPATH', __DIR__ . '\/' );\r\n}\r\nrequire_once ABSPATH . 'wp-settings.php';\r\n<\/code><\/pre>\n<hr \/>\n<h2>\ud83e\udde0 Explica\u00e7\u00e3o de cada se\u00e7\u00e3o<\/h2>\n<h3>\ud83d\udd39 1. Banco de dados<\/h3>\n<ul>\n<li><code>DB_NAME<\/code> \u2192 Nome do banco de dados onde o WordPress guarda posts, p\u00e1ginas, usu\u00e1rios etc.<\/li>\n<li><code>DB_USER<\/code> \u2192 Usu\u00e1rio que tem permiss\u00e3o para acessar esse banco.<\/li>\n<li><code>DB_PASSWORD<\/code> \u2192 Senha do usu\u00e1rio. <strong>Nunca compartilhe<\/strong>.<\/li>\n<li><code>DB_HOST<\/code> \u2192 Endere\u00e7o do servidor do banco (geralmente <code>localhost<\/code>).<\/li>\n<\/ul>\n<h3>\ud83d\udd39 2. Prefixo das tabelas (<code>$table_prefix<\/code>)<\/h3>\n<p>Define como as tabelas ser\u00e3o nomeadas. Exemplo: com o prefixo <code>'wp_'<\/code>, os posts ficam em <code>wp_posts<\/code>. No Multisite, cada blog filho usa tabelas como <code>wp_2_posts<\/code> (onde <code>2<\/code> \u00e9 o ID do blog).<\/p>\n<h3>\ud83d\udd39 3. Chaves de seguran\u00e7a (Salt e Keys)<\/h3>\n<p>C\u00f3digos aleat\u00f3rios que criptografam os cookies de login. <strong>Devem ser \u00fanicos e secretos<\/strong>. Use o gerador oficial do WordPress para criar valores reais.<\/p>\n<h3>\ud83d\udd39 4. Modo de depura\u00e7\u00e3o (<code>WP_DEBUG<\/code>)<\/h3>\n<p>Quando <code>true<\/code>, exibe todos os erros e avisos do PHP. Essencial para desenvolvimento, mas <strong>perigoso em produ\u00e7\u00e3o<\/strong> (pode expor informa\u00e7\u00f5es sens\u00edveis).<\/p>\n<h3>\ud83d\udd39 5. Configura\u00e7\u00f5es customizadas<\/h3>\n<p>\u00c9 a \u00e1rea onde voc\u00ea adiciona constantes extras, como as listadas nas pr\u00f3ximas se\u00e7\u00f5es (Multisite, desempenho, seguran\u00e7a, WooCommerce, etc.).<\/p>\n<h3>\ud83d\udd39 6. Carregamento final<\/h3>\n<p>Define o caminho absoluto da instala\u00e7\u00e3o e carrega o arquivo <code>wp-settings.php<\/code>, que inicia o WordPress. <strong>N\u00e3o mexa nessas linhas<\/strong>.<\/p>\n<hr \/>\n<h2>\ud83c\udf10 Configura\u00e7\u00f5es espec\u00edficas para Multisite (rede de sites)<\/h2>\n<p>Para transformar um WordPress comum em uma rede Multisite, adicione as seguintes constantes na se\u00e7\u00e3o customizada <strong>antes de instalar a rede<\/strong>. Depois da instala\u00e7\u00e3o, o WordPress gerar\u00e1 algumas constantes automaticamente.<\/p>\n<pre><code>\/\/ ===============================================\r\n\/\/ ATIVAR O MODO MULTISITE\r\n\/\/ ===============================================\r\ndefine('WP_ALLOW_MULTISITE', true);   \/\/ Permite a cria\u00e7\u00e3o da rede\r\n\r\n\/\/ Ap\u00f3s instalar a rede, o WordPress gera estas constantes:\r\ndefine('MULTISITE', true);             \/\/ Declara que a rede est\u00e1 ativa\r\ndefine('SUBDOMAIN_INSTALL', false);    \/\/ false = subdiret\u00f3rios (ex: site.com\/notebook\/); true = subdom\u00ednios (ex: notebook.site.com)\r\ndefine('DOMAIN_CURRENT_SITE', 'www.portanova.com.br'); \/\/ Dom\u00ednio principal da rede\r\ndefine('PATH_CURRENT_SITE', '\/');      \/\/ Caminho da raiz da rede\r\ndefine('SITE_ID_CURRENT_SITE', 1);     \/\/ ID do site principal\r\ndefine('BLOG_ID_CURRENT_SITE', 1);     \/\/ ID do blog principal (sin\u00f4nimo)\r\n<\/code><\/pre>\n<p><strong>\ud83d\udccc Em um site WordPress normal (single site), nenhuma dessas constantes deve existir.<\/strong> Se voc\u00ea adicionar <code>WP_ALLOW_MULTISITE<\/code> ou <code>MULTISITE<\/code> em um site single, poder\u00e1 causar erros.<\/p>\n<hr \/>\n<h2>\u2699\ufe0f Configura\u00e7\u00f5es comuns para sites normais (single site)<\/h2>\n<p>As constantes abaixo s\u00e3o \u00fateis para qualquer site WordPress, independentemente de ser Multisite ou n\u00e3o. Elas melhoram desempenho, seguran\u00e7a e gerenciamento de conte\u00fado.<\/p>\n<h3>\ud83d\udd27 Desempenho e recursos<\/h3>\n<table class=\"wp-list-table widefat fixed striped\">\n<thead>\n<tr>\n<th>Constante<\/th>\n<th>Descri\u00e7\u00e3o<\/th>\n<th>Exemplo<\/th>\n<\/tr>\n<\/thead>\n<tbody>\n<tr>\n<td><code>WP_MEMORY_LIMIT<\/code><\/td>\n<td>Mem\u00f3ria PHP para o front-end do site.<\/td>\n<td><code>define('WP_MEMORY_LIMIT', '256M');<\/code><\/td>\n<\/tr>\n<tr>\n<td><code>WP_MAX_MEMORY_LIMIT<\/code><\/td>\n<td>Mem\u00f3ria para a \u00e1rea administrativa (<code>\/wp-admin<\/code>).<\/td>\n<td><code>define('WP_MAX_MEMORY_LIMIT', '512M');<\/code><\/td>\n<\/tr>\n<tr>\n<td><code>WP_CACHE<\/code><\/td>\n<td>Ativa o cache de p\u00e1gina (usado por plugins de cache).<\/td>\n<td><code>define('WP_CACHE', true);<\/code><\/td>\n<\/tr>\n<tr>\n<td><code>AUTOSAVE_INTERVAL<\/code><\/td>\n<td>Intervalo (segundos) entre salvamentos autom\u00e1ticos.<\/td>\n<td><code>define('AUTOSAVE_INTERVAL', 300);<\/code><\/td>\n<\/tr>\n<\/tbody>\n<\/table>\n<h3>\ud83d\udd12 Seguran\u00e7a<\/h3>\n<table class=\"wp-list-table widefat fixed striped\">\n<thead>\n<tr>\n<th>Constante<\/th>\n<th>Descri\u00e7\u00e3o<\/th>\n<th>Exemplo<\/th>\n<\/tr>\n<\/thead>\n<tbody>\n<tr>\n<td><code>DISALLOW_FILE_EDIT<\/code><\/td>\n<td>Remove o editor de temas e plugins do admin.<\/td>\n<td><code>define('DISALLOW_FILE_EDIT', true);<\/code><\/td>\n<\/tr>\n<tr>\n<td><code>FORCE_SSL_ADMIN<\/code><\/td>\n<td>For\u00e7a toda a administra\u00e7\u00e3o via HTTPS.<\/td>\n<td><code>define('FORCE_SSL_ADMIN', true);<\/code><\/td>\n<\/tr>\n<tr>\n<td><code>WP_AUTO_UPDATE_CORE<\/code><\/td>\n<td>Controla atualiza\u00e7\u00f5es autom\u00e1ticas do n\u00facleo.<\/td>\n<td><code>define('WP_AUTO_UPDATE_CORE', 'minor');<\/code><\/td>\n<\/tr>\n<\/tbody>\n<\/table>\n<h3>\ud83d\udcdd Conte\u00fado e banco de dados<\/h3>\n<table class=\"wp-list-table widefat fixed striped\">\n<thead>\n<tr>\n<th>Constante<\/th>\n<th>Descri\u00e7\u00e3o<\/th>\n<th>Exemplo<\/th>\n<\/tr>\n<\/thead>\n<tbody>\n<tr>\n<td><code>WP_POST_REVISIONS<\/code><\/td>\n<td>Limita o n\u00famero de revis\u00f5es por post.<\/td>\n<td><code>define('WP_POST_REVISIONS', 5);<\/code><\/td>\n<\/tr>\n<tr>\n<td><code>EMPTY_TRASH_DAYS<\/code><\/td>\n<td>Dias at\u00e9 exclus\u00e3o permanente da lixeira.<\/td>\n<td><code>define('EMPTY_TRASH_DAYS', 15);<\/code><\/td>\n<\/tr>\n<tr>\n<td><code>WP_ALLOW_REPAIR<\/code><\/td>\n<td>Ativa a ferramenta de reparo do banco em <code>\/wp-admin\/maint\/repair.php<\/code>.<\/td>\n<td><code>define('WP_ALLOW_REPAIR', true);<\/code><\/td>\n<\/tr>\n<\/tbody>\n<\/table>\n<h3>\ud83d\uded2 WooCommerce e plugins populares<\/h3>\n<table class=\"wp-list-table widefat fixed striped\">\n<thead>\n<tr>\n<th>Constante<\/th>\n<th>Descri\u00e7\u00e3o<\/th>\n<th>Exemplo<\/th>\n<\/tr>\n<\/thead>\n<tbody>\n<tr>\n<td><code>WC_REMOVE_ALL_BUTTONS<\/code><\/td>\n<td>Remove bot\u00f5es de a\u00e7\u00e3o em massa na lista de produtos (WooCommerce).<\/td>\n<td><code>define('WC_REMOVE_ALL_BUTTONS', true);<\/code><\/td>\n<\/tr>\n<tr>\n<td><code>WC_TAX_ROUNDING_MODE<\/code><\/td>\n<td>Altera o arredondamento de impostos.<\/td>\n<td><code>define('WC_TAX_ROUNDING_MODE', 'auto');<\/code><\/td>\n<\/tr>\n<tr>\n<td><code>WPS_ROLES_CACHE<\/code><\/td>\n<td>Ativa\/desativa cache de pap\u00e9is de usu\u00e1rio no WP Statistics.<\/td>\n<td><code>define('WPS_ROLES_CACHE', false);<\/code><\/td>\n<\/tr>\n<\/tbody>\n<\/table>\n<hr \/>\n<h2>\u2705 Exemplo pr\u00e1tico da se\u00e7\u00e3o customizada no <code>wp-config.php<\/code><\/h2>\n<p>Abaixo est\u00e1 um exemplo real de como voc\u00ea pode organizar suas constantes entre os coment\u00e1rios indicados:<\/p>\n<pre><code>\/* Add any custom values between this line and the \"stop editing\" line. *\/\r\n\r\n\/\/ 1. MULTISITE (se for uma rede)\r\ndefine('WP_ALLOW_MULTISITE', true);\r\ndefine('MULTISITE', true);\r\ndefine('SUBDOMAIN_INSTALL', false);\r\ndefine('DOMAIN_CURRENT_SITE', 'www.portanova.com.br');\r\ndefine('PATH_CURRENT_SITE', '\/');\r\ndefine('SITE_ID_CURRENT_SITE', 1);\r\ndefine('BLOG_ID_CURRENT_SITE', 1);\r\n\r\n\/\/ 2. DESEMPENHO\r\ndefine('WP_MEMORY_LIMIT', '512M');\r\ndefine('WP_CACHE', true);\r\ndefine('DISABLE_WP_CRON', true);\r\n\r\n\/\/ 3. SEGURAN\u00c7A\r\ndefine('DISALLOW_FILE_EDIT', true);\r\ndefine('FORCE_SSL_ADMIN', true);\r\n\r\n\/\/ 4. CONTE\u00daDO\r\ndefine('WP_POST_REVISIONS', 5);\r\ndefine('EMPTY_TRASH_DAYS', 15);\r\n\r\n\/\/ 5. PLUGINS (ex: Akismet, WP Super Cache)\r\ndefine('WPCOM_API_KEY', '983e0f6c595e');\r\ndefine('WPSC_READABLE_WARNING', false);\r\n\r\n\/\/ 6. DEBUG (apenas desenvolvimento)\r\ndefine('WP_DEBUG', true);\r\ndefine('WP_DEBUG_LOG', true);\r\ndefine('WP_DEBUG_DISPLAY', false);\r\n@ini_set('display_errors', 0);\r\n\r\n\/\/ 7. QUERY MONITOR (desativar no Elementor)\r\nif ( isset( $_GET['action'] ) &amp;&amp; $_GET['action'] === 'elementor' ) {\r\n    define( 'QM_DISABLED', true );\r\n}\r\n\r\n\/* That's all, stop editing! Happy publishing. *\/\r\n<\/code><\/pre>\n<hr \/>\n<h2>\u26a0\ufe0f Cuidados importantes<\/h2>\n<ul>\n<li>Fa\u00e7a sempre um <strong>backup do arquivo original<\/strong> antes de edit\u00e1-lo.<\/li>\n<li>Um erro de sintaxe (como falta de ponto e v\u00edrgula) pode derrubar o site inteiro.<\/li>\n<li>Nunca compartilhe suas chaves de seguran\u00e7a ou senha do banco de dados.<\/li>\n<li>Se mudar de servidor, atualize os dados do banco e as URLs (use o plugin <strong>Better Search Replace<\/strong> ou WP-CLI).<\/li>\n<li>Em sites normais (single site), evite colocar constantes de Multisite \u2013 elas podem causar erros inesperados.<\/li>\n<\/ul>\n<p><strong>Pr\u00f3ximo passo:<\/strong> Agora que voc\u00ea entende o <code>wp-config.php<\/code>, pode estudar como migrar um site normal para Multisite ou como adicionar outras constantes avan\u00e7adas (como <code>WP_SITEURL<\/code>, <code>WP_HOME<\/code>, <code>COOKIE_DOMAIN<\/code>).<\/p>\n<p><em>Este guia foi feito para estudo. Consulte a <a href=\"https:\/\/br.wordpress.org\/support\/article\/editing-wp-config-php\/\" target=\"_blank\" rel=\"noopener\">documenta\u00e7\u00e3o oficial<\/a> para informa\u00e7\u00f5es completas.<\/em><\/p>\n","protected":false},"excerpt":{"rendered":"<p>\ud83d\udcd8 Guia Completo: O arquivo wp-config.php no WordPress O arquivo wp-config.php \u00e9 o cora\u00e7\u00e3o da configura\u00e7\u00e3o do seu site WordPress. Ele fica na pasta raiz da instala\u00e7\u00e3o e cont\u00e9m informa\u00e7\u00f5es essenciais como a conex\u00e3o com o banco de dados, chaves de seguran\u00e7a, configura\u00e7\u00f5es de desempenho, seguran\u00e7a e, no caso de uma rede Multisite, as diretrizes [&hellip;]<\/p>\n","protected":false},"author":1,"featured_media":0,"comment_status":"open","ping_status":"open","sticky":false,"template":"","format":"standard","meta":{"footnotes":""},"categories":[2,3],"tags":[],"class_list":["post-246","post","type-post","status-publish","format-standard","hentry","category-lessons","category-wordpress"],"_links":{"self":[{"href":"https:\/\/www.portanova.com.br\/notebook\/wp-json\/wp\/v2\/posts\/246","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/www.portanova.com.br\/notebook\/wp-json\/wp\/v2\/posts"}],"about":[{"href":"https:\/\/www.portanova.com.br\/notebook\/wp-json\/wp\/v2\/types\/post"}],"author":[{"embeddable":true,"href":"https:\/\/www.portanova.com.br\/notebook\/wp-json\/wp\/v2\/users\/1"}],"replies":[{"embeddable":true,"href":"https:\/\/www.portanova.com.br\/notebook\/wp-json\/wp\/v2\/comments?post=246"}],"version-history":[{"count":1,"href":"https:\/\/www.portanova.com.br\/notebook\/wp-json\/wp\/v2\/posts\/246\/revisions"}],"predecessor-version":[{"id":717,"href":"https:\/\/www.portanova.com.br\/notebook\/wp-json\/wp\/v2\/posts\/246\/revisions\/717"}],"wp:attachment":[{"href":"https:\/\/www.portanova.com.br\/notebook\/wp-json\/wp\/v2\/media?parent=246"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/www.portanova.com.br\/notebook\/wp-json\/wp\/v2\/categories?post=246"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/www.portanova.com.br\/notebook\/wp-json\/wp\/v2\/tags?post=246"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}