WP-CLI on WordPressi käsureatööriist, millega saab hallata WordPressi veebilehte otse terminalist. Selle abil saab näiteks uuendada pluginaid, hallata kasutajaid, kontrollida WordPressi faile ja teha muid hooldustöid.

Selles juhendis näitame, kuidas paigaldada WP-CLI oma cPaneli veebimajutuskontole ilma administraatori ehk root-õigusteta.

1. Ava cPaneli terminal

Logi sisse cPanelisse ja vali Advanced -> Terminal. Kui terminal pole saadaval, võid kasutada SSH-ühendust, kui see on sinu veebimajutuskontol lubatud.

2. Paigalda WP-CLI

Loo oma kasutajakataloogi bin kaust, laadi alla WP-CLI ning anna failile käivitamisõigus:

mkdir -p "$HOME/bin"
curl -fsSL -o "$HOME/bin/wp" https://raw.githubusercontent.com/wp-cli/builds/gh-pages/phar/wp-cli.phar
chmod +x "$HOME/bin/wp"

Sellega on WP-CLI paigaldatud sinu kasutajakonto alla. Faili eraldi ümber nimetada ei ole vaja, sest see salvestatakse kohe nimega wp.

3. Lisa WP-CLI PATH-i

Et saaksid kasutada käsku wp ilma täielikku failiteed kirjutamata, peab kaust $HOME/bin olema PATH-keskkonnamuutujas.

Kontrolli olemasolevat PATH-i:

echo "$PATH"

Kui sinu kasutaja bin kaust puudub, lisa järgmine rida faili ~/.bash_profile:

export PATH="$HOME/bin:$PATH"

Seejärel laadi profiil uuesti:

source ~/.bash_profile

Kui sinu terminal kasutab teistsugust käivitusskripti, näiteks ~/.bashrc, tuleb PATH seadistada vastavas failis.

4. Kontrolli paigaldust

Käivita:

wp --info

Kui paigaldus õnnestus, kuvatakse WP-CLI versioon, PHP versioon ja muu keskkonnateave.

5. Kasuta WP-CLI-d WordPressi haldamiseks

Liigu oma WordPressi paigalduskataloogi. Näiteks:

cd ~/public_html

Kasulikud käsud:

wp core version
wp plugin list
wp theme list
wp core verify-checksums
wp plugin update --all
wp cache flush

Tähelepanu! Enne WordPressi, pluginate või teemade uuendamist on soovitatav teha veebilehest ja andmebaasist varukoopia.

6. WP-CLI uuendamine

WP-CLI uuendamiseks saad kasutada käsku:

wp cli update

Alternatiivina võid WP-CLI uuema versiooni uuesti alla laadida:

curl -fsSL -o "$HOME/bin/wp" https://raw.githubusercontent.com/wp-cli/builds/gh-pages/phar/wp-cli.phar
chmod +x "$HOME/bin/wp"

Võimalikud probleemid

wp: command not found – kontrolli, kas $HOME/bin on PATH-is. Ajutiselt saad kasutada käsku $HOME/bin/wp --info.

PHP veateated – kontrolli PHP käsureaversiooni käsuga php -v. cPaneli terminali PHP versioon võib erineda veebilehe PHP versioonist.

WordPress installation not found – veendu, et käivitad käsu WordPressi juurkataloogis või kasutad parameetrit --path.

Lisainfo

WP-CLI ametlik dokumentatsioon: WP-CLI paigaldusjuhend.