WP-CLI

Bijgewerkt op: 13 september 2024

WP-CLI (WordPress Command Line Interface) is een krachtig hulpmiddel om een WordPress installatie direct vanaf de command-line of terminal te beheren. In plaats van het standaard WordPress dashboard te gebruiken, kun je commando’s uitvoeren om taken uit te voeren zoals het bijwerken van plugins, het beheren van thema’s en het configureren van instellingen, allemaal vanaf je terminal.

Het gebruik van WP-CLI heeft een aantal voordelen, waaronder:

Snelheid: Het uitvoeren van taken met behulp van de opdrachtregel is vaak sneller dan navigeren door de WordPress admin-interface, vooral voor repetitieve taken.
Automatisering: WP-CLI kan worden geïntegreerd in scripts voor geautomatiseerde workflows.
Beheer op afstand: Met WP-CLI kun je WordPress sites op afstand beheren.
Flexibiliteit: De mogelijkheid om commando’s en scripts uit te voeren biedt een niveau van controle en maatwerk.

Toegang tot WP-CLI op Kinsta

WP-CLI v2 is standaard geïnstalleerd op al onze servers. Om toegang te krijgen tot WP-CLI moet je verbinding maken met je server via SSH en navigeren naar de document root van je site. Kinsta biedt SSH toegang bij al onze Managed WordPress Hosting pakketten.

1. Maak verbinding met je server met SSH

De eenvoudigste methode om verbinding te maken via SSH is door een gebruikersnaam en wachtwoord te gebruiken. De stappen om verbinding te maken variëren afhankelijk van je besturingssysteem.

Windows

Windows-gebruikers hebben een terminalclient nodig om verbinding te maken met SSH. We raden aan de gratis PuTTY client te downloaden met behulp van het .msi installatieprogramma.

Start PuTTY en voer het IP-adres van je host en het unieke poortnummer in (beide te vinden in MyKinsta > Sites > sitenaam > Info > SFTP/SSH). Klik dan op Openen.
Als dit de eerste keer is dat je verbinding maakt, zie je waarschijnlijk een rsa2-sleutelprompt. Klik op Yes, en dit zal de host in de toekomst vertrouwen.
Voer in het terminalscherm je Kinsta-gebruikersnaam in (te vinden in MyKinsta > Sites > sitenaam > Info > SFTP/SSH) en druk op Enter.
Voer je Kinsta wachtwoord in (te vinden in MyKinsta > Sites > sitenaam > Info > SFTP/SSH) en druk nogmaals op Enter.

Je bent nu via SSH verbonden met je WordPress site.

Mac/Linux

Open een nieuwe terminal via Applications > Utilities> Terminal.
Navigeer in MyKinsta naar Sites > sitenaam > Info > SFTP/SSH en klik bij het SSH-terminal commando op Kopiëren naar klembord .
Plak het SSH-terminal commando in de terminal en druk op Enter.
Voer je Kinsta-wachtwoord in (te vinden in MyKinsta > Sites > sitenaam > Info > SFTP/SSH) en druk nogmaals op Enter.

Je bent nu via SSH verbonden met je WordPress site.

2. Navigeer naar de document root van je site

Om WP-CLI commando’s uit te voeren, moet je eerst naar de document root van je site navigeren; dit is waar je WordPress bestanden (zoals wp-config.php, wp-content, wp-admin, en wp-includes) zich bevinden. Om op Kinsta naar de document root van je site te navigeren, voer je het volgende commando in:

cd public

Je kunt nu WP-CLI commando’s gebruiken op je WordPress installatie gehost op Kinsta. Voor een volledige lijst van beschikbare WP-CLI commando’s, raadpleeg je de WordPress developer documentatie.

Nuttige WP-CLI commando’s

Hieronder volgt een lijst met WP-CLI commando’s die je misschien handig vindt. Raadpleeg de WordPress developer documentatie voor een volledige lijst van beschikbare WP-CLI commando’s, inclusief globale parameters en opties.

Handige opties

Hieronder volgt een lijst met handige opties die je kunt toevoegen aan het einde van je commando’s:

--skip-themes: Hiermee voorkom je dat WordPress thema’s worden geladen wanneer je een WP-CLI commando uitvoert. Dit is handig als er een probleem is in een van de thema’s dat conflicten veroorzaakt met WP-CLI commando’s.
--skip-plugins: Hiermee voorkom je dat WordPress plugins worden geladen wanneer je een WP-CLI commando uitvoert. Dit is handig als er een probleem is met een van de plugins dat conflicten veroorzaakt met WP-CLI commando’s.
--all: Hiermee wordt een commando toegepast op alle relevante items. Bijvoorbeeld, als je alle plugins of gebruikers wilt bijwerken.
--dry-run: Hiermee kun je de uitvoering van een commando simuleren zonder daadwerkelijk wijzigingen aan te brengen. Het laat je zien wat er zou gebeuren als de opdracht werd uitgevoerd, maar voert geen enkele actie uit. Bijvoorbeeld, als je een search-and-replace opdracht uitvoert, alle plugins bijwerkt of in bulk berichten verwijdert.
--format=<format>: Specificeert het uitvoerformat bij het exporteren van gegevens. Als je bijvoorbeeld wp plugin list of wp user list uitvoert, wil je dit misschien in table, json of csv formaat.

Plugins

Een lijst met plugins weergeven

Bekijk een lijst met geïnstalleerde plugins met het volgende commando:

wp plugin list

Een plugin activeren

Om een plugin te activeren gebruik je het volgende commando, waarbij je $plugin vervangt door de naam van de plugin uit de wp plugin list.

wp plugin activate $plugin

Een plugin deactiveren

Om een plugin te deactiveren gebruik je het volgende commando, waarbij je $plugin vervangt door de naam van de plugin uit de wp plugin list.

wp plugin deactivate $plugin

Een specifieke plugin bijwerken

Om een plugin bij te werken gebruik je het volgende commando, waarbij je $plugin vervangt door de naam van de plugin uit de wp plugin list.

wp plugin update $plugin

Alle plugins bijwerken

wp plugin update --all

Een plugin terugdraaien

Als je een plugin bijwerkt die vervolgens iets kapot maakt op je site, kun je deze terugdraaien door een specifieke versie te installeren met het volgende commando, waarbij je $plugin vervangt door de naam van de plugin van de wp plugin list en $version door het gewenste versienummer.

wp plugin update $plugin --version=$version

URL’s

De URL voor je homepageinstellen

Om de URL voor je homepage in te stellen, gebruik je het volgende commando, waarbij je $URL vervangt door de gewenste URL.

wp option update home '$URL'

Site URL instellen

Om de URL van de site in te stellen gebruik je het volgende commando, waarbij je $URL vervangt door de gewenste URL.

wp option update siteurl '$URL'

Gebruikers

Alle WordPress gebruikers weergeven

Bekijk een lijst van alle WordPress gebruikers met de volgende opdracht:

wp user list

Een nieuwe gebruiker maken

Om een nieuwe gebruiker aan te maken, gebruik je de volgende opdracht, waarbij je $username en $emailaddress vervangt door de gebruikersgegevens en $role door de rol waaraan je de nieuwe gebruiker wilt toewijzen, bijvoorbeeld beheerder.

wp user create $username $emailaddress -–role=$role

Het wachtwoord van een gebruiker resetten

Om het wachtwoord van een gebruiker opnieuw in te stellen, gebruik je de volgende opdracht, waarbij je $username vervangt door de vereiste gebruikersnaam uit de wp user list.

wp user reset-password $username

De gegevens van een gebruiker bijwerken

Om een gebruiker bij te werken, gebruik je de volgende opdracht, waarbij je $user vervangt door de vereiste gebruikersnaam uit de wp user list, $field door het veld dat je wilt bijwerken en $value door de nieuwe gegevens die je wilt invoeren.

wp user update $user -—$field=$value

Cache wissen

Om de onderstaande opdrachten voor het wissen van cache te kunnen gebruiken, moet de Kinsta Must Use (MU) plugin op de site zijn geïnstalleerd.

Alle cache wissen

Gebruik de volgende opdracht om alle cache te wissen, inclusief site cache, edge cache, CDN cache en Redis cache:

wp kinsta cache purge --all

Full-page cache en edge cache wissen

Om de cache voor de volledige pagina en de edge cache te wissen, gebruik je het volgende commando:

wp kinsta cache purge

Site cache wissen zonder edge cache te wissen

Om alleen de site cache te wissen, gebruik je de volgende opdracht:

wp kinsta cache purge --site

CDN-cache wissen

Om alleen de CDN-cache te wissen, gebruik je de volgende opdracht:

wp kinsta cache purge --cdn

Redis-cache wissen

Gebruik de volgende opdracht om alleen de Redis-cache te wissen:

wp kinsta cache purge --object

Object cache flushen

Flush de object cache van je site met het volgende commando:

wp cache flush

Dit kan tijdelijk leiden tot een lichte verlenging van de laadtijd, omdat de cache opnieuw wordt opgebouwd.

Zoeken en vervangen

Wanneer je een zoek- en vervangopdracht uitvoert op je WordPress site, raden we je aan een back-up te maken en de optie --dry-run te gebruiken om te zien wat er wordt vervangen voordat je de opdracht uitvoert.

Oud domein vervangen door nieuw domein

Om een oude URL te vervangen door een nieuwe URL, gebruik je de volgende opdracht, waarbij je $old-domain vervangt door de URL die je wilt vervangen en $new-domain door de URL waar je hem door wilt vervangen:

wp search-replace '$old-domain' '$new-domain' --skip-columns=guid

--skip-columns=guid wordt aangeraden om te voorkomen dat URL’s die zijn opgeslagen als unieke identifiers in de guid kolom van de database per ongeluk worden gewijzigd, waardoor URL’s van berichten kapot kunnen gaan. Dit commando kan ook worden gebruikt om domeinen van e-mailadressen te vervangen.

HTTP vervangen door HTTPS

Gebruik het volgende commando om je URL’s te vervangen van HTTP naar HTTPS:

wp search-replace 'http://' 'https://' --skip-columns=guid

--skip-columns=guid wordt aanbevolen om te voorkomen dat URL’s die zijn opgeslagen als unieke id’s in de kolom guid van de database per ongeluk worden gewijzigd, wat kan leiden tot problemen met mediabijlagen.

Problemen oplossen

Als je problemen hebt met het uitvoeren van commando’s in WP-CLI, kan dit komen doordat een thema of plugin een fatale fout heeft. Je kunt het volgende toevoegen aan je WP-CLI commando om het laden van thema’s en plugins over te slaan:

--skip-themes --skip-plugins

Om bijvoorbeeld een lijst met gebruikers te krijgen en de thema’s en plugins over te slaan, kun je het volgende uitvoeren:

wp user list --skip-themes --skip-plugins

Als je specifieke plugins wilt overslaan, kun je het volgende gebruiken, waarbij je $plugin vervangt door de pluginnaam en een komma gebruikt om elke plugin te scheiden:

--skip-plugins=$plugin,$plugin

Bijvoorbeeld:

wp user list --skip-plugins=wordpress-seo,wordfence