Configurar wp-config.php en WordPress: Guía completa con ejemplos (2024)

¿Qué es el archivo wp-config.php y por qué es tan importante?

El archivo wp-config.php es, sin lugar a dudas, el corazón técnico de tu instalación de WordPress. Sin él, WordPress simplemente no puede funcionar, ya que es el encargado de contener la información esencial para conectar tu sitio con la base de datos, así como las claves de seguridad, el prefijo de las tablas y una serie de configuraciones avanzadas que determinan cómo se comporta tu web en el servidor.

Piénsalo de esta manera: si WordPress fuera un coche, el archivo wp-config.php sería la llave de contacto y el manual de arranque. Es el primer archivo que se carga y el que le dice a WordPress dónde encontrar sus datos y cómo comportarse. Por eso, saber cómo editar wp-config.php es una habilidad fundamental para cualquier administrador de un sitio, ya sea para solucionar problemas, mejorar el rendimiento o simplemente para cambiar el prefijo de las tablas de la base de datos y reforzar la seguridad.

En esta guía, te explicaré paso a paso y en un lenguaje muy claro cómo localizar, editar y configurar este archivo en los tres paneles de control más comunes: cPanel, Plesk y DirectAdmin. No necesitas ser un experto en programación; solo seguir las instrucciones con calma y atención.

Primeros pasos: Localizando el archivo wp-config.php

Antes de poder configurar wp-config, necesitas saber dónde está. El archivo se encuentra siempre en la carpeta raíz de tu instalación de WordPress. Es decir, en la misma carpeta donde están las carpetas wp-admin, wp-content y wp-includes. Esta carpeta raíz suele llamarse public_html, htdocs o el nombre de tu dominio, dependiendo del panel de control que uses.

La forma más común de acceder a él es a través de un administrador de archivos en línea o mediante un cliente FTP como FileZilla. Una vez dentro de la carpeta raíz, busca el archivo llamado wp-config.php. No te confundas con wp-config-sample.php, que es solo una plantilla.

Acceso a través de cPanel

cPanel es uno de los paneles más populares en el hosting compartido. Para encontrar el archivo:

Inicia sesión en tu cuenta de cPanel (generalmente en tudominio.com/cpanel).
Busca la sección Archivos y haz clic en el Administrador de Archivos.
Se abrirá una nueva ventana. Navega hasta la carpeta public_html (o la carpeta donde tengas instalado WordPress).
Busca el archivo wp-config.php. A la derecha, haz clic derecho sobre él y selecciona Editar o Edit. El sistema te preguntará si quieres codificar el archivo; simplemente elige "Editar" de nuevo.
Se abrirá un editor de texto en la misma ventana. Aquí es donde harás los cambios.

Acceso a través de Plesk

Plesk tiene una interfaz más moderna y limpia. El proceso es igual de sencillo:

Accede a tu panel de Plesk (normalmente en tudominio.com:8443).
En el menú lateral izquierdo, busca tu dominio y haz clic en Administrador de archivos (o File Manager).
Navega a la carpeta httpdocs (que es el equivalente a public_html en Plesk).
Localiza wp-config.php, haz clic en él y luego en el botón Editar en el editor de texto (o simplemente "Editar").
El archivo se abrirá en un editor integrado. Podrás modificarlo y guardar los cambios con el botón Aceptar o Guardar.

Acceso a través de DirectAdmin

DirectAdmin es otro panel muy utilizado. Para editar el archivo:

Ingresa a tu panel de DirectAdmin (en tudominio.com:2222).
En el menú superior, busca la sección Administrador de archivos (o File Manager).
Se abrirá una interfaz similar a un explorador de Windows. Navega hasta la carpeta domains y luego tudominio.com y finalmente public_html.
Busca wp-config.php, haz clic derecho sobre él y selecciona Editar (o Edit).
Se abrirá un editor de texto simple. Realiza los cambios y pulsa Guardar.

Configuraciones esenciales dentro de wp-config.php

Una vez que tengas el archivo abierto en el editor, verás una serie de líneas de código PHP. No te asustes; solo necesitas entender algunas secciones clave.

1. Configuración de la base de datos

Esta es la parte más crítica. Si estos datos son incorrectos, tu sitio no cargará y verás un error de "Error al conectar con la base de datos". Busca estas líneas:

define( 'DB_NAME', 'nombre_de_tu_base_de_datos' );
define( 'DB_USER', 'tu_usuario' );
define( 'DB_PASSWORD', 'tu_contraseña' );
define( 'DB_HOST', 'localhost' );

DB_NAME: Es el nombre exacto de la base de datos que creaste para WordPress.
DB_USER: El nombre de usuario que tiene acceso a esa base de datos.
DB_PASSWORD: La contraseña de ese usuario.
DB_HOST: Generalmente es localhost, pero a veces el servidor usa una dirección diferente como mysql.tudominio.com. Si no estás seguro, contacta con tu proveedor de hosting.

[WARNING] No cambies estos valores a menos que sepas exactamente lo que estás haciendo. Un error aquí dejará tu sitio completamente inaccesible. Si solo quieres cambiar el prefijo de las tablas, esta sección no debe tocarse.

2. Claves de seguridad y salting

Un poco más abajo, encontrarás una sección llamada "Authentication Unique Keys and Salts". Verás definiciones como AUTH_KEY, SECURE_AUTH_KEY, LOGGED_IN_KEY, etc., con valores vacíos o valores antiguos.

Estas claves son como contraseñas de seguridad que cifran las cookies de tus usuarios. Si tu sitio fue hackeado o sospechas que alguien tiene acceso, puedes cambiarlas. La forma más fácil de obtener nuevas claves es visitando el generador oficial de WordPress: https://api.wordpress.org/secret-key/1.1/salt/.

Simplemente copia todas las líneas de ese enlace y reemplaza las que están en tu archivo. Esto cerrará todas las sesiones activas de los usuarios, forzándolos a iniciar sesión de nuevo.

3. El prefijo de las tablas: Cómo cambiar el prefijo de WordPress

Este es uno de los cambios más comunes y recomendados por seguridad. Por defecto, las tablas de WordPress se llaman wp_usuarios, wp_posts, etc. Cambiar el prefijo a algo como miweb_ o seguro_ dificulta los ataques de inyección SQL (un tipo común de hackeo).

Para hacer este cambio, busca la línea:

$table_prefix = 'wp_';

Cambia el valor 'wp_' por el prefijo que desees. Por ejemplo:

$table_prefix = 'miweb_';

[WARNING] Este cambio no es suficiente. Solo cambiar el archivo wp-config.php no modifica los nombres reales de las tablas en tu base de datos. Debes hacerlo también en la base de datos a través de phpMyAdmin. Si no lo haces, tu sitio dejará de funcionar al instante.

Para completar el cambio, debes seguir estos pasos:

Ve a phpMyAdmin desde tu panel de control (cPanel, Plesk o DirectAdmin).
Selecciona tu base de datos.
Haz clic en la pestaña SQL y ejecuta el siguiente comando para renombrar todas las tablas. Reemplaza wp_ por tu nuevo prefijo y miweb_ por el nuevo que elegiste.

RENAME TABLE wp_commentmeta TO miweb_commentmeta;
RENAME TABLE wp_comments TO miweb_comments;
RENAME TABLE wp_links TO miweb_links;
RENAME TABLE wp_options TO miweb_options;
RENAME TABLE wp_postmeta TO miweb_postmeta;
RENAME TABLE wp_posts TO miweb_posts;
RENAME TABLE wp_terms TO miweb_terms;
RENAME TABLE wp_term_relationships TO miweb_term_relationships;
RENAME TABLE wp_term_taxonomy TO miweb_term_taxonomy;
RENAME TABLE wp_usermeta TO miweb_usermeta;
RENAME TABLE wp_users TO miweb_users;

Si tienes plugins que crean sus propias tablas (como WooCommerce, por ejemplo), también deberías renombrarlas. Generalmente empiezan con wp_woocommerce_, wp_actionscheduler_, etc.

[TIP] Antes de hacer este cambio, es obligatorio hacer una copia de seguridad completa de tu base de datos. Un error al renombrar las tablas puede dejar tu sitio inutilizado.

4. WP_DEBUG: El modo de depuración

Si estás teniendo errores en tu sitio y no ves ninguna explicación, es hora de activar el modo de depuración. Busca esta línea:

define( 'WP_DEBUG', false );

Cámbiala a true para ver los errores en pantalla. Esto es muy útil para configurar wp-config y solucionar problemas. Sin embargo, nunca debes dejarlo activado en un sitio en producción, ya que mostrará errores a los visitantes.

define( 'WP_DEBUG', true );

[INFO] Cuando termines de depurar, vuelve a ponerlo en false o, mejor aún, activa el registro en un archivo de log para no mostrar errores en pantalla. Puedes usar estas líneas:

define( 'WP_DEBUG', true );
define( 'WP_DEBUG_LOG', true );
define( 'WP_DEBUG_DISPLAY', false );

Con esto, los errores se guardarán en un archivo llamado debug.log dentro de la carpeta wp-content, y no serán visibles para los visitantes.

5. Aumentar la memoria de WordPress

A veces, tu sitio puede quedarse sin memoria, especialmente si usas muchos plugins o un constructor de páginas pesado. Para aumentar el límite de memoria, añade esta línea justo antes de la línea que dice /* That's all, stop editing! Happy publishing. */:

define( 'WP_MEMORY_LIMIT', '256M' );

Esto aumenta el límite de memoria a 256 MB. Puedes cambiarlo a 512M si lo necesitas. Es una solución común para errores de "memoria agotada".

6. Cambiar la URL del sitio

Si has movido tu sitio de dominio o de carpeta, necesitas actualizar las URLs. Busca estas líneas (si no están, puedes añadirlas):

define( 'WP_HOME', 'https://tudominio.com' );
define( 'WP_SITEURL', 'https://tudominio.com' );

Reemplaza https://tudominio.com con la URL exacta de tu sitio. Esto es una alternativa segura a cambiar las URLs desde el panel de administración, especialmente si no puedes acceder a él.

Consejos finales y buenas prácticas para editar wp-config.php

Editar este archivo es una tarea delicada, pero con las precauciones adecuadas, es totalmente segura. Aquí van algunos consejos finales:

Siempre haz una copia de seguridad: Antes de modificar cualquier cosa, descarga una copia del archivo original a tu ordenador. Si algo sale mal, puedes subirlo de nuevo y revertir los cambios.
Usa un editor de texto plano: No uses procesadores de texto como Word. Usa el editor integrado en tu panel o un editor como Notepad++ o Sublime Text.
No dejes espacios en blanco: Asegúrate de que el archivo no tenga líneas en blanco al principio o al final después del <?php. Esto puede causar el famoso error de "headers already sent".
Guarda y verifica: Después de guardar los cambios, visita tu sitio para asegurarte de que todo sigue funcionando correctamente. Si ves un error, revierte los cambios de inmediato.

Mención especial para Syspanel

Si tu hosting utiliza Syspanel (el antiguo HestiaCP), el proceso es muy similar al de DirectAdmin. La principal diferencia es que el acceso al panel se realiza a través del puerto 2106 (por ejemplo, https://tudominio.com:2106). Una vez dentro, busca el Administrador de archivos y navega hasta public_html dentro de la carpeta de tu dominio. El resto del proceso es idéntico al descrito.

Preguntas frecuentes (FAQ)

¿Qué pasa si edito el wp-config.php y rompo mi sitio?

Si tu sitio muestra un error blanco o un mensaje de error, no te preocupes. Simplemente sube la copia de seguridad que hiciste antes de empezar. Si no la hiciste, puedes descargar el archivo wp-config-sample.php, copiar los valores de tu base de datos de tu panel de control y crear un nuevo archivo.

¿Puedo cambiar el prefijo de WordPress sin tocar la base de datos?

No. Es un proceso de dos partes. Primero cambias el valor en wp-config.php y luego ejecutas el comando SQL en phpMyAdmin para renombrar las tablas. Si solo haces una parte, el sitio fallará.

¿Es necesario cambiar las claves de seguridad?

No es obligatorio, pero es una excelente práctica de seguridad, especialmente después de un ataque o si sospechas de actividad sospechosa. Es un cambio simple y no romperá nada.

¿Dónde puedo encontrar la contraseña de la base de datos si la he olvidado?

Puedes verla en tu panel de control. En cPanel, busca la sección Bases de datos MySQL y verás los usuarios y sus privilegios. Si no recuerdas la contraseña, puedes cambiarla desde ahí, pero recuerda actualizar también el archivo wp-config.php.

¿Qué hago si no veo la línea `$table_prefix` en mi archivo?

Es muy extraño, pero si no está, puedes añadirla justo después de la sección de las claves de seguridad y antes de define('WP_DEBUG', false);. La línea debe ser: $table_prefix = 'wp_'; (o el prefijo que quieras).

Con esta guía completa, ya tienes el conocimiento necesario para editar wp-config.php con confianza. Recuerda siempre trabajar con calma, hacer copias de seguridad y verificar los cambios. ¡Tu sitio WordPress te lo agradecerá!