Cómo comprobar si WP-CLI está instalado correctamente

Si ya has seguido la guía de qué es WP-CLI y para qué sirve en WordPress y también has completado los pasos de instalación en Linux, macOS y Windows, el siguiente paso lógico es verificar que todo funciona como debería.

Comprobar si WP-CLI está instalado correctamente no consiste solo en ejecutar un comando y esperar una respuesta. También implica confirmar que el sistema lo reconoce, que la ruta es accesible, que la versión es la adecuada y que puedes usarlo sin errores de permisos o dependencia del entorno.

Por qué conviene validar la instalación

En automatización de tareas de WordPress, una instalación incorrecta puede darte problemas difíciles de diagnosticar: comandos que no se encuentran, versiones inconsistentes o fallos al ejecutar operaciones sobre un sitio concreto.

La verificación temprana evita perder tiempo más adelante. Es especialmente útil si trabajas con varios entornos, como local, staging y producción, o si administras WordPress desde SSH en servidores distintos.

Además, esta comprobación te permite distinguir entre una instalación real de WP-CLI y una configuración parcial donde el archivo existe, pero no está disponible globalmente desde la terminal.

Primer test: ejecutar el comando principal

La forma más rápida de comprobar si WP-CLI está operativo es abrir la terminal y lanzar:

wp --info

Este comando suele mostrar información útil sobre la instalación: versión de WP-CLI, versión de PHP, sistema operativo, ruta del binario y otras variables del entorno.

Si el comando responde con datos estructurados, el programa está disponible para tu sesión actual. Si aparece un error como command not found o ‘wp’ no se reconoce, el problema no es WordPress, sino la forma en que el sistema está encontrando la herramienta.

Qué debes esperar en la salida

La salida exacta puede variar según tu sistema y la versión instalada, pero normalmente verás información relacionada con la ruta del ejecutable, la versión de PHP utilizada y el gestor de paquetes o método de instalación.

No necesitas memorizar cada línea. Lo importante es confirmar tres cosas: que el comando responde, que el ejecutable es accesible y que la versión coincide con la que esperabas instalar.

Comprobar la versión instalada

Otro control básico es pedir la versión directamente con:

wp --version

Este comando te ayuda a verificar que la instalación no solo existe, sino que corresponde a una versión válida y reconocible por el sistema. Si gestionas varios servidores, esto es especialmente práctico para detectar diferencias entre entornos.

En entornos administrados por equipos, también conviene registrar la versión exacta de WP-CLI para mantener consistencia operativa. Así evitas que una persona trabaje con una versión antigua mientras otra usa una más reciente.

Validar la ruta del ejecutable

En muchos casos WP-CLI está instalado, pero no está en el PATH del sistema. Eso significa que el binario existe, pero la terminal no sabe dónde buscarlo.

Para revisarlo, puedes usar:

which wp

En Windows, el equivalente puede depender del shell que uses. En PowerShell, por ejemplo, puedes apoyarte en:

Get-Command wp

Si el sistema devuelve una ruta, como /usr/local/bin/wp o una ubicación similar, entonces la herramienta está accesible desde la terminal. Si no devuelve nada, probablemente necesites ajustar la variable de entorno o revisar cómo se instaló.

Por qué esto importa

WP-CLI puede instalarse correctamente y, aun así, no funcionar desde cualquier carpeta. Eso suele pasar cuando se instaló en una ubicación sin permisos de ejecución adecuados o cuando el enlace simbólico no se creó bien.

Verificar la ruta es una manera sencilla de confirmar que la instalación es usable, no solo presente en el disco.

Comprobar que php está disponible y es compatible

WP-CLI depende de PHP para ejecutarse, así que una instalación aparentemente correcta puede fallar si el entorno no tiene una versión compatible o si el intérprete no está accesible.

Puedes revisar la versión de PHP con:

php -v

Si este comando funciona, ya tienes una pista importante: el entorno PHP está disponible. Si no funciona, WP-CLI tampoco podrá arrancar de forma fiable.

Recuerda que no basta con tener PHP instalado en el servidor; también importa qué versión está ejecutando la terminal y si esa versión es la que usa WP-CLI en la práctica.

Probar un comando orientado a WordPress

Una validación más completa consiste en ejecutar un comando que interactúe con un sitio WordPress real. Por ejemplo, una vez situado en la carpeta de la instalación:

wp core version

Si el comando devuelve la versión de WordPress, entonces WP-CLI no solo está instalado: además puede comunicarse con la instalación del sitio.

Este paso es especialmente útil cuando la herramienta responde correctamente a wp --info, pero falla al operar sobre un proyecto concreto. En ese caso, el problema ya no suele ser la instalación global, sino el contexto del sitio, la ruta actual o la configuración del repositorio.

Errores comunes y cómo interpretarlos

“command not found” o “no se reconoce como un comando”

Este es uno de los fallos más habituales. Suele indicar que WP-CLI no está en el PATH, que no se creó el enlace correcto o que la terminal no ha recargado la configuración del sistema.

También puede ocurrir si abriste una nueva sesión antes de reiniciar el shell o si el archivo descargado no tiene permisos de ejecución.

“permission denied”

Este mensaje apunta a un problema de permisos. El archivo puede existir, pero no tener permisos para ejecutarse desde tu usuario actual.

En este caso conviene revisar la propiedad del archivo, el modo de ejecución y la forma en que se instaló. En servidores compartidos, también es importante comprobar si hay restricciones del hosting.

Fallos relacionados con php

Si WP-CLI se ejecuta, pero muestra errores de PHP, probablemente el problema esté en el intérprete, en la versión activa o en extensiones requeridas por el entorno.

Esto es común cuando el sistema tiene varias instalaciones de PHP y la terminal usa una distinta de la esperada. Por eso conviene verificar tanto wp --info como php -v.

Comprobaciones útiles en distintos sistemas

En Linux y macOS, la verificación suele ser directa porque el trabajo con terminal está muy integrado. Aun así, siempre conviene confirmar el binario con which wp y comprobar que el usuario tenga permisos de ejecución.

En Windows, la experiencia puede variar según uses PowerShell, CMD o un entorno como WSL. Si instalaste WP-CLI en Windows, revisa bien cómo quedó registrado el comando y si estás llamándolo desde el shell correcto.

Si trabajas con WSL, recuerda que en realidad puedes estar usando el sistema Linux dentro de Windows. Eso cambia algunas rutas, la resolución del PATH y la forma de diagnosticar errores.

Señales de que todo está correcto

Podemos resumir la validación en una lista rápida de señales positivas:

WP-CLI responde a comandos básicos como wp --info y wp --version.

El sistema encuentra el ejecutable con which wp o su equivalente en tu shell.

PHP está disponible y la versión se muestra correctamente con php -v.

Los comandos sobre WordPress funcionan, como wp core version, cuando te sitúas dentro del proyecto.

Recomendación práctica para administradores de sitios

Si gestionas varios WordPress, documenta siempre el método de instalación, la versión de WP-CLI y la ruta del comando. Esa pequeña disciplina reduce incidencias y acelera el soporte técnico.

También es recomendable probar la instalación en la terminal exacta que usarás a diario. No es lo mismo validar en una sesión temporal que trabajar de forma habitual desde SSH, una consola local o un contenedor.

En entornos colaborativos, un simple checklist puede evitar incidencias repetidas: versión, ruta, permisos, PHP y ejecución sobre un sitio real.

Conclusión

Comprobar si WP-CLI está instalado correctamente es un proceso sencillo, pero muy valioso. No basta con que el archivo exista: necesitas confirmar que la terminal lo reconoce, que PHP está operativo y que puede interactuar con WordPress sin errores.

Si el comando responde, la ruta es visible y los tests básicos funcionan, puedes trabajar con bastante confianza. Y si algo falla, los mensajes de error suelen darte pistas claras para localizar el origen del problema.

Con esta verificación hecha, ya tendrás una base sólida para empezar a usar WP-CLI en tareas reales de administración, mantenimiento y automatización.

Fuentes y lecturas recomendadas

WP-CLI Handbook oficial

Sitio oficial de WP-CLI

Documentación de comandos de WordPress CLI