WP-CLI: instala y administra WordPress desde la terminal

Instalar WP-CLI es el primer paso si quieres administrar WordPress de forma profesional desde la terminal, sin depender del panel de administración ni de un navegador. WP-CLI es la interfaz oficial de WordPress para la línea de comandos, y permite desde actualizar plugins y el núcleo hasta gestionar usuarios, bases de datos y copias de seguridad con comandos de una sola línea. En esta guía verás qué es WP-CLI, qué necesitas en tu servidor y cómo instalarlo correctamente en Linux en pocos minutos.

Qué es WP-CLI y por qué deberías usarlo

WP-CLI (WordPress Command Line Interface) es una herramienta oficial de WordPress que te permite hacer prácticamente cualquier tarea administrativa desde la terminal. En vez de entrar al escritorio y navegar por menús, ejecutas comandos directos que consumen menos recursos. Y van mucho más rápido.

¿Merece la pena aprenderlo? Las ventajas más relevantes son:

• Velocidad: actualizar todos los plugins con wp plugin update –all tarda segundos. Hacerlo a mano desde el escritorio, en cambio, puede llevar fácilmente un cuarto de hora.
• Automatización: puedes integrar WP-CLI en scripts y cron jobs para tareas programadas como copias de seguridad o rotación de usuarios.
• Rescate de sitios caídos: cuando el panel de WordPress no carga (por ejemplo, por un error fatal en un plugin), WP-CLI funciona igual y te permite desactivar plugins o regenerar credenciales. Esto, creedme, se agradece.
• Gestión avanzada: búsqueda y reemplazo en la base de datos con wp search-replace, evaluación de código arbitrario con wp eval, o instalación de WordPress en un solo comando con wp core install.

Si administras varios sitios WordPress, WP-CLI deja de ser una opción y se convierte en una necesidad. En RedServicio (redservicio.net) lo usamos a diario para el mantenimiento de servidores y sitios de clientes.

Requisitos previos para instalar WP-CLI en tu servidor

Antes de instalar nada, asegúrate de cumplir estos requisitos:

• Sistema operativo: entorno UNIX-like (Linux, macOS, FreeBSD, Cygwin). Windows nativo requiere WSL.
• PHP 5.6 o superior: se recomienda PHP 7.4 o superior para un rendimiento óptimo. Compruébalo con php -v.
• WordPress 3.7 o superior: las versiones antiguas no son compatibles.
• Acceso SSH al servidor: necesario si trabajas con un VPS o hosting gestionado. Muchos hostings compartidos incluyen SSH; actívalo desde cPanel o Plesk si está desactivado.
• cURL o wget: para descargar el archivo Phar de instalación.

Verificar el entorno

Conéctate por SSH y ejecuta:

1. php -v — confirma la versión de PHP.
2. which curl wget — verifica que tienes al menos una herramienta de descarga.
3. ls -la ~/public_html — localiza el directorio raíz de tu WordPress (puede variar según el hosting).

¿Tu hosting no permite SSH? Entonces valora migrar a un VPS o consultar en redservicio.net las opciones de servidores con acceso completo a terminal.

Cómo instalar WP-CLI paso a paso en Linux

La instalación recomendada utiliza el archivo Phar oficial. Sigue estos pasos con un usuario con permisos suficientes:

Paso 1: descargar WP-CLI

Ejecuta:

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

O con wget si no tienes cURL disponible.

Paso 2: verificar el archivo descargado

Comprueba que funciona antes de moverlo a su sitio definitivo:

php wp-cli.phar –info

Si ves información sobre la versión de WP-CLI y de PHP, la descarga es correcta.

Paso 3: hacerlo ejecutable y accesible globalmente

Asigna permisos de ejecución y muévelo a una ruta del PATH del sistema:

chmod +x wp-cli.phar && sudo mv wp-cli.phar /usr/local/bin/wp

Paso 4: comprobar la instalación

Ejecuta wp –version. Si el comando responde con la versión instalada, ya puedes usar WP-CLI desde cualquier directorio. Un detalle: los comandos de WordPress deben ejecutarse desde la carpeta raíz del sitio, o bien especificar la ruta con –path.

Con WP-CLI ya instalado, en la siguiente parte de esta guía veremos los comandos esenciales para gestionar núcleo, plugins, temas y usuarios de tu WordPress desde la terminal.

Comandos esenciales de WP-CLI para administrar WordPress

Hay tareas que desde el panel de administración te comen cinco minutos. Con WP-CLI, segundos. Y no exagero. Estos son los comandos que, en mi experiencia, conviene tener memorizados o al menos en una nota pegada al monitor:

Gestión del núcleo de WordPress

• wp core version — muestra la versión instalada de WordPress.
• wp core update — actualiza el núcleo a la última versión disponible.
• wp core verify-checksums — comprueba si algún archivo del núcleo ha sido modificado. Después de limpiar un malware, este comando te salva.

Plugins y temas

• wp plugin list — lista todos los plugins con su estado y versión.
• wp plugin update –all — actualiza todos los plugins de una sola vez.
• wp plugin install wordfence –activate — instala y activa un plugin en un solo comando.
• wp theme activate astra — cambia el tema activo al instante.

Usuarios y base de datos

• wp user create juan juan@dominio.com –role=editor — crea un usuario con rol específico.
• wp user update 1 –user_pass=NuevaClave123 — restablece la contraseña del administrador. Ideal cuando has perdido el acceso y no hay otra vía.
• wp db export backup.sql — exporta la base de datos completa.
• wp search-replace ‘http://dominio-viejo.com’ ‘https://dominio.com’ — imprescindible en migraciones: sustituye URLs en toda la base de datos de forma segura.

Quedan otros que usas a diario: wp cache flush para vaciar la caché, wp cron event run –due-now para lanzar tareas programadas pendientes, wp media regenerate para regenerar miniaturas después de cambiar de tema (algo que mucha gente olvida, y luego se pregunta por qué las imágenes salen borrosas).

Automatiza tareas con scripts y aliases de WP-CLI

Aquí está lo bueno de verdad. Cuando combinas comandos en scripts Bash, el mantenimiento rutinario deja de depender de tu memoria. Un ejemplo de script de mantenimiento diario:

mantenimiento.sh
wp core update
wp plugin update –all
wp theme update –all
wp cache flush
wp db optimize

Lo guardas, le das permisos de ejecución con chmod +x mantenimiento.sh y lo programas con cron para que corra cada noche. Nada más. En diez minutos tienes un mantenimiento automático sin instalar ni un plugin más.

Aliases para gestionar varias instalaciones

¿Administras varios sitios WordPress? Los aliases te dejan cambiar de contexto sin moverte de directorio. Los defines en tu archivo wp-cli.yml o config.yml:

• @tienda: path: /var/www/tienda
• @blog: path: /var/www/blog

Desde ese momento puedes lanzar wp @tienda plugin list o wp @blog core update sin cambiar de carpeta. Y si quieres aplicarlo a todos los sitios de golpe, wp @all plugin update –all. Sencillo y potente a la vez.

Conclusión: administra WordPress como un profesional con WP-CLI

La diferencia entre gestionar WordPress a base de clics y hacerlo con WP-CLI es notable. Actualizas núcleo, plugins y temas en segundos; recuperas el acceso cuando te has bloqueado, sin recurrir a phpMyAdmin; ejecutas migraciones complejas con search-replace; y dejas todo el mantenimiento en manos de un script programado con cron.

Hay un beneficio menos visible: menos plugins de mantenimiento instalados, menos vectores de ataque. El sitio pesa menos y hay menos cosas que puedan romperse. La curva de aprendizaje es corta, y el tiempo invertido se recupera en la primera semana.

¿No te apetece tocar la terminal? Es legítimo (a mí me ha tocado resolver más de un lío ajeno). Si te encuentras con un problema complejo durante la instalación o el uso de WP-CLI, en RedServicio (redservicio.net) tienen expertos en administración de servidores y WordPress capaces de ayudarte con cualquier incidencia técnica, desde la configuración inicial hasta la automatización completa de tus mantenimientos. A partir de ahí, la terminal es tuya.