WP-CLI is de opdrachtregel van WordPress. Daarmee bedien je cloneworx Backup zonder browser, bijvoorbeeld voor back-ups die de server zelf start. Zo installeer je WP-CLI en controleer je of de commando’s van de plugin er zijn.
De stappen volgen de handleiding van hostnet: Wie installiere ich WP-CLI? Gebruiker, groep en paden kunnen bij jouw hoster anders heten.
Dit heb je nodig
- SSH-toegang tot de server,
- PHP voor de opdrachtregel,
- curl,
- sudo-rechten, als je WP-CLI voor de hele server installeert. Zonder sudo-rechten gaat het ook: zie de paragraaf “Zonder sudo-rechten”.
Meld je via SSH aan op de server en ga naar een map waarin je mag schrijven, bijvoorbeeld je thuismap.
WP-CLI nooit als root uitvoeren
WordPress, plugins en thema’s zouden daarbij ook de rechten van root krijgen. Voer WP-CLI uit als de gebruiker aan wie de website toebehoort.
Stap 1: WP-CLI downloaden
curl -fLO https://raw.githubusercontent.com/wp-cli/builds/gh-pages/phar/wp-cli.phar
Daarna staat het bestand wp-cli.phar in de map waarin je je nu bevindt.
Stap 2: het bestand controleren
php wp-cli.phar --info
De uitvoer noemt de versies van PHP en WP-CLI. Deze stap is optioneel.
Stap 3: het bestand uitvoerbaar maken
chmod 755 wp-cli.phar
Met deze rechten kan ook de gebruiker van de website het bestand uitvoeren.
Stap 4: WP-CLI voor de hele server installeren
sudo mv wp-cli.phar /usr/local/bin/wp
Het commando verplaatst het bestand naar /usr/local/bin en noemt het wp. Vanaf nu roep je WP-CLI aan met wp.
Stap 5: testen als gebruiker van de website
sudo -u web -g vuser -H wp --info
Bij hostnet draait de webserver als gebruiker web in de groep vuser. Heten gebruiker en groep bij jou anders, bijvoorbeeld omdat je website met suEXEC draait, dan vul je hier de gebruiker en de groep van jouw website in. Toont het commando de gegevens over systeem, PHP en WP-CLI zonder foutmelding, dan is WP-CLI geïnstalleerd.
Zonder sudo-rechten
Heb je geen sudo-rechten, dan blijft het bestand in jouw map en roep je het aan met PHP. De stappen 3 tot 5 vervallen.
# In plaats van wp: php en het pad naar het bestand php ~/wp-cli.phar --info
Het voorbeeld geldt voor een bestand dat in je thuismap staat. Overal waar in deze hulp wp staat, schrijf je dan php en het pad naar het bestand, hier php ~/wp-cli.phar.
Tot slot: zijn de commando’s van de plugin er?
Ga naar de map van je website, dus de map waarin WordPress staat. Vraag daar de toestand van de website op:
# In de map van de website cd /pfad/zur/website wp cloneworx-backup status # Met sudo als gebruiker van de website sudo -u web -g vuser -H wp cloneworx-backup status # Zonder sudo-rechten, met het bestand in de eigen map php ~/wp-cli.phar cloneworx-backup status
De uitvoer is Engels. De eerste regel noemt de toestand van de website, bijvoorbeeld State: none (no backup yet): er is nog geen back-up. Daaronder volgen onder andere de laatste back-up, zodra er een is, en het aantal plannen en doelen. Het is hetzelfde resultaat dat de statustegel van de pagina Overzicht toont.
Antwoordt het commando zo, dan zijn de commando’s van de plugin er. Welke er zijn, toont De opdrachten in één oogopslag.
Als iets niet lukt
| Wat er gebeurt | Wat je kunt doen |
|---|---|
Je mag sudo niet gebruiken. |
Neem de weg uit de paragraaf “Zonder sudo-rechten”. |
WP-CLI kent het commando cloneworx-backup niet. |
De plugin registreert zijn commando’s alleen als hij op deze website actief is. Controleer of je in de map van de juiste website bent en of cloneworx Backup daar is geactiveerd. Op een WordPress-multisite-installatie bestaan de commando’s niet: cloneworx Backup ondersteunt multisite niet. |
Een commando van de plugin breekt af. In zijn melding staat This command runs as user, en die noemt twee gebruikers. |
Je werkt als een andere gebruiker dan de gebruiker aan wie de mappen van de plugin toebehoren. Voer het commando uit als gebruiker van de website, zoals in stap 5. |
Goed om te weten
- De uitvoer van alle commando’s van de plugin is Engels en wordt niet vertaald.
- Bijna elk commando dat iets wijzigt of een taak start, controleert vooraf of je werkt als de gebruiker aan wie de mappen van de plugin toebehoren. Bestanden en mappen van een andere gebruiker zou de website later niet meer kunnen wijzigen of verwijderen.
- Wachtwoorden en sleutels accepteert de opdrachtregel nooit. Doelen met inloggegevens stel je in op de pagina Doelen.