WordPress WP-CLI gebruiken vanaf de command line
Voor ontwikkelaars is er een fantastische tool die je veel werk kan besparen: WP CLI (Command Line Interface). Door de snelheid waarmee je bepaalde zaken via deze weg kunt uitvoeren kun je als developer eigenlijk niet meer om deze tool heen. WP-CLI is dan ook standaard actief op ieder hosting account bij Hoasted.
WordPress WP-CLI gebruiken
Om gebruik te maken van WP-CLI dien je eerst in te loggen via SSH of via de cPanel Terminal, en naar de map van de installatie te navigeren. Vervolgens kun je verschillende commando's gebruiken zoals onderstaand beschreven.
Log in op het account via SSH
ssh cpaneluser@domein.nl
Navigeer vervolgens naar de locatie van de WordPress installatie, in dit geval ~/public_html/
cd public_html
Vanuit de hoofdmap van de installatie kun je vervolgens de WP-CLI commando's uitvoeren. In deze handleiding beschrijven we een aantal veel gebruikte commando's die het beheer van de website vele malen makkelijker maken. Voor de volledige lijst van commando's die je kunt gebruiken zie onderstaande link:
https://developer.wordpress.org/cli/commands/
Mogelijkheden
WP-CLI biedt vele mogelijkheden waarvan we er een aantal hieronder hebben uitgeschreven. De overige commando's kun je vinden op de website van WordPress.
Database
- Database exporteren en importeren
- Wijzig WordPress URL (database links herschrijven)
Plugins
- Lijst van plugins tonen
- Nieuwe plugin zoeken
- Plugin installeren
- Plugin updaten
- Plugin deactiveren
Gebruikers
- Lijst van gebruikers tonen
- Nieuwe gebruiker aanmaken
- Gebruiker verwijderen
WooCommerce
- WooCommerce CLI activeren
Overig
- WordPress installeren via WP-CLI
- WordPress onderhoudsmodus inschakelen
- WordPress permalinks flushen via WP-CLI
Database
Vele zaken omtrent de database kunnen het best direct via de command line uitgevoerd worden. Zie onderstaand een aantal veel voorkomende taken en commando's.
Database exporteren en importeren
Gebruik onderstaande commando's om de database te exporteren naar een .sql bestand die geplaatst zal worden in de hoofdmap van de installatie.
wp db export
wp db export bestandsnaam.sql
Onderstaande commando zal de database importeren op basis van de bestandsnaam in de hoofdmap van de installatie. Het bestand zal vervolgens geïmporteerd worden naar de database welke in het wp-config.php bestand vermeld staat.
wp db import bestandsnaam.sql
Wijzig WordPress URL (database links herschrijven)
Je kunt dit gebruiken wanneer je bijvoorbeeld een staging website die op een andere URL heeft gedraaid te herschrijven zodat deze op de nieuwe link komt te draaien. Gebruik voor de veiligheid eerst het '--dry-run' commando aan het einde om een test run uit te voeren zonder dat hier iets bij herschreven word.
wp search-replace "staging.domein.nl" "domein.nl" --all-tables --dry-run
Dit commando kan ook gebruikt worden om een website van http:// naarhttps:// te wijzigen
wp search-replace "http://domein.nl" "https://domein.nl" --all-tables --dry-run
Plugins
Via de command line kun je een aantal handige acties uitvoeren met betrekking tot de WordPress plugins:
Lijst van plugins tonen
wp plugin list
Je krijgt dan de lijst, bijvoorbeeld:
Plugin installeren
Je kunt plugins direct installeren door de 'slug' op te zoeken en deze in het commando te verwerken. Met de optionele '--activate' flag activeer je de plugin ook direct.
wp plugin install litespeed-cache --activate
wp plugin install https://codecanyon.net/downloads/plugin.zip
Plugin updaten
Gebruik onderstaande commando om de plugin te updaten naar een bepaalde versie. Wanneer je de optionele '--version' flag niet gebruikt zal de plugin naar de laatste versie geupdate worden.
wp plugin update litespeed-cache
wp plugin update litespeed-cache --version=1.0.1
Plugin deactiveren
Om een plugin direct te deactiveren kun je onderstaande commando gebruiken. Met de '--all' flag kun je alle plugins in één keer uitschakelen. Handig voor tijdens het debuggen!
wp plugin deactivate litespeed-cache
wp plugin deactivate --all
Gebruikers
Wanneer je om één of andere reden geen toegang meer hebt tot het WordPress dashboard kun je gemakkelijk via de command line alle zaken omtrent de gebruikers beheren.
Lijst van gebruikers tonen
Handig om snel alle beheerders te tonen.
wp user list
wp user list --role=administrator
Gebruiker toevoegen
Voeg razendsnel een nieuwe beheer toe aan de website.
wp user create jouwusername jouw@email.nl --role=administrator
Gebruiker verwijderen
Verwijder een gebruiker en verplaats zijn berichten naar een andere gebruiker.
wp user delete jouwusernaam --reassign=userid
WooCommerce
WooCommerce heeft een eigen set van commando's die niet standaard in de WP-CLI commando's zijn opgenomen. Zie onderstaand hoe je deze kunt activeren:
WooCommerce CLI activeren
Gebruike onderstaande commando's om WooCommerce CLI commando's beschikbaar te maken.
unalias wc
wc
Zie ook onderstaande link voor alle WooCommerce commando's die je kunt gebruiken:
https://github.com/woocommerce/woocommerce/wiki/WC-CLI-Commands
Overig
Onderstaand nog een aantal handige acties die je kunt gebruiken.
WordPress installeren via WP-CLI
Zet razendsnel een nieuwe WordPress installatie op met onderstaande commando.
wp core install --url=domein.nl --title=voorbeeld --admin_user=gebruikersnaam --admin_password=jouwwachtwoord --admin_email=info@domein.nl
WordPress onderhoudsmodus inschakelen via WP-CLI
Schakel de WordPress maintenance pagina in via de command line.
wp maintenance-mode activate
wp maintenance-mode deactivate
wp maintenance-mode status
WordPress permalinks flushen via WP-CLI
Flush de permalinks rechtstreeks via de CLI wanneer dit nodig is.
wp rewrite flush