Conectar WordPress a MySQL en cPanel | Configuración wp-config.php

Conectar WordPress a una base de datos MySQL es uno de los pasos más importantes al crear un sitio web. Aunque suene a algo muy técnico, la realidad es que con las herramientas adecuadas (como cPanel) y una guía clara, puedes hacerlo en menos de 15 minutos. En este artículo te explicaré paso a paso, sin tecnicismos innecesarios, cómo realizar esta conexión, qué archivos debes modificar y cómo solucionar los errores más comunes.

¿Qué necesitas antes de empezar?

Antes de lanzarnos a la acción, es fundamental que tengas a mano tres datos que te proporcionará tu proveedor de hosting. Normalmente los encuentras en el correo de bienvenida o en el panel de control de tu hosting.

Nombre de la base de datos: Es el identificador único de tu base. Ejemplo: usuario_wpdb.
Usuario de la base de datos: Un usuario con permisos para gestionar esa base. Ejemplo: usuario_adminwp.
Contraseña: La contraseña asociada a ese usuario. Debe ser segura (mezcla de mayúsculas, minúsculas, números y símbolos).
Host de la base de datos: Normalmente es localhost, pero en algunos casos puede ser sql.midominio.com o una dirección IP.

[INFO] Si no tienes estos datos, contacta con tu proveedor de hosting. No podrás continuar sin ellos.

Paso 1: Crear la base de datos en cPanel

cPanel es el panel de control más popular en el mundo del hosting. Es la herramienta que te permite gestionar archivos, correos, dominios y, por supuesto, bases de datos. Para crear una base de datos, sigue estos pasos:

Inicia sesión en tu cPanel. Normalmente se accede a través de tudominio.com/cPanel o tudominio.com:2083.
Busca la sección "Bases de datos" o "Databases". Dentro, haz clic en "Asistente de Base de Datos MySQL" o en "Bases de datos MySQL" (depende de la versión de cPanel).
En el campo "Nueva base de datos", escribe un nombre descriptivo. cPanel añadirá automáticamente un prefijo con tu nombre de usuario. Por ejemplo, si tu usuario es usuario y escribes wordpress, el nombre final será usuario_wordpress. Anota este nombre completo.
Haz clic en "Crear base de datos".
Ahora crea un usuario. Ve a la sección "Usuarios MySQL" y completa los campos:
- Nombre de usuario: Elige uno fácil de recordar. Ejemplo: wpuser.
- Contraseña: Genera una segura. Puedes usar el generador que incluye cPanel (icono de llave) y luego copiarla.
Haz clic en "Crear usuario".
Ahora debes asignar el usuario a la base de datos. Busca la sección "Añadir usuario a la base de datos".
Selecciona tu usuario y tu base de datos en los menús desplegables y haz clic en "Añadir".
Se abrirá una ventana de "Privilegios". Para WordPress, lo más recomendable es marcar "TODOS LOS PRIVILEGIOS" y hacer clic en "Realizar cambios".

[TIP] Anota en un bloc de notas el nombre completo de la base de datos y del usuario. Los necesitarás en el siguiente paso.

Paso 2: Configurar el archivo wp-config.php

Ahora viene la parte más técnica, pero no te preocupes, es más sencillo de lo que parece. WordPress necesita un archivo llamado wp-config.php para saber a qué base de datos conectarse. Este archivo se encuentra en la raíz de tu instalación.

¿Cómo editar el archivo?

Tienes dos opciones principales: editarlo directamente desde cPanel o subirlo desde tu computadora.

Opción A: Editar desde cPanel

En cPanel, busca la sección "Archivos" y haz clic en "Administrador de archivos".
Navega hasta la carpeta donde instalaste WordPress. Normalmente es public_html (si es en el dominio principal) o una subcarpeta como public_html/blog.
Busca el archivo wp-config.php. Si no existe, no te preocupes, ahora lo crearemos. Si existe, haz clic derecho sobre él y selecciona "Editar".
Se abrirá un editor de texto. Busca las líneas que contienen las constantes de base de datos. Deberían verse así:

define( 'DB_NAME', 'nombre_base_datos' );
define( 'DB_USER', 'usuario_base_datos' );
define( 'DB_PASSWORD', 'contraseña' );
define( 'DB_HOST', 'localhost' );

Reemplaza los valores con los datos que anotaste anteriormente. Presta atención a las comillas y al punto y coma al final de cada línea. No borres nada más.
Guarda los cambios con el botón "Guardar cambios" en la esquina superior derecha.

Opción B: Crear el archivo desde cero

Si no tienes el archivo wp-config.php, puedes crearlo manualmente:

En tu computadora, descarga el archivo de muestra llamado wp-config-sample.php (está en la carpeta raíz de WordPress).
Ábrelo con un editor de texto (como Bloc de notas o Sublime Text).
Busca las mismas líneas que mencionamos antes y reemplaza los valores.
Guarda el archivo con el nombre wp-config.php (sin la parte de "sample").
Sube el archivo a tu servidor usando el Administrador de archivos de cPanel o un cliente FTP como FileZilla.

[WARNING] Si el archivo wp-config.php ya existe, NO lo borres. Solo edita las líneas de conexión a la base de datos. Borrarlo puede causar la pérdida de configuraciones importantes.

Paso 3: Entender la constante DB_HOST

La mayoría de las veces, el valor de DB_HOST es localhost, pero hay excepciones. Algunos hosts utilizan servidores de bases de datos separados para mejorar el rendimiento. Si tu proveedor te ha indicado un host específico (como mysql.tudominio.com), debes usar ese valor.

[TIP] Si no estás seguro, prueba primero con localhost. Si aparece un error de conexión, revisa la documentación de tu hosting o contacta con soporte.

Paso 4: Probar la conexión

Una vez que hayas configurado el archivo wp-config.php, es hora de probar si todo funciona. Simplemente abre tu navegador y visita la URL de tu sitio web.

Caso 1: Instalación limpia Si estás instalando WordPress por primera vez, deberías ver el asistente de instalación. Te pedirá elegir idioma, crear un usuario administrador y proporcionar el nombre del sitio. Si llegaste aquí, ¡felicidades! La conexión a la base de datos fue exitosa.
Caso 2: Sitio existente Si ya tenías WordPress instalado y solo estabas moviendo la base de datos, deberías ver tu sitio normalmente. Si ves un error, continúa leyendo.

Errores comunes al conectar WordPress con MySQL

Incluso con una guía perfecta, pueden surgir problemas. Aquí te dejo los errores más frecuentes y cómo solucionarlos.

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

Este es el error más común y significa que WordPress no puede comunicarse con MySQL. Las causas más habituales son:

Datos incorrectos: Verifica que DB_NAME, DB_USER y DB_PASSWORD sean exactamente los que creaste en cPanel. Un simple espacio o mayúscula extra puede causar el error.
Host incorrecto: Prueba cambiando DB_HOST de localhost a 127.0.0.1. En algunas configuraciones, esto resuelve el problema.
Base de datos vacía: Si estás migrando un sitio, asegúrate de haber importado los datos de tu sitio anterior. Puedes importar un archivo .sql desde cPanel en la sección "phpMyAdmin".

Error: "No se pudo seleccionar la base de datos"

Este error suele aparecer cuando el usuario no tiene permisos sobre la base de datos. Vuelve a los pasos 7-9 del Paso 1 y asegúrate de haber asignado el usuario a la base de datos con "TODOS LOS PRIVILEGIOS".

Error: "Demasiadas conexiones"

Este error indica que tu base de datos está llegando a su límite de conexiones simultáneas. Puede ser por un plugin mal configurado o por un aumento de tráfico. Contacta con tu proveedor de hosting para aumentar el límite o revisa los plugins de caché.

Tabla de errores rápidos

Error	Causa probable	Solución
"Error al conectar"	Credenciales incorrectas	Revisa `wp-config.php`
"No se pudo seleccionar"	Usuario sin permisos	Asigna privilegios en cPanel
"Tabla no existe"	Base de datos vacía	Importa tu archivo `.sql`
"Host no encontrado"	`DB_HOST` incorrecto	Cambia a `localhost` o `127.0.0.1`

Consejos de seguridad para tu base de datos WordPress

Una vez que tu WordPress está conectado a MySQL, es crucial proteger esa conexión. Aquí tienes algunas recomendaciones básicas:

Usa un prefijo de tabla personalizado

Por defecto, WordPress usa wp_ como prefijo para sus tablas. Esto es un blanco fácil para los atacantes. Puedes cambiarlo durante la instalación o editando el archivo wp-config.php. Busca la línea:

$table_prefix = 'wp_';

Y cámbiala por algo único como miwp_ o seguro_. Esto no afecta el funcionamiento, pero añade una capa extra de seguridad.

Cambia la contraseña de la base de datos periódicamente

Hazlo desde cPanel en la sección "Usuarios MySQL". Después de cambiar la contraseña, recuerda actualizar el archivo wp-config.php con la nueva. Si cambias la contraseña y no actualizas el archivo, tu sitio se caerá.

Realiza copias de seguridad automáticas

Configura copias de seguridad de tu base de datos en cPanel. Busca la sección "Copias de seguridad" y programa una copia semanal. Esto te salvará en caso de un ataque o un error humano.

Preguntas frecuentes (FAQ)

¿Puedo usar una base de datos existente para WordPress?

Sí, puedes. Solo asegúrate de que la base de datos esté vacía o que no tenga tablas con el mismo prefijo que usarás. Si ya tiene datos, WordPress podría intentar sobrescribirlos y causar conflictos.

¿Qué es phpMyAdmin y para qué sirve?

phpMyAdmin es una herramienta incluida en cPanel que te permite gestionar tus bases de datos desde un navegador web. Puedes usarla para importar, exportar y editar datos. Es muy útil para migraciones o para solucionar problemas.

¿Puedo cambiar el nombre de la base de datos después de instalarla?

Técnicamente sí, pero es un proceso delicado. Tendrías que crear una nueva base de datos, importar los datos de la anterior, actualizar el wp-config.php y luego eliminar la base antigua. Es más fácil y seguro crear una nueva base desde cero.

¿Qué pasa si mi hosting usa Syspanel en lugar de cPanel?

[INFO] Si tu hosting utiliza Syspanel (anteriormente conocido como HestiaCP), el proceso es muy similar. La principal diferencia es que la URL de acceso a tu panel será tudominio.com:2106 en lugar del puerto 2083 de cPanel. Dentro de Syspanel, busca la sección "Bases de datos" o "MySQL" para crear tu base de datos y usuario. El resto del proceso (editar wp-config.php) es idéntico.

¿Es necesario saber SQL para conectar WordPress?

No. Todo el proceso se hace desde la interfaz gráfica de cPanel o Syspanel. No necesitas escribir una sola línea de código SQL. Solo necesitas copiar, pegar y reemplazar valores en el archivo de configuración.

¿Puedo conectar WordPress a una base de datos de otro servidor?

Sí, es posible. Tendrías que modificar la constante DB_HOST para que apunte al servidor remoto. Sin embargo, debes asegurarte de que el servidor de bases de datos permita conexiones remotas y que tu hosting no lo bloquee. Esto es menos común y puede ser más lento.

Conclusión

Conectar WordPress a una base de datos MySQL con cPanel es un proceso mecánico que, una vez que lo has hecho un par de veces, se vuelve automático. Los pasos clave son: crear la base de datos y el usuario en cPanel, asignar los permisos correctos y luego editar el archivo wp-config.php con los datos correctos.

Recuerda siempre anotar las credenciales en un lugar seguro y probar el acceso después de cada cambio. Si sigues los pasos de esta guía, tendrás tu sitio funcionando sin problemas. Si te encuentras con errores, revisa la sección de errores comunes y verifica cada dato cuidadosamente. La mayoría de los problemas se deben a un simple error de tipeo o a un host incorrecto.

[WARNING] Nunca compartas tus credenciales de base de datos en foros públicos o con personas no autorizadas. Son la puerta de entrada a toda la información de tu sitio web.

Ahora que ya sabes cómo hacerlo, ¡manos a la obra! Configura tu base de datos y lanza tu sitio WordPress con confianza.