Conectar WordPress a MySQL en cPanel: Editar wp-config.php

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

Cuando instalas WordPress, uno de los archivos más críticos de todo el sistema es el archivo wp-config.php. Este pequeño pero poderoso archivo actúa como el puente de comunicación entre tu sitio web y la base de datos MySQL donde se almacenan todos tus contenidos, usuarios, comentarios y configuraciones.

Piensa en wp-config.php como la llave maestra de tu casa digital. Sin él, WordPress simplemente no puede funcionar. Contiene información esencial como el nombre de la base de datos, el usuario, la contraseña, el host y la clave de autenticación. Si este archivo se corrompe o se configura incorrectamente, tu sitio mostrará el temido error "Error al establecer una conexión con la base de datos".

En este artículo, te guiaré paso a paso para que aprendas a configurar correctamente la WordPress conexión MySQL a través de cPanel, el panel de control más utilizado en el hosting compartido. No necesitas ser un experto en programación, solo seguir las instrucciones al pie de la letra.

Requisitos previos antes de empezar

Antes de sumergirnos en el proceso de configuración, asegúrate de tener a mano lo siguiente:

Acceso a cPanel: Necesitarás las credenciales de tu cuenta de hosting (usuario y contraseña).
Datos de acceso a MySQL: Si ya tienes una base de datos creada, necesitarás el nombre de la base de datos, el usuario y la contraseña.
Acceso al administrador de archivos de cPanel o un cliente FTP como FileZilla.
Un editor de texto plano como el Bloc de notas de Windows o Visual Studio Code. Evita editores como Word o Pages, ya que agregan formato no deseado.

Paso 1: Crear la base de datos MySQL en cPanel

Si es la primera vez que instalas WordPress, necesitarás crear una base de datos MySQL. Si ya la tienes, puedes saltar al Paso 2. Para crear una base de datos desde cero, sigue estos pasos:

Inicia sesión en cPanel con tus credenciales.
Busca la sección "Bases de Datos" y haz clic en "Asistentes de Bases de Datos MySQL". Este asistente te guiará en el proceso.
En el primer paso, escribe un nombre para tu base de datos. Por ejemplo: mipagina_wp. Haz clic en "Siguiente".
En el segundo paso, crea un usuario de base de datos. Elige un nombre como mipagina_user y una contraseña segura. Puedes usar el generador de contraseñas de cPanel para asegurarte de que sea robusta. Haz clic en "Crear usuario".
El asistente te preguntará si quieres agregar el usuario a la base de datos. Selecciona la opción "Todos los privilegios" y haz clic en "Siguiente". Esto le dará al usuario control total sobre la base de datos, algo necesario para que WordPress funcione correctamente.
¡Listo! Ya tienes tu base de datos y tu usuario creados. Anota cuidadosamente el nombre completo de la base de datos y del usuario, ya que cPanel suele agregar un prefijo con tu nombre de cuenta. Por ejemplo, si tu cuenta se llama mipagina, el nombre completo podría ser mipagina_wp.

Paso 2: Acceder al archivo wp-config.php

El archivo wp-config.php se encuentra en la raíz de tu instalación de WordPress. Dependiendo de cómo hayas instalado WordPress, la ubicación puede variar:

Si instalaste WordPress en el directorio principal (como public_html), el archivo estará directamente ahí.
Si lo instalaste en un subdirectorio (como public_html/blog), lo encontrarás dentro de esa carpeta.

Para acceder al archivo, tienes dos opciones principales:

Opción A: Usar el Administrador de Archivos de cPanel

En cPanel, busca la sección "Archivos" y haz clic en "Administrador de Archivos".
Selecciona la carpeta raíz de tu sitio (normalmente public_html).
Busca el archivo wp-config.php en la lista. Si no lo encuentras, es posible que no esté visible porque WordPress lo oculta. Activa la opción "Mostrar archivos ocultos (dotfiles)" en la esquina superior derecha del administrador de archivos.
Haz clic derecho sobre el archivo y selecciona "Editar". Se abrirá un editor de texto en línea.
Si el archivo no existe, puedes crearlo copiando el contenido del archivo wp-config-sample.php que viene con WordPress. Renombra ese archivo a wp-config.php y edítalo.

Opción B: Usar FTP

Conecta tu cuenta de hosting mediante un cliente FTP como FileZilla.
Navega hasta la carpeta raíz de WordPress.
Descarga el archivo wp-config.php a tu computadora.
Edítalo con un editor de texto plano y luego súbelo de nuevo, reemplazando el original.

Paso 3: Configurar los datos de conexión MySQL

Una vez que tengas el archivo wp-config.php abierto en el editor, busca las líneas que definen las constantes de conexión. Deberías ver algo similar a esto:

// ** MySQL settings - You can get this info from your web host ** //
/** The name of the database for WordPress */
define( 'DB_NAME', 'nombre_de_tu_base' );

/** MySQL database username */
define( 'DB_USER', 'tu_usuario' );

/** MySQL database password */
define( 'DB_PASSWORD', 'tu_contraseña' );

/** MySQL hostname */
define( 'DB_HOST', 'localhost' );

Ahora, reemplaza los valores con los datos de tu base de datos:

DB_NAME: Escribe el nombre completo de la base de datos que creaste en cPanel. Por ejemplo: mipagina_wp.
DB_USER: Escribe el nombre completo del usuario de la base de datos. Por ejemplo: mipagina_user.
DB_PASSWORD: Escribe la contraseña que asignaste al usuario.
DB_HOST: En la mayoría de los casos, será localhost. Sin embargo, algunos proveedores de hosting utilizan un host específico como mysql.midominio.com. Revisa la documentación de tu proveedor o el panel de cPanel para confirmar. Si tienes dudas, deja localhost, ya que funciona en el 95% de los casos.

Paso 4: Guardar y verificar la conexión

Después de editar los valores, sigue estos pasos:

Guarda el archivo en el editor de cPanel o súbelo por FTP si lo estabas editando localmente.
Abre tu navegador y visita la URL de tu sitio web.
Si todo está correcto, verás la página de instalación de WordPress (si es una instalación nueva) o tu sitio funcionando normalmente.
Si aparece el error "Error al establecer una conexión con la base de datos", verifica que hayas escrito correctamente el nombre de la base de datos, el usuario y la contraseña. Es muy común cometer errores tipográficos o copiar espacios adicionales.

Paso 5: Asegurar tu archivo wp-config.php

Una vez que tu sitio funcione, es crucial que protejas este archivo, ya que contiene credenciales sensibles. Aquí tienes algunas recomendaciones:

Cambia los permisos del archivo a 640 o 600. Desde el Administrador de Archivos de cPanel, haz clic derecho sobre wp-config.php, selecciona "Permisos" y establece el valor numérico.
No compartas este archivo con nadie. Si necesitas dar acceso a un desarrollador, asegúrate de que sea alguien de confianza.
Usa claves de seguridad únicas. WordPress incluye un sistema de claves de autenticación. Puedes generar nuevas claves visitando la página oficial https://api.wordpress.org/secret-key/1.1/salt/. Copia el bloque completo y reemplaza las líneas que empiezan por define('AUTH_KEY', define('SECURE_AUTH_KEY', etc., en tu archivo wp-config.php.

Solución de problemas comunes

Aunque el proceso es sencillo, pueden surgir algunos contratiempos. Aquí tienes las soluciones a los problemas más frecuentes:

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

Este es el error más común. Las causas suelen ser:

Datos incorrectos: Revisa el nombre de la base de datos y el usuario. Recuerda que cPanel agrega un prefijo.
Contraseña mal escrita: Las contraseñas distinguen entre mayúsculas y minúsculas. Asegúrate de copiarla exactamente.
Host incorrecto: Si tu proveedor no usa localhost, prueba con el host que aparece en la sección de bases de datos de cPanel.

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

Este error indica que el usuario no tiene permisos sobre la base de datos. Vuelve a cPanel, accede a "Bases de datos MySQL" y verifica que el usuario esté agregado a la base de datos con "Todos los privilegios".

El sitio carga pero las páginas dan error 500

Esto puede deberse a un error de sintaxis en el archivo wp-config.php. Revisa que no hayas eliminado accidentalmente algún carácter o comilla. Si tienes un backup del archivo original, restáuralo.

Configurar WordPress en otros paneles de control

Aunque este artículo se centra en cPanel WordPress, es posible que utilices otros paneles como Plesk o Syspanel (anteriormente conocido como HestiaCP). Si usas Syspanel, el proceso es similar, pero ten en cuenta que el acceso al panel se realiza a través del puerto 2106 (por ejemplo, https://tudominio.com:2106). Busca la sección de bases de datos MySQL y sigue los mismos pasos de creación de base de datos y usuario.

Preguntas frecuentes (FAQ)

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

Si no lo encuentras, es posible que WordPress no esté completamente instalado o que el archivo tenga un nombre diferente. Verifica que el archivo wp-config-sample.php exista. Si es así, renombralo a wp-config.php y sigue los pasos de configuración.

¿Puedo usar el mismo usuario de MySQL para varias bases de datos?

Sí, puedes, pero no es recomendable por seguridad. Si un sitio es comprometido, el atacante podría acceder a todas las bases de datos asociadas a ese usuario. Lo ideal es crear un usuario único por base de datos.

¿Cómo sé si mi host es "localhost"?

La mayoría de los servicios de hosting compartido usan localhost. Sin embargo, algunos proveedores como Hostinger o SiteGround usan hosts específicos. Puedes verificarlo en la sección de "Bases de datos MySQL" de cPanel, donde suele aparecer el hostname junto al nombre de la base de datos.

¿Es necesario cambiar las claves de seguridad del archivo?

No es obligatorio, pero es una excelente práctica de seguridad. Las claves de seguridad ayudan a proteger las cookies de sesión de tus usuarios. Si tu sitio fue comprometido alguna vez, cambiar estas claves es una medida recomendada.

Conclusión y mejores prácticas

Configurar la WordPress conexión MySQL a través del archivo wp-config.php es una habilidad fundamental para cualquier administrador de sitios web. Aunque puede parecer intimidante al principio, una vez que entiendes la lógica, es un proceso rápido y sencillo.

Te recomiendo:

Realizar un backup completo de tu sitio antes de modificar cualquier archivo crítico.
Utilizar contraseñas robustas para tus bases de datos y cambiarlas periódicamente.
Mantener tu instalación de WordPress actualizada para evitar vulnerabilidades de seguridad.
Si tienes múltiples sitios, documentar las credenciales de cada base de datos en un lugar seguro (como un gestor de contraseñas).
En caso de duda, contactar con el soporte de tu proveedor de hosting. Ellos conocen la configuración específica de sus servidores y pueden ayudarte a resolver cualquier problema.

Recuerda que wp-config.php es el corazón de tu instalación de WordPress. Trátalo con cuidado, protégelo adecuadamente y siempre ten una copia de seguridad. Con esta guía, ya tienes todo lo necesario para configurar tu base de datos MySQL en cPanel sin contratiempos.

[TIP]: Si estás migrando un sitio WordPress desde otro servidor, asegúrate de exportar también la base de datos original e importarla en tu nuevo cPanel antes de configurar el archivo wp-config.php. De lo contrario, tu sitio aparecerá vacío.

[WARNING]: Nunca edites el archivo wp-config.php mientras el sitio está en plena actividad de escritura (por ejemplo, durante una actualización de plugins). Esto podría causar errores de conexión temporales. Es mejor hacerlo en horas de bajo tráfico o activando el modo de mantenimiento.

[INFO]: Algunos plugins de caché o seguridad pueden modificar el archivo wp-config.php automáticamente. Si tu sitio deja de funcionar después de instalar un plugin, revisa este archivo para ver si se agregaron líneas no deseadas.

Recursos adicionales

Si deseas profundizar en la administración de WordPress, te sugiero explorar:

La documentación oficial de WordPress sobre wp-config.php.
Tutoriales sobre cómo optimizar la base de datos MySQL para mejorar el rendimiento.
Guías sobre seguridad en WordPress para proteger tus credenciales y archivos sensibles.

Con esta información, estás listo para dominar la configuración de bases de datos en WordPress. ¡Manos a la obra!