Conectar WordPress a MySQL en DirectAdmin | Guía completa

Introducción: El motor de datos de tu WordPress

Cuando instalas WordPress, estás creando un sitio web que necesita un lugar seguro y organizado para guardar todo su contenido: artículos, páginas, imágenes, configuraciones, comentarios y usuarios. Ese "almacén" es la base de datos, y en la mayoría de los servidores con panel de control DirectAdmin, el motor que se utiliza es MySQL (o sus variantes como MariaDB).

Conectar WordPress a una base de datos MySQL en DirectAdmin puede parecer un paso técnico complicado, pero en realidad es un proceso muy mecánico. Solo necesitas entender qué datos buscar y dónde colocarlos. En esta guía extensa, te explicaré paso a paso, desde cero y con un lenguaje claro, cómo realizar esta conexión sin romper nada en el intento. También resolveremos los errores más comunes que aparecen cuando algo falla en el camino.

Al final de este artículo, tendrás la confianza para hacerlo tú mismo, ya sea para un blog personal, una tienda online o el sitio de tu negocio. Vamos a ello.

¿Qué necesitas antes de empezar?

Antes de tocar cualquier archivo, es fundamental que tengas a mano tres datos clave que te proporcionará tu proveedor de hosting o que tú mismo crearás en DirectAdmin:

El nombre de la base de datos (ejemplo: usuario_wpdb).
El nombre de usuario de la base de datos (ejemplo: usuario_wpuser).
La contraseña de ese usuario (la que definiste al crearla).
El host de la base de datos (normalmente es localhost, pero a veces puede ser un servidor remoto como mysql.tudominio.com).

Si no tienes estos datos, primero debes crearlos en DirectAdmin. Te muestro cómo hacerlo en la siguiente sección.

Paso 1: Crear la base de datos y el usuario en DirectAdmin

DirectAdmin es un panel de control muy popular y su interfaz para gestionar MySQL es bastante intuitiva. Sigue estos pasos para crear tu base de datos desde cero.

### Accediendo al área de gestión de MySQL

Inicia sesión en tu panel de DirectAdmin (normalmente en https://tudominio.com:2222).
Busca la sección "MySQL Management" o "Administración de MySQL". En la mayoría de los temas de DirectAdmin, está en la página principal o en el menú "Cuenta".
Haz clic en el icono de "Crear nueva base de datos" (suele tener un símbolo de "+" o un texto similar).

### Creando la base de datos y el usuario

En el formulario, te pedirá un "Nombre de la base de datos". DirectAdmin normalmente añade un prefijo con tu nombre de usuario. Por ejemplo, si tu usuario es juan, y escribes wordpress, el nombre final será juan_wordpress. Anota este nombre completo, lo necesitarás más tarde.
A continuación, te pedirá un "Nombre de usuario" para la base de datos. De nuevo, se añadirá el prefijo. Por ejemplo: juan_wpuser. Anótalo también.
Ahora, define una contraseña segura. DirectAdmin suele tener un generador automático. Si la creas tú, asegúrate de que tenga mayúsculas, minúsculas, números y símbolos. Guárdala en un lugar seguro (un gestor de contraseñas es ideal).
Haz clic en "Crear".

[TIP] No necesitas crear el usuario por separado si el formulario te lo pide todo junto. DirectAdmin lo hace automáticamente y le asigna todos los privilegios sobre esa base de datos. Si te da la opción de elegir privilegios, selecciona "ALL PRIVILEGES" para evitar problemas de permisos al instalar plugins o temas.

Paso 2: Localizar y editar el archivo wp-config.php

Este es el corazón de la conexión. WordPress guarda toda la configuración de conexión a la base de datos en un archivo llamado wp-config.php. Este archivo se encuentra en la raíz de tu instalación de WordPress.

### ¿Dónde está el archivo?

Si instalaste WordPress en la raíz de tu dominio (ej. public_html/), el archivo estará en public_html/wp-config.php.
Si lo instalaste en una subcarpeta (ej. public_html/blog/), estará en public_html/blog/wp-config.php.

Puedes acceder a él de dos maneras:

A través del Administrador de Archivos de DirectAdmin: Entra en "Gestor de Archivos" (File Manager), navega a la carpeta correcta y busca el archivo. Haz clic derecho y selecciona "Editar".
A través de FTP: Conecta con un cliente como FileZilla, navega a la ruta mencionada, descarga el archivo a tu ordenador, edítalo con un editor de texto plano (como Notepad++ o Sublime Text) y vuelve a subirlo (sobrescribiendo el original).

[WARNING] Nunca edites wp-config.php con el Bloc de Notas de Windows estándar, ya que puede añadir caracteres invisibles que rompan el archivo. Usa un editor de código o el editor integrado de DirectAdmin.

### Los datos que debes cambiar

Una vez que tengas el archivo abierto, busca las siguientes líneas (normalmente están al principio del archivo):

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' );
define( 'DB_CHARSET', 'utf8' );
define( 'DB_COLLATE', '' );

Sustituye los valores entre comillas simples por los datos que anotaste en el Paso 1:

DB_NAME: Pega aquí el nombre completo de la base de datos (ej. juan_wordpress).
DB_USER: Pega aquí el nombre completo del usuario (ej. juan_wpuser).
DB_PASSWORD: Pega aquí la contraseña que definiste.
DB_HOST: En el 99% de los casos, déjalo como localhost. Si tu hosting usa un servidor de bases de datos externo, te lo habrán indicado (ej. mysql.tudominio.com).

Guarda los cambios y sube el archivo si lo estabas editando localmente.

Paso 3: Probar la conexión (y errores comunes)

Ahora viene el momento de la verdad. Abre tu navegador y escribe la URL de tu sitio web (o la URL de la carpeta donde instalaste WordPress).

### Éxito: La instalación o el sitio funciona

Si la conexión es correcta, verás una de dos cosas:

Si es una instalación nueva: La famosa pantalla de instalación de WordPress en español ("¡Bienvenido a WordPress!").
Si es un sitio ya existente: Tu página web cargará con normalidad.

### Error 1: "Error establishing a database connection" (Error al conectar con la base de datos)

Este es el error más temido y común. Aparece cuando WordPress no puede comunicarse con MySQL. Las causas suelen ser:

Datos incorrectos en wp-config.php: Revisa que no haya espacios extra, comillas o errores tipográficos. Compara carácter por carácter con los datos de DirectAdmin.
El host es incorrecto: A veces, el host no es localhost, sino 127.0.0.1 o un nombre de servidor específico. Consulta la documentación de tu hosting o el correo de bienvenida.
La base de datos o el usuario no existen: Ve a DirectAdmin y verifica que la base de datos y el usuario que creaste estén listados correctamente.
El usuario no tiene permisos sobre la base de datos: En DirectAdmin, edita la base de datos y asegúrate de que el usuario asignado tenga todos los privilegios (SELECT, INSERT, UPDATE, DELETE, etc.).

### Error 2: "One or more database tables are unavailable" (Una o más tablas no están disponibles)

Este error suele indicar que la conexión se realiza, pero las tablas de WordPress (wp_posts, wp_options, etc.) no existen o están corruptas.

Solución: Si es una instalación nueva, borra todo el contenido de la carpeta y vuelve a subir los archivos de WordPress. Si es un sitio existente, necesitarás reparar las tablas desde phpMyAdmin (en DirectAdmin) usando la opción "Reparar" (Repair) en la pestaña "Operaciones".

### Error 3: "Your PHP installation appears to be missing the MySQL extension"

Este error es menos común hoy en día, pero puede aparecer. Significa que PHP no tiene activada la extensión para hablar con MySQL.

Solución: En DirectAdmin, ve a "Configuración de PHP" o "Select PHP Version" y asegúrate de que los módulos mysqli y pdo_mysql estén marcados y activados. Luego, reinicia PHP o el servicio de Apache/LiteSpeed.

Solución de problemas avanzados (FAQ)

Aquí tienes las preguntas más frecuentes que recibimos en soporte sobre este tema.

### ¿Puedo usar la misma base de datos para dos instalaciones de WordPress?

No es recomendable. Aunque es técnicamente posible si cambias el prefijo de las tablas (ej. wp_ a wp2_), es una fuente de problemas. Si un sitio se actualiza o se rompe, puede afectar al otro. Es mucho más seguro crear una base de datos independiente para cada instalación.

### ¿Qué es el prefijo de la base de datos y debo cambiarlo?

El prefijo es el texto que va antes del nombre de cada tabla (ej. wp_options). Cambiarlo de wp_ a algo como miwp_ añade una capa de seguridad contra ataques de inyección SQL. Puedes cambiarlo en el archivo wp-config.php con la línea $table_prefix = 'miwp_';. Hazlo antes de instalar WordPress, porque cambiarlo después es un proceso complejo.

### ¿Cómo cambio la contraseña de la base de datos en DirectAdmin?

Ve a "MySQL Management" en DirectAdmin.
Localiza la base de datos y haz clic en el icono de "Editar" o "Cambiar contraseña".
Introduce la nueva contraseña y guárdala.
Importante: Debes actualizar también el archivo wp-config.php con la nueva contraseña, o tu sitio dejará de funcionar.

### ¿Qué hago si mi sitio ya estaba funcionando y de repente da error de conexión?

Esto suele deberse a un cambio reciente en el servidor o a un ataque.

Revisa el wp-config.php: Asegúrate de que nadie lo haya modificado (a veces los plugins de seguridad lo hacen).
Revisa el estado del servidor: Contacta con tu proveedor de hosting para ver si hay una caída temporal del servicio de MySQL.
Revisa los logs de error: En DirectAdmin, en "Logs de Errores", busca errores relacionados con mysqli o pdo. Esto te dará pistas más precisas.

### ¿Es lo mismo conectar WordPress a MySQL que a MariaDB?

Sí, a efectos prácticos es idéntico. MariaDB es un reemplazo directo de MySQL y usa el mismo protocolo. La configuración en wp-config.php es exactamente la misma. DirectAdmin a menudo instala MariaDB por defecto, pero el panel lo llama "MySQL Management".

Conclusión y consejos finales

Conectar WordPress a una base de datos MySQL en DirectAdmin es un proceso de "rellenar formularios" una vez que entiendes la lógica. La clave está en tener los datos correctos y colocarlos en el archivo wp-config.php sin errores tipográficos.

Recuerda estos puntos clave:

Siempre haz una copia de seguridad del archivo wp-config.php antes de editarlo.
Usa contraseñas fuertes y únicas para tu base de datos.
No compartas tu archivo wp-config.php con nadie, ya que contiene credenciales de acceso a tu base de datos.
Si en algún momento te sientes perdido, no dudes en consultar la documentación oficial de DirectAdmin o abrir un ticket de soporte con tu proveedor. Ellos pueden ver los logs del servidor y ayudarte a diagnosticar el problema en cuestión de minutos.

[INFO] Si tu hosting utiliza un panel alternativo llamado Syspanel, el proceso es prácticamente idéntico al de DirectAdmin. La única diferencia notable es que el acceso al panel de control se realiza a través del puerto 2106 (ej. https://tudominio.com:2106). Busca la sección de "Bases de Datos" o "MySQL" y sigue los mismos pasos de creación de base de datos y usuario.

Espero que esta guía te haya sido de gran ayuda. Con un poco de práctica, podrás realizar esta conexión en menos de cinco minutos. ¡Buena suerte con tu proyecto WordPress!