WP-CLI on virallinen komentorivityökalu WordPress-sivujen hallintaan. Monissa toimissa se on kätevämpi ja nopeampi vaihtoehto WordPressin ohjauspaneelille.
WP-CLI-komentoriviapuohjelmaa käytetään päätteen kautta muodostamalla SSH-yhteys virtuaalipalvelimeesi. Voit lukea lisää täältä: Establishing an SSH connection.
Tässä korostamme hyödyllisiä WP-CLI-komentoja ja kaikki komennot selityksineen ja esimerkeineen näkyvät WP-CLI kotisivulla sekä komentorivillä.
Näet kaikki komennot kirjoittamalla:
> wp
tai
> wp help
WP-CLI-komennot on ryhmitelty luokkiin toimintojen mukaan.
Jokaisella niin sanotulla pääkategorialla on omat alikomennot ja vaihtoehdot.
Näet ydinkomennot kirjoittamalla:
> wp core
Näet komennon selityksen esimerkein kirjoittamalla:
> wp help core update
WordPressin konfigurointi
Katso WordPress-versio:
> wp core version
Katso kokoonpano:
> wp config list
Haetaan vain tietokantatietoja:
> wp config list DB_
Tarkastele tiettyä kokoonpanoasetusta:
> wp config get DB_NAME
Muuta kokoonpanoasetusta:
> wp config set DB_NAME db_name
Tilan tarkasteleminen, huoltotilan aktivointi ja deaktivointi:
> wp maintenance-mode status > wp maintenance-mode activate > wp maintenance-mode deactivate
WordPressin asennus ja päivitys
Lataa WordPress-tiedostot, määritä versio ja hylkää oletusteema ja laajennukset:
> wp core download --version=5.5.3 --skip-content
Asenna WordPress 5 sekunnissa (tietokantatiedot on lisättävä wp-config.php-tiedostoon etukäteen):
> wp core install --url=domain.tld --title='Uus sait' --admin_user=nimi --admin_email=nimi@domain.tld
Päivitä WordPress tarvitsemaasi versioon ja päivitä sitten tietokanta:
> wp core update --version=5.5.1 > wp core update-db
WordPressin käyttäjät, teemat ja laajennukset
Luettelo kaikista WordPress-käyttäjistä, jokaisella käyttäjällä on oma yksilöllinen tunnus:
> wp user list
Käyttäjätilin lisääminen WordPress-järjestelmänvalvojan oikeuksilla:
> wp user create username name@domain.tld --role=administrator
Poista käyttäjä (tilin tunnus = 123).
HUOM. Jos poistat käyttäjän, jonka viestejä ei ole osoitettu uudelleen toiselle käyttäjälle –resign-vaihtoehdolla, myös hänen postaukset poistetaan.
> wp user delete 123 > wp user delete 123 --reassign=1234
Vaihda käyttäjän salasana. On suositeltavaa tuoda salasana tiedostosta komennon 2 mukaisesti, jotta se ei jää komentorivin historiatiedostoon (käyttäjätunnus = 123):
> wp user update 123 --user_pass=new-and-long-password > wp user update 123 --prompt=user_pass < user_password.txt
Luettelo kaikista laajennuksista, tilasta, versionumerosta ja siitä, onko päivitystä saatavilla:
> wp plugin list
Lisäosien päivittäminen (tietyn laajennuksen päivittäminen ja kaikkien päivitys):
> wp plugin update hello > wp plugin update --all
Tietyn laajennuksen poistaminen käytöstä voi olla väliaikainen ratkaisu verkkosivuston palauttamiseen, jos WordPress on poistunut käytöstä (näyttöön tulee PHP-virheilmoitus) WordPressin tai laajennuksen päivityksen jälkeen. Tämä voi olla myös ratkaisu, jos et enää pääse WordPress-järjestelmänvalvojasivullesi ja se näyttää laajennuksen nimen.
Laajennuksen deaktivointi:
> wp plugin deactivate plugin-name
Luettelo kaikista teemoista, tilasta, versionumerosta ja siitä, onko päivitystä saatavilla:
> wp theme list
Päivitetään teemoja:
> wp theme update twentytwenty
WordPress-tietokantaan liittyvät toiminnot
Tietokannan tallentaminen tiedostoon. Nopea ja kätevä tapa varmuuskopioida tietokanta (on suositeltavaa varmuuskopioida tietokanta ennen kuin teet siihen suuria muutoksia):
> wp db export
Tietokannan tuominen tiedostosta
> wp db import dbname-2020-01-01-abcd1234.sql
Etsi tietokannasta tiettyä tekstiä:
> wp db search 'find this text'
Tietojen korvaaminen tietokannassa.
Jos haluat nähdä, mitä korvaava muutos muuttaisi ja missä taulukoissa ennen muokkaamista, lisää komentoon vaihtoehto: --dry-run.
Jos etsittävä tai korvattava teksti sisältää välilyöntejä tai erikoismerkkejä, se tulee ympäröidä lainausmerkeillä:
> wp search-replace --report-changed-only --dry-run --skip-columns=guid 'search this' 'replace with this'
Avaa mysql-komentorivi (tietokantaan yhteyden muodostamistiedot on otettu wp-config.php-tiedostosta):
> wp db cli
WordPressin URL-osoitteen muuttaminen
Saatat joutua muuttamaan WordPressin URL-osoitetta, kun siirrät WordPressiä palvelimelta toiselle, aliverkkotunnuksesta pääverkkotunnukseen tai päinvastoin.
WordPress-sivuston URL-osoite määritetään tietokantataulukon asetuksissa kenttien home ja siteurl.
Lisäksi toimialueen nimi löytyy yleensä muista tietokantataulukoista ja tiedostoista.
Katso nykyisen WordPress-sivuston URL-osoite:
> wp option get home > wp option get siteurl
WordPress-sivuston URL-osoitteen muuttaminen:
> wp option update home https://domain.tld
Muuttaa siteurl– URL-osoite hakemistoon, johon WordPress on asennettu.
siteurl on sama kuin home, jos WordPress on asennettu domainien juurihakemistoon.
Jos WordPress on asennettu alihakemistoon, esimerkiksi “blog”, siteurl-arvo on https://domain.tld/blog.
> wp option update siteurl https://domain.tld
Vanhan URL-osoitteen korvaaminen koko tietokannassa (paitsi posts ja guidetaulukossa).
Ennen muutosten tekemistä on suositeltavaa tarkistaa, missä taulukoissa muutos tehdään. Kun olet saanut yleiskatsauksen taulukoista, poista valinta kohdasta --dry-run tehdäksesi muutoksen:
> wp search-replace --report-changed-only --dry-run --skip-columns=guid https://old.tld https://new.tld
Jos vanha verkkotunnus on korvattava uudella verkkotunnuksella myös tiedostoissa ja muutoksia on tehtävä paljon, voidaan vaihto tehdä komentoriviltä.
Ennen kuin korvaat vanhan verkkotunnuksen nimen, on tiedettävä, voidaanko tämä tehdä kaikille tiedostoille vai vain tietyille hakemistoille ja tiedostotyypeille.
Useimmiten puskurissa ja lokitiedostoissa ei tarvitse tehdä korvauksia. Puskuritiedostot voidaan poistaa joko manuaalisesti tai WordPressin hallintapaneelin kautta.
Tämän mukaisesti sinun on valmisteltava korvaava komento.
Etsi kaikkien tiedostojen vanha verkkotunnus ja näytä näiden tiedostojen nimet (jätä tarvittaessa pois https:// verkkotunnuksen nimen edestä):
> grep -irl 'https://old.tld' ./
Hae vanhasta verkkotunnuksesta tiedostoja, joilla on tietyt tiedostotunnisteet (muokkaa tiedostotunnisteiden luetteloa tarpeidesi mukaan käyttämällä --include optioa):
> grep -irl --include \*.php --include \*.html --include \*.css 'https://old.tld' ./
Korvaa vanha toimialue uudella verkkotunnuksella tiedostoissa, joissa on tietty tiedostopääte (tässä esimerkissä PHP-tiedostot):
> find ./ -name '*.php' -exec sed -i 's~https://old.tld~https://new.tld~g' {} \;
WordPress-tiedostojen tarkistussummat
Joskus on tarpeen tarkistaa, että WordPress-tiedostoja ei ole muokattu. Tämä on usein merkki vaarantuneesta WordPressistä. Tämä voidaan tehdä kahdella seuraavalla komennolla:
Tarkista WordPressin ydintiedostot:
> wp core verify-checksums
Tarkista WordPress-laajennukset:
> wp plugin verify-checksums --all