Configurar wp-config.php en WordPress: Guía completa (cPanel/Plesk)

¿Listo para poner a punto el corazón de tu WordPress? El archivo wp-config.php es, sin duda, el archivo más importante de tu instalación. Es el que conecta tu web con la base de datos, define claves de seguridad, la memoria máxima permitida y mucho más. Aunque suene técnico, configurarlo correctamente es un proceso muy sencillo si sabes qué estás tocando y por qué.

En esta guía extensa, te voy a enseñar paso a paso cómo configurarlo y editarlo, tanto si usas cPanel como Plesk. No necesitas ser un experto en programación; solo seguir las instrucciones, leer con atención y hacer copias de seguridad.

Vamos a ello.

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

Piensa en wp-config.php como el directorio de operaciones de tu casa (WordPress). Contiene los planos y las llaves de acceso. Sin él, WordPress no puede hablar con la base de datos donde se guardan tus artículos, usuarios y ajustes. Es literalmente el pegamento que une el código de WordPress con la base de datos MySQL.

Este archivo se encuentra en la carpeta raíz de tu instalación de WordPress. Si instalaste WordPress en la carpeta principal de tu dominio (ej. public_html), ahí lo encontrarás. Si lo instalaste en una subcarpeta (ej. public_html/blog), tendrás que buscarlo dentro de esa carpeta.

Preparación antes de tocar nada: La copia de seguridad (IMPORTANTE)

Esta es la regla de oro. Antes de modificar cualquier archivo de configuración, debes hacer una copia de seguridad. Si te equivocas en algo, podrías dejar tu web en blanco o con un error fatal. No te asustes, es reversible si tienes una copia.

Qué necesitas:

Acceso al panel de control de tu hosting (cPanel o Plesk).
Un editor de texto simple (como el Bloc de notas de Windows o TextEdit en Mac).
Paciencia y ganas de aprender.

Cómo hacer la copia de seguridad del archivo:

Accede al administrador de archivos de tu hosting.
Navega hasta la carpeta raíz de tu WordPress.
Busca el archivo wp-config.php.
Haz clic derecho sobre él y selecciona "Copiar".
Nombra la copia como wp-config-backup.php. De esta manera, si algo sale mal, puedes restaurar la versión original eliminando la actual y renombrando la copia.

[WARNING] No edites nunca el archivo directamente desde el editor del panel de control sin antes haber descargado una copia a tu ordenador. Un error de escritura puede romper el sitio.

Cómo configurar wp-config.php desde cPanel

cPanel es uno de los paneles más populares del mundo. Su administrador de archivos es muy intuitivo. Aquí te muestro cómo editar el archivo paso a paso.

Paso 1: Acceder al Administrador de Archivos

Inicia sesión en tu cPanel.
Busca la sección "Archivos" y haz clic en el icono de "Administrador de Archivos".
Se abrirá una ventana. Selecciona la "Document Root" para el dominio donde está instalado WordPress. Suele ser public_html o el nombre de tu dominio. Haz clic en "Ir".

Paso 2: Localizar y editar el archivo

Una vez dentro, navega hasta la carpeta raíz de WordPress (si lo instalaste en public_html, ya estás dentro).
Busca el archivo wp-config.php.
Haz clic derecho sobre él y selecciona "Editar" o "Code Editor" (Editor de código). Si te pregunta qué aplicación usar, elige la opción de editor de texto.
Se abrirá una pestaña nueva con el código del archivo. No te asustes, es normal que parezca un galimatías.

Paso 3: Modificar los valores clave

Aquí es donde ocurre la magia. Dentro del archivo verás constantes definidas como DB_NAME, DB_USER, etc. Estas son las que debes revisar y ajustar.

DB_NAME: El nombre de tu base de datos.
DB_USER: El usuario de tu base de datos.
DB_PASSWORD: La contraseña de tu usuario de base de datos.
DB_HOST: El servidor de la base de datos. Normalmente es localhost, pero a veces puede ser una dirección como mysql.tudominio.com.

¿Dónde encuentro estos datos? En cPanel, ve a la sección "Bases de Datos" y haz clic en "Bases de Datos MySQL". Allí verás el nombre de tu base de datos y el usuario. La contraseña es la que definiste al crear el usuario.

[TIP] Si tu web funciona, no cambies estos valores. Solo debes tocarlos si estás moviendo el sitio a otro servidor o si has cambiado la contraseña de la base de datos.

Paso 4: Añadir o modificar constantes importantes

Además de los datos de conexión, hay otras líneas de configuración que mejoran el rendimiento y la seguridad.

WP_MEMORY_LIMIT: Aumenta la memoria disponible para WordPress. Por defecto puede ser baja. 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');
WP_DEBUG: Activa el modo de depuración para ver errores. Es útil para solucionar problemas, pero debe estar en false en un sitio en producción. Asegúrate de que esté así:
define('WP_DEBUG', false);
AUTOMATIC_UPDATER_DISABLED: Si quieres controlar las actualizaciones manualmente, puedes desactivarlas:
define('AUTOMATIC_UPDATER_DISABLED', true);

Paso 5: Guardar los cambios

Una vez hayas hecho tus modificaciones, haz clic en el botón "Guardar cambios" o "Save" en la esquina superior derecha del editor.
Cierra el editor.
Importante: Ve a tu web y comprueba que todo sigue funcionando correctamente. Si ves un error, restaura la copia de seguridad que hiciste al principio.

Cómo configurar wp-config.php desde Plesk

Plesk es otro panel de control muy común, especialmente en servidores VPS o dedicados. El proceso es similar, pero la interfaz cambia.

Paso 1: Acceder al Administrador de Archivos

Inicia sesión en tu Plesk.
En el menú lateral izquierdo, busca la sección "Archivos" (Files). Si no lo ves, ve a tu dominio y busca el icono de "Administrador de Archivos".
Se abrirá una ventana que te llevará a la raíz del dominio. Navega hasta la carpeta httpdocs (este es el equivalente a public_html en Plesk) o hasta la carpeta donde esté instalado WordPress.

Paso 2: Encontrar y abrir el archivo

Busca el archivo wp-config.php en la lista de archivos.
Haz clic en el icono de "Editar en el editor de texto" (normalmente es un icono de lápiz o una hoja con un lápiz).
Se abrirá una vista previa del archivo. Haz clic en el botón "Editar" en la parte superior o en el icono de "Texto" para poder modificarlo.

Paso 3: Ajustar la configuración

Al igual que en cPanel, verás las mismas líneas de código. Los cambios que debes hacer son los mismos: revisar DB_NAME, DB_USER, DB_PASSWORD y DB_HOST. La base de datos en Plesk se gestiona desde la sección "Bases de datos" del panel de administración de tu dominio.

Paso 4: Guardar y verificar

Realiza tus cambios.
Haz clic en "Guardar" (el botón suele estar en la parte superior derecha).
Cierra el editor y visita tu sitio web para confirmar que todo está en orden.

[INFO] Tanto en cPanel como en Plesk, el editor de archivos no tiene por qué romper el código si no tocas nada más. Simplemente busca las líneas que te he indicado y modifica solo los valores que necesitas.

Errores comunes al editar wp-config.php y cómo solucionarlos

Es muy fácil cometer un error. Aquí tienes los más frecuentes y su solución.

Error: "Error al establecer una conexión con la base de datos"

Causa: Los datos de conexión (DB_NAME, DB_USER, DB_PASSWORD o DB_HOST) son incorrectos.
Solución: Revisa que has escrito correctamente el nombre de la base de datos y el usuario. Asegúrate de que la contraseña no tiene espacios ni caracteres extraños. Verifica que el DB_HOST es el correcto (normalmente localhost, pero a veces es un servidor específico).

Error: "Error fatal: Allowed memory size of X bytes exhausted"

Causa: El límite de memoria es demasiado bajo.
Solución: Añade la línea define('WP_MEMORY_LIMIT', '256M'); en tu archivo.

Error: "Headers already sent"

Causa: Hay espacios en blanco o caracteres invisibles antes de la línea <?php o después de la línea ?> al final del archivo.
Solución: Abre el archivo en un editor de texto avanzado y elimina cualquier espacio o línea en blanco que haya fuera de las etiquetas PHP. Asegúrate de que el archivo termina justo después de la línea ?> (si existe) o sin ella.

La web se descarga en lugar de mostrarse

Causa: El archivo no se está interpretando como PHP.
Solución: Asegúrate de que el archivo se llama exactamente wp-config.php y no wp-config.php.txt o algo parecido. A veces el editor de Windows añade una extensión extra.

[WARNING] Si no sabes qué línea tocar, no la toques. Configurar WordPress archivo implica solo modificar las constantes que conoces. Si tienes dudas, busca ayuda profesional para no romper tu sitio.

Preguntas Frecuentes (FAQ) sobre wp-config.php

¿Puedo cambiar el prefijo de las tablas de la base de datos desde aquí?

Sí, puedes. Busca la línea $table_prefix = 'wp_'; y cámbiala por otro valor como miprefijo_. Hazlo antes de instalar WordPress o si ya tienes contenido, tendrás que cambiar los nombres de las tablas en la base de datos manualmente, lo cual es más complejo. No es recomendable para principiantes.

¿Qué son las claves de seguridad (Authentication Unique Keys)?

Son un conjunto de 8 líneas que hacen más segura la conexión entre tu web y tu navegador. Si tu web ya funciona, no las toques. Si las cambias, cerrarás todas las sesiones activas de los usuarios y tendrán que volver a iniciar sesión. Es una buena medida de seguridad si sospechas que tu web ha sido comprometida.

¿Cómo puedo saber si mi archivo está bien configurado?

Si tu web carga correctamente, el panel de administración (/wp-admin) funciona y no ves errores, tu wp-config.php está bien configurado. También puedes crear un archivo de prueba llamado phpinfo.php con el contenido <?php phpinfo(); ?> para ver la configuración de PHP, pero esto es más avanzado.

¿Qué pasa si no encuentro el archivo wp-config.php?

Es muy raro, pero puede que no exista. En ese caso, WordPress no puede funcionar. Deberías crear uno nuevo. Puedes copiar el contenido de wp-config-sample.php (que siempre está en la raíz de WordPress) y renombrarlo a wp-config.php. Luego, rellena los datos de la base de datos.

¿Puedo usar este archivo para cambiar la URL de mi sitio?

Sí. Puedes añadir las líneas define('WP_HOME', 'https://tudominio.com'); y define('WP_SITEURL', 'https://tudominio.com'); para forzar la URL del sitio. Esto es útil cuando mueves una web de un dominio a otro o de un servidor a otro. Si no lo haces, a veces la web sigue redirigiendo a la URL antigua.

¿Y si uso Syspanel (HestiaCP)?

¡Buena pregunta! Si tu hosting usa Syspanel (anteriormente conocido como HestiaCP), el proceso es muy similar. Accede al panel a través del puerto 2106 (por ejemplo, https://tudominio.com:2106). Dentro, busca la sección de "Administrador de archivos" en el menú lateral. Navega hasta la carpeta public_html y ahí encontrarás tu wp-config.php. El resto del proceso es idéntico al de cPanel o Plesk.

Consejos finales para el mantenimiento de tu wp-config.php

Este archivo no es algo que debas tocar a la ligera, pero tampoco es un misterio. Aquí van mis últimos consejos:

Mantén una copia local: Guarda una copia de tu wp-config.php en tu ordenador junto con el resto de tu web. Te será útil para restaurar el sitio si tienes un problema grave.
No lo compartas: Este archivo contiene credenciales de acceso a tu base de datos. Nunca lo compartas en foros públicos ni lo envíes por correo electrónico sin cifrar.
Actualiza las claves de seguridad periódicamente: Es una buena práctica de seguridad. Puedes usar el generador oficial de claves de WordPress para obtener nuevas y reemplazar las existentes.
Combínalo con un buen plugin de caché: Configurar WordPress archivo correctamente es solo una parte. Un plugin de caché te ayudará a mejorar la velocidad de carga, lo cual es fundamental para el SEO.

Configurar correctamente wp-config.php te da un control total sobre tu instalación y te permite diagnosticar problemas con facilidad. Con esta guía, ya tienes el conocimiento para hacerlo de forma segura y efectiva, tanto en cPanel como en Plesk (y también en Syspanel vía puerto 2106). Si sigues los pasos y respetas las reglas de oro (copia de seguridad y paciencia), no tendrás ningún problema.