WP CLI, Línea de comando para WordPress

WP-CLI es un conjunto de líneas de comandos para hacer administrar instalaciones de WordPress. Fácilmente puedes actualizar plugins, configurar instalaciones multi sitios y mucho más, y lo mejor de todo, sin usar un navegador.

Cómo instalarlo

La opción recomendada es descargando un archivo Phar, aunque existen otras alternativas. Antes de instalar WP-CLI por favor asegúrate de tener un ambiente que cumpla con los requerimientos mínimos.

  • Ambiente UNIX o similar (OS X, Linux, FreeBSD, Cygwin); el soporte para windows es muy límitado (sorry Windows).
  • PHP 5.3.29 o posterior.
  • WordPress 3.7 o posterior.

Si cuentas con los requisitos entonces procedemos a descargar el archivo .phar usando wget o curl:


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

Lo siguiente es confirmar si está funcionando:


$ php wp-cli.phar --info

Para hacer uso de WP-CLI desde la línea de comando al escribir wp tendrémos que hacer que el archivo  sea ejecutable y lo movemos a algúna ubicación de nuestro PATH. Por ejemplo:


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

Si todo lo hicimo correctamente ahora al ejecutar los comandos wp --info veremos algo así:


$ wp --info
PHP binary: /usr/bin/php5
PHP version: 5.5.9-1ubuntu4.14
php.ini used: /etc/php5/cli/php.ini
WP-CLI root dir: /home/wp-cli/.wp-cli
WP-CLI packages dir: /home/wp-cli/.wp-cli/packages/
WP-CLI global config: /home/wp-cli/.wp-cli/config.yml
WP-CLI project config:
WP-CLI version: 1.1.0

Otros métodos de instalación

Instalar vía Composer

Como parte de un proyecto

Agregamos la siguiente línea a nuestro archivo composer.json dentro de nuestro proyecto:


"require" : {
"wp-cli/wp-cli" : "~0.22",
"psy/psysh" : "~0.6"
}

EL package psy/psysh es una sugerencia por parte WP CLI package, es opcional.

Opcionalmente (si se ejecuta en un servidor o, por ejemplo, en una máquina virtual local), puede automatizar la configuración del comando y hacerlo disponible en la ruta de acceso de los usuarios. Supongamos que Composer se instaló en /var/www/vendor, podemos agregar los siguientes comandos de scripts / al archivo composer.json. La segunda y tercera línea configura la finalización de bash (Bash completation) para que no tengamos que recordar cada comando:


"scripts" : {
"post-install-cmd" : [
"[[ -f /usr/bin/wp ]] || sudo ln -s /var/www/vendor/wp-cli/wp-cli/bin/wp /usr/bin/wp",
"source /var/www/vendor/wp-cli/wp-cli/utils/wp-completion.bash",
"[[ -f ~/.bash_profile ]] || touch ~/.bash_profile",
"source ~/.bash_profile"
]
}

El script de arriba asume que su shell actual es bash, lo que podría no ser el caso para todos los usuarios. Por ejemplo para un box de Vagrant (añadido al scripts -block):


cat /etc/passwd | grep $(whoami)
vagrant:x:1000:1000::/home/vagrant:/bin/bash

En caso de tener bash disponible e instalado para su sistema operativo, puede cambiar dinámicamente:


"scripts" : {
"post-update-cmd" : [
"/bin/bash -c \"[[ -f /usr/local/bin/wp ]] || sudo ln -s /var/www/vendor/wp-cli/wp-cli/bin/wp /usr/bin/wp\"",
"/bin/bash -c \"source /var/www/vendor/wp-cli/wp-cli/utils/wp-completion.bash\"",
"/bin/bash -c \"[[ -f ~/.bash_profile ]] || touch ~/.bash_profile\"",
"/bin/bash -c \"source ~/.bash_profile\""
]
}

Como un proyecto

Es necesario php y Composser (o php composer.phar) configurado como comandos de consola.


composer create-project wp-cli/wp-cli --prefer-source

A continuación, ejecute wp-cli/bin/wp o agregue la carpeta wp-cli/bin a PATH para el comando wp global (en Windows, utilice wp-cli/bin/wp.bat en su lugar).

Para actualizar, necesita hacer lo siguiente:


cd wp-cli
git pull origin master
composer install

Requerimiento global

Si prefiere tener herramientas PHP instaladas globalmente a través de Composer y tiene algo como ~/.composer/vendor/bin en su PATH (o C:\Users\suUsuario\AppData\Roaming\Composer\ solo corre:


composer global require wp-cli/wp-cli

Para actualizar todo a nivel global, ejecute composer global update.

Instalación de una versión específica

Si desea instalar una versión específica de WP-CLI, añada los números de versión detrás de los paquetes


composer create-project wp-cli/wp-cli:0.22.0 --no-dev

La versión debe estar en un formato que Composer pueda entender y se puede encontrar en packagist.org.

Instalación bleeding-edge

Si desea instalar bleeding-edge, utilice dev-master:


composer create-project wp-cli/wp-cli:dev-master --no-dev

Instalación global como un proyecto

Como parte de un proyecto

Puede especificar una ruta de instalación personalizada para WP-CLI, así:


composer create-project wp-cli/wp-cli/usr/share/wp-cli --no-dev

Entonces, sólo haga un symlink al binario:


sudo ln -s /usr/share/wp-cli/bin/wp /usr/bin/wp

Instalación en Windows

Instale a través del compositor como se describe anteriormente (Composer) o utilice el siguiente método.

Asegúrese de tener PHP instalado y en nuestro path para que pueda ejecutar globalmente.

Descargue manualmente wp-cli.phar y guárdelo en una carpeta, por ejemplo c:\wp-cli

Cree un archivo llamado wp.bat en c:\wp-cli con los siguientes contenidos:


@ECHO OFF
php "c:/wp-cli/wp-cli.phar" %*

Agrega c:\wp-cli a tu ruta:


setx path "%path%;c:\wp-cli"

Ahora ya puedes usar WP-CLI desde cualquier lugar en la línea de comandos de Windows.

 

Instalar WordPress utilizando comandos de WP Cli

wp core download

Invítanos una tazita de café

Si te ha gustado esta publicación y quieres ayudarnos puedes donar 1 USD. Así seguiremos creando más y más publicaciones para ti.