{"id":6711,"date":"2024-05-02T12:37:16","date_gmt":"2024-05-02T10:37:16","guid":{"rendered":"https:\/\/www.nicalia.com\/nicapedia\/guias\/wordpress\/configuracion-de-wordpress\/modificar-archivo-de-configuracion-de-wordpress\/"},"modified":"2026-06-11T10:35:47","modified_gmt":"2026-06-11T08:35:47","slug":"modificar-archivo-de-configuracion-de-wordpress","status":"publish","type":"docs","link":"https:\/\/www.nicalia.com\/nicapedia\/modificar-archivo-de-configuracion-de-wordpress\/","title":{"rendered":"C\u00f3mo editar el archivo wp-config.php de WordPress"},"content":{"rendered":"

El archivo wp-config.php<\/strong> es uno de los archivos m\u00e1s importantes de WordPress. Se encuentra en la carpeta ra\u00edz de la instalaci\u00f3n y contiene la configuraci\u00f3n esencial del sitio: credenciales de la base de datos, URLs de WordPress, claves de seguridad, configuraci\u00f3n del modo debug y otras variables que controlan el comportamiento del CMS.<\/p>\n

Modificar este archivo directamente es necesario en situaciones como cambiar la base de datos conectada, cambiar la URL del sitio cuando no se puede acceder a wp-admin, activar el modo debug para diagnosticar errores, o a\u00f1adir par\u00e1metros de configuraci\u00f3n avanzados.<\/p>\n

\u26a0\ufe0f Haz siempre una copia de seguridad de wp-config.php antes de editarlo.<\/strong> Un error de sintaxis en este archivo puede dejar el sitio completamente inaccesible. Desc\u00e1rgalo a tu equipo antes de hacer cualquier modificaci\u00f3n.<\/p>\n

<\/p>\n

C\u00f3mo editar el archivo wp-config.php desde cPanel<\/h2>\n

Lo primero es localizar la carpeta donde est\u00e1 instalado WordPress. Si no sabes a qu\u00e9 carpeta apunta tu dominio, consulta la gu\u00eda \u00bfa qu\u00e9 carpeta apunta mi dominio?<\/a><\/p>\n

Una vez localizada, accede al Administrador de Archivos de cPanel<\/a>, navega hasta la carpeta ra\u00edz de WordPress (normalmente public_html<\/code>) y localiza el archivo wp-config.php<\/code>. Haz clic derecho sobre \u00e9l y selecciona \u00abEdit\u00bb<\/strong> (Editar).<\/p>\n

\n \"Men\u00fa
\n<\/figure>\n

Se abrir\u00e1 el editor de texto del Administrador de Archivos con el contenido del archivo:<\/p>\n

\n \"Editor
\n<\/figure>\n

Realiza los cambios necesarios y haz clic en \u00abSave Changes\u00bb<\/strong> para guardar. Tambi\u00e9n puedes editar el archivo por FTP con FileZilla o por SSH con un editor de texto como nano<\/code>.<\/p>\n

<\/p>\n

Par\u00e1metros m\u00e1s importantes de wp-config.php<\/h2>\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n
Constante<\/th>\nDescripci\u00f3n<\/th>\n<\/tr>\n<\/thead>\n
DB_NAME<\/code><\/td>\nNombre de la base de datos MySQL<\/td>\n<\/tr>\n
DB_USER<\/code><\/td>\nUsuario de la base de datos<\/td>\n<\/tr>\n
DB_PASSWORD<\/code><\/td>\nContrase\u00f1a del usuario de la base de datos<\/td>\n<\/tr>\n
DB_HOST<\/code><\/td>\nServidor de la base de datos (normalmente localhost<\/code>)<\/td>\n<\/tr>\n
table_prefix<\/code><\/td>\nPrefijo de las tablas de WordPress en la base de datos<\/td>\n<\/tr>\n
WP_SITEURL<\/code><\/td>\nURL de WordPress (direcci\u00f3n de la instalaci\u00f3n)<\/td>\n<\/tr>\n
WP_HOME<\/code><\/td>\nURL de la p\u00e1gina de inicio del sitio<\/td>\n<\/tr>\n
WP_DEBUG<\/code><\/td>\nActiva o desactiva el modo debug (true<\/code>\/false<\/code>)<\/td>\n<\/tr>\n
WP_DEBUG_LOG<\/code><\/td>\nGuarda los errores en wp-content\/debug.log<\/code><\/td>\n<\/tr>\n
WP_MEMORY_LIMIT<\/code><\/td>\nL\u00edmite de memoria PHP para WordPress<\/td>\n<\/tr>\n<\/tbody>\n<\/table>\n

<\/p>\n

Cambiar los datos de conexi\u00f3n de la base de datos<\/h2>\n

Es posible que necesites modificar los datos de conexi\u00f3n a la base de datos: cuando has migrado el sitio a otro servidor, has cambiado el nombre de la base de datos, o quieres conectar el WordPress a una base de datos diferente.<\/p>\n

Busca las siguientes l\u00edneas en wp-config.php<\/code> y modifica los valores entre comillas simples:<\/p>\n

define('DB_NAME', 'nombre_de_tu_base_de_datos');\ndefine('DB_USER', 'nombre_de_usuario');\ndefine('DB_PASSWORD', 'contrase\u00f1a');\ndefine('DB_HOST', 'localhost');<\/code><\/pre>\n
\u2139\ufe0f En los servidores de Nicalia el valor de DB_HOST<\/code> es siempre localhost<\/code>. El nombre completo de la base de datos y el usuario incluyen el prefijo del usuario de cPanel (ej: cpanelusr_nombrebd<\/code>). Puedes encontrar los valores exactos en cPanel \u2192 Bases de datos MySQL<\/strong>.<\/p>\n
<\/p>\n
Cambiar la URL de WordPress en wp-config.php<\/h2>\n
Si la URL del sitio es incorrecta y no puedes acceder a wp-admin para cambiarla desde los ajustes, puedes forzarla directamente en wp-config.php<\/code> a\u00f1adiendo estas l\u00edneas antes de \/* That's all, stop editing! *\/<\/code>:<\/p>\n
define('WP_SITEURL', 'https:\/\/tudominio.com');\ndefine('WP_HOME', 'https:\/\/tudominio.com');<\/code><\/pre>\n
Estas constantes sobreescriben los valores guardados en la base de datos. Una vez restaurado el acceso a wp-admin y corregida la URL desde Ajustes \u2192 Generales<\/em>, puedes eliminar estas l\u00edneas del wp-config.php<\/code> para que WordPress use el valor de la base de datos.<\/p>\n
<\/p>\n
Activar el modo debug en wp-config.php<\/h2>\n
Para diagnosticar errores en WordPress, a\u00f1ade estas l\u00edneas en wp-config.php<\/code>:<\/p>\n
define('WP_DEBUG', true);\ndefine('WP_DEBUG_DISPLAY', false);\ndefine('WP_DEBUG_LOG', true);<\/code><\/pre>\n
Con esta configuraci\u00f3n los errores se registran en wp-content\/debug.log<\/code> sin mostrarse en pantalla a los visitantes. Consulta la gu\u00eda completa c\u00f3mo habilitar el modo Debug en WordPress<\/a>.<\/p>\n
<\/p>\n
Otros par\u00e1metros \u00fatiles<\/h2>\n
Aumentar el l\u00edmite de memoria PHP de WordPress<\/h3>\n
define('WP_MEMORY_LIMIT', '256M');<\/code><\/pre>\n
Deshabilitar el editor de archivos desde wp-admin (seguridad)<\/h3>\n
define('DISALLOW_FILE_EDIT', true);<\/code><\/pre>\n
Deshabilitar actualizaciones autom\u00e1ticas<\/h3>\n
define('AUTOMATIC_UPDATER_DISABLED', true);<\/code><\/pre>\n
Cambiar el prefijo de las tablas (solo en instalaciones nuevas)<\/h3>\n
El prefijo por defecto de las tablas de WordPress es wp_<\/code>. Cambiarlo reduce el riesgo de ataques SQL injection dirigidos a tablas con nombres predecibles. Solo modifica esta variable antes de instalar WordPress<\/strong> \u2014 cambiarla en una instalaci\u00f3n existente requiere tambi\u00e9n renombrar todas las tablas en la base de datos:<\/p>\n
$table_prefix = 'miprefijo_';<\/code><\/pre>\n
<\/p>\n
Errores frecuentes al editar wp-config.php<\/h2>\n
Error \u00abError al establecer conexi\u00f3n con la base de datos\u00bb<\/h3>\n
Los datos de DB_NAME<\/code>, DB_USER<\/code> o DB_PASSWORD<\/code> son incorrectos. Verifica en cPanel \u2192 Bases de datos MySQL<\/strong> que el nombre de la base de datos y del usuario son exactos (incluyendo el prefijo del usuario de cPanel). Si la contrase\u00f1a no la recuerdas, c\u00e1mbiala desde cPanel y actualiza el wp-config.php<\/code>.<\/p>\n
La web muestra una pantalla en blanco despu\u00e9s de editar<\/h3>\n
Hay un error de sintaxis en el archivo \u2014 probablemente una comilla, punto y coma o par\u00e9ntesis mal colocado. Recupera la copia de seguridad que hiciste antes de editar. Si no la tienes, accede al wp-config.php<\/code> de nuevo desde el Administrador de Archivos y revisa cuidadosamente la l\u00ednea que modificaste.<\/p>\n
No puedo encontrar wp-config.php en el Administrador de Archivos<\/h3>\n
El archivo puede estar oculto o WordPress puede estar instalado en un subdirectorio diferente a public_html<\/code>. Activa la visualizaci\u00f3n de archivos ocultos en el Administrador de Archivos (Ajustes \u2192 Mostrar archivos ocultos<\/em>). Tambi\u00e9n verifica en qu\u00e9 carpeta apunta tu dominio desde \u00bfa qu\u00e9 carpeta apunta mi dominio?<\/a><\/p>\n
He a\u00f1adido WP_SITEURL y WP_HOME pero el sitio sigue redirigiendo mal<\/h3>\n
Verifica que las URLs no tienen barra final (\/<\/code>) al final: https:\/\/tudominio.com<\/code> es correcto; https:\/\/tudominio.com\/<\/code> puede causar bucles de redirecci\u00f3n. Tambi\u00e9n verifica que las l\u00edneas est\u00e1n colocadas antes de \/* That's all, stop editing! *\/<\/code>.<\/p>\n
<\/p>\n
Preguntas frecuentes sobre wp-config.php<\/h2>\n
\u00bfD\u00f3nde est\u00e1 el archivo wp-config.php?<\/h3>\n
En la carpeta ra\u00edz de la instalaci\u00f3n de WordPress \u2014 normalmente public_html<\/code> si WordPress est\u00e1 instalado en el dominio principal, o public_html\/subdirectorio<\/code> si est\u00e1 en un subdirectorio. Puedes acceder a \u00e9l desde el Administrador de Archivos de cPanel o por FTP.<\/p>\n
\u00bfEs seguro editar wp-config.php directamente?<\/h3>\n
S\u00ed, siempre que hagas una copia de seguridad antes y tengas cuidado con la sintaxis PHP. Un error como una comilla mal cerrada o un punto y coma olvidado puede dejar el sitio inaccesible. Si no est\u00e1s seguro, haz los cambios en una copia local primero.<\/p>\n
\u00bfC\u00f3mo cambiar la URL de WordPress sin acceso a wp-admin?<\/h3>\n
A\u00f1ade estas dos l\u00edneas en wp-config.php<\/code> antes de \/* That's all, stop editing! *\/<\/code>: define('WP_SITEURL', 'https:\/\/tudominio.com');<\/code> y define('WP_HOME', 'https:\/\/tudominio.com');<\/code>. Una vez recuperado el acceso a wp-admin, corr\u00edgelo desde Ajustes \u2192 Generales<\/em> y elimina esas l\u00edneas del wp-config.php<\/code>.<\/p>\n
\u00bfQu\u00e9 pasa si borro accidentalmente wp-config.php?<\/h3>\n
WordPress mostrar\u00e1 el asistente de instalaci\u00f3n como si fuera una instalaci\u00f3n nueva, pero los datos de la base de datos (publicaciones, usuarios, configuraciones) permanecen intactos. Puedes recrear el wp-config.php<\/code> copiando el archivo wp-config-sample.php<\/code> (que WordPress incluye en la ra\u00edz) e introduciendo los datos de conexi\u00f3n de la base de datos original.<\/p>\n
\u00bfPuedo editar wp-config.php desde el panel de WordPress?<\/h3>\n
No por defecto \u2014 el editor de archivos de WordPress (Apariencia \u2192 Editor de archivos del tema<\/em>) no permite editar wp-config.php<\/code> por razones de seguridad. Debes editarlo desde el Administrador de Archivos de cPanel, por FTP o por SSH.<\/p>\n","protected":false},"excerpt":{"rendered":"
El archivo wp-config.php es uno de los archivos m\u00e1s importantes de WordPress. Se encuentra en la carpeta ra\u00edz de la instalaci\u00f3n y contiene la configuraci\u00f3n esencial del sitio: credenciales de la base de datos, URLs de WordPress, claves de seguridad, configuraci\u00f3n del modo debug y otras variables que controlan el comportamiento del CMS. Modificar este […]<\/p>\n","protected":false},"author":4,"featured_media":0,"parent":6705,"menu_order":4,"comment_status":"open","ping_status":"closed","template":"","doc_tag":[],"doc_badge":[],"class_list":["post-6711","docs","type-docs","status-publish","hentry","no-post-thumbnail"],"acf":[],"author_avatar":"https:\/\/secure.gravatar.com\/avatar\/4471485c4e49f46218d6b6d125f80f4cde1f86f045fd896202eefddaf4d4510a?s=96&d=mm&r=g","author_name":"Francisco Garvi","_links":{"self":[{"href":"https:\/\/www.nicalia.com\/nicapedia\/wp-json\/wp\/v2\/docs\/6711","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/www.nicalia.com\/nicapedia\/wp-json\/wp\/v2\/docs"}],"about":[{"href":"https:\/\/www.nicalia.com\/nicapedia\/wp-json\/wp\/v2\/types\/docs"}],"author":[{"embeddable":true,"href":"https:\/\/www.nicalia.com\/nicapedia\/wp-json\/wp\/v2\/users\/4"}],"replies":[{"embeddable":true,"href":"https:\/\/www.nicalia.com\/nicapedia\/wp-json\/wp\/v2\/comments?post=6711"}],"version-history":[{"count":5,"href":"https:\/\/www.nicalia.com\/nicapedia\/wp-json\/wp\/v2\/docs\/6711\/revisions"}],"predecessor-version":[{"id":10109,"href":"https:\/\/www.nicalia.com\/nicapedia\/wp-json\/wp\/v2\/docs\/6711\/revisions\/10109"}],"up":[{"embeddable":true,"href":"https:\/\/www.nicalia.com\/nicapedia\/wp-json\/wp\/v2\/docs\/6705"}],"wp:attachment":[{"href":"https:\/\/www.nicalia.com\/nicapedia\/wp-json\/wp\/v2\/media?parent=6711"}],"wp:term":[{"taxonomy":"doc_tag","embeddable":true,"href":"https:\/\/www.nicalia.com\/nicapedia\/wp-json\/wp\/v2\/doc_tag?post=6711"},{"taxonomy":"doc_badge","embeddable":true,"href":"https:\/\/www.nicalia.com\/nicapedia\/wp-json\/wp\/v2\/doc_badge?post=6711"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}