<\/span><\/h3>\n\n\n\nLa forma recomendada es descargar el archivo PHAR oficial y moverlo a una ubicaci\u00f3n del PATH del sistema para poder ejecutarlo desde cualquier directorio:<\/p>\n\n\n\n
bash<\/p>\n\n\n\n
curl -O https:\/\/raw.githubusercontent.com\/wp-cli\/builds\/gh-pages\/phar\/wp-cli.phar\nchmod +x wp-cli.phar\nsudo mv wp-cli.phar \/usr\/local\/bin\/wp<\/code><\/pre>\n\n\n\nVerifica que la instalaci\u00f3n es correcta:<\/p>\n\n\n\n
bash<\/p>\n\n\n\n
wp --info<\/code><\/pre>\n\n\n\nDeber\u00edas ver informaci\u00f3n sobre la versi\u00f3n de WP-CLI, PHP y el sistema operativo.<\/p>\n\n\n\n
<\/span>En hosting compartido con acceso SSH<\/span><\/h3>\n\n\n\nSi tu hosting ofrece acceso SSH, el proceso es el mismo. Con\u00e9ctate con tu cliente habitual (Terminal en Mac\/Linux, PuTTY o Windows Terminal en Windows) y ejecuta los comandos anteriores.<\/p>\n\n\n\n
Si no tienes permisos para escribir en \/usr\/local\/bin<\/code>, puedes instalar WP-CLI en tu directorio de usuario:<\/p>\n\n\n\nbash<\/p>\n\n\n\n
mkdir -p ~\/bin\ncurl -O https:\/\/raw.githubusercontent.com\/wp-cli\/builds\/gh-pages\/phar\/wp-cli.phar\nchmod +x wp-cli.phar\nmv wp-cli.phar ~\/bin\/wp\necho 'export PATH=\"$HOME\/bin:$PATH\"' >> ~\/.bashrc\nsource ~\/.bashrc<\/code><\/pre>\n\n\n\n<\/span>Actualizar WP-CLI<\/span><\/h3>\n\n\n\nbash<\/p>\n\n\n\n
wp cli update<\/code><\/pre>\n\n\n\nPara ver la versi\u00f3n instalada:<\/p>\n\n\n\n
bash<\/p>\n\n\n\n
wp cli version<\/code><\/pre>\n\n\n\n<\/span>Estructura b\u00e1sica de los comandos<\/span><\/h2>\n\n\n\nLos comandos de WP-CLI siguen siempre la misma estructura:<\/p>\n\n\n\n
wp <comando> <subcomando> [opciones] [--flag]<\/code><\/pre>\n\n\n\nPor ejemplo:<\/p>\n\n\n\n
bash<\/p>\n\n\n\n
wp plugin install contact-form-7 --activate<\/code><\/pre>\n\n\n\nDonde wp<\/code> es la herramienta, plugin<\/code> es el comando, install<\/code> es el subcomando, contact-form-7<\/code> es el argumento y --activate<\/code> es una opci\u00f3n para activar el plugin tras instalarlo.<\/p>\n\n\n\nSi tienes varias instalaciones de WordPress en el mismo servidor, usa --path=\/ruta\/a\/wordpress<\/code> para indicar cu\u00e1l es el sitio objetivo. Si ejecutas el comando desde el directorio de la instalaci\u00f3n, no hace falta especificarlo.<\/p>\n\n\n\n<\/span>Comandos esenciales: los que usar\u00e1s cada d\u00eda<\/span><\/h2>\n\n\n\n<\/span>Informaci\u00f3n del sitio<\/span><\/h3>\n\n\n\nbash<\/p>\n\n\n\n
# Ver la versi\u00f3n de WordPress instalada\nwp core version\n\n# Ver informaci\u00f3n completa del entorno\nwp --info\n\n# Verificar la integridad de los archivos de WordPress\nwp core verify-checksums<\/code><\/pre>\n\n\n\n<\/span>Gesti\u00f3n del n\u00facleo de WordPress<\/span><\/h3>\n\n\n\nbash<\/p>\n\n\n\n
# Actualizar WordPress a la \u00faltima versi\u00f3n\nwp core update\n\n# Actualizar la base de datos tras una actualizaci\u00f3n del n\u00facleo\nwp core update-db\n\n# Descargar WordPress en espa\u00f1ol\nwp core download --locale=es_ES\n\n# Instalar WordPress desde cero\nwp core install \\\n --url=\"https:\/\/tudominio.com\" \\\n --title=\"Mi sitio\" \\\n --admin_user=\"admin\" \\\n --admin_password=\"contrase\u00f1a-segura\" \\\n --admin_email=\"correo@tudominio.com\"<\/code><\/pre>\n\n\n\n<\/span>Gesti\u00f3n de plugins<\/span><\/h3>\n\n\n\nbash<\/p>\n\n\n\n
# Listar todos los plugins instalados\nwp plugin list\n\n# Instalar un plugin\nwp plugin install nombre-del-plugin\n\n# Instalar y activar en un solo paso\nwp plugin install nombre-del-plugin --activate\n\n# Instalar desde un archivo ZIP local\nwp plugin install \/ruta\/al\/plugin.zip --activate\n\n# Actualizar un plugin espec\u00edfico\nwp plugin update nombre-del-plugin\n\n# Actualizar todos los plugins de una vez\nwp plugin update --all\n\n# Desactivar un plugin\nwp plugin deactivate nombre-del-plugin\n\n# Eliminar un plugin\nwp plugin delete nombre-del-plugin\n\n# Ver plugins con actualizaciones pendientes\nwp plugin status<\/code><\/pre>\n\n\n\n<\/span>Gesti\u00f3n de temas<\/span><\/h3>\n\n\n\nbash<\/p>\n\n\n\n
# Listar temas instalados\nwp theme list\n\n# Instalar un tema\nwp theme install nombre-del-tema\n\n# Instalar y activar\nwp theme install nombre-del-tema --activate\n\n# Actualizar todos los temas\nwp theme update --all\n\n# Eliminar un tema\nwp theme delete nombre-del-tema<\/code><\/pre>\n\n\n\n<\/span>Gesti\u00f3n de usuarios<\/span><\/h3>\n\n\n\nbash<\/p>\n\n\n\n
# Listar usuarios\nwp user list\n\n# Crear un nuevo usuario\nwp user create nombre correo@ejemplo.com --role=editor\n\n# Crear un administrador\nwp user create admin2 admin2@ejemplo.com --role=administrator --user_pass=contrase\u00f1a-segura\n\n# Cambiar la contrase\u00f1a de un usuario\nwp user update 1 --user_pass=nueva-contrase\u00f1a\n\n# Cambiar el rol de un usuario\nwp user update 1 --role=editor\n\n# Eliminar un usuario reasignando su contenido\nwp user delete 2 --reassign=1<\/code><\/pre>\n\n\n\n<\/span>Gesti\u00f3n de contenido<\/span><\/h3>\n\n\n\nbash<\/p>\n\n\n\n
# Listar entradas publicadas\nwp post list\n\n# Listar p\u00e1ginas\nwp post list --post_type=page\n\n# Crear una entrada\nwp post create --post_title=\"T\u00edtulo de la entrada\" --post_status=publish --post_type=post\n\n# Eliminar una entrada por su ID\nwp post delete 42\n\n# Vaciar la papelera de un golpe\nwp post delete $(wp post list --post_status=trash --format=ids) --force<\/code><\/pre>\n\n\n\n<\/span>Comandos avanzados: los que marcan la diferencia<\/span><\/h2>\n\n\n\n<\/span>B\u00fasqueda y reemplazo en la base de datos<\/span><\/h3>\n\n\n\nEste es uno de los comandos m\u00e1s potentes de WP-CLI, especialmente en migraciones o cuando cambias el dominio de un sitio:<\/p>\n\n\n\n
bash<\/p>\n\n\n\n
# Simular el cambio sin ejecutarlo (imprescindible antes de hacer el cambio real)\nwp search-replace 'http:\/\/dominio-antiguo.com' 'https:\/\/dominio-nuevo.com' --dry-run\n\n# Ejecutar el reemplazo\nwp search-replace 'http:\/\/dominio-antiguo.com' 'https:\/\/dominio-nuevo.com'\n\n# Reemplazar solo en tablas espec\u00edficas\nwp search-replace 'texto-antiguo' 'texto-nuevo' wp_posts wp_postmeta\n\n# Reemplazar excluyendo la tabla de opciones\nwp search-replace 'http:\/\/local.test' 'https:\/\/produccion.com' --skip-tables=wp_options<\/code><\/pre>\n\n\n\nEl comando search-replace<\/code> de WP-CLI gestiona correctamente los datos serializados de PHP \u2014 algo que un simple buscar\/reemplazar en SQL romper\u00eda. \u00dasalo siempre para cambios de URL en lugar de hacerlo manualmente en phpMyAdmin.<\/p>\n\n\n\n<\/span>Gesti\u00f3n de la base de datos<\/span><\/h3>\n\n\n\nbash<\/p>\n\n\n\n
# Optimizar todas las tablas\nwp db optimize\n\n# Reparar la base de datos\nwp db repair\n\n# Exportar la base de datos con fecha en el nombre\nwp db export backup-$(date +%Y%m%d).sql\n\n# Importar un archivo SQL\nwp db import backup.sql\n\n# Ejecutar una consulta SQL directamente\nwp db query \"SELECT COUNT(*) FROM wp_posts WHERE post_status='publish'\"\n\n# Ver el tama\u00f1o de cada tabla\nwp db size --tables<\/code><\/pre>\n\n\n\n<\/span>Gesti\u00f3n de cach\u00e9<\/span><\/h3>\n\n\n\nbash<\/p>\n\n\n\n
# Vaciar la cach\u00e9 de WordPress\nwp cache flush\n\n# Con WP Rocket\nwp rocket clean --confirm\n\n# Con W3 Total Cache\nwp w3-total-cache flush all\n\n# Con LiteSpeed Cache\nwp litespeed-purge all<\/code><\/pre>\n\n\n\n<\/span>Gesti\u00f3n de opciones del sitio<\/span><\/h3>\n\n\n\nbash<\/p>\n\n\n\n
# Ver el valor de una opci\u00f3n\nwp option get siteurl\nwp option get blogname\n\n# Cambiar el nombre del sitio\nwp option update blogname \"Nuevo nombre del sitio\"\n\n# Actualizar la URL del sitio (tras una migraci\u00f3n)\nwp option update siteurl 'https:\/\/nuevo-dominio.com'\nwp option update home 'https:\/\/nuevo-dominio.com'<\/code><\/pre>\n\n\n\n<\/span>Regenerar miniaturas de im\u00e1genes<\/span><\/h3>\n\n\n\n\u00datil cuando cambias de tema y el nuevo usa tama\u00f1os de imagen diferentes:<\/p>\n\n\n\n
bash<\/p>\n\n\n\n
# Regenerar todas las miniaturas\nwp media regenerate --yes\n\n# Regenerar solo un tama\u00f1o espec\u00edfico\nwp media regenerate --image_size=thumbnail --yes<\/code><\/pre>\n\n\n\n<\/span>Gesti\u00f3n del modo mantenimiento<\/span><\/h3>\n\n\n\nbash<\/p>\n\n\n\n
# Activar modo mantenimiento\nwp maintenance-mode activate\n\n# Desactivar modo mantenimiento\nwp maintenance-mode deactivate\n\n# Comprobar el estado\nwp maintenance-mode status<\/code><\/pre>\n\n\n\n<\/span>Gesti\u00f3n de cron jobs de WordPress<\/span><\/h3>\n\n\n\nbash<\/p>\n\n\n\n
# Ver todos los eventos programados\nwp cron event list\n\n# Ejecutar manualmente los eventos pendientes\nwp cron event run --due-now\n\n# Eliminar un evento cron espec\u00edfico\nwp cron event delete nombre_del_evento\n\n# Ver los schedules disponibles\nwp cron schedule list<\/code><\/pre>\n\n\n\n<\/span>Comandos para WordPress Multisite<\/span><\/h2>\n\n\n\nbash<\/p>\n\n\n\n
# Listar todos los sitios de la red\nwp site list\n\n# Crear un nuevo sitio en la red\nwp site create --slug=nuevo-sitio --title=\"Nuevo Sitio\" --email=admin@ejemplo.com\n\n# Actualizar plugins en todos los sitios de la red de una sola vez\nwp site list --field=url | xargs -I {} wp --url={} plugin update --all\n\n# Activar un plugin en toda la red\nwp plugin activate nombre-del-plugin --network<\/code><\/pre>\n\n\n\n<\/span>Scripts \u00fatiles: automatizar con WP-CLI<\/span><\/h2>\n\n\n\nUna de las mayores ventajas de WP-CLI es combinar comandos en scripts de shell para automatizar tareas repetitivas.<\/p>\n\n\n\n
<\/span>Script de actualizaci\u00f3n masiva de sitios<\/span><\/h3>\n\n\n\nbash<\/p>\n\n\n\n
#!\/bin\/bash\n# actualizar-wordpress.sh\n\nSITIOS=(\n \"\/var\/www\/sitio1\/public_html\"\n \"\/var\/www\/sitio2\/public_html\"\n \"\/var\/www\/sitio3\/public_html\"\n)\n\nfor SITIO in \"${SITIOS[@]}\"; do\n echo \"=== Actualizando: $SITIO ===\"\n wp --path=\"$SITIO\" core update\n wp --path=\"$SITIO\" plugin update --all\n wp --path=\"$SITIO\" theme update --all\n wp --path=\"$SITIO\" core update-db\n echo \"=== $SITIO actualizado ===\"\ndone<\/code><\/pre>\n\n\n\n<\/span>Script de backup antes de actualizar<\/span><\/h3>\n\n\n\nbash<\/p>\n\n\n\n
#!\/bin\/bash\n# backup-antes-actualizar.sh\n\nSITIO=\"\/var\/www\/miweb\/public_html\"\nFECHA=$(date +%Y%m%d-%H%M%S)\nBACKUP_DIR=\"\/backups\/wordpress\"\n\nmkdir -p \"$BACKUP_DIR\"\n\nwp --path=\"$SITIO\" db export \"$BACKUP_DIR\/db-$FECHA.sql\"\ntar -czf \"$BACKUP_DIR\/files-$FECHA.tar.gz\" \"$SITIO\"\n\necho \"Backup completado en $BACKUP_DIR\"\n\nwp --path=\"$SITIO\" core update\nwp --path=\"$SITIO\" plugin update --all<\/code><\/pre>\n\n\n\n<\/span>Script de limpieza de la base de datos<\/span><\/h3>\n\n\n\nbash<\/p>\n\n\n\n
#!\/bin\/bash\n# limpiar-wordpress.sh\n\nSITIO=\"\/var\/www\/miweb\/public_html\"\n\n# Eliminar revisiones de entradas\nwp --path=\"$SITIO\" post delete \\\n $(wp --path=\"$SITIO\" post list --post_type=revision --format=ids) \\\n --force 2>\/dev\/null\n\n# Vaciar papelera\nwp --path=\"$SITIO\" post delete \\\n $(wp --path=\"$SITIO\" post list --post_status=trash --format=ids) \\\n --force 2>\/dev\/null\n\n# Eliminar comentarios spam\nwp --path=\"$SITIO\" comment delete \\\n $(wp --path=\"$SITIO\" comment list --status=spam --format=ids) \\\n --force 2>\/dev\/null\n\nwp --path=\"$SITIO\" db optimize\nwp --path=\"$SITIO\" cache flush\n\necho \"Limpieza completada para $SITIO\"<\/code><\/pre>\n\n\n\n<\/span>Soluci\u00f3n de problemas frecuentes<\/span><\/h2>\n\n\n\n\u00abError: This does not seem to be a WordPress installation\u00bb<\/strong>--path=\/ruta\/completa<\/code> expl\u00edcitamente.<\/p>\n\n\n\n\u00abError establishing a database connection\u00bb<\/strong>wp-config.php<\/code> son incorrectas o el servidor MySQL no est\u00e1 accesible. Verifica los valores de DB_NAME<\/code>, DB_USER<\/code>, DB_PASSWORD<\/code> y DB_HOST<\/code>.<\/p>\n\n\n\n\u00abPHP Fatal error\u00bb al ejecutar comandos<\/strong>bash<\/p>\n\n\n\n
\/usr\/local\/bin\/php81 \/usr\/local\/bin\/wp plugin list<\/code><\/pre>\n\n\n\nO a\u00f1ade un alias en tu .bashrc<\/code>:<\/p>\n\n\n\nbash<\/p>\n\n\n\n
alias wp='\/usr\/local\/bin\/php81 \/usr\/local\/bin\/wp'<\/code><\/pre>\n\n\n\nPermisos denegados en archivos<\/strong><\/span>Referencia r\u00e1pida de comandos<\/span><\/h2>\n\n\n\nTarea<\/th> Comando<\/th><\/tr><\/thead> Actualizar WordPress<\/td> wp core update<\/code><\/td><\/tr>Actualizar todos los plugins<\/td> wp plugin update --all<\/code><\/td><\/tr>