<\/p>\n
Aprende a buscar y reemplazar URLs en WordPress con WP-CLI de forma segura, r\u00e1pida y precisa, ideal para migraciones y cambios de dominio.<\/p>\n
Cuando un sitio WordPress cambia de dominio, pasa de HTTP a HTTPS o necesita corregir enlaces antiguos, una de las tareas m\u00e1s delicadas es actualizar URLs en toda la base de datos. Hacerlo manualmente desde el panel puede ser lento y, en algunos casos, insuficiente. Aqu\u00ed es donde WP-CLI marca la diferencia: permite hacer b\u00fasquedas y reemplazos masivos desde la consola con rapidez, control y menos margen de error.<\/p>\n
En este art\u00edculo veremos c\u00f3mo usar WP-CLI search-replace<\/strong> para sustituir URLs de forma segura, qu\u00e9 precauciones tomar y en qu\u00e9 escenarios conviene combinarlo con otras herramientas de mantenimiento. Si todav\u00eda no tienes instalado WP-CLI o quieres repasar lo b\u00e1sico, te conviene revisar primero qu\u00e9 es WP-CLI y para qu\u00e9 sirve en WordPress<\/a> y primeros pasos con WP-CLI: comandos b\u00e1sicos explicados<\/a>.<\/p>\n WordPress guarda informaci\u00f3n en la base de datos en muchos lugares diferentes: entradas, p\u00e1ginas, opciones, widgets, metadatos y, en algunos casos, incluso cadenas serializadas usadas por plugins o temas. Por eso, cambiar una URL no siempre significa modificar solo la configuraci\u00f3n principal del sitio.<\/p>\n Algunos casos habituales son:<\/p>\n Migraciones de dominio<\/strong>: pasar de un dominio antiguo a uno nuevo. En estos escenarios, el comando adecuado de WP-CLI evita trabajo repetitivo y ayuda a mantener coherencia en todo el sitio.<\/p>\n Antes de ejecutar cualquier sustituci\u00f3n masiva, haz un backup completo de la base de datos. Un reemplazo mal planteado puede afectar enlaces internos, im\u00e1genes incrustadas o configuraciones de plugins. Si a\u00fan no tienes afianzado este proceso, te recomiendo leer c\u00f3mo hacer un backup de WordPress con WP-CLI<\/a>.<\/p>\n Tambi\u00e9n es buena pr\u00e1ctica comprobar que sabes restaurar la base de datos si algo falla. En ese sentido, conviene tener a mano la gu\u00eda de c\u00f3mo exportar e importar la base de datos con WP-CLI<\/a>, porque el flujo de trabajo en consola suele ir de la mano del respaldo y la recuperaci\u00f3n.<\/p>\n El comando principal para esta tarea es wp search-replace<\/strong>. Su funci\u00f3n es buscar una cadena espec\u00edfica y reemplazarla por otra en la base de datos de WordPress. Su gran ventaja es que entiende la estructura de datos de WordPress, lo que resulta especialmente \u00fatil cuando hay valores serializados.<\/p>\n En un reemplazo est\u00e1ndar, WP-CLI recorre las tablas de la base de datos y actualiza las coincidencias encontradas. Esto lo convierte en una opci\u00f3n muy pr\u00e1ctica para migraciones, siempre que se use con criterio y despu\u00e9s de validar los resultados.<\/p>\n La mejor forma de evitar sorpresas es ejecutar primero una simulaci\u00f3n<\/strong>. WP-CLI permite probar el reemplazo sin modificar nada, lo que te da una vista previa del impacto real del cambio.<\/p>\n Este paso es especialmente recomendable cuando trabajas con sitios grandes, tiendas online o instalaciones con muchos plugins. Una simple revisi\u00f3n del resultado puede ayudarte a detectar si la cadena aparece en m\u00e1s registros de los previstos o si alguna URL necesita un enfoque distinto.<\/p>\n El comando search-replace<\/strong> admite varias opciones que mejoran su control. No siempre necesitas todas, pero conocerlas te ayudar\u00e1 a adaptar el proceso a cada caso.<\/p>\n Si vas a cambiar una URL en toda la web, lo normal es recorrer la base de datos completa. Sin embargo, en algunos proyectos puede interesar limitar el alcance para no tocar tablas de terceros o configuraciones delicadas.<\/p>\n Tambi\u00e9n puedes usar una referencia temporal a la estructura del sitio para comprobar qu\u00e9 contenido sigue apuntando a una direcci\u00f3n antigua. Esto es \u00fatil cuando el proyecto ya ha pasado por varias migraciones y necesitas auditar enlaces con rapidez.<\/p>\n No todas las URLs se comportan igual. En WordPress abundan datos almacenados como cadenas serializadas, y ah\u00ed es donde las b\u00fasquedas manuales o sustituciones directas en SQL pueden romper informaci\u00f3n. WP-CLI est\u00e1 pensado precisamente para reducir ese riesgo, pero aun as\u00ed conviene no improvisar.<\/p>\n Ten especial cuidado si tu sitio usa constructores visuales, plugins de membres\u00eda, LMS o tiendas online. Estos sistemas suelen guardar datos adicionales en la base de datos y pueden depender de rutas internas, im\u00e1genes destacadas o endpoints propios.<\/p>\n En casos complejos, puede ser \u00fatil combinar este proceso con una revisi\u00f3n general del sitio. Si adem\u00e1s est\u00e1s ajustando la direcci\u00f3n principal de la instalaci\u00f3n, consulta c\u00f3mo cambiar la URL de WordPress con WP-CLI<\/a> para no confundir ese ajuste con el reemplazo masivo de contenidos y opciones.<\/p>\n Una vez ejecutado el comando, no des por hecho que todo est\u00e1 perfecto. Dedica unos minutos a comprobar p\u00e1ginas clave, im\u00e1genes, enlaces internos, botones y redirecciones. Un reemplazo exitoso en base de datos no siempre garantiza que el sitio cargue exactamente como esperas.<\/p>\n En especial, verifica:<\/p>\n Home y p\u00e1ginas principales<\/strong>: que carguen con el dominio correcto. Si despu\u00e9s de cambiar URLs notas comportamientos extra\u00f1os relacionados con cach\u00e9, puede ser \u00fatil vaciar transients y cach\u00e9 con una gu\u00eda espec\u00edfica como c\u00f3mo limpiar la cach\u00e9 y transients con WP-CLI<\/a>.<\/p>\n Para una migraci\u00f3n t\u00edpica, un flujo ordenado podr\u00eda ser este:<\/p>\n Este enfoque minimiza riesgos y te permite detectar problemas antes de que afecten a usuarios o al posicionamiento SEO del sitio.<\/p>\n Uno de los fallos m\u00e1s comunes es reemplazar solo una parte de las URLs y dejar otras referencias obsoletas. Tambi\u00e9n es frecuente olvidar que un sitio puede tener versiones con y sin www, o que algunos contenidos sigan apuntando a http aunque ya uses https.<\/p>\n Otro error habitual consiste en realizar el cambio sin backup, o hacerlo sobre producci\u00f3n sin una prueba previa. Si trabajas con entornos separados, documentar bien cada paso te ahorrar\u00e1 tiempo y problemas.<\/p>\n Finalmente, recuerda que WP-CLI es una herramienta potente, pero la limpieza total del sitio a veces requiere m\u00e1s pasos: revisar base de datos, cach\u00e9, redirecciones y archivos del entorno. En migraciones m\u00e1s complejas, incluso puede ser \u00fatil coordinar este proceso con otras tareas de mantenimiento que ya hayas visto en art\u00edculos anteriores sobre gesti\u00f3n de WordPress con WP-CLI<\/a>.<\/p>\n Buscar y reemplazar URLs en WordPress con WP-CLI es una de esas tareas que ahorran horas de trabajo cuando se hace bien. La clave est\u00e1 en combinar tres elementos: backup previo, simulaci\u00f3n con Si ya usas WP-CLI para actualizaciones, instalaciones o copias de seguridad, este comando encaja de forma natural en tu flujo de trabajo y refuerza una administraci\u00f3n m\u00e1s profesional de WordPress desde consola.<\/p>\n Documentaci\u00f3n oficial de WP-CLI: search-replace<\/a><\/p>\nPor qu\u00e9 buscar y reemplazar URLs puede ser necesario<\/h3>\n
\nCambio de protocolo<\/strong>: sustituir URLs con http por https.
\nCorrecci\u00f3n de enlaces internos<\/strong>: limpiar referencias antiguas tras una reestructuraci\u00f3n.
\nEntornos de desarrollo<\/strong>: cambiar URLs entre local, staging y producci\u00f3n.<\/p>\nAntes de empezar: prepara una copia de seguridad<\/h3>\n
El comando search-replace de wp-cli<\/h3>\n
# Sintaxis b\u00e1sica\nwp search-replace 'http:\/\/tudominio.com' 'https:\/\/tudominio.com'\n\n# Ejemplo real: cambiar dominio antiguo por uno nuevo\nwp search-replace 'https:\/\/dominio-antiguo.com' 'https:\/\/dominio-nuevo.com'<\/code><\/pre>\nC\u00f3mo hacer una prueba antes de reemplazar<\/h3>\n
# Simulaci\u00f3n: no modifica la base de datos\nwp search-replace 'http:\/\/tudominio.com' 'https:\/\/tudominio.com' --dry-run<\/code><\/pre>\nOpciones \u00fatiles para afinar el reemplazo<\/h3>\n
# Mostrar m\u00e1s detalle del proceso\nwp search-replace 'http:\/\/tudominio.com' 'https:\/\/tudominio.com' --report-changed-only\n\n# Limitar la operaci\u00f3n a una tabla concreta\nwp search-replace 'http:\/\/tudominio.com' 'https:\/\/tudominio.com' wp_posts\n\n# Saltar tablas espec\u00edficas\nwp search-replace 'http:\/\/tudominio.com' 'https:\/\/tudominio.com' --skip-tables=wp_options<\/code><\/pre>\nCasos en los que hay que tener m\u00e1s cuidado<\/h3>\n
Revisar el resultado despu\u00e9s del reemplazo<\/h3>\n
\nEnlaces internos<\/strong>: que no quede contenido apuntando al dominio antiguo.
\nRecursos multimedia<\/strong>: im\u00e1genes, PDFs o archivos incrustados.
\nPlugins cr\u00edticos<\/strong>: formularios, checkout, membres\u00edas o \u00e1reas privadas.<\/p>\nEjemplo de flujo de trabajo recomendado<\/h3>\n
# 1. Hacer backup antes de tocar nada\nwp db export respaldo.sql\n\n# 2. Probar el reemplazo sin cambios reales\nwp search-replace 'http:\/\/antiguo.com' 'https:\/\/nuevo.com' --dry-run\n\n# 3. Ejecutar el reemplazo real\nwp search-replace 'http:\/\/antiguo.com' 'https:\/\/nuevo.com'\n\n# 4. Limpiar cach\u00e9 si es necesario\nwp cache flush<\/code><\/pre>\nErrores frecuentes al reemplazar URLs<\/h3>\n
Conclusi\u00f3n<\/h3>\n
--dry-run<\/code> y verificaci\u00f3n posterior. Con esa metodolog\u00eda, podr\u00e1s abordar migraciones de dominio, cambios a HTTPS o limpiezas de enlaces de forma mucho m\u00e1s segura.<\/p>\nFuentes y lecturas recomendadas<\/h3>\n