1. Home
  2. Tehniline
  3. WP-CLI – käsurea tööriist WordPress’i haldamiseks

WP-CLI – käsurea tööriist WordPress’i haldamiseks

WP-CLI on ametlik käsurea tööriist WordPress’i lehekülgede haldamiseks.
See on alternatiivne võimalus WordPress’i kontrollpaneelile ning on paljude tegevuste puhul mugavam ja kiirem kasutada.

WP-CLI käsurea utiliidi kasutamine käib terminali kaudu, luues selleks SSH ühenduse oma virtuaalserveriga. Loe täpsemalt: SSH ühenduse loomine.

Toome siin välja mõned kasulikud WP-CLI käsud.
Kõiki käskusi koos selgituste ja näidetega näeb WP-CLI leheküljelt ning samuti ka käsurealt.
Kõikide käskude nägemiseks sisesta:

> wp

või

> wp help

WP-CLI käsud on grupeeritud tegevuste järgi kategooriatesse.
Igal n. ö. peakategooria käsul on alamkäsud ja valikud.

Nägemaks tuumiku (core) alamkäskusi, sisesta:

> wp core

Et näha käsu kohta seletust koos näidetega, sisesta:

> wp help core update

 

WordPress’i konfiguratsioon

WordPress’i versiooni vaatamine:

> wp core version

Konfiguratsiooni vaatamine:

> wp config list

Ainult andmebaasi andmete vaatamine:

> wp config list DB_

Ühe kindla konfiguratsiooni sätte vaatamine:

> wp config get DB_NAME

Konfiguratsiooni sätte muutmine:

> wp config set DB_NAME db_name

Hooldusrežiimi staatuse vaatamine, aktiveerimine ja deaktiveerimine:

> wp maintenance-mode status
> wp maintenance-mode activate
> wp maintenance-mode deactivate

WordPress’i paigaldamine ja uuendamine

Laadi alla WordPress’i failid, täpsustades versiooni ja loobudes vaikimisi kaasapandud teemast ja pluginatest:

> wp core download --version=5.5.3 --skip-content

Paigalda WordPress 5 sekundiga (enne on vaja lisada andmebaasi andmed wp-config.php faili):

> wp core install --url=domain.tld --title='Uus sait' --admin_user=nimi --admin_email=nimi@domain.tld

Uuenda WordPress vajaliku versioonini ja uuenda peale seda ka andmebaasi:

> wp core update --version=5.5.1
> wp core update-db

WordPress’i kasutajad, teemad ja pluginad

Kõigi WordPress’i kasutajate nimekiri, igal kasutajal on oma unikaalne ID:

> wp user list

WordPress’i admin õigustes kasutajakonto lisamine:

> wp user create kasutajanimi nimi@domain.tld --role=administrator

Kasutaja kustutamine (konto ID = 123).
NB! Kui kustutatakse kasutaja kelle postitusi ei määrata mõnele teisele kasutajale valikuga --reassign, siis kustutatakse ka tema postitused.

> wp user delete 123
> wp user delete 123 --reassign=1234

Kasutaja salasõna muutmine. Soovitatav on salasõna sisse lugeda failist, nagu näha 2. käsus, et see ei jääks käsurea ajaloofaili (konto ID = 123):

> wp user update 123 --user_pass=uus-ja-pikk-salas6na
> wp user update 123 --prompt=user_pass < user_password.txt

Kõikide pluginate nimekiri, staatus, versiooni number ja kas on väljas uuendus

> wp plugin list

Plugina uuendamine (ühe konkreetse ja kõikide uuendamine):

> wp plugin update hello
> wp plugin update --all

Kui WordPress’i või selle plugina uuendamisel on muutunud WordPress kättesaamatuks (kuvatakse PHP veateade või ei saa enam sisse WordPress’i adminni ja veateates on näha mõne plugina nimi, võib konkreetse plugina deaktiveerimine olla ajutiseks lahenduseks, mis taastab veebilehe töö.
Plugina deaktiveerimine:

> wp plugin deactivate plugin-name

Kõikide teemade nimekiri, staatus, versiooni number ja kas on väljas uuendus:

> wp theme list

Teema uuendamine:

> wp theme update twentytwenty

WordPress’i andmebaasiga seotud tegevused

Andmebaasi salvestamine faili. Kiire ja mugav viis teha andmebaasist varukoopia (soovitatav on teha andmebaasist varukoopia enne igasugust suuremat muudatuste tegemist selles):

> wp db export

Andmebaasi sisselugemine failist:

> wp db import dbname-2020-01-01-abcd1234.sql

Otsi andmebaasist sõne:

> wp db search 'leia see tekst'

Andmebaasis andmete asendamine.
Kui enne muutmist on vaja näha, mida asendamine muudaks ja millistes tabelites, siis lisa käsule juurde valik: --dry-run
Kui otsitav või asendav tekst sisaldab tühikuid või erimärke, tuleb see ümbritseda jutumärkidega:

> wp search-replace --report-changed-only --dry-run --skip-columns=guid 'otsida seda' 'asenda sellega'

Ava mysql käsurida (andmed andmebaasiga ühenduse loomiseks võetakse failist wp-config.php):

> wp db cli

WordPress’i URL’i muutmine

WordPress’i kolimisel ühest serverist teise, alamdomeenilt peadomeenile või vastupidi, võib vaja minna muuta WordPress’i URL.
Wordpress’i veebilehe URL määratakse ära andmebaasi tabelis options, väljadega home ja siteurl.
Lisaks on enamasti domeeninimi kirjas veel teistes andmebaasi tabelites ja ka failides.

Praeguse WordPress’i veebilehe URL’i vaatamine:

> wp option get home
> wp option get siteurl

WordPress’i veebilehe URL’i muutmine:

> wp option update home https://domain.tld

siteurl’i muutmine – URL kataloogini kuhu WordPress on paigaldatud.
Kui WordPress on paigaldatud domeeni juurkataloogi, siis siteurl on sama, mis home URL.
Kui WordPress on paigaldatud mõnda alamkataloogi, näiteks blog, siis siteurl’i väärtus oleks https://domain.tld/blog.

> wp option update siteurl https://domain.tld

Vana URL’i asendamine terves andmebaasis (v. a. tabeli posts tulbas guid).
Enne muutmist on soovitatav vaadata, millistes tabelites toimub muutmine ja pärast ülevaate saamist muutmise jaoks eemaldada käsust valik --dry-run:

> wp search-replace --report-changed-only --dry-run --skip-columns=guid https://old.tld https://new.tld

Kui vana domeen on vaja asendada uue domeeni vastu ka failides ja neid muudatusi on vaja teha palju, saab asendamise teha käsurealt.
Enne vana domeeninime asendamist on vaja teada, kas seda võib teha kõigis failides või ainult kindlates kataloogides ja kindlat tüüpi failides.
Enamasti ei ole vaja teha asendamist puhver- ja logifailides. Puhverfailid saab kustutada, kas käsitsi või tuleb seda teha WordPress’i adminpaneeli kaudu.
Vastavalt sellele tuleb koostada oma asendamise käsk.
Otsi kõikidest failidest välja vana domeen ja kuva nende failide nimed (vajadusel jäta domeeninime eest ära https://):

> grep -irl 'https://old.tld' ./

Otsi vana domeeni kindlatest faililaientidega failidest (kohanda valikuga --include faililaiendite nimekirja vastavalt oma vajadusele):

> grep -irl --include \*.php --include \*.html --include \*.css 'https://old.tld' ./

Asenda vana domeen uue domeeniga kindla faililaiendiga failides (siin näites PHP failides):

> find ./ -name '*.php' -exec sed -i 's~https://old.tld~https://new.tld~g' {} \;

WordPress’i failide kontrollsummad

Kui on vaja kontrollida ega WordPress’i faile ei ole muudetud (tihti on see WordPress’i komrpomiteerimise tunnuseks), siis seda saab teha kahe järgneva käsuga
Wordpress’i tuumikfailide kontrollimine:

> wp core verify-checksums

WordPress’i pluginate failide kontrollimine:

> wp plugin verify-checksums --all
Updated on 25. nov. 2020

Was this article helpful?

Related Articles