Conectar WordPress a MySQL: Tutorial fácil

¡Hola! Soy tu técnico de soporte amigable. Hoy vamos a resolver una de las dudas más comunes cuando empiezas con WordPress: cómo conectar tu sitio web a una base de datos MySQL. No te preocupes si no eres un experto en tecnología, te guiaré paso a paso, como si estuviéramos tomando un café y resolviéndolo juntos.

¿Qué es exactamente una base de datos MySQL y por qué WordPress la necesita?

Imagina que tu sitio web WordPress es una gran biblioteca. Los archivos de WordPress (el tema, los plugins, las imágenes) son como los estantes y los libros físicos. Pero, ¿dónde guardas el catálogo de todos los libros, los datos de los lectores, los préstamos y las reseñas? Eso es exactamente lo que hace una base de datos MySQL.

WordPress es un sistema de gestión de contenidos (CMS) que necesita un lugar para almacenar toda su información dinámica:

Contenido: Todas tus páginas, entradas (posts), comentarios y categorías.
Configuración: La URL de tu sitio, el idioma, el tema activo y los ajustes generales.
Usuarios: Los nombres, correos electrónicos y contraseñas (encriptadas) de todos los que pueden acceder al panel de administración.
Datos de plugins y temas: Configuraciones específicas de las herramientas que instalas.

Sin una base de datos MySQL, WordPress sería como un coche sin motor: se ve bien, pero no funciona. Cada vez que alguien visita tu web, WordPress consulta la base de datos para mostrar el contenido correcto. Por eso, conectar tu sitio a la base de datos es el paso más importante después de instalar los archivos de WordPress.

Los dos ingredientes principales: archivos de WordPress y base de datos

Antes de empezar a conectar, necesitas tener dos cosas listas:

Los archivos de WordPress: Ya deben estar subidos a tu servidor (normalmente en la carpeta public_html o htdocs). Si aún no los tienes, descárgalos desde wordpress.org y súbelos por FTP o desde el panel de control de tu hosting.
Una base de datos MySQL ya creada: Esto se hace desde el panel de control de tu hosting (cPanel, Syspanel, Plesk, etc.). Necesitarás los siguientes datos:
- Nombre de la base de datos: Por ejemplo, miusuario_wordpress.
- Usuario de la base de datos: Por ejemplo, miusuario_admin.
- Contraseña del usuario: La que hayas elegido (guárdala en un lugar seguro).
- Host de la base de datos: Normalmente es localhost, pero a veces puede ser una IP o un nombre como mysql.tudominio.com.

[INFO] Si usas Syspanel (anteriormente conocido como HestiaCP), recuerda que accedes a tu panel de control a través del puerto 2106 (ejemplo: https://tudominio.com:2106). Allí, en la sección de Bases de Datos, puedes crear tu base de datos y usuario en un solo paso. Syspanel te dará automáticamente el nombre de la base, el usuario y la contraseña.

El archivo mágico: `wp-config.php`

Aquí está el corazón de la conexión. El archivo wp-config.php es el que le dice a WordPress: "Oye, tu base de datos está en esta dirección, con este usuario y esta contraseña". Sin este archivo, WordPress no sabe a dónde ir a buscar la información.

Método 1: La instalación automática (la más fácil)

Si estás instalando WordPress desde cero, la mayoría de los paneles de control (como los instaladores automáticos de Softaculous o el asistente de instalación de WordPress) te guiarán para crear la base de datos y el usuario. No tendrás que tocar el wp-config.php manualmente. El instalador lo hará por ti.

¿Cómo funciona?

Accedes a tu panel de control (Syspanel, cPanel, etc.).
Buscas la opción "Instalador de WordPress" o "Softaculous".
Durante el proceso, te pedirá:
- Nombre de la base de datos: Ponle un nombre descriptivo.
- Usuario: Crea uno nuevo o usa uno existente (mejor crear uno nuevo para seguridad).
- Contraseña: Elige una segura (mezcla mayúsculas, minúsculas, números y símbolos).
El instalador creará la base de datos, el usuario y generará el archivo wp-config.php automáticamente. ¡Listo!

Método 2: La conexión manual (cuando ya tienes los archivos)

Este método es necesario si ya subiste los archivos de WordPress y quieres conectarlos a una base de datos que ya creaste previamente. Aquí es donde entra en juego el archivo wp-config.php.

Paso 1: Localiza el archivo de ejemplo

Dentro de la carpeta de tu sitio web (donde están los archivos de WordPress), busca un archivo llamado wp-config-sample.php. Este es un modelo que vamos a modificar.

Paso 2: Renombra el archivo

Cambia el nombre de wp-config-sample.php a wp-config.php. Este será tu archivo de configuración real.

Paso 3: Edita el archivo con un editor de texto

Abre wp-config.php con un editor de texto plano (como el Bloc de Notas en Windows, TextEdit en Mac, o un editor de código como VS Code). No uses Word o Pages, ya que pueden añadir formatos invisibles que rompan el archivo.

Paso 4: Introduce los datos de tu base de datos

Busca las siguientes líneas en el archivo y reemplaza los valores con los tuyos:

define( 'DB_NAME', 'nombre_de_tu_base_de_datos' );
define( 'DB_USER', 'tu_usuario_de_base_de_datos' );
define( 'DB_PASSWORD', 'tu_contraseña' );
define( 'DB_HOST', 'localhost' ); // Normalmente es localhost

Ejemplo práctico:

Si tu base de datos se llama mipagina_blog, tu usuario es mipagina_admin y la contraseña es ClaveSegura123!, el código quedaría así:

define( 'DB_NAME', 'mipagina_blog' );
define( 'DB_USER', 'mipagina_admin' );
define( 'DB_PASSWORD', 'ClaveSegura123!' );
define( 'DB_HOST', 'localhost' );

[TIP] El DB_HOST casi siempre es localhost. Sin embargo, en algunos hostings compartidos o servicios como WP Engine, puede ser diferente. Si no estás seguro, consulta con tu proveedor de hosting o revisa la documentación. En Syspanel, por ejemplo, suele ser localhost.

Paso 5: Guarda el archivo y súbelo al servidor

Guarda los cambios en el archivo wp-config.php. Si estás trabajando localmente (en tu computadora), súbelo a la carpeta raíz de tu sitio en el servidor (normalmente public_html).

Paso 6: ¡Prueba la conexión!

Ahora, abre tu navegador y visita la URL de tu sitio (ejemplo: tudominio.com). Si todo está correcto, WordPress debería cargar sin problemas. Si ves un mensaje de error como "Error al establecer una conexión con la base de datos", no te preocupes, es común. Vuelve a revisar los datos en el wp-config.php:

¿El nombre de la base de datos está bien escrito?
¿El usuario y la contraseña son correctos?
¿El host es el adecuado?

¿Qué son las "Sales" o "Claves de Seguridad"?

En el mismo archivo wp-config.php, justo después de los datos de la base de datos, encontrarás unas líneas con nombres como AUTH_KEY, SECURE_AUTH_KEY, etc. Estas son claves de seguridad que mejoran el cifrado de las cookies y contraseñas de tu sitio.

¿Debo cambiarlas? Sí, es muy recomendable. No uses las que vienen por defecto en el archivo de ejemplo. Puedes generar nuevas claves automáticamente visitando: https://api.wordpress.org/secret-key/1.1/salt/

Copia el bloque completo que te da esa página y pégalo en tu wp-config.php, reemplazando las líneas existentes. Esto hará tu sitio más seguro.

Solución de problemas comunes (FAQ)

Aquí tienes las preguntas que más me hacen los clientes. Si algo sale mal, revisa esta lista.

❓ "Error al conectar 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, el usuario y la contraseña. Un simple error tipográfico lo rompe todo.
Host incorrecto: Asegúrate de que DB_HOST es localhost o el que te haya proporcionado tu hosting.
Base de datos no creada: ¿Creaste la base de datos en tu panel de control? No basta con tener los archivos de WordPress.
Usuario sin permisos: El usuario debe tener todos los privilegios sobre la base de datos. En Syspanel, al crear la base de datos, el usuario se asigna automáticamente con permisos completos.

❓ "La página se ve en blanco (Pantalla Blanca de la Muerte - WSOD)"

Esto puede deberse a un error en el wp-config.php. Revisa que no haya espacios en blanco o caracteres extraños antes de <?php o después de ?>. Si usas un editor de texto, asegúrate de guardar el archivo en formato UTF-8 sin BOM.

❓ "¿Puedo usar la misma base de datos para dos sitios WordPress?"

Técnicamente sí, pero no es recomendable. Cada sitio debe tener su propia base de datos para evitar conflictos de datos (por ejemplo, que los usuarios de un sitio aparezcan en otro). Si lo haces, tendrías que usar un prefijo de tabla diferente (como wp_sitio1_ y wp_sitio2_), pero es más lío que otra cosa. Mejor crea una base de datos por sitio.

❓ "¿Cómo cambio la base de datos de mi sitio WordPress?"

Si necesitas mover tu sitio a un nuevo servidor o cambiar de base de datos, no solo debes modificar el wp-config.php. También necesitas exportar los datos de la base de datos antigua (con phpMyAdmin o similar) e importarlos a la nueva. Luego, actualiza el wp-config.php con los nuevos datos. Es un proceso más avanzado, pero se puede hacer.

❓ "Mi hosting usa Syspanel. ¿Cómo creo la base de datos?"

¡Fácil! Sigue estos pasos:

Accede a tu panel Syspanel en https://tudominio.com:2106 (recuerda el puerto 2106).
Inicia sesión con tu usuario y contraseña.
Busca la sección "Bases de Datos" o "Base de datos" en el menú lateral.
Haz clic en "Añadir base de datos".
Completa los campos:
- Nombre de la base de datos: Ponle un nombre descriptivo (ej: mipagina_blog).
- Usuario: Se creará automáticamente con el mismo nombre, o puedes personalizarlo.
- Contraseña: Genera una segura o escribe una propia.
Haz clic en "Guardar". Syspanel creará la base de datos y el usuario con todos los permisos necesarios.
Anota el nombre de la base, el usuario y la contraseña. Los usarás en tu wp-config.php.

[WARNING] Nunca compartas tu contraseña de la base de datos por correo electrónico o en lugares públicos. Es la llave maestra de tu sitio.

Consejos finales para una conexión exitosa

Siempre haz una copia de seguridad de tu wp-config.php y de tu base de datos antes de hacer cambios importantes.
Usa contraseñas fuertes para el usuario de la base de datos. Evita cosas como "123456" o "admin".
Mantén tu wp-config.php fuera del alcance público. No lo subas a repositorios públicos de GitHub. Si usas Git, añádelo a tu archivo .gitignore.
Si algo falla, no entres en pánico. Vuelve a leer este artículo paso a paso. El error más común es un simple error de dedo al escribir el nombre de la base de datos.
Para sitios en producción, considera usar un plugin de seguridad que limite los intentos de inicio de sesión en la base de datos, aunque esto es más avanzado.

Conectar WordPress a MySQL es como ponerle el corazón a tu sitio. Una vez que lo haces, todo funciona en armonía. Si después de seguir estos pasos sigues teniendo problemas, no dudes en contactar a tu soporte técnico. ¡Estamos aquí para ayudarte!

Espero que este artículo te haya sido de gran ayuda. ¡Ahora ve y conecta ese sitio web con confianza!