wp cli
Version 2.11.0
WP-CLI es la interfaz de línea de comandos para WordPress. Puede actualizar complementos, configurar instalaciones multisitio y mucho más, sin utilizar un navegador web.
El mantenimiento continuo es posible gracias a:
La versión estable actual es la versión 2.11.0. Para anuncios, siga a @wpcli en Twitter o regístrese para recibir actualizaciones por correo electrónico. Consulte la hoja de ruta para obtener una descripción general de lo que está planeado para los próximos lanzamientos.
Enlaces rápidos: Usando | Instalación | Soporte | Ampliando | Contribuyendo | Créditos
WP-CLI proporciona una interfaz de línea de comandos para muchas acciones que puedes realizar en el administrador de WordPress. Por ejemplo, wp plugin install --activate (doc) te permite instalar y activar un complemento de WordPress:
$ wp plugin install user-switching --activate
Installing User Switching (1.0.9)
Downloading installation package from https://downloads.wordpress.org/plugin/user-switching.1.0.9.zip...
Unpacking the package...
Installing the plugin...
Plugin installed successfully.
Activating ' user-switching ' ...
Plugin ' user-switching ' activated.
Success: Installed 1 of 1 plugins. WP-CLI también incluye comandos para muchas cosas que no puedes hacer en el administrador de WordPress. Por ejemplo, wp transient delete --all (doc) te permite eliminar uno o todos los transitorios:
$ wp transient delete --all
Success: 34 transients deleted from the database.Para obtener una introducción más completa al uso de WP-CLI, lea la guía de inicio rápido. O póngase al día con amigos del shell para conocer útiles utilidades de línea de comandos.
¿Ya te sientes cómodo con lo básico? Vaya a la lista completa de comandos para obtener información detallada sobre cómo administrar temas y complementos, importar y exportar datos, realizar operaciones de búsqueda y reemplazo de bases de datos y más.
Descargar el archivo Phar es nuestro método de instalación recomendado para la mayoría de los usuarios. Si lo necesita, consulte también nuestra documentación sobre métodos de instalación alternativos (Composer, Homebrew, Docker).
Antes de instalar WP-CLI, asegúrese de que su entorno cumpla con los requisitos mínimos:
Una vez que haya verificado los requisitos, descargue el archivo wp-cli.phar usando wget o curl :
curl -O https://raw.githubusercontent.com/wp-cli/builds/gh-pages/phar/wp-cli.pharA continuación, verifique el archivo Phar para verificar que esté funcionando:
php wp-cli.phar --info Para usar WP-CLI desde la línea de comando escribiendo wp , haga que el archivo sea ejecutable y muévalo a algún lugar de su RUTA. Por ejemplo:
chmod +x wp-cli.phar
sudo mv wp-cli.phar /usr/local/bin/wp Si WP-CLI se instaló correctamente, debería ver algo como esto cuando ejecute wp --info :
$ wp --info
OS: Linux 5.10.60.1-microsoft-standard-WSL2 # 1 SMP Wed Aug 25 23:20:18 UTC 2021 x86_64
Shell: /usr/bin/zsh
PHP binary: /usr/bin/php8.1
PHP version: 8.1.0
php.ini used: /etc/php/8.1/cli/php.ini
MySQL binary: /usr/bin/mysql
MySQL version: mysql Ver 8.0.27-0ubuntu0.20.04.1 for Linux on x86_64 (( Ubuntu ))
SQL modes:
WP-CLI root dir: /home/wp-cli/
WP-CLI vendor dir: /home/wp-cli/vendor
WP_CLI phar path:
WP-CLI packages dir: /home/wp-cli/.wp-cli/packages/
WP-CLI global config:
WP-CLI project config: /home/wp-cli/wp-cli.yml
WP-CLI version: 2.11.0 Puede actualizar WP-CLI con wp cli update (doc) o repitiendo los pasos de instalación.
Si WP-CLI es propiedad de root u otro usuario del sistema, deberá ejecutar sudo wp cli update .
¿Quieres vivir la vida al límite? Ejecute wp cli update --nightly para utilizar la última versión nocturna de WP-CLI. La compilación nocturna es lo suficientemente estable como para que pueda usarla en su entorno de desarrollo y siempre incluye las últimas y mejores funciones de WP-CLI.
WP-CLI también viene con un script de finalización de pestañas para Bash y ZSH. Simplemente descargue wp-completion.bash y obtengalo de ~/.bash_profile :
source /FULL/PATH/TO/wp-completion.bash No olvides ejecutar source ~/.bash_profile después.
Si usa zsh para su shell, es posible que necesite cargar e iniciar bashcompinit antes de realizar el abastecimiento. Coloque lo siguiente en su .zshrc :
autoload bashcompinit
bashcompinit
source /FULL/PATH/TO/wp-completion.bashLos mantenedores y contribuyentes de WP-CLI tienen disponibilidad limitada para abordar preguntas generales de soporte. La versión actual de WP-CLI es la única versión oficialmente compatible.
Cuando busque ayuda, primero busque su pregunta en estos lugares:
Si no encontró una respuesta en uno de los lugares anteriores, puede:
#cli en WordPress.org Slack para chatear con quien esté disponible en ese momento. Esta opción es la mejor para preguntas rápidas.Los problemas de GitHub están destinados a rastrear mejoras y errores de los comandos existentes, no a soporte general. Antes de enviar un informe de error, revise nuestras mejores prácticas para ayudar a garantizar que su problema se resuelva de manera oportuna.
No hagas preguntas de soporte en Twitter. Twitter no es un lugar aceptable para recibir soporte porque: 1) es difícil mantener conversaciones de menos de 280 caracteres y 2) Twitter no es un lugar donde alguien con la misma pregunta pueda buscar una respuesta en una conversación anterior.
Recuerde, libre != gratis; la licencia de código abierto le otorga la libertad de usar y modificar, pero no compromete el tiempo de otras personas. Sea respetuoso y establezca sus expectativas en consecuencia.
Un comando es la unidad atómica de la funcionalidad WP-CLI. wp plugin install (doc) es un comando. wp plugin activate (doc) es otra.
WP-CLI admite el registro de cualquier clase, función o cierre invocable como un comando. Lee los detalles de uso del PHPdoc de la devolución de llamada. WP_CLI::add_command() (doc) se utiliza para el registro de comandos internos y de terceros.
/**
* Delete an option from the database.
*
* Returns an error if the option didn't exist.
*
* ## OPTIONS
*
* <key>
* : Key for the option.
*
* ## EXAMPLES
*
* $ wp option delete my_option
* Success: Deleted 'my_option' option.
*/
$ delete_option_cmd = function ( $ args ) {
list ( $ key ) = $ args ;
if ( ! delete_option ( $ key ) ) {
WP_CLI :: error ( " Could not delete ' $ key ' option. Does it exist? " );
} else {
WP_CLI :: success ( " Deleted ' $ key ' option. " );
}
};
WP_CLI :: add_command ( ' option delete ' , $ delete_option_cmd );WP-CLI viene con docenas de comandos. Es más fácil de lo que parece crear un comando WP-CLI personalizado. Lea el libro de recetas de comandos para obtener más información. Explore los documentos internos de la API para descubrir una variedad de funciones útiles que puede usar en su comando WP-CLI personalizado.
Apreciamos que haya tomado la iniciativa de contribuir a WP-CLI. Es gracias a usted y a la comunidad que lo rodea que WP-CLI es un gran proyecto.
La contribución no se limita solo al código. Le animamos a contribuir de la manera que mejor se adapte a sus capacidades, escribiendo tutoriales, ofreciendo una demostración en su reunión local, ayudando a otros usuarios con sus preguntas de soporte o revisando nuestra documentación.
Lea nuestras pautas de contribución en el manual para obtener una introducción detallada sobre cómo puede participar. Seguir estas pautas ayuda a comunicar que respeta el tiempo de otros contribuyentes en el proyecto. A su vez, harán todo lo posible para corresponder ese respeto cuando trabajen con usted, en diferentes zonas horarias y en todo el mundo.
WP-CLI tiene un responsable del proyecto: schlessera.
En ocasiones, otorgamos acceso de escritura a contribuyentes que han demostrado, durante un período de tiempo, que son capaces e invertidos en hacer avanzar el proyecto.
Lea el documento de gobernanza en el manual para obtener más detalles operativos sobre el proyecto.
Además de las bibliotecas definidas en Composer.json, hemos utilizado código o ideas de los siguientes proyectos:
wp shellwp media regeneratewp search-replacewp exportwp importwp scaffold plugin-tests
