Hoe voer je WordPress-databasemigraties uit zonder je website te beschadigen? 

Een WordPress-databasemigratie klinkt eenvoudig: exporteer de database, importeer hem ergens anders, klaar. In de praktijk is dit echter de stap waar meer WordPress-sites vastlopen dan bij welke andere stap ook.

De redenen zijn specifiek. WordPress slaat geserialiseerde PHP-objecten op in de database. Een simpele zoek-en-vervangactie in een URL kan die geserialiseerde gegevens ongemerkt beschadigen, waardoor uw site er op lastig te traceren manieren niet meer goed uitziet. Plugin-updates veroorzaken migraties van het databaseschema die niet ongedaan gemaakt kunnen worden met een bestandsherstel. Een onjuist databasevoorvoegsel, een ontbrekende tabel of een niet-gesynchroniseerd wp-config.php- bestand kunnen elk een andere foutmelding veroorzaken die in een andere richting wijst.

Deze handleiding behandelt alle scenario's waarin u een WordPress-databasemigratie moet uitvoeren, hoe u dit zonder gegevensverlies kunt doen en hoe u de veelvoorkomende fouten kunt oplossen die optreden wanneer er iets misgaat.

Soorten WordPress-databasemigraties

Niet alle databasemigraties zijn hetzelfde. De methode, het risico en de voorbereiding verschillen per migratietype.

De database verplaatsen naar een nieuwe host of domein

Dit is het meest voorkomende scenario. U wisselt van hostingprovider, stapt over van HTTP naar HTTPS of voert een rebranding door met een nieuw domein. De database-inhoud blijft intact, maar alle URL's in de database moeten worden bijgewerkt om de nieuwe locatie weer te geven.

Het probleem: WordPress slaat URL's op meerdere plaatsen in de database op, waaronder geserialiseerde arrays in de wp_options-tabel en de wp_postmeta-tabel. Een handmatige zoek-en-vervangactie in deze tabellen, waarbij geen rekening wordt gehouden met serialisatie, zal de gegevens ongemerkt beschadigen.

Van enscenering naar productie

Wanneer je een website bouwt in een stagingomgeving en deze vervolgens naar de productieomgeving pusht, moet de database meeverhuisd worden en moeten alle staging-URL's vervangen worden door productie-URL's. Dit is een van de meest voorkomende oorzaken van problemen bij de migratie van staging naar productie, omdat ontwikkelaars vaak een bestand pushen zonder de database bij te werken.

Door plug-ins geactiveerde schema-migraties

Wanneer plugins de databasestructuur wijzigen tijdens een update, voeren ze een schema-migratie uit: een wijziging van de databasestructuur in plaats van alleen de gegevens erin. De HPOS-migratie (High-Performance Order Storage) van WooCommerce is een actueel voorbeeld. Lidmaatschapsplugins die ledengegevens naar nieuwe tabelstructuren verplaatsen, zijn een ander voorbeeld.

Deze migraties worden uitgevoerd als onderdeel van het plugin-updateproces. U kunt ze niet handmatig starten. Daarom is voorbereiding in een testomgeving nodig voordat de update in productie wordt toegepast.

  

Wat heb je nodig vóór een databasemigratie?

Voltooi elk punt op deze lijst voordat u ook maar één commando uitvoert of op exporteren klikt.

Volledige databaseback-up. Exporteer de complete MySQL-database vanuit uw huidige omgeving met behulp van phpMyAdmin, WP-CLI of de back-uptool van uw hostingprovider. Controleer of het back-upbestand kan worden geopend en gegevens bevat voordat u verdergaat. Een beschadigd exportbestand dat wordt ontdekt nadat u de originele database al hebt overschreven, kan niet worden hersteld zonder een back-up op hostingniveau.

Volledige back-up van uw bestanden. Uw database kan niet functioneren zonder de bijbehorende WordPress-bestanden. Maak een back-up van uw volledige WordPress-installatie, samen met de back-up van uw database.

De details in het wp-config.php-bestand voor de bestemming. Let op de databasenaam, gebruikersnaam, wachtwoord en host voor de bestemmingsomgeving. Deze gegevens zijn nodig om uw WordPress-bestanden te koppelen aan de geïmporteerde database.

Een testomgeving. Elke databasemigratie moet eerst in de testomgeving worden getest voordat deze in de productieomgeving wordt uitgevoerd. Dit geldt zowel voor migraties tussen hosts als voor schema-migraties bij plugin-updates.

Controleer of de PHP-versie compatibel is. Als u migreert naar een nieuwe hostingprovider met een andere PHP-versie, controleer dan vóór de migratie of uw plug-ins en thema's compatibel zijn met de nieuwe versie. PHP-versieverschillen na de migratie kunnen fouten veroorzaken die op databaseproblemen lijken, maar in werkelijkheid compatibiliteitsproblemen zijn.

Hoe migreer je een WordPress-database: 3 methoden

De juiste methode hangt af van uw technische kennis en de grootte van uw database. Alle drie de methoden verwerken geserialiseerde gegevens correct wanneer ze worden gebruikt zoals hieronder beschreven.

Methode 1: Migratieplugin (eenvoudigst)

Migratieplugins verzorgen de export, import, bestandsoverdracht en URL-vervanging in één proces. Ze zijn de juiste keuze voor de meeste website-eigenaren zonder ervaring met de commandoregel.

Aanbevolen plugins:

Duplicator Pro kan databases tot enkele gigabytes verwerken, ondersteunt geplande migraties en genereert een installatiebestand dat automatisch URL-vervanging afhandelt. Het is de meest betrouwbare optie voor grote of complexe websites.

All-in-One WP Migration maakt één archiefbestand aan met uw volledige WordPress-installatie, inclusief de database. De gratis versie heeft een importlimiet van 512 MB. De premiumversie heft deze limiet op. De plugin zorgt voor de vervanging van geserialiseerde gegevens tijdens het importeren.

WP Migrate (voorheen WP Migrate DB) is specifiek ontworpen voor migraties van alleen de database en het pushen/pull-proces tussen omgevingen. Het verwerkt geserialiseerde data correct en ondersteunt selectieve tabelmigratie, wat handig is wanneer u alleen de contentdatabase van de productieomgeving naar de stagingomgeving wilt overzetten zonder de instellingen van uw stagingplugin te overschrijven.

Stapsgewijs met All-in-One WP Migration:

• Installeer en activeer All-in-One WP Migration op uw bronsite

• Ga naar Alles-in-één WP-migratie > Exporteren

• Selecteer Exporteren naar > Bestand

• Wacht tot de export is voltooid en download het .wpress-bestand

• Installeer All-in-One WP Migration op uw doelsite

• Ga naar Alles-in-één WP-migratie > Importeren

• Sleep het .wpress-bestand hierheen of klik om ernaar te bladeren

• Bevestig de import wanneer daarom wordt gevraagd. De plugin waarschuwt dat hiermee alle bestaande inhoud wordt overschreven

• Nadat de import is voltooid, ga je naar Instellingen > Permalinks en klik je op Wijzigingen opslaan zonder iets te wijzigen. Hiermee worden de herschrijfregels gewist en worden de meeste 404-fouten opgelost die na de migratie optreden

Methode 2: phpMyAdmin (Handmatig)

phpMyAdmin is de juiste methode wanneer je volledige controle over de migratie nodig hebt, een grote database migreert die plugintools niet aankunnen, of een database onafhankelijk van de WordPress-bestanden wilt migreren.

De database exporteren:

• Log in bij phpMyAdmin op uw hostingomgeving via uw hostingcontrolepaneel

• Selecteer je WordPress-database in de linkerzijbalk

• Klik op het tabblad Exporteren

• Selecteer de aangepaste exportmethode

• Zorg ervoor dat alle tafels geselecteerd zijn

• Schakel onder 'Formaat-specifieke opties' het vakje 'DROP TABLE / VIEW / PROCEDURE / FUNCTION / EVENT / TRIGGER-instructie toevoegen' in. Dit zorgt ervoor dat de import bestaande tabellen netjes overschrijft en geen fouten met dubbele vermeldingen veroorzaakt

• Schakel onder 'Opties voor gegevenscreatie' de opties 'Volledige invoegingen' en 'Uitgebreide invoegingen' in

• Klik op Exporteren en sla het .sql-bestand op

De database importeren:

• Log in bij phpMyAdmin op uw hostingomgeving

• Selecteer of maak de doeldatabase aan

• Klik op de importtabel

• Klik op 'Bestand kiezen' en selecteer uw .sql-bestand

• Klik op 'Ga' om de import uit te voeren

De URL's bijwerken:

Na de import moet u de in de database opgeslagen site-URL bijwerken. De eenvoudigste methode voor niet-technische gebruikers is om de volgende SQL-query's uit te voeren in het SQL-tabblad van phpMyAdmin, waarbij u old-domain.com en new-domain.com vervangt door uw daadwerkelijke domeinen:

UPDATE wp_options SET option_value = replace(option_value, 'https://old-domain.com', 'https://new-domain.com') WHERE option_name = 'siteurl' OR option_name = 'home';

Voer geen volledige zoek-en-vervangactie uit in alle tabellen met alleen SQL. Dit zal de geserialiseerde gegevens beschadigen. Gebruik de onderstaande WP-CLI-methode voor de volledige vervanging.

Methode 3: WP-CLI (Meest betrouwbaar voor technische gebruikers)

WP-CLI is de commandoregelinterface van WordPress. De zoek- en vervangopdracht is de meest betrouwbare methode om URL's in een WordPress-database te vervangen, omdat deze standaard correct omgaat met geserialiseerde gegevens.

Vereisten: SSH-toegang tot uw server en WP-CLI geïnstalleerd. De meeste beheerde WordPress-hostingproviders (Kinsta, WP Engine, Cloudways) bieden WP-CLI standaard aan.

Exporteer de database:

wp db export backup-$(date +%Y%m%d).sql

Hiermee wordt de volledige database geëxporteerd naar een gedateerd .sql-bestand in uw huidige map.

Importeer de database naar de bestemming:

wp db import backup-20260101.sql

Vervang backup-20260101.sql door de daadwerkelijke bestandsnaam.

Voer de URL-vervanging uit:

wp search-replace 'https://old-domain.com' 'https://new-domain.com' --precise --all-tables

De vlag –precise zorgt ervoor dat geserialiseerde gegevens correct worden verwerkt. De vlag –all-tables past de vervanging toe op elke tabel in de database, inclusief tabellen die door plug-ins zijn aangemaakt.

Controleer de vervanging:

wp search-replace 'https://old-domain.com' 'https://new-domain.com' --precise --all-tables --dry-run

Als je de optie –dry-run gebruikt, zie je hoeveel vervangingen er zouden plaatsvinden zonder dat ze daadwerkelijk worden uitgevoerd. Voer dit eerst uit om te controleren of het aantal klopt voordat je de daadwerkelijke vervanging uitvoert.

Cache leegmaken en regels herschrijven:

wp cache flush

wp rewrite flush

Hoe ga je om met geserialiseerde data tijdens een migratie?

Dit is het meest misbegrepen onderdeel van de WordPress-databasemigratie en de meest voorkomende oorzaak van problemen na de migratie.

Waarom zorgt een simpele zoek-en-vervangfunctie ervoor dat WordPress vastloopt?

WordPress slaat bepaalde gegevens op in een geserialiseerd PHP-formaat. Een geserialiseerde tekenreeks ziet er als volgt uit:

a:2:{s:4:"home";s:22:"https://old-domain.com";}

Het gedeelte s:22 betekent "tekenreeks van 22 tekens". Als je een zoek-en-vervangactie uitvoert waarbij old-domain.com wordt vervangen door new-domain.com, verandert de lengte van de tekenreeks, maar de s:22-teller wordt niet bijgewerkt. WordPress probeert een tekenreeks van 22 tekens te lezen, vindt er een met een andere lengte en geeft een foutmelding.

De fout uit zich vaak als een leeg wit scherm, kapotte widgetgebieden of lege plug-ininstellingen na de migratie. Zonder informatie over de geserialiseerde gegevens is de oorzaak moeilijk te achterhalen.

Hoe voer ik een veilige zoek- en vervangactie uit?

Gebruik een van deze serialisatiebewuste methoden:

WP-CLI (aanbevolen):

wp search-replace 'https://old-domain.com' 'https://new-domain.com' --precise --all-tables

Better Search Replace-plugin: Installeer de Better Search Replace-plugin in WordPress. Deze plugin verwerkt standaard geserialiseerde gegevens en biedt een testversie waarmee je wijzigingen kunt bekijken voordat je ze toepast. Dit is de juiste optie als je geen toegang hebt tot WP-CLI.

Interconnect/it Search Replace DB: Een PHP-script dat u uploadt naar de rootmap van uw server, via een browser uitvoert en na gebruik verwijdert. Het verwerkt geserialiseerde gegevens en ondersteunt live- en dry-run-modi.

Hoe controleer ik of de zoek- en vervangfunctie goed is gelukt?

Controleer na het uitvoeren van de vervanging de volgende locaties:

• Ga in je WordPress-dashboard naar Instellingen > Algemeen. Controleer of het WordPress-adres en het siteadres je nieuwe domein weergeven

• Ga naar de frontend van je website en controleer de ontwikkelaarsconsole van je browser op waarschuwingen voor gemengde inhoud (HTTP-bronnen die worden geladen op een HTTPS-domein)

• Controleer je mediabibliotheek: wordt de juiste URL weergegeven als je op een afbeelding klikt?

• Voer een Screaming Frog-crawl uit of gebruik Broken Link Checker om te scannen op resterende URL's van oude domeinen.

Door plugins geactiveerde databasemigraties in WordPress

In tegenstelling tot migraties tussen hosts, hoeft u deze niet handmatig te starten. Ze worden uitgevoerd als onderdeel van het plugin-updateproces, waardoor de voorbereiding van de stagingomgeving hier belangrijker is dan elders.

Hoe werkt een databasemigratie in WooCommerce?

WooCommerce introduceerde HPOS (High-Performance Order Storage) als een belangrijke structurele verandering in de manier waarop bestellingen worden opgeslagen. Bij migratie naar HPOS maakt WooCommerce nieuwe, specifieke besteltabellen aan en verplaatst alle historische bestelgegevens daarin.

Deze migratie wordt automatisch uitgevoerd wanneer u HPOS inschakelt in de WooCommerce-instellingen of wanneer u WooCommerce bijwerkt op een site waar de migratie nog in behandeling is. Deze migratie kan niet ongedaan worden gemaakt door bestanden terug te zetten. Als de migratie wordt uitgevoerd op een site waar sommige plug-ins niet HPOS-compatibel zijn, zullen die plug-ins niet meer correct werken.

Voorbereiding: Voordat u HPOS inschakelt of WooCommerce bijwerkt naar een nieuwere versie, voert u de compatibiliteitscontrole van WooCommerce uit via WooCommerce > Status > HPOS. Deze geeft een overzicht van alle geïnstalleerde plugins en of ze HPOS-compatibel zijn. Los eventuele incompatibiliteiten op voordat de migratie wordt uitgevoerd.

Hoe werkt de migratie van de lidmaatschapsplugin?

Lidmaatschapsplugins, waaronder MemberPress, Paid Memberships Proen Restrict Content Pro, maken hun eigen aangepaste databasetabellen aan voor ledengegevens, abonnementsgegevens en transactiegeschiedenis. Wanneer deze plugins worden bijgewerkt naar een nieuwere versie, kunnen deze tabelstructuren soms veranderen.

Omdat ledengegevens in aangepaste tabellen worden opgeslagen in plaats van in standaard WordPress-tabellen, is het mogelijk dat migratieplugins deze gegevens niet altijd standaard in hun exportbestanden opnemen. Controleer daarom expliciet of uw back-uptool aangepaste plugintabellen ondersteunt voordat u een ledensite migreert.

Hoe bereid je je voor voordat een plugin een migratie in gang zet?

• Zet een testomgeving op die een exacte kopie is van uw productiedatabase.

• Voer de plugin-update eerst uit op de stagingomgeving

• Controleer na de update alle getroffen functionaliteiten (afrekenen, ledenaanmelding, abonnementsbeheer) in de testomgeving

• Als de testomgeving succesvol is, voer dan dezelfde update uit op de productieomgeving tijdens een periode met weinig verkeer

• Bewaar een geverifieerde back-up van direct vóór de productie-update

Checklist voor de database na de migratie

Loop na een databasemigratie elk item zorgvuldig door voordat je iemand vertelt dat de migratie is voltooid.

• Het WordPress-beheerpaneel laadt zonder fouten op de nieuwe URL

• De voorkant van de website laadt correct op de nieuwe URL

• Alle mediabestanden laden correct (geen beschadigde afbeeldingen)

• Contactformulieren verzenden en bevestigingsmails versturen

• Gebruikersaanmelding werkt voor alle accounttypen

• Als je WooCommerce gebruikt: voer een volledige testcheckout uit

• Als het om een ​​ledensite gaat: log in als lid en verifieer de toegang tot de inhoud

• Google Search Console toont geen indexeringsfouten meer na het opnieuw indienen van de sitemap

• Geen waarschuwingen voor gemengde inhoud (HTTP-bronnen op een HTTPS-site) in de browserconsole

• Er zijn geen oude domein-URL's zichtbaar in de broncode van de pagina of in het netwerktabblad van de browser

• -plugin gewist

• De permalinkstructuur is bijgewerkt: Instellingen > Permalinks > Wijzigingen opslaan

Veelvoorkomende fouten bij het migreren van WordPress-databases en hoe je ze kunt oplossen

Probeer de migratie niet opnieuw uit te voeren voordat u de fout hebt vastgesteld. Elke foutmelding hieronder geeft precies aan wat er mis is gegaan en wat u moet wijzigen voordat u het opnieuw probeert.

Fout 1062: Dubbele invoer voor sleutel PRIMARY

Deze foutmelding verschijnt wanneer u een database importeert in een bestemming die al gegevens bevat. Het importscript probeert een rij in te voegen met een ID die al bestaat.

Oplossing: Verwijder vóór het importeren alle bestaande tabellen in de doeldatabase of zorg ervoor dat uw exportbestand DROP TABLE-instructies bevat. Schakel in phpMyAdmin bij het exporteren de optie in om DROP TABLE-instructies op te nemen. In WP-CLI: wp db reset –yes, gevolgd door wp db import backup.sql.

Fout 2002: Kan geen verbinding maken met de MySQL-server

Deze foutmelding geeft aan dat WordPress geen verbinding kan maken met de databaseserver. Het probleem treedt meestal op na een migratie, wanneer de hostnaam van de database in wp-config.php niet overeenkomt met de daadwerkelijke hostnaam op de nieuwe server.

Oplossing: Open wp-config.php en controleer de waarde van DB_HOST. Bij de meeste shared hostingproviders is dit localhost. Bij managed WordPress hostingproviders kan dit een specifieke hostnaam zijn die in je hostingdashboard wordt weergegeven. Werk de waarde van DB_HOST bij zodat deze overeenkomt met de MySQL-hostnaam van je doelserver.

Fout 1045: Toegang geweigerd voor gebruiker

Deze foutmelding betekent dat de gebruikersnaam of het wachtwoord van de database in wp-config.php niet overeenkomt met de inloggegevens voor de database op de doelserver.

Oplossing: Open wp-config.php en controleer of DB_USER en DB_PASSWORD overeenkomen met de gebruikersgegevens van de database op uw doelserver. Ga in cPanel naar MySQL-databases en controleer of de gebruiker is toegewezen aan de juiste database met alle rechten.

Tot slot nog enkele gedachten over het migreren van WordPress-databases

Database-migraties in WordPress mislukken het vaakst door twee dingen: geserialiseerde gegevens die stilletjes beschadigd raken door een simpele zoek-en-vervangactie, en door plugins geactiveerde schema-migraties die automatisch worden uitgevoerd tijdens updates op onvoorbereide sites.

Beide problemen hebben duidelijke oplossingen. Gebruik WP-CLI of een serialisatiebewust zoek- en vervangprogramma in plaats van SQL. Bereid een testomgeving voor voordat u pluginupdates toepast die schema-migraties activeren. Maak een geverifieerde back-up vóór elke migratiestap en test deze voordat u erop vertrouwt.

De drie hierboven beschreven migratiemethoden zijn geschikt voor alle vaardigheidsniveaus: plugins voor wie een begeleid proces wenst, phpMyAdmin voor wie gedetailleerde controle nodig heeft, en WP-CLI voor wie toegang heeft tot de commandoregel. Kies de methode die het beste bij uw omgeving past en volg de checklist na de migratie voordat u het project afsluit.

Als u een ervaren team nodig heeft voor de migratie van uw WordPress-database, dan bent u bij Seahawk aan het juiste adres. Seahawk heeft al honderden WordPress-sites van uiteenlopende complexiteit succesvol gemigreerd.

Veelgestelde vragen over WordPress-databasemigraties