Migrar un sitio de WordPress no consiste solo en copiar archivos. Cuando el proyecto crece, intervienen la base de datos, las URLs, la pila de plugins, los medios y, en muchos casos, ajustes espec\u00edficos del servidor. Aqu\u00ed es donde WP-CLI<\/strong> se convierte en una herramienta especialmente \u00fatil: permite ejecutar la migraci\u00f3n con precisi\u00f3n, rapidez y menos dependencia del panel de administraci\u00f3n.<\/p>\n Si ya has trabajado con tareas como exportar e importar la base de datos con WP-CLI<\/a> o hacer backups con WP-CLI<\/a>, este art\u00edculo ir\u00e1 un paso m\u00e1s all\u00e1: el objetivo es trasladar una instalaci\u00f3n completa de un entorno a otro de forma ordenada y verificable.<\/p>\n Antes de ejecutar comandos, conviene dejar claro qu\u00e9 significa \u201cmigrar\u201d un WordPress completo. En la pr\u00e1ctica, normalmente hablamos de:<\/p>\n – Los archivos del n\u00facleo, temas, plugins y subidas. Este enfoque es especialmente \u00fatil en despliegues entre entornos de desarrollo, staging y producci\u00f3n, o cuando se cambia de hosting. Si administras varias instalaciones, puede venir bien revisar tambi\u00e9n c\u00f3mo gestionar m\u00faltiples instalaciones de WordPress con WP-CLI<\/a>.<\/p>\n La migraci\u00f3n es m\u00e1s fiable cuando ambos entornos est\u00e1n bien preparados. En el servidor de origen necesitas acceso por terminal y permisos suficientes para leer la instalaci\u00f3n. En el destino, debes disponer de WordPress instalado o, como m\u00ednimo, del directorio listo para recibir los archivos.<\/p>\n Antes de empezar, comprueba que WP-CLI responde correctamente en ambos servidores. Si tienes dudas, te servir\u00e1 la gu\u00eda sobre c\u00f3mo comprobar si WP-CLI est\u00e1 instalado correctamente<\/a>. Tambi\u00e9n es recomendable evitar trabajar en horas de tr\u00e1fico alto.<\/p>\n Aunque el proceso sea t\u00e9cnico y repetible, una migraci\u00f3n siempre debe ir precedida de un backup. Si algo falla, podr\u00e1s volver atr\u00e1s sin perder contenido ni configuraciones. Puedes apoyarte en la estrategia explicada en c\u00f3mo hacer un backup de WordPress con WP-CLI<\/a>.<\/p>\n La parte de archivos incluye el n\u00facleo de WordPress, temas, plugins y, sobre todo, wp-content\/uploads<\/strong>, donde suele residir gran parte del peso del sitio. En muchos casos, el n\u00facleo puede reinstalarse en destino para asegurar que la versi\u00f3n sea consistente.<\/p>\n Una pr\u00e1ctica habitual es transferir solo lo necesario y regenerar lo repetible. Por ejemplo, si el destino ya cuenta con una instalaci\u00f3n limpia, basta con copiar wp-content<\/strong> y luego restaurar la base de datos. Esto reduce errores por archivos obsoletos o personalizaciones accidentales.<\/p>\n Si administras el servidor desde herramientas como Plesk o cPanel, conviene revisar antes WP-CLI en servidores con Plesk o cPanel<\/a>, porque la ruta del sitio y los permisos pueden variar.<\/p>\n La base de datos es el coraz\u00f3n de la migraci\u00f3n. Ah\u00ed est\u00e1n las entradas, p\u00e1ginas, ajustes del tema, men\u00fas, widgets y configuraciones de plugins. WP-CLI simplifica esta tarea porque genera un volcado limpio y compatible.<\/p>\n Si surge un problema de acceso, consulta la gu\u00eda sobre errores de conexi\u00f3n a la base de datos en WP-CLI<\/a>. Es importante no seguir adelante hasta confirmar que la conexi\u00f3n es estable.<\/p>\n Con los archivos ya transferidos, el siguiente paso es restaurar la base de datos en el nuevo entorno. Debes apuntar WordPress a la nueva base de datos y verificar que el usuario tiene privilegios adecuados.<\/p>\n Tras la importaci\u00f3n, conviene limpiar cach\u00e9s y asegurar que el sitio no conserve datos temporales heredados. Si tienes plugins de cach\u00e9 o transients activos, puede ser \u00fatil revisar c\u00f3mo limpiar la cach\u00e9 y transients con WP-CLI<\/a>.<\/p>\n Este es uno de los puntos m\u00e1s delicados. Cuando un WordPress cambia de dominio, de subdominio o incluso de ruta, la base de datos conserva muchas referencias antiguas. Cambiar solo la URL visible no basta: tambi\u00e9n hay que revisar enlaces internos, im\u00e1genes y metadatos serializados.<\/p>\n WP-CLI ofrece una ventaja clara aqu\u00ed: permite hacer b\u00fasquedas y reemplazos seguros a gran escala. Si este paso te resulta familiar, ya habr\u00e1s visto el enfoque en c\u00f3mo cambiar la URL de WordPress con WP-CLI<\/a> y buscar y reemplazar URLs con WP-CLI<\/a>.<\/p>\n Siempre es recomendable empezar con –dry-run<\/strong> para revisar el impacto antes de aplicar cambios definitivos, especialmente en sitios con plugins que almacenan datos serializados.<\/p>\n Si el sitio cambia de servidor, probablemente tambi\u00e9n cambien el nombre de la base de datos, el usuario, la contrase\u00f1a o el host. El archivo wp-config.php<\/strong> debe reflejar esos datos. No es una tarea espec\u00edfica de WP-CLI, pero s\u00ed forma parte de una migraci\u00f3n completa y funcional.<\/p>\n Adem\u00e1s, conviene comprobar que las rutas a archivos temporales, claves de autenticaci\u00f3n o ajustes de entorno no se hayan quedado vinculados al servidor anterior. En despliegues automatizados, esta fase suele formar parte del script de publicaci\u00f3n.<\/p>\n Una vez importada la base de datos y actualizadas las URLs, la revisi\u00f3n final es imprescindible. No des por terminada la migraci\u00f3n hasta validar que el sitio responde, carga recursos est\u00e1ticos y permite entrar al escritorio de WordPress.<\/p>\n Si durante esta fase aparecen errores, vuelve a los fundamentos de diagn\u00f3stico y revisa la gu\u00eda de errores comunes al usar WP-CLI<\/a>. Tambi\u00e9n puede ayudarte WP-CLI no funciona: causas y soluciones<\/a> si el problema est\u00e1 en el entorno de ejecuci\u00f3n.<\/p>\n Una migraci\u00f3n hecha con WP-CLI gana mucho cuando se apoya en buenas pr\u00e1cticas. La primera es trabajar siempre con copia previa. La segunda, validar el proceso en un entorno de pruebas antes de tocar producci\u00f3n. La tercera, documentar cada comando para poder repetirlo en el futuro.<\/p>\n En proyectos m\u00e1s avanzados, muchas agencias convierten este flujo en scripts bash o despliegues autom\u00e1ticos. Si te interesa esa l\u00ednea, puedes profundizar en c\u00f3mo usar WP-CLI en scripts bash<\/a> y despliegues autom\u00e1ticos de WordPress con WP-CLI<\/a>.<\/p>\n Otra recomendaci\u00f3n \u00fatil es auditar el resultado final. Un sitio migrado no solo debe \u201cfuncionar\u201d; tambi\u00e9n debe mantener permisos correctos, contenido \u00edntegro y comportamiento estable. Para ese enfoque, resulta interesante c\u00f3mo auditar una instalaci\u00f3n de WordPress desde consola<\/a>.<\/p>\n Migrar un WordPress completo con WP-CLI es una de esas tareas que, una vez dominadas, ahorran tiempo y reducen errores. La clave est\u00e1 en separar el proceso en fases: preparar, copiar archivos, exportar e importar la base de datos, ajustar URLs y verificar el resultado. WP-CLI no sustituye el criterio t\u00e9cnico, pero s\u00ed ofrece la precisi\u00f3n necesaria para operar con confianza.<\/p>\n Si ya usas la consola para actualizaciones, backups o gesti\u00f3n diaria, dar el salto a la migraci\u00f3n completa es un paso natural. Y si adem\u00e1s construyes tu flujo sobre comandos reproducibles, el proceso se vuelve mucho m\u00e1s predecible en cualquier servidor.<\/p>\n Documentaci\u00f3n oficial de WP-CLI<\/a><\/p>\n Referencia de comandos de WP-CLI en WordPress Developer Resources<\/a><\/p>\nQu\u00e9 incluye una migraci\u00f3n completa<\/h2>\n
\n– La base de datos con contenidos, opciones y configuraciones.
\n– La actualizaci\u00f3n de URLs si cambia el dominio o el subdominio.
\n– La comprobaci\u00f3n final de enlaces, permisos y cach\u00e9.<\/p>\nPreparar el entorno de origen y destino<\/h2>\n
Haz una copia de seguridad previa<\/h3>\n
# Exporta la base de datos del sitio de origen\nwp db export backup-origen.sql\n\n# Comprime los archivos principales del proyecto\ntar -czf wordpress-archivos.tar.gz .\n<\/code><\/pre>\nCopiar los archivos del sitio<\/h2>\n
# Copia wp-content al nuevo servidor\nrsync -avz wp-content\/ usuario@servidor-destino:\/var\/www\/html\/wp-content\/\n\n# O bien sube un respaldo comprimido y descompr\u00edmelo en destino\ntar -xzf wordpress-archivos.tar.gz -C \/var\/www\/html\/\n<\/code><\/pre>\nExportar la base de datos desde el origen<\/h2>\n
# Exportaci\u00f3n est\u00e1ndar de la base de datos\nwp db export origen.sql\n\n# Exportaci\u00f3n comprimida para sitios m\u00e1s grandes\nwp db export - | gzip > origen.sql.gz\n<\/code><\/pre>\nImportar la base de datos en el destino<\/h2>\n
# Importa el volcado SQL en el nuevo servidor\nwp db import origen.sql\n\n# Si el archivo est\u00e1 comprimido\ngunzip < origen.sql.gz | wp db import -\n<\/code><\/pre>\nActualizar urls y rutas internas<\/h2>\n
# Sustituye la URL antigua por la nueva\nwp search-replace 'https:\/\/dominio-antiguo.com' 'https:\/\/dominio-nuevo.com' --all-tables\n\n# Revisa que los cambios sean correctos sin escribir en la base de datos\nwp search-replace 'https:\/\/dominio-antiguo.com' 'https:\/\/dominio-nuevo.com' --all-tables --dry-run\n<\/code><\/pre>\nRevisar wp-config.php y credenciales<\/h2>\n
Verificar el sitio despu\u00e9s de la migraci\u00f3n<\/h2>\n
# Comprueba el estado general de WordPress\nwp core version\n\n# Revisa plugins instalados y su estado\nwp plugin list\n\n# Verifica temas activos\nwp theme list\n\n# Limpia cach\u00e9s residuales si procede\nwp cache flush\n<\/code><\/pre>\nBuenas pr\u00e1cticas para migraciones m\u00e1s seguras<\/h2>\n
Conclusi\u00f3n<\/h2>\n
Fuentes y lecturas recomendadas<\/h3>\n