Guía completa de WP-CLI: gestionar WordPress desde terminal

Aquí tienes el texto humanizado, manteniendo todas las etiquetas HTML y clases CSS originales.

WP-CLI es la interfaz de línea de comandos para WordPress. Te permite gestionar cada aspecto de un sitio sin tocar el panel de administración. Para administradores de sistemas y webmasters, esto es un salto enorme en eficiencia. En lugar de hacer clic decenas de veces, ejecutas una sola línea de código y ya: sitio actualizado, plugins instalados, base de datos reparada.

En RedServicio (redservicio.net) sabemos que la terminal puede intimidar al principio. Pero dominar WP-CLI es de esas habilidades que te rentabilizan como profesional técnico. Este artículo va paso a paso, desde la instalación hasta casos de uso que ya no son tan básicos.

Qué es WP-CLI y por qué usarlo

WP-CLI es un conjunto de herramientas de código abierto. Te deja interactuar con WordPress mediante comandos de terminal. Salió oficialmente en 2011 y desde entonces es el estándar de facto para administrar sitios de forma remota.

Las ventajas principales:

• Velocidad: lo que toma minutos en el panel se resuelve en segundos.
• Automatización: integras comandos en scripts de mantenimiento o despliegue continuo.
• Acceso remoto: con SSH gestionas cualquier servidor sin interfaz gráfica.
• Depuración: detectas errores de plugins o temas sin cargar páginas enteras.
• Consistencia: los comandos siempre funcionan igual, da igual la versión de WordPress.

Instalación de WP-CLI

La instalación es directa en Linux o macOS. En Windows necesitas WSL o un emulador como Git Bash.

Instalación en Linux/macOS

Abre tu terminal y corre esto:

1. Descargar el PHAR: curl -O https://raw.githubusercontent.com/wp-cli/builds/gh-pages/phar/wp-cli.phar
2. Verificar que funciona: php wp-cli.phar –info
3. Hacerlo ejecutable: chmod +x wp-cli.phar
4. Moverlo al PATH: sudo mv wp-cli.phar /usr/local/bin/wp
5. Verificar: wp –info

Instalación en Windows con WSL

Si usas Windows 10 u 11, instala WSL2 con Ubuntu desde Microsoft Store. Luego sigues los pasos de Linux dentro de la terminal WSL. El comando wp estará disponible para todos los sitios WordPress alojados en esa máquina virtual.

Comandos esenciales de WP-CLI

Una vez instalado, navega al directorio raíz de tu WordPress. Todos los comandos se ejecutan desde ahí.

Información del sitio

• wp core version – Muestra la versión actual de WordPress.
• wp core check-update – Comprueba si hay actualizaciones.
• wp plugin list – Lista todos los plugins instalados con su estado (activo/inactivo).
• wp theme list – Lista los temas instalados.

Actualizaciones

• wp core update – Actualiza el núcleo a la última versión.
• wp core update-db – Ejecuta las migraciones de base de datos tras una actualización.
• wp plugin update –all – Actualiza todos los plugins.
• wp theme update –all – Actualiza todos los temas.

Gestión de plugins y temas

• wp plugin install nombre-del-plugin – Instala un plugin desde el repositorio oficial.
• wp plugin activate nombre-del-plugin – Activa un plugin.
• wp plugin deactivate nombre-del-plugin – Desactiva un plugin.
• wp plugin delete nombre-del-plugin – Elimina un plugin por completo.
• wp theme activate nombre-del-tema – Activa un tema.

Gestión de usuarios

• wp user list – Muestra todos los usuarios del sitio.
• wp user create usuario [email protected] –role=administrator – Crea un nuevo usuario administrador.
• wp user delete ID – Elimina un usuario por su ID.
• wp user meta update ID wp_user_level 10 – Cambia el nivel de acceso de un usuario.

Base de datos

• wp db export – Exporta la base de datos a un archivo SQL.
• wp db import archivo.sql – Importa una base de datos desde un archivo.
• wp db optimize – Optimiza todas las tablas de la base de datos.
• wp db repair – Repara tablas dañadas.
• wp search-replace ‘dominio-viejo.com’ ‘dominio-nuevo.com’ – Reemplaza cadenas en toda la base de datos. Esto es esencial para migraciones.

WP-CLI para tareas avanzadas

Más allá de lo básico, WP-CLI permite acciones complejas. Te ahorran horas de trabajo.

Clonación y migración de sitios

Con tres comandos duplicas un sitio completo:

1. wp db export backup.sql – Exportas la base de datos.
2. Comprimes y copias los archivos al nuevo servidor.
3. En el nuevo servidor: wp db import backup.sql y luego wp search-replace ‘old.com’ ‘new.com’.

Este método es mucho más rápido que usar plugins de migración. Sobre todo en sitios grandes.

Mantenimiento programado

Puedes crear un script bash que ejecute estos comandos cada semana:

• wp core update
• wp plugin update –all
• wp theme update –all
• wp db optimize

Guardas el script y lo agregas al cron del sistema con crontab -e. Así automatizas el mantenimiento sin tener que tocarlo manualmente.

Depuración de errores

Cuando un sitio se queda en pantalla blanca, WP-CLI te saca del apuro:

• wp plugin deactivate –all – Desactiva todos los plugins de golpe. Así descartas conflictos.
• wp theme activate twentytwentyfour – Cambia al tema por defecto de WordPress.
• wp config set WP_DEBUG true –raw – Activa el modo debug en wp-config.php.

Estos comandos funcionan incluso si el panel de administración está roto. Créeme, lo he visto.

Buenas prácticas y seguridad

WP-CLI es poderoso. Pero también peligroso si no se usa con cuidado. Aquí van algunas recomendaciones:

• Siempre haz un backup antes de actualizar. Usa wp db export antes de cualquier operación destructiva.
• No ejecutes comandos como root. Crea un usuario del sistema con permisos limitados para tareas de WordPress.
• Protege el acceso SSH. Usa claves SSH y desactiva la autenticación por contraseña en el servidor.
• Verifica los comandos. Usa wp –help para ver opciones antes de ejecutar algo nuevo.
• Mantén WP-CLI actualizado. Ejecuta wp cli update periódicamente.

Conclusión

WP-CLI es una herramienta indispensable para cualquier administrador de sistemas o webmaster que gestione sitios WordPress. Hace tareas complejas con comandos simples. Transforma la administración diaria. Desde actualizaciones masivas hasta migraciones completas, te da un control granular que el panel de administración no puede igualar.

Hemos visto instalación, comandos esenciales, tareas avanzadas y buenas prácticas. Si encuentras algún problema técnico que no puedas resolver con estos comandos, en RedServicio (redservicio.net) ofrecemos asistencia profesional para cualquier incidencia relacionada con WordPress y servidores. Nuestro equipo puede ayudarte a configurar WP-CLI, automatizar procesos o recuperar sitios dañados.

Empieza hoy mismo: abre tu terminal, navega a tu sitio WordPress y prueba wp core version. Verás que gestionar WordPress desde la terminal no solo es posible. Te hará más eficiente y te dará un control total sobre tu infraestructura.