Cómo configurar una base de datos en WordPress con WP-CLI

¿Qué es WP-CLI y por qué te hará la vida más fácil?

Si alguna vez has tenido que gestionar una base de datos en WordPress a través de phpMyAdmin, sabrás que puede resultar un poco tedioso, sobre todo si no eres un experto en informática. Pero no te preocupes, porque existe una herramienta que te va a simplificar muchísimo este trabajo: WP-CLI.

WP-CLI es la interfaz de línea de comandos oficial de WordPress. En lugar de hacer clic en botones y navegar por menús, escribes comandos en una terminal (o consola) y la herramienta hace el trabajo por ti. Es rápido, seguro y muy potente. Con WP-CLI puedes instalar WordPress, actualizar plugins, gestionar usuarios y, por supuesto, configurar, importar y exportar bases de datos sin esfuerzo.

En este artículo, te voy a guiar paso a paso, como si estuvieras sentado a mi lado, para que aprendas a usar los comandos wp-cli para manejar tu base de datos WordPress como un profesional. No necesitas ser un desarrollador; solo necesitas seguir las instrucciones con calma.

Requisitos previos: ¿Qué necesitas antes de empezar?

Antes de lanzarnos a escribir comandos, asegurémonos de que tienes todo lo necesario. No queremos que te quedes a mitad de camino.

Acceso al servidor o hosting

Para usar WP-CLI, necesitas acceso a la terminal de tu servidor. Esto normalmente se hace a través de SSH (Secure Shell). Si tu hosting lo gestionas con un panel como Syspanel, recuerda que el acceso por SSH se configura desde ahí. Para conectarte, necesitarás un programa como PuTTY (si usas Windows) o la propia terminal si usas macOS o Linux.

[INFO] Si tu plan de hosting es compartido y no incluye acceso SSH, es posible que no puedas usar WP-CLI directamente. En ese caso, consulta con tu proveedor o considera migrar a un plan VPS o dedicado.

WordPress instalado

Obviamente, necesitas tener WordPress instalado en tu servidor. WP-CLI trabaja directamente sobre la instalación, así que debe estar en una ruta accesible.

WP-CLI instalado

Si no tienes WP-CLI instalado, no te preocupes, es muy sencillo. Normalmente, en los paneles modernos como Syspanel (que se accede por el puerto 2106), ya viene preinstalado. Si no es tu caso, puedes instalarlo siguiendo la guía oficial de WordPress, pero lo más común es que ya lo tengas disponible.

Ubicación de tu WordPress

Necesitas saber la ruta exacta donde está instalado tu WordPress. Por ejemplo, algo como /home/usuario/public_html. Cuando te conectes por SSH, navega hasta esa carpeta usando el comando cd.

cd /home/usuario/public_html

Una vez dentro, puedes verificar que WP-CLI funciona con este comando:

wp --info

Si todo está correcto, verás una lista con la versión de WP-CLI, la versión de PHP, etc. ¡Perfecto, ya estamos listos!

Configurar la base de datos WordPress desde cero con WP-CLI

Ahora sí, vamos a la parte práctica. Configurar una base de datos puede significar varias cosas: crearla, modificarla, o simplemente asegurarnos de que los datos de conexión en wp-config.php son correctos. Vamos a ver los casos más comunes.

Crear una base de datos y un usuario

Imagina que estás instalando WordPress desde cero. Con WP-CLI, puedes crear la base de datos y el usuario asociado sin tocar el panel de control del hosting. Esto es genial porque te evita errores de escritura.

Para crear una base de datos, usa el siguiente comando:

wp db create

Este comando creará la base de datos que está especificada en tu archivo wp-config.php. Si aún no tienes ese archivo configurado, WP-CLI te pedirá los datos. Pero normalmente, si estás en un hosting, ya tienes la base de datos creada desde el panel.

Si necesitas crear un usuario y darle permisos sobre la base de datos, esto se hace mejor desde el panel de control del hosting (como Syspanel), ya que WP-CLI no está diseñado para gestionar usuarios de bases de datos a nivel de servidor.

[TIP] Cuando crees una base de datos desde tu panel, usa un prefijo único para el usuario y la base. Por ejemplo, miusuario_wp. Esto añade una capa de seguridad.

Verificar la conexión a la base de datos

A veces, los problemas de WordPress se deben a que los datos de conexión en wp-config.php son incorrectos. Para verificar que WordPress puede conectar con tu base de datos, usa:

wp db check

Este comando revisa el estado de la conexión y te dirá si todo está bien o si hay algún error. Es una herramienta de diagnóstico muy útil.

Arreglar el prefijo de las tablas

Un clásico en la seguridad de WordPress es cambiar el prefijo de las tablas de la base de datos (por defecto es wp_). WP-CLI no tiene un comando directo para esto, pero puedes usar SQL para hacerlo. Sin embargo, hay un truco: puedes usar wp search-replace para cambiar el prefijo en las opciones de la base de datos.

Este comando es más avanzado, pero te lo menciono porque es muy útil:

wp search-replace 'wp_' 'miprefijo_' --all-tables

[WARNING] Antes de ejecutar este comando, haz una copia de seguridad. Cambiar el prefijo puede romper tu sitio si no se hace correctamente. Además, debes editar manualmente el archivo wp-config.php para cambiar el prefijo en la variable $table_prefix.

Exportar base de datos WordPress con WP-CLI

Exportar tu base de datos es fundamental para hacer copias de seguridad o para migrar tu sitio a otro servidor. Con WP-CLI, es tan fácil como escribir una frase.

Exportar a un archivo .sql

El comando básico para exportar es:

wp db export

Esto creará un archivo con un nombre como database.sql en la carpeta donde estés. Puedes especificar un nombre y una ruta:

wp db export backups/mi-sitio.sql

Así, la copia de seguridad quedará guardada en la carpeta backups con el nombre mi-sitio.sql.

Exportar con compresión

Para ahorrar espacio y tiempo, especialmente si tu base de datos es grande, puedes comprimir el archivo. WP-CLI te permite hacerlo directamente:

wp db export - | gzip > backups/mi-sitio.sql.gz

Este comando exporta la base de datos y la comprime en un archivo .gz. Para restaurarlo después, tendrás que descomprimir primero.

[TIP] Programa una tarea cron en tu servidor para que exporte tu base de datos automáticamente cada semana. Así, siempre tendrás una copia de seguridad reciente sin acordarte de hacerlo tú.

Importar base de datos WordPress con WP-CLI

Importar es el proceso inverso. Es muy útil cuando quieres restaurar una copia de seguridad o migrar tu sitio desde otro lugar.

Importar desde un archivo .sql

El comando es igual de sencillo:

wp db import backups/mi-sitio.sql

Esto importará el archivo mi-sitio.sql a la base de datos que está configurada en tu wp-config.php. Es importante que el archivo exista y que la ruta sea correcta.

Importar desde un archivo comprimido

Si tu copia de seguridad está comprimida (.gz), primero debes descomprimirla y luego importarla. Puedes hacerlo en un solo paso:

gunzip < backups/mi-sitio.sql.gz | wp db import -

Este comando descomprime el archivo y lo pasa directamente al importador de WP-CLI. Es muy elegante y eficiente.

[WARNING] ¡Ojo! Importar una base de datos sobrescribirá todos los datos existentes. Si no estás seguro de que quieres hacer esto, haz una copia de seguridad de la base de datos actual antes de importar. No hay vuelta atrás.

Comandos wp-cli avanzados para gestionar tu base de datos

Ya hemos visto lo básico, pero WP-CLI tiene más trucos bajo la manga. Aquí van algunos comandos que te pueden sacar de un apuro.

Buscar y reemplazar datos (muy útil para migraciones)

Cuando mueves un sitio de un dominio a otro (por ejemplo, de mipagina.com a mipagina.es), las URLs almacenadas en la base de datos siguen apuntando al dominio antiguo. Para arreglarlo, usa wp search-replace:

wp search-replace 'http://mipagina.com' 'http://mipagina.es' --all-tables

Este comando reemplaza todas las ocurrencias de la URL antigua por la nueva en todas las tablas. Es una herramienta indispensable para migraciones.

[INFO] Este comando también es útil para cambiar de HTTP a HTTPS. Solo asegúrate de incluir la http:// o https:// completa para que el reemplazo sea exacto.

Optimizar la base de datos

Con el tiempo, tu base de datos puede fragmentarse y volverse más lenta. Puedes optimizarla con:

wp db optimize

Este comando ejecuta la sentencia OPTIMIZE TABLE en todas las tablas, lo que ayuda a mejorar el rendimiento.

Reparar la base de datos

Si tu base de datos está corrupta o tiene errores, puedes intentar repararla:

wp db repair

Este comando es un buen primer paso si tu sitio te da errores de conexión a la base de datos.

Obtener información de la base de datos

Para ver el tamaño de la base de datos, el número de tablas, etc., usa:

wp db size

Es una forma rápida de tener una visión general de tu base de datos sin tener que ir a phpMyAdmin.

Errores comunes y cómo solucionarlos

No todo es perfecto, y es posible que te encuentres con algún error. Aquí tienes los más comunes y su solución.

El comando wp no se encuentra

Si al escribir wp te dice que el comando no existe, es que WP-CLI no está instalado o no está en el PATH. Intenta ejecutarlo con la ruta completa o revisa la instalación.

Error de conexión a la base de datos

Si WP-CLI te da un error de conexión, revisa los datos en wp-config.php (nombre de la base de datos, usuario, contraseña y host). Asegúrate de que el servicio de base de datos esté activo en tu servidor.

[TIP] Si usas Syspanel para gestionar tu hosting, recuerda que el acceso a la gestión de bases de datos se realiza a través del puerto 2106. Ahí puedes verificar que la base de datos existe y que los usuarios tienen los permisos correctos.

El archivo de importación es demasiado grande

Si tu archivo .sql es muy grande, la importación puede fallar por límites de memoria o tiempo de ejecución. Puedes intentar dividir el archivo en partes más pequeñas o aumentar el límite de memoria de PHP.

Conclusión: Domina tu base de datos con WP-CLI

Como has visto, configurar una base de datos en WordPress con WP-CLI es mucho más sencillo de lo que parece. No necesitas ser un gurú de la línea de comandos; solo necesitas un poco de práctica y las instrucciones adecuadas.

Hemos aprendido a exportar base de datos WordPress, a importar base de datos WordPress y a usar varios comandos wp-cli para mantener tu base de datos en perfecto estado. Esta herramienta te ahorrará muchísimo tiempo y te dará un control total sobre tu sitio web.

Si te ha surgido alguna duda, no dudes en consultar la documentación oficial de WP-CLI o preguntar en los foros de soporte de tu hosting. Y recuerda, antes de cualquier operación que implique cambios, haz una copia de seguridad. ¡Tu yo del futuro te lo agradecerá!

¿Te ha sido útil esta guía? Cuéntame en los comentarios si has conseguido configurar tu base de datos sin problemas o si tienes alguna pregunta que no haya respondido. ¡Estoy aquí para ayudarte!