Requisitos previos antes de instalar WP-CLI
WP-CLI es una herramienta basada en PHP, así que lo primero es confirmar que tu sistema cumple con los requisitos mínimos. En general, necesitarás tener instalado PHP y acceso a la terminal o consola de comandos.
Antes de empezar, conviene revisar estos puntos:
- PHP instalado y accesible desde la línea de comandos.
- Permisos para mover archivos en el sistema.
- Conexión a Internet para descargar el archivo oficial.
- En Windows, una terminal compatible como PowerShell, Windows Terminal o WSL.
Si trabajas en un entorno con restricciones, como un hosting compartido o un equipo corporativo, puede que necesites coordinar permisos o usar una ruta personalizada para la instalación.
Instalación de WP-CLI en linux
Linux suele ofrecer la experiencia más directa para instalar WP-CLI. La forma recomendada es descargar el archivo PHAR oficial, hacerlo ejecutable y moverlo a una ubicación incluida en el PATH.
Descargar el archivo oficial
Usa la terminal para obtener la versión estable de WP-CLI desde su repositorio oficial. Este método es preferible porque reduce la dependencia de gestores de paquetes que pueden tener versiones retrasadas.
curl -O https://raw.githubusercontent.com/wp-cli/builds/gh-pages/phar/wp-cli.phar
# Verifica que el archivo responde correctamente
php wp-cli.phar --info
Si el comando anterior devuelve información del entorno, significa que el archivo funciona y que PHP lo ejecuta sin problemas.
Hacer WP-CLI ejecutable
Después de descargarlo, cambia los permisos para que el sistema pueda ejecutarlo como un comando.
chmod +x wp-cli.phar
sudo mv wp-cli.phar /usr/local/bin/wp
Con esto, podrás invocarlo simplemente escribiendo wp en la terminal. El nombre corto es el más habitual en documentación, tutoriales y flujos de trabajo profesionales.
Comprobar la instalación
La validación final es sencilla:
wp --info
Si el sistema muestra datos sobre WP-CLI, PHP y el entorno actual, ya puedes empezar a usarlo. En algunos casos, si el comando no se reconoce, el problema suele estar en la variable de entorno PATH o en el permiso de ejecución.
Instalación de WP-CLI en macOS
En macOS, el proceso es muy parecido al de Linux. La terminal de Apple permite instalar WP-CLI manualmente sin complicaciones, y en muchos casos resulta la opción más estable para desarrolladores que trabajan con WordPress localmente.
Usar la terminal para descargar WP-CLI
Abre Terminal o iTerm2 y ejecuta el comando de descarga:
curl -O https://raw.githubusercontent.com/wp-cli/builds/gh-pages/phar/wp-cli.phar
php wp-cli.phar --info
Si recibes un error relacionado con PHP, revisa qué versión tienes instalada en el sistema. macOS suele requerir una instalación adicional de PHP, ya sea mediante Homebrew o a través de la configuración del entorno de desarrollo.
Mover el binario al path
El siguiente paso consiste en renombrar el archivo y colocarlo en una carpeta accesible globalmente. Una ruta común es /usr/local/bin o, en equipos más recientes, una ubicación compatible con tu instalación de Homebrew.
chmod +x wp-cli.phar
sudo mv wp-cli.phar /usr/local/bin/wp
Si prefieres mantener un control más estricto del entorno, también puedes guardarlo en una carpeta de herramientas dentro de tu directorio personal y añadirla al PATH manualmente.
Verificar que wp responde
wp --info
Cuando el comando responde correctamente, ya tienes WP-CLI listo para gestionar instalaciones de WordPress, plugins, temas y bases de datos desde la consola.
Instalación de WP-CLI en windows
Windows merece una mención especial porque el flujo de instalación depende del tipo de terminal y del ecosistema que uses. En la práctica, hay tres caminos comunes: WSL, PowerShell con PHP instalado y entornos como Git Bash o Windows Terminal.
Opción recomendada: usar wsl
Si trabajas con WordPress en serio desde Windows, WSL suele ser la alternativa más cómoda. Te permite disponer de un entorno Linux dentro de Windows, con una experiencia muy cercana a la de un servidor real.
Una vez dentro de WSL, puedes seguir exactamente los mismos pasos que en Linux:
curl -O https://raw.githubusercontent.com/wp-cli/builds/gh-pages/phar/wp-cli.phar
chmod +x wp-cli.phar
sudo mv wp-cli.phar /usr/local/bin/wp
wp --info
Esta opción resulta muy útil para desarrollo local, automatización y pruebas reproducibles.
Instalación directa en windows con php
Si prefieres trabajar de forma nativa en Windows, necesitas tener PHP instalado y disponible en la consola. Luego puedes descargar el archivo PHAR y ejecutarlo con el intérprete de PHP.
curl -o wp-cli.phar https://raw.githubusercontent.com/wp-cli/builds/gh-pages/phar/wp-cli.phar
php wp-cli.phar --info
Para usarlo como comando global, puedes crear un archivo por lotes o un alias en PowerShell que apunte al ejecutable de PHP. También es posible añadir la carpeta donde guardes wp-cli.phar al PATH, aunque eso depende de tu forma de trabajo.
Comprobar problemas habituales
En Windows, los errores más frecuentes suelen estar relacionados con rutas, permisos o con la ausencia de PHP en el PATH. Si el comando php no se reconoce, primero soluciona ese punto y luego vuelve a probar WP-CLI.
También es importante recordar que WP-CLI se ejecuta mejor en entornos de desarrollo y administración controlada; en servidores o equipos con políticas restrictivas, puede requerir ajustes adicionales.
Cómo comprobar que WP-CLI está bien instalado
Más allá de que el comando se ejecute, conviene validar que la instalación está completa. El chequeo más básico es consultar la información del entorno:
wp --info
Este comando sirve para confirmar versión, binario activo y compatibilidad del entorno. Si todo está correcto, ya puedes pasar a tareas más avanzadas como instalar plugins, crear usuarios o ejecutar búsquedas y reemplazos en la base de datos.
Si el comando no funciona, revisa estas causas:
- PHP no está instalado o no está en el PATH.
- El archivo no tiene permisos de ejecución.
- La ruta de instalación no forma parte de las variables del sistema.
- Se descargó un archivo incorrecto o incompleto.
Buenas prácticas después de instalar WP-CLI
Una vez instalado, merece la pena dedicar unos minutos a dejar el entorno bien preparado. Eso reduce errores futuros y mejora la productividad en tareas repetitivas de WordPress.
Te conviene trabajar siempre con una versión de PHP compatible con tu proyecto, documentar la ubicación del binario y revisar que el comando se ejecute desde la carpeta correcta del sitio. Aunque WP-CLI es muy flexible, el contexto de ejecución importa mucho, sobre todo cuando administras varios proyectos.
También es buena idea combinar WP-CLI con entornos locales como Docker, MAMP, XAMPP o Laravel Herd, según el flujo de trabajo que uses. La instalación en sí es solo el comienzo; el verdadero valor aparece cuando lo integras en tu rutina diaria.
Conclusión
Instalar WP-CLI paso a paso en Linux, macOS o Windows es un proceso sencillo si partes de un entorno con PHP y una terminal bien configurada. La clave está en descargar el archivo oficial, darle permisos adecuados y asegurarte de que el comando quede accesible globalmente.
Si vienes de leer qué es WP-CLI y para qué sirve en WordPress, esta guía te deja listo para dar el salto a la práctica. A partir de aquí, podrás automatizar tareas, administrar sitios con más rapidez y trabajar con una consola mucho más eficiente.
Fuentes y lecturas recomendadas
Deja una respuesta