Zoeken en vervangen in de WordPress-database

WordPress bewaart het adres van je site niet op één plek. Het staat in de instellingen, maar ook letterlijk in je berichten, bij afbeeldingen en in instellingen van thema's, plugins en widgets. Verander je het adres, dan moet je het daarom in de hele database vervangen. Hier lees je hoe dat veilig gaat, en waarom een gewone SQL-opdracht je site kan breken.

Wanneer heb je dit nodig?

• Je site stond op http en draait nu op https, en je ziet gemengde inhoud (een pagina op https die onderdelen via http laadt). Zie ook Geen slotje of 'niet veilig': mixed content oplossen.
• Je verhuist je site naar een ander domein, of van een tijdelijk adres naar je echte domein.
• Je hebt met de hand een kopie gemaakt op een ander adres, bijvoorbeeld een testsite.

Kloon je een site met Installatron of de Website Manager, dan past die de adressen in de kopie zelf aan. Zie Klonen en een testomgeving (staging) maken. Verhuis je alleen naar een andere hosting met hetzelfde domein, dan hoeft er niets te veranderen.

Waarom geen kale SQL REPLACE?

In phpMyAdmin kun je met één SQL-opdracht alle teksten vervangen. Doe dat niet voor adressen. Veel instellingen zijn geserialiseerd opgeslagen: PHP zet er de lengte van elke tekst bij. Dat ziet er zo uit:

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

s:27 betekent: hier volgt een tekst van 27 tekens. Maak je er https:// van, dan is de tekst 28 tekens lang, maar staat er nog steeds 27. PHP kan de waarde dan niet meer lezen en de instelling valt stil weg. Je ziet dan bijvoorbeeld een leeg menu, een verdwenen logo of widgets die weg zijn. Gebruik daarom een hulpmiddel dat die lengtes bijwerkt.

Eerst een back-up

Zoeken en vervangen is direct en heeft geen prullenbak. Maak vooraf een export van je database, zie Een database exporteren, of maak met één klik een extra back-up in WebOké Backups, zie WebOké Backups: een backup bekijken, terugzetten of downloaden.

Manier 1: WP-CLI in de Terminal of via SSH

WP-CLI is het officiële opdrachtregelprogramma van WordPress. Bij ons gebruik je het als de opdracht wp in de Terminal van DirectAdmin of via SSH. Die heb je alleen in de pakketten met SSH. Welke pakketten dat zijn, lees je in Terminal in je browser.

1. Open de Terminal en ga naar de map van je WordPress: cd domains/example.com/public_html
2. Kijk eerst wat er zou veranderen, zonder iets te wijzigen:

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

   Je ziet per tabel hoeveel vervangingen er zouden zijn.
3. Klopt dat, voer dan dezelfde opdracht uit zonder --dry-run.

Een paar keuzes in de opdracht:

• Zonder extra optie werkt WP-CLI op de tabellen die WordPress kent. Gebruikt een plugin eigen tabellen met hetzelfde voorvoegsel (bijvoorbeeld wp_), voeg dan --all-tables-with-prefix toe. De optie --all-tables raakt alle tabellen in de database, ook die van een andere site die er toevallig in staat.
• --skip-columns=guid laat de kolom guid met de vaste kenmerken van berichten met rust. WordPress raadt aan die nooit te wijzigen, anders tonen feedlezers oude berichten opnieuw als nieuw.
• Gaat er iets mis met ingewikkelde instellingen, dan werkt --precise trager maar grondiger.

Manier 2: een plugin

Heb je geen Terminal of SSH, gebruik dan een plugin voor zoeken en vervangen die geserialiseerde gegevens ondersteunt. Daarvan staan er meerdere in de pluginmap van wordpress.org. Lees bij het kiezen de beschrijving: er moet staan dat hij geserialiseerde gegevens goed verwerkt. Gebruik ook hier eerst de proefmodus als de plugin die heeft, en verwijder de plugin als je klaar bent. Zie ook WordPress-plugins kiezen, beoordelen en opruimen.

Alleen het WordPress-adres en het site-adres?

Kom je na een wijziging niet meer in het beheer, omdat WordPress je naar een verkeerd adres stuurt? Dan pas je eerst alleen de rijen siteurl en home in de tabel wp_options aan (het voorvoegsel wp_ kan bij jou anders zijn). Dat zijn gewone teksten, die mag je in phpMyAdmin wijzigen. Hoe dat gaat, lees je in phpMyAdmin openen en gebruiken. Daarna doe je de rest met WP-CLI of een plugin.

Na afloop

• Leeg de cache van je cacheplugin en van je browser.
• Geven pagina's een 404, sla dan bij Instellingen > Permalinks één keer op. Zie Mijn website doet het niet na het uploaden of verhuizen.
• Controleer een paar pagina's, je menu, je logo en een formulier. Kijk met F12 in de console of er nog meldingen over gemengde inhoud staan.

Verder lezen

• wp search-replace op developer.wordpress.org (Engels)
• WordPress met de hand verhuizen: bestanden, database en wp-config.php

Meer leren? Volg de gratis WordPress-cursus, les 3.2 www, doorsturen en gemengde inhoud of les 9.5 Een WordPress-site verhuizen.