Buscar y reemplazar en la base de datos de WordPress

WordPress no guarda la dirección de su sitio en un único lugar. Está en los ajustes, pero también aparece literalmente en sus entradas, en las imágenes y en los ajustes de temas, plugins y widgets. Por eso, si cambia la dirección, debe sustituirla en toda la base de datos. Aquí le explicamos cómo hacerlo de forma segura y por qué una simple consulta SQL puede estropear su sitio.

¿Cuándo lo necesita?

• Su sitio estaba en http y ahora funciona con https, y aparece contenido mixto (una página en https que carga elementos a través de http). Consulte también Sin candado o «No seguro»: solucionar el contenido mixto.
• Traslada su sitio a otro dominio, o de una dirección temporal a su dominio definitivo.
• Ha creado manualmente una copia en otra dirección, por ejemplo un sitio de pruebas.

Si clona un sitio con Installatron o con el Website Manager, la propia herramienta ajusta las direcciones en la copia. Consulte Clonar y crear un entorno de pruebas (staging). Si solo traslada el sitio a otro alojamiento con el mismo dominio, no es necesario cambiar nada.

¿Por qué no usar un simple REPLACE en SQL?

En phpMyAdmin puede sustituir todos los textos con una sola consulta SQL. No lo haga con las direcciones. Muchos ajustes se guardan serializados: PHP añade la longitud de cada texto. Tiene este aspecto:

s:27:"http://example.com/logo.png";

s:27 significa: a continuación viene un texto de 27 caracteres. Si lo cambia a https://, el texto pasa a tener 28 caracteres, pero sigue indicando 27. PHP ya no puede leer el valor y el ajuste se pierde sin avisar. Verá, por ejemplo, un menú vacío, un logotipo desaparecido o widgets que ya no están. Por eso debe usar una herramienta que actualice esas longitudes.

Primero, una copia de seguridad

Buscar y reemplazar tiene efecto inmediato y no hay papelera. Exporte antes su base de datos, consulte Exportar una base de datos, o cree con un solo clic una copia de seguridad adicional en WebOké Backups, consulte WebOké Backups: ver, restaurar o descargar una copia de seguridad.

Método 1: WP-CLI en el Terminal o por SSH

WP-CLI es la herramienta oficial de línea de comandos de WordPress. Con nosotros la utiliza como el comando wp en el Terminal de DirectAdmin o por SSH. Solo está disponible en los paquetes con SSH. Puede consultar qué paquetes son en Terminal en su navegador.

1. Abra el Terminal y vaya a la carpeta de su WordPress: cd domains/example.com/public_html
2. Compruebe primero qué cambiaría, sin modificar nada:

   wp search-replace 'http://example.com' 'https://example.com' --skip-columns=guid --dry-run

   Verá por cada tabla cuántas sustituciones se harían.
3. Si es correcto, ejecute el mismo comando sin --dry-run.

Algunas opciones del comando:

• Sin opciones adicionales, WP-CLI trabaja con las tablas que WordPress conoce. Si un plugin usa tablas propias con el mismo prefijo (por ejemplo wp_), añada --all-tables-with-prefix. La opción --all-tables afecta a todas las tablas de la base de datos, incluidas las de otro sitio que pudieran estar en ella.
• --skip-columns=guid deja intacta la columna guid con los identificadores fijos de las entradas. WordPress recomienda no modificarla nunca; de lo contrario, los lectores de feeds volverán a mostrar entradas antiguas como nuevas.
• Si algo falla con ajustes complejos, --precise funciona más despacio pero de forma más exhaustiva.

Método 2: un plugin

Si no dispone de Terminal ni de SSH, utilice un plugin de buscar y reemplazar que admita datos serializados. Encontrará varios en el directorio de plugins de wordpress.org. Al elegir, lea la descripción: debe indicar que procesa correctamente los datos serializados. También aquí, use primero el modo de prueba si el plugin lo tiene, y elimine el plugin cuando haya terminado. Consulte también Elegir, evaluar y limpiar plugins de WordPress.

¿Solo la dirección de WordPress y la dirección del sitio?

¿No puede acceder a la administración tras un cambio porque WordPress le redirige a una dirección incorrecta? En ese caso, modifique primero solo las filas siteurl y home de la tabla wp_options (el prefijo wp_ puede ser distinto en su caso). Son textos normales, que sí puede modificar en phpMyAdmin. Puede consultar cómo hacerlo en Abrir y usar phpMyAdmin. Después, haga el resto con WP-CLI o con un plugin.

Al terminar

• Vacíe la caché de su plugin de caché y de su navegador.
• Si las páginas devuelven un error 404, vaya a Ajustes > Enlaces permanentes y guarde una vez. Consulte Mi sitio web no funciona después de subirlo o trasladarlo.
• Revise algunas páginas, su menú, su logotipo y un formulario. Pulse F12 y compruebe en la consola si siguen apareciendo avisos de contenido mixto.

Más información

• wp search-replace en developer.wordpress.org (en inglés)
• Trasladar WordPress manualmente: archivos, base de datos y wp-config.php

¿Quiere aprender más? Siga el curso gratuito de WordPress, lección 3.2 www, redirecciones y contenido mixto o lección 9.5 Trasladar un sitio WordPress.