WP-CLI käyttöön: hallitse WordPressiä komentoriviltä

Tiivistelmä

WordPressin ylläpito onnistuu tavallisesti selaimen kautta, mutta samojen tehtävien toistaminen voi viedä aikaa. Lisäosien tarkistaminen, tietokannan vieminen ja sivuston asetusten tutkiminen sujuvat usein nopeammin…

WP-CLI on WordPressin komentorivityökalu. Sen avulla voit hallita asennusta tekstikomennoilla ilman hallintapaneelin näkymien avaamista. Se sopii yksittäisen sivuston ylläpitoon, kehitystyöhön ja useiden sivustojen toistuvien tehtävien automatisointiin.

Käyttöönotossa tärkeintä on tunnistaa oikea palvelin, hakemisto ja tietokanta. Kun nämä ovat selvillä, voit aloittaa tietoja näyttävistä komennoista ja siirtyä vähitellen muutoksia tekeviin toimintoihin.

Mitä WP-CLI:llä voi tehdä?

WP-CLI tarjoaa komentoja esimerkiksi WordPressin ytimen, teemojen, lisäosien, käyttäjien ja sisältöjen hallintaan. Sillä voidaan myös käsitellä tietokantaa ja suorittaa ajastettuja tehtäviä. WP-CLI:n komentovalikoima

Tyypillisiä käyttökohteita ovat:

Asennettujen lisäosien ja niiden versioiden tarkistaminen.
WordPressin päivittäminen.
Tietokannan vienti ennen muutoksia.
Sivuston osoitteiden korvaaminen siirron yhteydessä.
Artikkeleiden ja käyttäjien listaaminen.
Ongelmallisen lisäosan poistaminen käytöstä.

Komentorivi ei korvaa kaikkia selaimessa tehtäviä tarkistuksia. Päivityskomento voi onnistua, vaikka jokin sivuston toiminto vaatisi vielä korjaamista. Lopputulos pitää siksi tarkistaa myös kävijän näkökulmasta.

Selvitä palveluntarjoajan tarjoamat mahdollisuudet

Tarkista ensin, onko hosting-palvelussasi SSH-yhteys tai hallintapaneelin terminaali. WP-CLI voi olla valmiiksi asennettuna, jolloin erillistä asennusta ei tarvita.

SSH-yhteys avataan omalta tietokoneelta esimerkiksi näin:

ssh kayttaja@palvelin.example

Korvaa käyttäjänimi ja palvelimen osoite palveluntarjoajalta saamillasi tiedoilla. Myös yhteyden portti voi olla palvelukohtainen.

Yhteyden avaamisen jälkeen komennot suoritetaan palvelimella. Omalla tietokoneella oleva WordPress-kopio ei muutu, ellei työskentelyä ole erikseen kohdistettu siihen.

Käytä sivuston ylläpitoon tarkoitettua palvelintunnusta. Tavallisia WordPress-tehtäviä ei tarvitse suorittaa palvelimen root-käyttäjänä.

Tarkista, löytyykö WP-CLI jo valmiiksi

Suorita terminaalissa:

wp --info

Jos komento toimii, näet tietoja WP-CLI:stä ja sen käyttämästä PHP-ympäristöstä. Jos saat ilmoituksen, ettei komentoa löydy, työkalu voi puuttua tai sijaita komentohakemiston ulkopuolella.

Tarkista myös PHP:

php --version

Komentorivin PHP voi olla eri versio kuin verkkosivustoa palveleva PHP. Tämä on tärkeää erityisesti silloin, kun jokin lisäosa toimii selaimessa mutta antaa virheen komentorivillä.

Kysy tarvittaessa palveluntarjoajalta oikea PHP-polku ja suositeltu WP-CLI:n käyttötapa. Älä vaihda palvelimen asetuksia vain yhden virheilmoituksen perusteella.

Asenna työkalu tarvittaessa omalle käyttäjällesi

Linux- tai macOS-ympäristössä WP-CLI voidaan asentaa Phar-tiedostosta. Jos palveluntarjoaja sallii oman asennuksen, lataa paketti virallisesta jakelusta:

curl -fL -o wp-cli.phar \
  https://raw.githubusercontent.com/wp-cli/builds/gh-pages/phar/wp-cli.phar

Tarkista toiminta:

php wp-cli.phar --info

Voit sijoittaa tiedoston oman käyttäjäsi ohjelmahakemistoon:

mkdir -p ~/.local/bin
chmod +x wp-cli.phar
mv wp-cli.phar ~/.local/bin/wp

Kokeile tämän jälkeen:

~/.local/bin/wp --info

Lyhyt wp-komento toimii, kun kyseinen hakemisto kuuluu shellin PATH-hakupolkuun. Tarvittava asetus riippuu käyttämästäsi shellistä.

Virallinen asennusohje sisältää myös paketin aitouden tarkistamisen ja vaihtoehtoiset asennustavat. Palveluntarjoajan valmiiksi ylläpitämää asennusta ei yleensä tarvitse korvata omalla. WP-CLI:n asennusohje

Siirry oikean WordPress-asennuksen hakemistoon

Useimmat sivustoa käsittelevät komennot tarvitsevat tiedon WordPressin sijainnista. Siirry hakemistoon, jossa kyseisen asennuksen tiedostot sijaitsevat:

cd /polku/wordpressiin

Korvaa esimerkkipolku todellisella hakemistolla. Tarkista työskentelypaikka ja WordPressin versio:

pwd
wp core version

Tarkista lisäksi sivuston julkinen osoite:

wp option get home

Nämä tarkistukset auttavat välttämään muutokset väärään asennukseen. Samalla palvelimella voi olla tuotantosivusto, testikopio ja vanha asennus.

Hakemiston vaihtamisen sijaan voit antaa polun komennolle:

wp core version --path=/polku/wordpressiin

Hakemiston nimi ei yksin takaa, että käytössä on oikea ympäristö. Myös sen asetusten osoittama tietokanta ratkaisee.

Opettele komentojen rakenne ja ohjeet

WP-CLI-komento muodostuu yleensä työkalun nimestä, komentoryhmästä ja toiminnosta:

wp plugin list

Tässä plugin tarkoittaa lisäosien hallintaa ja list luettelon näyttämistä.

Komentoja voidaan täydentää valinnoilla. Esimerkiksi CSV-muotoinen tuloste saadaan näin:

wp plugin list --format=csv

Saat komennon käyttöohjeen suoraan terminaaliin:

wp help plugin
wp help plugin update

Opettele käyttämään ohjetta ennen uusia ylläpitotoimia. Samankaltaiset komennot voivat käyttäytyä eri tavalla, eikä esimerkiksi kokeilutilaa ole kaikissa toiminnoissa.

Aloita lukevista komennoista. Ne auttavat hahmottamaan työkalua ilman tarkoituksellisia muutoksia sivuston sisältöihin tai asetuksiin.

Tarkista ja päivitä lisäosia hallitusti

Asennetut lisäosat saat näkyviin komennolla:

wp plugin list

Päivitystä tarvitsevat lisäosat voidaan rajata omaan listaukseensa:

wp plugin list --update=available

Yksittäinen lisäosa päivitetään sen tunnisteella:

wp plugin update lisaosan-tunniste

Korvaa esimerkin tunniste luettelossa näkyvällä lisäosan nimellä. Kaikkien päivitysten alustavan tarkistuksen voi tehdä näin:

wp plugin update --all --dry-run

Tässä --dry-run näyttää suunnitellut päivitykset asentamatta niitä. Se ei kuitenkaan testaa uusien versioiden yhteensopivuutta sivustosi kanssa. Lisäosien hallintakomennot

Ota varmuuskopio ja käytä merkittävissä muutoksissa testiympäristöä. Tarkista päivityksen jälkeen ainakin kirjautuminen, lomakkeet ja mahdollinen ostaminen.

Päivitä WordPress ja tarkista tietokannan päivitystarve

WordPressin ytimen saatavilla olevat päivitykset voi tarkistaa komennolla:

wp core check-update

Varsinainen päivitys tehdään näin:

wp core update

Päivityksen jälkeen suorita tarvittaessa tietokannan päivitysvaihe:

wp core update-db

Tarkista lopuksi asennettu versio uudelleen. Ytimen tiedostoja voi myös verrata virallisiin tarkistussummiin:

wp core verify-checksums

Tarkistussummien vertailu auttaa havaitsemaan poikkeamia ydintiedostoissa. Se ei ole koko sivuston tietoturvatarkastus eikä arvioi kaikkia lisäosia tai ladattuja tiedostoja. WordPressin ytimen WP-CLI-komennot

Jos päivitys epäonnistuu, lue virheilmoitus ennen uudelleenyritystä. Syynä voi olla esimerkiksi kirjoitusoikeus, puuttuva levytila tai latausyhteys.

Vie tietokanta ennen laajoja muutoksia

Tietokannan viennin voi tehdä wp db export -komennolla:

wp db export /suojattu/varmistukset/ennen-muutoksia.sql

Esimerkin kohdehakemiston täytyy olla olemassa ja kirjoitettavissa. Valitse paikka julkisen verkkohakemiston ulkopuolelta, sillä vientitiedosto voi sisältää käyttäjätietoja ja muita luottamuksellisia tietoja.

Komento tarvitsee ympäristöönsä sopivan tietokannan vientityökalun. Jos vienti epäonnistuu puuttuvan ohjelman vuoksi, selvitä asia palveluntarjoajalta. Tietokannan vientikomennon ohje

Tietokantavienti ei sisällä mediakirjaston kuvatiedostoja, teemoja tai lisäosia. Täydellinen palautusvalmius edellyttää myös tarvittavien tiedostojen varmuuskopiointia.

Varmista viennin onnistuminen ja säilytä palautusohje saatavilla ennen seuraavaa työvaihetta.

Käytä osoitteiden korvaamisessa ensin kokeilutilaa

Sivuston siirrossa tietokantaan voi jäädä vanhoja osoitteita. WP-CLI:n search-replace osaa käsitellä myös PHP:n sarjallistettuja tietorakenteita.

Aloita kokeilulla:

wp search-replace \
  'https://vanha.example' \
  'https://uusi.example' \
  --skip-columns=guid \
  --dry-run

Komento raportoi suunnitellut korvaukset muuttamatta tietokantaa. Tarkista raportista kohteet ja korvausten määrä ennen varsinaista ajoa.

Kun rajaus on oikea ja varmuuskopio valmis, sama komento voidaan suorittaa ilman --dry-run-valintaa. Esimerkki ohittaa guid-sarakkeen tarkoituksellisesti. Search-replace-komennon toiminta

Älä laajenna käsittelyä automaattisesti kaikkiin tietokannan tauluihin. Samassa tietokannassa voi olla muiden asennusten tietoja. Monisivustossa ja lisäosien omissa tauluissa rajaus täytyy suunnitella erikseen.

Selvitä virheet ja rakenna oma ylläpitorutiini

Jos WP-CLI pysähtyy lisäosan PHP-virheeseen, kokeile tietoja näyttävää komentoa ohittamalla tavallisten lisäosien ja teeman lataaminen:

wp plugin list --skip-plugins --skip-themes

Valinnat koskevat kyseistä komentoa eivätkä poista lisäosia pysyvästi käytöstä. Pakolliset mu-plugin-lisäosat latautuvat edelleen.

Tallenna toimivat komennot lyhyeksi ylläpito-ohjeeksi. Merkitse mukaan kohdeympäristö, tarvittavat varmistukset ja onnistumisen tarkistus. Älä liitä salasanoja ohjeisiin tai komentohistoriaan.

Automatisoi vasta sellainen työvaihe, jonka olet testannut käsin. Skriptin pitää huomata epäonnistuminen ja keskeyttää tarvittaessa seuraavat muutokset. Näin WP-CLI:stä muodostuu ennustettava ylläpitotyökalu myös silloin, kun hoidettavia sivustoja on useita.

Liittyvät kategoriat

Artikkeleita 2 032 artikkelia IT 1 958 artikkelia Kotisivut 1 207 artikkelia Nettisivut 1 207 artikkelia Verkkokehitys 1 273 artikkelia Verkkosivut 1 406 artikkelia Verkkotyökalu 1 186 artikkelia WordPress 1 226 artikkelia