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
Amazon Auto Links: No products found.