WP-CLI on WordPressin komentorivityökalu, jonka avulla voit hallita WordPress-sivustoasi suoraan terminaalista. Voit esimerkiksi päivittää lisäosia, hallita käyttäjiä, tarkistaa WordPressin tiedostoja ja suorittaa erilaisia ylläpitotehtäviä.

Tässä ohjeessa käymme läpi WP-CLI:n asentamisen omalle cPanel-webhotellitilille ilman pääkäyttäjän eli root-käyttöoikeuksia.

1. Avaa cPanelin terminaali

Kirjaudu cPaneliin ja siirry kohtaan Advanced -> Terminal. Vaihtoehtoisesti voit käyttää SSH-yhteyttä, mikäli se on käytettävissä webhotellitililläsi.

2. Asenna WP-CLI

Luo kotihakemistoosi bin-hakemisto, lataa WP-CLI ja anna tiedostolle suoritusoikeudet:

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"

WP-CLI on nyt asennettu käyttäjätilillesi. Tiedostoa ei tarvitse nimetä erikseen uudelleen, sillä se tallennetaan suoraan nimellä wp.

3. Lisää WP-CLI PATH-ympäristömuuttujaan

Jotta voit suorittaa komennon wp ilman koko tiedostopolkua, hakemiston $HOME/bin tulee sisältyä PATH-ympäristömuuttujaan.

Tarkista nykyinen PATH:

echo "$PATH"

Jos kotihakemistosi bin-hakemisto puuttuu PATH-muuttujasta, lisää seuraava rivi tiedostoon ~/.bash_profile:

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

Lataa asetukset uudelleen:

source ~/.bash_profile

Jos käytössäsi on toinen komentotulkin asetustiedosto, esimerkiksi ~/.bashrc, lisää PATH-asetus siihen.

4. Tarkista asennus

Suorita:

wp --info

Onnistuneen asennuksen jälkeen näet muun muassa WP-CLI:n version, PHP-version ja muita ympäristötietoja.

5. WordPressin hallinta WP-CLI:llä

Siirry WordPress-asennuksesi hakemistoon, esimerkiksi:

cd ~/public_html

Hyödyllisiä komentoja:

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

Huomio! Suosittelemme ottamaan varmuuskopion sivuston tiedostoista ja tietokannasta ennen WordPressin, lisäosien tai teemojen päivittämistä.

6. WP-CLI:n päivittäminen

Voit päivittää WP-CLI:n seuraavalla komennolla:

wp cli update

Vaihtoehtoisesti voit ladata uusimman version uudelleen:

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

Yleisimmät ongelmat

wp: command not found – tarkista, että $HOME/bin löytyy PATH-muuttujasta. Voit myös suorittaa komennon suoraan muodossa $HOME/bin/wp --info.

PHP-virheet – tarkista komentorivin PHP-versio komennolla php -v. cPanelin komentorivin PHP-versio voi olla eri kuin verkkosivustolla käytettävä PHP-versio.

WordPress installation not found – varmista, että olet WordPressin asennushakemistossa tai määritä oikea hakemisto --path-parametrilla.

Lisätietoja

Virallinen dokumentaatio: WP-CLI Installation Guide.