Instalación y uso de WP-CLI en Windows

Guía completa: qué es WP-CLI, para qué sirve, cómo instalarlo, configurarlo y usarlo en Windows.

---

Qué es WP-CLI

WP-CLI (WordPress Command Line Interface) es una herramienta de línea de comandos para administrar sitios de WordPress sin usar un navegador.

Permite:

• instalar y actualizar WordPress;
• gestionar plugins, temas y usuarios;
• realizar búsquedas y reemplazos en la base de datos;
• automatizar tareas mediante scripts.

Sitio oficial: https://wp-cli.org

---

Por qué es útil

Ventajas de usar WP-CLI:

• Automatización — puedes escribir scripts para operaciones masivas.
• Velocidad — trabajar por línea de comandos es más rápido que la interfaz gráfica.
• Flexibilidad — administra WordPress incluso sin interfaz web.
• Seguridad — puedes desactivar el panel de administración y trabajar solo desde la terminal.

---

Requisitos

• PHP 7.4 o superior (se recomienda 8.x)
• WordPress 3.7 o superior
• PHP CLI debe estar en la variable PATH
• Conexión a Internet para descargar los archivos

Verificar PHP:

php -v

---

Instalación de WP-CLI en Windows

1. Descargar wp-cli.phar

Abre PowerShell y ejecuta:

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

(O bien, descárgalo manualmente y guárdalo en C:\wp-cli\.)

---

2. Verificar el funcionamiento

php C:\wp-cli\wp-cli.phar --info

Si aparece información de versión, funciona correctamente.

---

3. Crear wp.bat

Crea un archivo C:\wp-cli\wp.bat con este contenido:

@ECHO OFF
php "%~dp0wp-cli.phar" %*

Ahora podrás usar WP-CLI escribiendo simplemente wp.

---

4. Agregar al PATH

Para poder ejecutar wp desde cualquier carpeta:

setx PATH "$($env:PATH);C:\wp-cli" /M

Reinicia PowerShell y verifica:

wp --info

Si funciona, la instalación está completa.

---

Alternativa: instalación mediante Composer

composer global require wp-cli/wp-cli

Luego añade la ruta:

%USERPROFILE%\AppData\Roaming\Composer\vendor\bin

---

Uso de WP-CLI

Ejemplos de comandos:

Instalar WordPress:

wp core download --locale=es_ES

Crear el archivo wp-config.php:

wp config create --dbname=wordpress --dbuser=root --dbpass=secret

Instalar un sitio:

wp core install --url="http://localhost" --title="Mi Sitio" --admin_user=admin --admin_password=1234 --admin_email=test@example.com

Actualizaciones:

wp core update
wp plugin update --all

Usuarios:

wp user create editor editor@example.com --role=editor --user_pass=pass123

---

Comandos útiles

• wp plugin list — muestra la lista de plugins
• wp theme list — muestra los temas instalados
• wp search-replace "http://viejo" "https://nuevo" — búsqueda y reemplazo masivo
• wp db export / wp db import — copia de seguridad y restauración de la base de datos
• wp shell — abre una consola PHP interactiva

Lista completa: https://developer.wordpress.org/cli/commands/

---

Script de PowerShell para instalación automática

Guarda esto como install-wp-cli.ps1 y ejecútalo como administrador:

$targetDir = "C:\wp-cli"
$pharUrl   = "https://raw.githubusercontent.com/wp-cli/builds/gh-pages/phar/wp-cli.phar"
$pharPath  = "$targetDir\wp-cli.phar"
$batPath   = "$targetDir\wp.bat"

Write-Host "Instalando WP-CLI..." -ForegroundColor Cyan

if (!(Test-Path $targetDir)) {
    New-Item -ItemType Directory -Force -Path $targetDir | Out-Null
}

Invoke-WebRequest -Uri $pharUrl -OutFile $pharPath

"@ECHO OFF
php ""%~dp0wp-cli.phar"" %*" | Out-File $batPath -Encoding ASCII

$envPath = [Environment]::GetEnvironmentVariable("Path", "Machine")
if ($envPath -notlike "*$targetDir*") {
    [Environment]::SetEnvironmentVariable("Path", "$envPath;$targetDir", "Machine")
    Write-Host "✅ Añadido $targetDir al PATH (reinicia la terminal)" -ForegroundColor Green
}

php $pharPath --info

Después de ejecutarlo, podrás usar:

wp --info

---

Consejos

• Ejecuta PowerShell como administrador al modificar el PATH.
• Para sitios remotos, usa --ssh=<usuario>@<host>.
• Si hay errores SSL, usa --skip-ssl-check.
• Realiza una copia de seguridad antes de operaciones masivas.

---

Conclusión

WP-CLI es una herramienta potente para administradores y desarrolladores de WordPress.
Ahorra tiempo, automatiza tareas y hace la gestión más segura y eficiente.

Autor: hypo69
Licencia: MIT (https://opensource.org/licenses/MIT)