11 min. lees

WP-CLI: De complete handleiding voor het beheren van WordPress vanaf de opdrachtregel

WP-CLI is de officiële opdrachtregeltool voor het beheren van WordPress installaties direct vanaf je terminal, zonder ooit een browser te openen. Als je ooit een middag hebt doorgebracht met het doorklikken van het WordPress admin dashboard om plugins op meerdere sites bij te werken, dan weet je al waarom deze tool bestaat.

In deze gids leert u alles over het installeren van WP-CLI op Linux, macOS en Windows tot het automatiseren van complexe onderhoudstaken met scripts en configuratiebestanden. Of je nu een enkele blog beheert of tientallen sites van klanten, het beheersen van WP-CLI zal de manier waarop je met WordPress werkt fundamenteel veranderen.

Wat je zult leren:

Hoe WP-CLI installeren en configureren op verschillende besturingssystemen
Essentiële opdrachten voor het beheren van plugins, thema’s, gebruikers en inhoud
Databasebewerkingen zoals exporteren, importeren en veilig zoeken-vervangen
Automatiseringstechnieken met scripts, aliassen en cronjobs
Best practices om veelvoorkomende valkuilen te vermijden bij het werken vanaf de terminal

Wat is WP-CLI? (Eerst een korte uitleg)

WP-CLI staat voor WordPress Command Line Interface, een open-source tool waarmee je WordPress sites volledig vanaf de terminal kunt beheren. In plaats van in te loggen op wp-admin en door menu’s te navigeren, voer je commando’s uit zoals wp plugin update --all en zie je hoe je hele plugin-stack binnen enkele seconden wordt bijgewerkt.

Het project is rond 2011 gestart door ontwikkelaars die een snellere manier wilden om WordPress op schaal te beheren. In 2017 werd het ondergebracht bij de officiële WordPress.org paraplu en wordt het nu onderhouden door een toegewijd team van medewerkers, waaronder Alain Schlesser en Daniel Bachhuber.

Dit is wat je moet weten over WP-CLI:

Huidige stabiele versie: WP-CLI 2.x serie
WordPress compatibiliteit: Werkt met WordPress 5.x tot en met 6.x (en historisch terug naar 3.7)
PHP-vereisten: PHP 7.4+ of 8.x aanbevolen voor beveiliging en prestaties
Opdracht-ecosysteem: Meer dan 40 hoofdcommando’s voor vrijwel elke WordPress bewerking
Primaire gebruikers: Ontwikkelaars, agentschappen, DevOps-engineers en power users die complexe of meerdere sites beheren
Distributie: Beschikbaar als PHAR-bestand, via pakketbeheerders of vooraf geïnstalleerd op veel beheerde WordPress-hosts.

Belangrijkste voordelen van WP-CLI

Als u eenmaal begrijpt waarom WP-CLI bestaat, wordt de leercurve veel gemakkelijker te rechtvaardigen. In deze sectie worden de concrete voordelen uitgelegd die deze tool uw tijd waard maken.

Tijdsbesparing op repetitieve taken
20 plugins updaten via het WordPress dashboard betekent 20 pagina’s laden, 20 keer klikken en 20 voortgangsbalkjes bekijken. Met WP-CLI voert u wp plugin update --all één keer uit en gaat u verder. Voor bureaus die sites van meerdere klanten beheren, komt dit verschil neer op een besparing van uren per week.

Bulk en geautomatiseerde bewerkingen
Stel je een scenario voor waarbij je 15 WooCommerce-winkels voorbereidt op Black Friday. U moet plugins bijwerken, caches leegmaken en database-integriteit controleren op elke site. Met WP-CLI kunt u deze hele reeks scripten en uitvoeren op alle sites in minuten in plaats van uren. De belangrijkste automatiseringsmogelijkheden zijn

Alle plugins in meerdere installaties bijwerken met één script
Gebruikers in bulk aanmaken met voorgedefinieerde rollen
Nachtelijk onderhoud uitvoeren via cron (databaseoptimalisatie, tijdelijke opschoning)
Identieke WordPress configuraties uitrollen naar nieuwe omgevingen

Betrouwbaarheid over browser-gebaseerde operaties
Browser operaties hebben HTTP timeouts. Grote database-importen mislukken halverwege het proces. Zoek-vervang operaties corrumperen geserialiseerde gegevens als ze worden uitgevoerd met ruwe SQL. WP-CLI vermijdt al deze problemen omdat het direct op de server draait zonder time-outbeperkingen en omdat het zoek-vervang commando correct omgaat met geserialiseerde gegevensstructuren.

Directe controle over de belangrijkste WordPress-systemen
Vanaf één terminal kun je:

De WordPress database exporteren en importeren
Instellingen wijzigen wp-config.php
Wp-cron gebeurtenissen inspecteren en triggeren
Onderhoudsmodus in- en uitschakelen
Willekeurige PHP-code uitvoeren in de WordPress-context

Minder belasting op wp-admin
Op drukke productieservers verbruikt elke belasting van het admin dashboard resources. Onderhoudsbewerkingen uitvoeren via WP-CLI houdt die belasting van de webserver weg, wat belangrijk is tijdens drukke periodes.

WP-CLI vereisten en ondersteunde omgevingen

Voordat je WP-CLI installeert, moet je bevestigen dat je server of lokale omgeving voldoet aan de basisvereisten. Het goede nieuws is dat de meeste moderne WordPress setups hier al aan voldoen.

Vereiste PHP-versie:

Minimaal: PHP 5.6 (hoewel dit verouderd is)
Aanbevolen: PHP 7.4, 8.0, 8.1, 8.2, 8.3, 8.4 of 8.5 voor beveiliging en prestaties in 2026

WordPress versie compatibiliteit:

Historische ondersteuning: WordPress 3.7 en nieuwer
Modern doel: WordPress 5.0 tot 6.7+ voor huidige projecten

Verwachtingen van het besturingssysteem:

Beste ondersteuning: UNIX-achtige systemen (Ubuntu 22.04 LTS, Debian 12, CentOS Stream, macOS)
Windows: Ondersteund via WSL (Windows Subsystem for Linux) of native PHP-installatie

Extra vereisten:

PHP beschikbaar op de commandoregel (de php binary moet in je PATH staan)
cURL of wget voor het downloaden van het wp-cli.phar bestand
SSH-toegang voor externe servers (bij de meeste managed WordPress hostingpakketten is dit standaard inbegrepen)

Veel populaire hosts zoals Kinsta, SiteGround en DreamHost hebben WP-CLI vooraf geïnstalleerd. WordPress.com bevat ook WP-CLI voor sites met SSH-toegang ingeschakeld.

Hoe WP-CLI installeren op Linux en macOS

De standaardinstallatiemethode gebruikt het officiële PHAR-bestand (PHP-archief). Dit proces werkt op Ubuntu, Debian, CentOS, Fedora en macOS terminals.

Stap 1: Download het PHAR-bestand
Open je terminal en download wp-cli.phar met behulp van curl:

curl -O https://raw.githubusercontent.com/wp-cli/builds/gh-pages/phar/wp-cli.phar

Je kunt ook wget gebruiken:

wget https://raw.githubusercontent.com/wp-cli/builds/gh-pages/phar/wp-cli.phar

Stap 2: Controleer de download (optioneel maar aanbevolen)
Controleer de SHA-256 controlesom aan de hand van de officiële waarde die is gepubliceerd in de WP-CLI documentatie om er zeker van te zijn dat er tijdens het downloaden niet met het bestand is geknoeid:

sha256sum wp-cli.phar

Vergelijk de uitvoer met de controlesom op de officiële WP-CLI website.

Stap 3: Test het php-bestand
Controleer of het php-bestand werkt:

php wp-cli.phar --info

U zou uitvoer moeten zien met WP-CLI versie, PHP versie en systeeminformatie.

Stap 4: Maak het uitvoerbaar en verplaats het naar het PATH
Markeer het bestand als uitvoerbaar en verplaats het naar een map in het PATH van je systeem:

chmod +x wp-cli.phar
sudo mv wp-cli.phar /usr/local/bin/wp

Het commando sudo is meestal nodig omdat /usr/local/bin een systeemdirectory is. Installeer WP-CLI niet als root als u het voornamelijk als gewone gebruiker zult uitvoeren.

Stap 5: Controleer de wereldwijde installatie
Bevestig dat WP-CLI nu wereldwijd beschikbaar is:

wp --info
wp cli version

U zou uitvoer moeten zien die de versie van wp cli, de binaire locatie van PHP en de details van het besturingssysteem bevestigt. Op dit punt is WP-CLI geïnstalleerd en klaar voor gebruik.

Hoe WP-CLI installeren op Windows

Windows gebruikers kunnen kiezen uit twee mogelijkheden: het gebruik van Windows Subsystem for Linux (WSL) of het opzetten van een native Windows installatie. WSL biedt een meer Linux-achtige ervaring en wordt over het algemeen aanbevolen.

Optie 1: WSL gebruiken (aanbevolen)
Schakel eerst WSL in op Windows 10 of 11:

wsl --install

Installeer Ubuntu vanuit de Microsoft Store en start vervolgens de Ubuntu-terminal. Vanaf daar volg je exact dezelfde Linux-installatiestappen als in de vorige sectie – download het phar-bestand, maak het uitvoerbaar en verplaats het naar /usr/local/bin/wp.

Optie 2: Native Windows-installatie
Voor een native installatie moet PHP voor Windows geïnstalleerd zijn met de php executable beschikbaar in het PATH van je systeem.

PHP downloaden en installeren van de officiële PHP voor Windows-site
Voeg de PHP directory toe aan je Windows PATH omgevingsvariabele
Controleer of PHP werkt door Command Prompt te openen en uit te voeren php -v

Download vervolgens het WP-CLI PHAR-bestand:

curl -O https://raw.githubusercontent.com/wp-cli/builds/gh-pages/phar/wp-cli.phar

Windows bevat standaard curl sinds 2018, dus dit zou moeten werken zonder extra instellingen. Maak een map aan voor WP-CLI (bijvoorbeeld C:\wp-cli) en verplaats het gedownloade bestand daarheen.

Maak vervolgens een batchwrapperbestand met de naam wp.bat in dezelfde map:

@echo off
php "C:\wp-cli\wp-cli.phar" %*

Voeg C:\wp-cli toe aan de omgevingsvariabele PATH van je systeem. Open nu een nieuw Command Prompt- of PowerShell-venster en controleer:

wp --info

U ziet nu de versie van WP-CLI en omgevingsgegevens die bevestigen dat WP-CLI correct is geïnstalleerd.

Basisgebruik WP-CLI en hulp krijgen

Als WP-CLI is geïnstalleerd, moet u het basispatroon van de opdrachten begrijpen voordat u specifieke bewerkingen uitvoert. Alle WP-CLI commando’s volgen deze structuur:

wp <command> <subcommand> [options]

Commando’s worden uitgevoerd vanuit een WordPress installatiemap – de map met wp-config.php. Als je ergens anders bent, kun je het pad opgeven met --path=/var/www/html/mysite.

Je omgeving controleren
Begin met het bevestigen van je opstelling:

wp --info

Dit toont uw WP-CLI versie, PHP versie, PHP binair pad, besturingssysteem en andere omgevingsdetails. Om alleen de WP-CLI versie te zien:

wp cli version

Beschikbare opdrachten verkennen
Om alle beschikbare wp cli-opdrachten op te sommen:

wp help

Voor hulp bij een specifiek commando:

wp help plugin
wp help core update

Je kunt ook --help toevoegen aan elk commando:

wp user --help

De helpuitvoer wordt weergegeven in een pager, vergelijkbaar met Unix man pagina’s. Druk op q om af te sluiten.

Eerste commando’s om te proberen:

wp core version – geeft je WordPress versie weer
wp plugin list – toont alle geïnstalleerde WordPress plugins met hun status
wp theme list – toont geïnstalleerde thema’s
wp user list – somt alle gebruikers op de site op

Met deze alleen-lezen opdrachten kun je je WordPress site verkennen zonder iets te veranderen, wat perfect is om vertrouwd te raken met de interface.

WordPress installeren en configureren met WP-CLI

WP-CLI kan een complete nieuwe WordPress installatie sneller uitvoeren dan het traditionele webgebaseerde installatieprogramma. Dit is vooral waardevol bij het opstarten van ontwikkelomgevingen of het programmatisch uitrollen van nieuwe sites.

Voorwaarden
Voordat u de installatiecommando’s uitvoert, moet u een MySQL of MariaDB database klaar hebben staan. Voor dit voorbeeld gaan we ervan uit dat u:

Naam database: wpsite_db
Databasegebruiker: wpsite_user
Wachtwoord: securepassword123
Gastheer: localhost

Stap 1: Download WordPress core bestanden
Navigeer naar de gewenste installatiemap en download WordPress core:

wp core download

Hiermee wordt de nieuwste WordPress versie opgehaald. Om een versie of locale op te geven:

wp core download --version=6.4.2 --locale=fr_FR

Na voltooiing zie je een bevestiging dat WordPress met succes is gedownload.

Stap 2: Genereer wp-config.php
Maak het configuratiebestand met wp config create:

wp config create --dbname=wpsite_db --dbuser=wpsite_user --dbpass=securepassword123 --dbhost=localhost

Dit genereert een complete wp-config.php met je databasegegevens en automatisch gegenereerde beveiligingszouten.

Stap 3: Voer de installatie uit
Installeer nu WordPress met de gegevens van je site:

wp core install --url=https://example.com --title="My New Site" --admin_user=admin --admin_password=strongpassword [email protected]

Je ziet nu de melding “WordPress succesvol geïnstalleerd” en je site is klaar voor gebruik.

Multisite installatie
Gebruik voor WordPress multisite netwerken de multisite variant. WP-CLI kan multisite-installaties configureren met:

wp core multisite-install --url=https://example.com --title="My Network" --admin_user=admin --admin_password=strongpassword [email protected]

Thema’s beheren met WP-CLI

WP-CLI handelt alle themabewerkingen af zonder dat toegang tot het WordPress admin dashboard nodig is. Je kunt thema’s direct vanaf je terminal oplijsten, installeren, activeren, bijwerken en verwijderen.

Geïnstalleerde thema’s weergeven
Om alle momenteel geïnstalleerde thema’s te zien:

wp theme list

Voorbeelduitvoer:

naam	status	update	versie
twentytwentyfour	actief	none	1.0
drieëntwintig	inactief	none	1.2
astra	inactief	beschikbaar	4.5.0

Een thema activeren
Schakel over naar een ander thema:

wp theme activate astra

Hierdoor wordt het actieve thema onmiddellijk gewijzigd. Terugschakelen naar een standaardthema is handig voor het oplossen van problemen met thema’s:

wp theme activate twentytwentyfour

Nieuwe thema’s installeren
Installeer een thema uit de WordPress.org repository:

wp theme install astra

Installeren en activeren met één opdracht:

wp theme install astra --activate

Thema’s bijwerken
Werk een specifiek thema bij:

wp theme update astra

Of werk alle thema’s tegelijk bij:

wp theme update --all

Thema’s verwijderen
Verwijder een thema dat je niet langer nodig hebt:

wp theme delete twentytwentythree

Plugins beheren met WP-CLI

Pluginbeheer is waar WP-CLI de meeste tijd bespaart. Je kunt bulkbewerkingen uitvoeren die tientallen klikken in het dashboard zouden vergen.

Plugins weergeven

wp plugin list

Voorbeelduitvoer:

naam	status	update	versie
woocommerce	actief	none	8.5.1
yoast-seo	actief	beschikbaar	21.0
elementor	inactief	none	3.18.0

Plugins installeren
Installeer een plugin met de slug:

wp plugin install woocommerce

Installeren en activeren:

wp plugin install yoast-seo --activate

activeren en deactiveren Een plugin activeren:

wp plugin activate elementor

Een plugin deactiveren (handig voor debuggen):

wp plugin deactivate elementor

Alle plugins in één keer deactiveren (redder in nood bij het debuggen van “White Screen of Death”):

wp plugin deactivate --all

Plugins bijwerken
Een specifieke plugin bijwerken:

wp plugin update yoast-seo

Werk alle plugins bij:

wp plugin update --all

Je kunt ook specifieke plugins uitsluiten van een bulkupdate:

wp plugin update --all --exclude=woocommerce

WordPress kern bijwerken en repareren

WordPress up-to-date houden is cruciaal voor de veiligheid. WP-CLI maakt dit proces transparant en controleerbaar.

Controleren op updates

wp core check-update

WordPress bijwerken
Werk bij naar de nieuwste versie:

wp core update

Na een kernupdate is het een goed gebruik om het databaseschema bij te werken:

wp core update-db

Controlesommen controleren
Als u vermoedt dat uw site is gehackt, kunt u controleren of de kernbestanden niet zijn gewijzigd:

wp core verify-checksums

Hiermee worden je bestanden vergeleken met de checksums van de officiële WordPress repository.

Core
opnieuw installeren Als bestanden beschadigd zijn, kun je een herinstallatie forceren zonder je inhoud aan te tasten:

wp core download --force --skip-content

Inhoud, gebruikers en database beheren

Met WP-CLI kunt u direct communiceren met de gegevens op uw site.

Gebruikersbeheer
Gebruikers weergeven:

wp user list

Maak een nieuwe beheerder:

wp user create newadmin [email protected] --role=administrator --user_pass=securepass123

Een gebruikerswachtwoord bijwerken:

wp user update 1 --user_pass=newpassword

Een gebruiker verwijderen en zijn inhoud opnieuw toewijzen:

wp user delete 5 --reassign=1

Databasebewerkingen
Exporteer de database naar een bestand:

wp db export backup.sql

Een database importeren vanuit een bestand:

wp db import backup.sql

Optimaliseer de database:

wp db optimize

Open een MySQL console die rechtstreeks is verbonden met je WordPress database:

wp db cli

Zoeken en vervangen (op de juiste manier)

Het handmatig verplaatsen van een WordPress site naar een nieuw domein is riskant omdat gegevens vaak geserialiseerd zijn in de database. Een eenvoudige SQL find-and-replace zal widgets en thema-opties breken. WP-CLI verwerkt serialisatie op de juiste manier.

Standaard zoeken-vervangen

wp search-replace 'http://old-domain.com' 'https://new-domain.com'

Dry Run (Voorbeeld)
Controleer altijd wat er gaat veranderen voordat je het commando uitvoert:

wp search-replace 'http://old-domain.com' 'https://new-domain.com' --dry-run

Exporteren met vervanging
Je kunt een database exporteren met de vervangingen die in het bestand zijn gemaakt, waarbij de live database onaangeroerd blijft:

wp search-replace 'old.com' 'new.com' --export=migrated-db.sql

Geavanceerd onderhoud: Cron en Object Cache

Cron Jobs beheren
Geplande gebeurtenissen weergeven:

wp cron event list

Voer alle cron gebeurtenissen onmiddellijk uit:

wp cron event run --due-now

Transiënten en cache beheren
De objectcache wissen:

wp cache flush

Alle verlopen transiënten verwijderen:

wp transient delete --expired

Taken automatiseren met scripts

U kunt WP-CLI commando’s combineren in Bash scripts voor geautomatiseerd onderhoud.

Voorbeeld: Wekelijks onderhoudsscript
Maak een bestand aan met de naam maintain.sh:

#!/bin/bash
# Update everything
wp core update
wp core update-db
wp plugin update --all
wp theme update --all

# Cleanup
wp transient delete --expired
wp cache flush
wp db optimize

echo "Maintenance complete."

Maak het uitvoerbaar (chmod +x maintain.sh) en voer het uit om binnen enkele seconden volledig siteonderhoud uit te voeren.

WP-CLI op afstand gebruiken via SSH

Je hoeft niet in te loggen op de server om commando’s uit te voeren als je aliassen configureert.

In uw lokale wp-cli.yml bestand:

@prod:
  ssh: [email protected]/var/www/html
@dev:
  ssh: [email protected]/var/www/html

Nu kun je commando’s uitvoeren op de externe server vanaf je lokale machine:

wp @prod plugin list
wp @dev core version

Beste praktijken

Altijd een back-up maken: Voer wp db export uit voordat u bulkupdates of zoek-vervangopdrachten uitvoert.
Gebruik Dry Run: Gebruik voor zoeken-vervangen altijd eerst --dry-run.
Ren niet als root: WP-CLI waarschuwt u als u als root draait. Het is veiliger om te draaien als de webservergebruiker (bijv. www-data) of uw specifieke gebruikersaccount.
Test op staging: Gebruik WP-CLI om uw productiesite te klonen naar staging, test uw updatescripts daar en pas ze vervolgens toe op productie.

Conclusie

WP-CLI transformeert WordPress beheer van een reeks klikken in gestroomlijnde, scriptbare bewerkingen. Beginnen met eenvoudige commando’s zoals het controleren van versies en het oplijsten van plugins legt de basis voor geavanceerde automatisering. Als je WP-CLI vandaag nog in je workflow integreert, kun je ontelbare uren besparen op al je WordPress projecten.