WP-CLI: Guía completa para gestionar WordPress desde la línea de comandos

Introducción

WP-CLI — es la utilidad oficial de línea de comandos para WordPress. Permite gestionar el sitio sin entrar al panel de administración: instalar plugins, actualizar el núcleo, gestionar usuarios e incluso ejecutar migraciones de la base de datos. Este enfoque ahorra tiempo, permite automatizar tareas y es especialmente útil para administradores que manejan varios proyectos.

En este artículo veremos qué es WP-CLI, cómo instalarlo y mostraremos ejemplos prácticos de comandos.

¿Qué es WP-CLI?

WP-CLI (WordPress Command Line Interface) — es una herramienta en PHP para trabajar con WordPress desde la terminal. Cubre casi todas las tareas disponibles en el panel gráfico, y a veces ofrece incluso más posibilidades:

instalación y actualización del núcleo, plugins y temas;
gestión de usuarios, entradas y la BD;
operaciones masivas (bulk actions);
gestión remota vía SSH;
automatización mediante scripts Bash/PHP.

Ventajas de WP-CLI

Eficiencia: los comandos se ejecutan más rápido que las mismas acciones por la interfaz.
Operaciones masivas: actualizar plugins o limpiar caché en todos los sitios de una vez.
Automatización: scripts para backups, migraciones o despliegues.
Gestión remota: trabajar vía SSH sin navegador.
Funciones avanzadas: comandos que no existen en el admin (por ejemplo, wp transient delete --all).

Instalación de WP-CLI

Requisitos

Entorno UNIX (Linux, macOS, FreeBSD).
PHP 5.6+.
WordPress 3.7+.

Pasos de instalación

Descargar el archivo Phar:

curl -O https://raw.githubusercontent.com/wp-cli/builds/gh-pages/phar/wp-cli.phar

Hacerlo ejecutable:
```
chmod +x wp-cli.phar
```
Moverlo a $PATH:
```
sudo mv wp-cli.phar /usr/local/bin/wp
```
Comprobar:
```
wp --info
```

Si tienes cPanel sin acceso root:

alias wp='~/wp-cli.phar'
echo "alias wp='~/wp-cli.phar'" >> ~/.bashrc

💡 También se puede instalar WP-CLI mediante Composer, Homebrew o Docker.

Comandos principales de WP-CLI

Gestión del núcleo

wp core download --path=wp-site
wp core install --url="http://example.com" --title="My Site" --admin_user="admin" --admin_password="securepassword" --admin_email="admin@example.com"
wp core update
wp core install --skip-content   # reinstalación sin afectar el contenido

Plugins

wp plugin install akismet --activate
wp plugin update --all
wp plugin deactivate --all

Temas

wp theme install twentytwentyone --activate
wp theme list

Base de datos

wp db export backup.sql
wp db import backup.sql
wp search-replace 'http://old.com' 'https://new.com' --dry-run

Usuarios

wp user create newuser user@example.com --role=editor --user_pass=123secure
wp user delete 42 --reassign=1

Contenido

wp post create --post_type=post --post_title="Новый пост" --post_status=publish
wp post generate --count=10

Adicional

wp transient delete --all
wp config set WP_DEBUG true --raw
wp eval 'echo get_option("siteurl");'

Funciones avanzadas

Comandos personalizados

Con wp scaffold package se pueden crear comandos propios de WP-CLI en PHP.

Gestión remota

wp --ssh=user@host:/path/to/wordpress plugin install akismet --activate

Integración con scripts

#!/bin/bash
for site in /var/www/site1 /var/www/site2; do
  wp --path=$site plugin update --all
done

Solución de problemas

Comprobación de versión: wp cli version
Ayuda por comando: wp help plugin install
Depuración: wp plugin install akismet --debug

Problemas comunes:

Permission denied → ejecución con un usuario sin permisos.
No encuentra WordPress → indicar --path=/var/www/site.

Conclusión

WP-CLI es imprescindible para desarrolladores y administradores de WordPress. Acelera las tareas rutinarias, permite automatizar actualizaciones, migraciones y el mantenimiento de sitios. Al dominar sus comandos básicos, podrás trabajar con WordPress de forma más eficiente y fiable.

📚 Referencia completa: wp-cli.org

Comando de ayuda: wp help