<\/p>\n
Aprende a comprobar si WP-CLI est\u00e1 instalado correctamente con comandos, verificaci\u00f3n de versi\u00f3n, ruta y soluci\u00f3n de errores comunes.<\/p>\n
Si ya has seguido la gu\u00eda de qu\u00e9 es WP-CLI y para qu\u00e9 sirve en WordPress<\/a> y tambi\u00e9n has completado los pasos de instalaci\u00f3n en Linux, macOS y Windows<\/a>, el siguiente paso l\u00f3gico es verificar que todo funciona como deber\u00eda.<\/p>\n Comprobar si WP-CLI<\/strong> est\u00e1 instalado correctamente no consiste solo en ejecutar un comando y esperar una respuesta. Tambi\u00e9n implica confirmar que el sistema lo reconoce, que la ruta es accesible, que la versi\u00f3n es la adecuada y que puedes usarlo sin errores de permisos o dependencia del entorno.<\/p>\n En automatizaci\u00f3n de tareas de WordPress, una instalaci\u00f3n incorrecta puede darte problemas dif\u00edciles de diagnosticar: comandos que no se encuentran, versiones inconsistentes o fallos al ejecutar operaciones sobre un sitio concreto.<\/p>\n La verificaci\u00f3n temprana evita perder tiempo m\u00e1s adelante. Es especialmente \u00fatil si trabajas con varios entornos, como local, staging y producci\u00f3n, o si administras WordPress desde SSH en servidores distintos.<\/p>\n Adem\u00e1s, esta comprobaci\u00f3n te permite distinguir entre una instalaci\u00f3n real de WP-CLI y una configuraci\u00f3n parcial donde el archivo existe, pero no est\u00e1 disponible globalmente desde la terminal.<\/p>\n La forma m\u00e1s r\u00e1pida de comprobar si WP-CLI est\u00e1 operativo es abrir la terminal y lanzar:<\/p>\n Este comando suele mostrar informaci\u00f3n \u00fatil sobre la instalaci\u00f3n: versi\u00f3n de WP-CLI, versi\u00f3n de PHP, sistema operativo, ruta del binario y otras variables del entorno.<\/p>\n Si el comando responde con datos estructurados, el programa est\u00e1 disponible para tu sesi\u00f3n actual. Si aparece un error como command not found<\/strong> o ‘wp’ no se reconoce<\/strong>, el problema no es WordPress, sino la forma en que el sistema est\u00e1 encontrando la herramienta.<\/p>\n La salida exacta puede variar seg\u00fan tu sistema y la versi\u00f3n instalada, pero normalmente ver\u00e1s informaci\u00f3n relacionada con la ruta del ejecutable, la versi\u00f3n de PHP utilizada y el gestor de paquetes o m\u00e9todo de instalaci\u00f3n.<\/p>\n No necesitas memorizar cada l\u00ednea. Lo importante es confirmar tres cosas: que el comando responde, que el ejecutable es accesible y que la versi\u00f3n coincide con la que esperabas instalar.<\/p>\n Otro control b\u00e1sico es pedir la versi\u00f3n directamente con:<\/p>\n Este comando te ayuda a verificar que la instalaci\u00f3n no solo existe, sino que corresponde a una versi\u00f3n v\u00e1lida y reconocible por el sistema. Si gestionas varios servidores, esto es especialmente pr\u00e1ctico para detectar diferencias entre entornos.<\/p>\n En entornos administrados por equipos, tambi\u00e9n conviene registrar la versi\u00f3n exacta de WP-CLI para mantener consistencia operativa. As\u00ed evitas que una persona trabaje con una versi\u00f3n antigua mientras otra usa una m\u00e1s reciente.<\/p>\n En muchos casos WP-CLI est\u00e1 instalado, pero no est\u00e1 en el PATH<\/strong> del sistema. Eso significa que el binario existe, pero la terminal no sabe d\u00f3nde buscarlo.<\/p>\n Para revisarlo, puedes usar:<\/p>\n En Windows, el equivalente puede depender del shell que uses. En PowerShell, por ejemplo, puedes apoyarte en:<\/p>\n Si el sistema devuelve una ruta, como WP-CLI puede instalarse correctamente y, aun as\u00ed, no funcionar desde cualquier carpeta. Eso suele pasar cuando se instal\u00f3 en una ubicaci\u00f3n sin permisos de ejecuci\u00f3n adecuados o cuando el enlace simb\u00f3lico no se cre\u00f3 bien.<\/p>\n Verificar la ruta es una manera sencilla de confirmar que la instalaci\u00f3n es usable, no solo presente en el disco.<\/p>\n WP-CLI depende de PHP<\/strong> para ejecutarse, as\u00ed que una instalaci\u00f3n aparentemente correcta puede fallar si el entorno no tiene una versi\u00f3n compatible o si el int\u00e9rprete no est\u00e1 accesible.<\/p>\n Puedes revisar la versi\u00f3n de PHP con:<\/p>\n Si este comando funciona, ya tienes una pista importante: el entorno PHP est\u00e1 disponible. Si no funciona, WP-CLI tampoco podr\u00e1 arrancar de forma fiable.<\/p>\n Recuerda que no basta con tener PHP instalado en el servidor; tambi\u00e9n importa qu\u00e9 versi\u00f3n est\u00e1 ejecutando la terminal y si esa versi\u00f3n es la que usa WP-CLI en la pr\u00e1ctica.<\/p>\n Una validaci\u00f3n m\u00e1s completa consiste en ejecutar un comando que interact\u00fae con un sitio WordPress real. Por ejemplo, una vez situado en la carpeta de la instalaci\u00f3n:<\/p>\n Si el comando devuelve la versi\u00f3n de WordPress, entonces WP-CLI no solo est\u00e1 instalado: adem\u00e1s puede comunicarse con la instalaci\u00f3n del sitio.<\/p>\n Este paso es especialmente \u00fatil cuando la herramienta responde correctamente a Este es uno de los fallos m\u00e1s habituales. Suele indicar que WP-CLI no est\u00e1 en el PATH<\/strong>, que no se cre\u00f3 el enlace correcto o que la terminal no ha recargado la configuraci\u00f3n del sistema.<\/p>\n Tambi\u00e9n puede ocurrir si abriste una nueva sesi\u00f3n antes de reiniciar el shell o si el archivo descargado no tiene permisos de ejecuci\u00f3n.<\/p>\n Este mensaje apunta a un problema de permisos. El archivo puede existir, pero no tener permisos para ejecutarse desde tu usuario actual.<\/p>\n En este caso conviene revisar la propiedad del archivo, el modo de ejecuci\u00f3n y la forma en que se instal\u00f3. En servidores compartidos, tambi\u00e9n es importante comprobar si hay restricciones del hosting.<\/p>\n Si WP-CLI se ejecuta, pero muestra errores de PHP, probablemente el problema est\u00e9 en el int\u00e9rprete, en la versi\u00f3n activa o en extensiones requeridas por el entorno.<\/p>\n Esto es com\u00fan cuando el sistema tiene varias instalaciones de PHP y la terminal usa una distinta de la esperada. Por eso conviene verificar tanto En Linux y macOS, la verificaci\u00f3n suele ser directa porque el trabajo con terminal est\u00e1 muy integrado. Aun as\u00ed, siempre conviene confirmar el binario con En Windows, la experiencia puede variar seg\u00fan uses PowerShell, CMD o un entorno como WSL. Si instalaste WP-CLI en Windows, revisa bien c\u00f3mo qued\u00f3 registrado el comando y si est\u00e1s llam\u00e1ndolo desde el shell correcto.<\/p>\n Si trabajas con WSL, recuerda que en realidad puedes estar usando el sistema Linux dentro de Windows. Eso cambia algunas rutas, la resoluci\u00f3n del PATH y la forma de diagnosticar errores.<\/p>\n Podemos resumir la validaci\u00f3n en una lista r\u00e1pida de se\u00f1ales positivas:<\/p>\n WP-CLI responde a comandos b\u00e1sicos<\/strong> como El sistema encuentra el ejecutable<\/strong> con PHP est\u00e1 disponible<\/strong> y la versi\u00f3n se muestra correctamente con Los comandos sobre WordPress funcionan<\/strong>, como Si gestionas varios WordPress, documenta siempre el m\u00e9todo de instalaci\u00f3n, la versi\u00f3n de WP-CLI y la ruta del comando. Esa peque\u00f1a disciplina reduce incidencias y acelera el soporte t\u00e9cnico.<\/p>\n Tambi\u00e9n es recomendable probar la instalaci\u00f3n en la terminal exacta que usar\u00e1s a diario. No es lo mismo validar en una sesi\u00f3n temporal que trabajar de forma habitual desde SSH, una consola local o un contenedor.<\/p>\n En entornos colaborativos, un simple checklist puede evitar incidencias repetidas: versi\u00f3n, ruta, permisos, PHP y ejecuci\u00f3n sobre un sitio real.<\/p>\n Comprobar si WP-CLI est\u00e1 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\u00e1 operativo y que puede interactuar con WordPress sin errores.<\/p>\n Si el comando responde, la ruta es visible y los tests b\u00e1sicos funcionan, puedes trabajar con bastante confianza. Y si algo falla, los mensajes de error suelen darte pistas claras para localizar el origen del problema.<\/p>\n Con esta verificaci\u00f3n hecha, ya tendr\u00e1s una base s\u00f3lida para empezar a usar WP-CLI en tareas reales de administraci\u00f3n, mantenimiento y automatizaci\u00f3n.<\/p>\n WP-CLI Handbook oficial<\/a><\/p>\nPor qu\u00e9 conviene validar la instalaci\u00f3n<\/h2>\n
Primer test: ejecutar el comando principal<\/h2>\n
wp --info<\/code><\/pre>\nQu\u00e9 debes esperar en la salida<\/h3>\n
Comprobar la versi\u00f3n instalada<\/h2>\n
wp --version<\/code><\/pre>\nValidar la ruta del ejecutable<\/h2>\n
which wp<\/code><\/pre>\nGet-Command wp<\/code><\/pre>\n\/usr\/local\/bin\/wp<\/code> o una ubicaci\u00f3n similar, entonces la herramienta est\u00e1 accesible desde la terminal. Si no devuelve nada, probablemente necesites ajustar la variable de entorno o revisar c\u00f3mo se instal\u00f3.<\/p>\nPor qu\u00e9 esto importa<\/h3>\n
Comprobar que php est\u00e1 disponible y es compatible<\/h2>\n
php -v<\/code><\/pre>\nProbar un comando orientado a WordPress<\/h2>\n
wp core version<\/code><\/pre>\nwp --info<\/code>, pero falla al operar sobre un proyecto concreto. En ese caso, el problema ya no suele ser la instalaci\u00f3n global, sino el contexto del sitio, la ruta actual o la configuraci\u00f3n del repositorio.<\/p>\nErrores comunes y c\u00f3mo interpretarlos<\/h2>\n
\u201ccommand not found\u201d o \u201cno se reconoce como un comando\u201d<\/h3>\n
\u201cpermission denied\u201d<\/h3>\n
Fallos relacionados con php<\/h3>\n
wp --info<\/code> como php -v<\/code>.<\/p>\nComprobaciones \u00fatiles en distintos sistemas<\/h2>\n
which wp<\/code> y comprobar que el usuario tenga permisos de ejecuci\u00f3n.<\/p>\nSe\u00f1ales de que todo est\u00e1 correcto<\/h2>\n
wp --info<\/code> y wp --version<\/code>.<\/p>\nwhich wp<\/code> o su equivalente en tu shell.<\/p>\nphp -v<\/code>.<\/p>\nwp core version<\/code>, cuando te sit\u00faas dentro del proyecto.<\/p>\nRecomendaci\u00f3n pr\u00e1ctica para administradores de sitios<\/h2>\n
Conclusi\u00f3n<\/h2>\n
Fuentes y lecturas recomendadas<\/h3>\n