Gids
WordPress-URL's aanpassen met search-replace
Verhuis je WordPress naar een andere domeinnaam of ga je van http naar https, dan staan er nog oude adressen in de database: in berichten, instellingen en widgets. Een eenvoudige SQL-vervanging is gevaarlijk omdat WordPress gegevens opslaat in een formaat met lengtes. Met een tool die daar rekening mee houdt gaat het goed.
Stap voor stap
-
Maak eerst een back-up van de database
Een vervanging is niet ongedaan te maken. Exporteer de database vooraf, zodat je kunt terugvallen.
-
Bepaal precies wat vervangen moet worden
Schrijf de oude en nieuwe URL volledig uit, inclusief http of https en eventueel www. Bijvoorbeeld https://oud.nl naar https://nieuw.nl.
-
Kies je tool
WP-CLI is het sterkst, de plugin Better Search Replace is het makkelijkst. Beide kunnen met serialized data omgaan.
-
Draai eerst een proefrun
Met WP-CLI: wp search-replace 'https://oud.nl' 'https://nieuw.nl' --skip-columns=guid --dry-run. Je ziet hoeveel vervangingen er per tabel plaatsvinden.
-
Voer de echte vervanging uit
Haal --dry-run weg. Met --all-tables neem je ook tabellen van plugins mee. De guid-kolom sla je over, want die hoort onveranderd te blijven.
-
Controleer de instellingen siteurl en home
Ga in WordPress naar Instellingen, Algemeen, of controleer met 'wp option get siteurl' en 'wp option get home' dat beide het nieuwe adres tonen.
-
Maak caches leeg en test
Leeg de cache van je plugin en de browser, en bekijk de belangrijkste pagina's. Loop de afbeeldingen en menu's na.
Waarom je niet gewoon REPLACE in SQL gebruikt
WordPress slaat veel instellingen op als serialized data, bijvoorbeeld s:20:"https://oud.nl/pagina";. Het getal is de lengte van de tekst. Vervang je alleen de tekst, dan klopt de lengte niet meer en leest WordPress de instelling niet meer. Widgets, thema-opties en pagina's van een paginabouwer verdwijnen dan.
Search-replace-tools lezen de gegevens eerst uit, vervangen de URL en schrijven de gegevens met een nieuwe lengte terug. Daarom is dat altijd de veilige keuze.
Wanneer heb je dit nodig?
Je gebruikt een search-replace bij deze situaties:
- Je verhuist naar een andere domeinnaam
- Je gaat van http naar https en wilt mixed content verhelpen
- Je zet een testomgeving om naar de echte site (of andersom)
- Je verwijdert of voegt www toe aan het domein
- Je verplaatst WordPress van een submap naar de hoofdmap
Verhuizen zonder URL te wijzigen
Blijft je domeinnaam gelijk, dan is er niets te vervangen. Dit is de reden dat het slim is om eerst te testen met het hosts-bestand en niet met een tijdelijk adres. Zo hoef je de database niet tweemaal aan te passen.
Veelgestelde vragen
Hoe pas ik de URL van mijn WordPress-site aan?
Wijzig siteurl en home in Instellingen, Algemeen, en vervang de oude URL in de database met WP-CLI search-replace of een plugin als Better Search Replace.
Wat is serialized data in WordPress?
Een manier om arrays op te slaan als tekst waarbij de lengte van elke waarde wordt vastgelegd. Een gewone vervanging maakt die lengte ongeldig.
Moet ik de guid-kolom ook vervangen?
Nee. De guid is een vaste identificatie van een bericht. Vervang je die toch, dan kunnen feedlezers berichten dubbel tonen.
Waarom zie ik na de vervanging nog oude adressen?
Meestal staat de URL in een cache, in een bestand van het thema of in een veld buiten de database. Leeg de cache en zoek in de themabestanden.
Zullen we je site verhuizen?
Bestel met de Overstapdeal of stuur ons een appje. Wij regelen de verhuizing van je site en mail, gratis.