11 min. lue

WP-CLI: Täydellinen opas WordPressin hallintaan komentoriviltä käsin

WP-CLI on virallinen komentorivityökalu WordPress-asennusten hallintaan suoraan päätelaitteesta avaamatta selainta. Jos olet joskus viettänyt iltapäivän napsauttamalla WordPressin hallintataulua päivittääksesi liitännäisiä useilla sivustoilla, tiedät jo, miksi tämä työkalu on olemassa.

Tässä oppaassa opit kaiken WP-CLI:n asentamisesta Linuxiin, macOS:ään ja Windowsiin sekä monimutkaisten ylläpitotehtävien automatisoinnista skriptien ja asetustiedostojen avulla. Riippumatta siitä, hallinnoitko yhtä blogia vai kymmeniä asiakassivustoja, WP-CLI:n hallitseminen muuttaa perusteellisesti tapasi työskennellä WordPressin kanssa.

Mitä opit:

WP-CLI:n asentaminen ja konfigurointi eri käyttöjärjestelmiin
Oleelliset komennot liitännäisten, teemojen, käyttäjien ja sisällön hallintaan
Tietokantatoiminnot, mukaan lukien vienti, tuonti ja turvallinen haku ja korvaaminen.
Automaatiotekniikat skriptien, aliasien ja cron-toimintojen avulla
Parhaat käytännöt yleisten sudenkuoppien välttämiseksi päätteeltä käsin työskenneltäessä

Mikä on WP-CLI? (Nopea selitys ensin)

WP-CLI on lyhenne sanoista WordPress Command Line Interface – avoimen lähdekoodin työkalu, jonka avulla voit hallita WordPress-sivustoja kokonaan päätelaitteesta. Sen sijaan, että kirjaudut wp-adminiin ja navigoit valikoissa, voit suorittaa komentoja kuten wp plugin update --all ja katsella, kuinka koko plugin-pinosi päivittyy sekunneissa.

Projekti alkoi noin vuonna 2011, ja sen loivat kehittäjät, jotka halusivat nopeamman tavan hallita WordPressiä laajassa mittakaavassa. Vuonna 2017 se siirtyi WordPress.orgin virallisen sateenvarjon alle, ja sitä ylläpitää nyt omistautunut avustajaryhmä, johon kuuluvat Alain Schlesser ja Daniel Bachhuber.

Seuraavassa kerrotaan, mitä sinun on tiedettävä WP-CLI:stä:

Nykyinen vakaa versio: WP-CLI 2.x series
WordPress-yhteensopivuus: 6.x (ja historiallisesti takaisin 3.7).
PHP-vaatimukset: PHP 7.4+ tai 8.x suositellaan turvallisuuden ja suorituskyvyn vuoksi.
Komentoekosysteemi: Yli 40 emokomentoa, jotka kattavat lähes kaikki WordPress-toiminnot.
Ensisijaiset käyttäjät: Kehittäjät, virastot, DevOps-insinöörit ja tehokäyttäjät, jotka hallinnoivat monimutkaisia tai useita sivustoja.
Jakelu: Pakettienhallinta: Saatavana PHAR-tiedostona, pakettienhallintaohjelmien kautta tai esiasennettuna moniin hallittuihin WordPress-isäntiin.

WP-CLI:n käytön tärkeimmät edut

Kun ymmärrät, miksi WP-CLI on olemassa, oppimiskäyrä on paljon helpompi perustella. Tässä osiossa selitetään konkreettiset edut, joiden ansiosta tämä työkalu on aikasi arvoinen.

Ajan säästö toistuvissa tehtävissä
20 liitännäisen päivittäminen WordPressin kojelaudan kautta tarkoittaa 20 sivulatausta, 20 napsautusta ja 20 edistymispalkin katselua. WP-CLI:n avulla suoritat wp plugin update --all kerran ja siirryt eteenpäin. Useita asiakassivustoja hallinnoiville toimistoille tämä ero tarkoittaa viikoittain säästettyjä tunteja.

Joukko- ja automatisoidut toiminnot
Ajattele skenaariota, jossa valmistelet 15 WooCommerce-kauppaa mustaa perjantaita varten. Sinun on päivitettävä liitännäisiä, tyhjennettävä välimuistit ja tarkistettava tietokannan eheys jokaisella sivustolla. WP-CLI:n avulla voit skriptata koko tämän jakson ja suorittaa sen kaikilla sivustoilla minuuteissa tuntien sijaan. Tärkeimpiä automaatio-ominaisuuksia ovat mm:

Kaikkien liitännäisten päivittäminen useissa asennuksissa yhdellä komentosarjalla
Käyttäjien luominen irtotavarana valmiiksi määritellyillä rooleilla
Yöllisen ylläpidon suorittaminen cronin kautta (tietokannan optimointi, ohimenevä siivous).
Identtisten WordPress-kokoonpanojen käyttöönotto uusiin ympäristöihin

Luotettavuus selainpohjaisissa toiminnoissa
Selainpohjaiset toiminnot kärsivät HTTP-aikakatkaisuista. Suurten tietokantojen tuonti epäonnistuu kesken prosessin. Haku-korvausoperaatiot vahingoittavat sarjallistettuja tietoja, kun ne tehdään raa’alla SQL:llä. WP-CLI välttää kaikki nämä ongelmat, koska se toimii suoraan palvelimella ilman aikakatkaisurajoituksia, ja sen search-replace-komento käsittelee oikein sarjallistettuja tietorakenteita.

WordPressin keskeisten järjestelmien suora hallinta
Yhdestä päätelaitteesta voit:

Vie ja tuo WordPress-tietokanta
Muokkaa wp-config.php asetuksia
Tarkasta ja laukaise wp-cron-tapahtumat
Kytke huoltotila päälle ja pois päältä
Suorita mielivaltaista PHP-koodia WordPress-kontekstissa

Vähentää wp-adminin
kuormitusta Kiireisillä tuotantopalvelimilla jokainen admin-kojelaudan sivun lataus kuluttaa resursseja. Ylläpitotoimintojen suorittaminen WP-CLI:n kautta pitää tuon kuormituksen poissa verkkopalvelimelta, millä on merkitystä suuren liikenteen aikana.

WP-CLI-vaatimukset ja tuetut ympäristöt

Ennen WP-CLI:n asentamista sinun on varmistettava, että palvelimesi tai paikallinen ympäristö täyttää perusvaatimukset. Hyvä uutinen on, että useimmat nykyaikaiset WordPress-asetukset täyttävät jo vaatimukset.

PHP-version vaatimukset:

Vähintään: PHP 5.6 (tämä on kuitenkin vanhentunut).
Suositellaan: PHP 7.4, 8.0, 8.1, 8.2, 8.3, 8.4 tai 8.5 turvallisuuden ja suorituskyvyn varmistamiseksi vuonna 2026.

WordPress-version yhteensopivuus:

Historiallinen tuki: WordPress 3.7 ja uudempi
Moderni kohde: WordPress 5.0 kautta 6.7+ nykyisille projekteille.

Käyttöjärjestelmän odotukset:

Paras tuki: UNIX-tyyppiset järjestelmät (Ubuntu 22.04 LTS, Debian 12, CentOS Stream, macOS).
Windows: (Windows Subsystem for Linux) tai natiivin PHP-asennuksen kautta.

Lisävaatimukset:

PHP käytettävissä komentorivillä ( php binäärin on oltava PATH-käytössänne).
cURL tai wget tiedoston wp-cli.phar lataamista varten.
SSH-yhteys etäpalvelimille (useimmat hallinnoidut WordPress-hosting-paketit sisältävät tämän oletusarvoisesti).

Monissa suosituissa isännöitsijöissä, kuten Kinstassa, SiteGroundissa ja DreamHostissa, WP-CLI on nyt esiasennettuna. WordPress.com sisältää myös WP-CLI:n sivustoille, joissa SSH-yhteys on käytössä.

WP-CLI:n asentaminen Linuxiin ja macOS:ään

Normaali asennustapa käyttää virallista PHAR-tiedostoa (PHP-arkisto). Tämä prosessi toimii Ubuntu-, Debian-, CentOS-, Fedora- ja macOS-päätteillä.

Vaihe 1: Lataa PHAR-tiedosto
Avaa päätteesi ja lataa wp-cli.phar käyttäen curl-ohjelmaa:

curl -O https://raw.githubusercontent.com/wp-cli/builds/gh-pages/phar/wp-cli.phar

Vaihtoehtoisesti voit käyttää wgetiä:

wget https://raw.githubusercontent.com/wp-cli/builds/gh-pages/phar/wp-cli.phar

Vaihe 2: Tarkista lataus (valinnainen mutta suositeltava)
Tarkista SHA-256-tarkistussumma WP-CLI-dokumentaatiossa julkaistun virallisen arvon perusteella varmistaaksesi, ettei tiedostoa ole peukaloitu latauksen aikana:

sha256sum wp-cli.phar

Vertaa tulostetta WP-CLI:n virallisella verkkosivustolla lueteltuun tarkistussummaan.

Vaihe 3: Testaa PHAR-tiedosto
Vahvista, että php-tiedosto toimii:

php wp-cli.phar --info

Näet tulosteen, joka näyttää WP-CLI-version, PHP-version ja järjestelmätiedot.

Vaihe 4: Tee tiedostosta suoritettava ja siirrä se PATH-osoitteeseen
Merkitse tiedosto suoritettavaksi ja siirrä se hakemistoon järjestelmän PATH-osoitteessa:

chmod +x wp-cli.phar
sudo mv wp-cli.phar /usr/local/bin/wp

Komento sudo tarvitaan yleensä, koska /usr/local/bin on järjestelmän hakemisto. Vältä WP-CLI:n asentamista pääkäyttäjänä, jos käytät sitä pääasiassa tavallisena käyttäjänä.

Vaihe 5: Tarkista maailmanlaajuinen asennus
Vahvista, että WP-CLI on nyt maailmanlaajuisesti käytettävissä:

wp --info
wp cli version

Sinun pitäisi nähdä tulosteet, jotka vahvistavat wp cli -version, PHP:n binäärin sijainnin ja käyttöjärjestelmän tiedot. Tässä vaiheessa WP-CLI on asennettu ja valmis käytettäväksi.

WP-CLI:n asentaminen Windowsissa

Windows-käyttäjillä on kaksi päätapaa: käyttää Windows Subsystem for Linux (WSL) -järjestelmää tai tehdä natiivin Windows-asennuksen. WSL tarjoaa enemmän Linuxin kaltaisen käyttökokemuksen, ja sitä suositellaan yleisesti.

Vaihtoehto 1: WSL:n käyttäminen (suositeltava)
Ota ensin WSL käyttöön Windows 10:ssä tai 11:ssä:

wsl --install

Asenna Ubuntu Microsoft Storesta ja käynnistä Ubuntun pääte. Noudata sieltä täsmälleen samoja Linuxin asennusvaiheita kuin edellisessä osassa – lataa phar-tiedosto, tee siitä suoritettava ja siirrä se osoitteeseen /usr/local/bin/wp.

Vaihtoehto 2: Natiivi Windows-asennus
Natiivia asennusta varten sinun on asennettava PHP for Windows, jonka php suoritusohjelma on saatavilla järjestelmäsi PATH-osoitteessa.

Lataa ja asenna PHP viralliselta PHP for Windows -sivustolta.
Lisää PHP-hakemisto Windowsin PATH-ympäristömuuttujaan.
Vahvista, että PHP toimii avaamalla komentorivi ja suorittamalla seuraava komento php -v

Lataa seuraavaksi WP-CLI PHAR -tiedosto:

curl -O https://raw.githubusercontent.com/wp-cli/builds/gh-pages/phar/wp-cli.phar

Windows sisältää curlin oletusarvoisesti vuodesta 2018 lähtien, joten tämän pitäisi toimia ilman lisäasetuksia. Luo kansio WP-CLI:tä varten (esim. C:\wp-cli) ja siirrä ladattu tiedosto sinne.

Luo sitten samassa kansiossa olevaan kansioon eräajotiedosto nimeltä wp.bat:

@echo off
php "C:\wp-cli\wp-cli.phar" %*

Lisää C:\wp-cli järjestelmän PATH-ympäristömuuttujaan. Avaa nyt uusi komentorivi tai PowerShell-ikkuna ja tarkista:

wp --info

Sinun pitäisi nähdä WP-CLI-version ja ympäristön tiedot, jotka vahvistavat, että WP-CLI on asennettu oikein.

WP-CLI:n peruskäyttö ja avun saaminen

Kun WP-CLI on asennettu, sinun on ymmärrettävä peruskomentomalli, ennen kuin pääset syventymään tiettyihin toimintoihin. Kaikki WP-CLI-komennot noudattavat tätä rakennetta:

wp <command> <subcommand> [options]

Komennot suoritetaan WordPress-asennushakemistosta – kansiosta, joka sisältää wp-config.php. Jos olet muualla, voit määrittää polun komennolla --path=/var/www/html/mysite.

Ympäristön tarkistaminen
Aloita vahvistamalla asetukset:

wp --info

Tässä näytetään WP-CLI-versio, PHP-versio, PHP:n binääripolku, käyttöjärjestelmä ja muita ympäristötietoja. Jos haluat nähdä vain WP-CLI-version:

wp cli version

Käytettävissä olevien komentojen tutkiminen
Voit luetella kaikki käytettävissä olevat wp cli -komennot:

wp help

Saat apua tiettyyn komentoon:

wp help plugin
wp help core update

Voit myös liittää --help mihin tahansa komentoon:

wp user --help

Ohjetuloste näytetään Unixin man-sivujen kaltaisessa hakemistossa. Poistu painamalla q.

Ensimmäiset kokeiltavat komennot:

wp core version – näyttää WordPress-version
wp plugin list – näyttää kaikki asennetut WordPress-liitännäiset ja niiden tilan
wp theme list – näyttää asennetut teemat
wp user list – listaa kaikki sivuston käyttäjät

Näillä vain lukukäyttöön tarkoitetuilla komennoilla voit tutkia WordPress-sivustoasi muuttamatta mitään, mikä on täydellinen tapa tutustua käyttöliittymään.

WordPressin asentaminen ja konfigurointi WP-CLI:n avulla

WP-CLI voi suorittaa täydellisen tuoreen WordPress-asennuksen nopeammin kuin perinteinen verkkopohjainen asennusohjelma. Tämä on erityisen arvokasta, kun käynnistät kehitysympäristöjä tai otat uusia sivustoja käyttöön ohjelmallisesti.

Edellytykset
Ennen asennuskomentojen suorittamista sinun on oltava valmis MySQL- tai MariaDB-tietokanta. Tässä esimerkissä oletetaan, että olet luonut:

Tietokannan nimi: wpsite_db
Tietokannan käyttäjä: wpsite_user
Salasana: securepassword123
Isäntä: localhost

Vaihe 1: Lataa WordPressin ydintiedostot
Siirry haluamaasi asennushakemistoon ja lataa WordPressin ydin:

wp core download

Tämä hakee uusimman WordPress-version. Voit määrittää version tai paikallisuuden:

wp core download --version=6.4.2 --locale=fr_FR

Kun lataus on valmis, näet vahvistuksen siitä, että WordPress ladattiin onnistuneesti.

Vaihe 2: Luo wp-config.php
Luo konfiguraatiotiedosto käyttämällä wp config create:

wp config create --dbname=wpsite_db --dbuser=wpsite_user --dbpass=securepassword123 --dbhost=localhost

Tämä luo täydellisen wp-config.php -osoitteen, jossa on tietokantasi tunnistetiedot ja automaattisesti luodut suojaussuolat.

Vaihe 3: Suorita asennus
Asenna nyt WordPress sivustosi tiedoilla:

wp core install --url=https://example.com --title="My New Site" --admin_user=admin --admin_password=strongpassword [email protected]

Näet viestin ”WordPress asennettu onnistuneesti” ja sivustosi on valmis käytettäväksi.

Multisite-asennus
Käytä WordPressin multisite-verkkoja varten multisite-vaihtoehtoa. WP-CLI:llä voi määrittää multisite-asennuksia:

wp core multisite-install --url=https://example.com --title="My Network" --admin_user=admin --admin_password=strongpassword [email protected]

Teemojen hallinta WP-CLI:llä

WP-CLI hoitaa kaikki teeman toiminnot ilman, että WordPressin hallintatauluun on päästävä käsiksi. Voit luetella, asentaa, aktivoida, päivittää ja poistaa teemoja suoraan päätelaitteesta.

Asennettujen teemojen luettelointi
Voit tarkastella kaikkia tällä hetkellä asennettuja teemoja:

wp theme list

Esimerkkitulos:

nimi	tila	päivitys	versio
twentytwentywentyfour	aktiivinen	none	1.0
twentytwentywentythree	inaktiivinen	none	1.2
Astra	inaktiivinen	saatavilla	4.5.0

Teeman aktivointi
Vaihda toiseen teemaan:

wp theme activate astra

Tämä muuttaa aktiivista teemaa välittömästi. Paluu oletusteemaan on hyödyllistä teemaan liittyvien ongelmien vianmäärityksessä:

wp theme activate twentytwentyfour

Uusien teemojen asentaminen
Asenna teema WordPress.orgin arkistosta:

wp theme install astra

Asenna ja aktivoi yhdellä komennolla:

wp theme install astra --activate

Teemojen päivittäminen
Päivitä tietty teema:

wp theme update astra

Tai päivitä kaikki teemat kerralla:

wp theme update --all

Teemojen poistaminen
Poista teema, jota et enää tarvitse:

wp theme delete twentytwentythree

Liitännäisten hallinta WP-CLI:llä

WP-CLI säästää eniten aikaa pluginien hallinnassa. Voit suorittaa massatoimintoja, jotka vaatisivat kymmeniä klikkauksia kojelaudassa.

Liitännäisten luettelointi

wp plugin list

Esimerkkitulos:

nimi	tila	päivitys	versio
woocommerce	aktiivinen	none	8.5.1
yoast-seo	aktiivinen	saatavilla	21.0
elementor	inaktiivinen	none	3.18.0

Lisäosien asentaminen
Asenna lisäosa sen slugin mukaan:

wp plugin install woocommerce

Asenna ja aktivoi:

wp plugin install yoast-seo --activate

Aktivointi ja deaktivointi
Aktivoi lisäosa:

wp plugin activate elementor

Deaktivoi lisäosa (hyödyllinen debuggausta varten):

wp plugin deactivate elementor

Deaktivoi kaikki liitännäiset kerralla (hengenpelastaja ”White Screen of Death” -virheenkorjauksessa):

wp plugin deactivate --all

Lisäosien päivittäminen
Päivitä tietty lisäosa:

wp plugin update yoast-seo

Päivitä kaikki liitännäiset:

wp plugin update --all

Voit myös sulkea tietyt lisäosat massapäivityksen ulkopuolelle:

wp plugin update --all --exclude=woocommerce

WordPress-ytimen päivittäminen ja korjaaminen

WordPressin pitäminen ajan tasalla on turvallisuuden kannalta kriittisen tärkeää. WP-CLI tekee tästä prosessista läpinäkyvän ja hallittavissa olevan.

Päivitysten tarkistaminen

wp core check-update

WordPressin päivittäminen
Päivitä uusimpaan versioon:

wp core update

Ydinpäivityksen jälkeen on hyvä käytäntö päivittää tietokannan skeema:

wp core update-db

Tarkistussummien tarkistaminen
Jos epäilet, että sivustoosi on murtauduttu, voit tarkistaa, että ydintiedostoja ei ole muutettu:

wp core verify-checksums

Tämä vertaa tiedostojasi WordPressin virallisen arkiston tarkistussummiin.

Ytimen uudelleenasennus
Jos tiedostot ovat vioittuneet, voit pakottaa uudelleenasennuksen vaikuttamatta sisältöön:

wp core download --force --skip-content

Sisällön, käyttäjien ja tietokannan hallinta

WP-CLI:n avulla voit olla suoraan vuorovaikutuksessa sivustosi tietojen kanssa.

Käyttäjien hallinta
Luettelo käyttäjistä:

wp user list

Luo uusi järjestelmänvalvoja:

wp user create newadmin [email protected] --role=administrator --user_pass=securepass123

Päivitä käyttäjän salasana:

wp user update 1 --user_pass=newpassword

Poista käyttäjä ja määritä hänen sisältönsä uudelleen:

wp user delete 5 --reassign=1

Tietokantatoiminnot
Vie tietokanta tiedostoon:

wp db export backup.sql

Tuo tietokanta tiedostosta:

wp db import backup.sql

Optimoi tietokanta:

wp db optimize

Avaa MySQL-konsoli, joka on suoraan yhteydessä WordPress-tietokantaan:

wp db cli

Etsi ja korvaa (Oikea tapa)

WordPress-sivuston siirtäminen uudelle verkkotunnukselle manuaalisesti on riskialtista, koska tiedot ovat usein sarjoitettuja tietokantaan. Yksinkertainen SQL-etsintä ja -korvaus rikkoo widgetit ja teema-asetukset. WP-CLI käsittelee sarjallistamisen oikein.

Vakiohaku-korvaa

wp search-replace 'http://old-domain.com' 'https://new-domain.com'

Kuivaajo (esikatselu)
Tarkista aina ennen komennon suorittamista, mikä muuttuu:

wp search-replace 'http://old-domain.com' 'https://new-domain.com' --dry-run

Vienti korvaavien tietojen kanssa
Voit viedä tietokannan niin, että tiedostossa olevat korvaavat tiedot viedään, mutta elävää tietokantaa ei kosketeta:

wp search-replace 'old.com' 'new.com' --export=migrated-db.sql

Edistynyt huolto: Cron ja Object Cache

Cron-töiden hallinta
Näytä ajastetut tapahtumat:

wp cron event list

Suorita kaikki cron-tapahtumat välittömästi:

wp cron event run --due-now

Transienttien ja välimuistin hallinta
Tyhjennä objektin välimuisti:

wp cache flush

Poista kaikki vanhentuneet siirtymät:

wp transient delete --expired

Tehtävien automatisointi skriptien avulla

Voit yhdistää WP-CLI-komentoja Bash-skripteiksi automaattista ylläpitoa varten.

Esimerkki:
Luo tiedosto nimeltä maintain.sh:

#!/bin/bash
# Update everything
wp core update
wp core update-db
wp plugin update --all
wp theme update --all

# Cleanup
wp transient delete --expired
wp cache flush
wp db optimize

echo "Maintenance complete."

Tee siitä suoritettava (chmod +x maintain.sh) ja suorita se, jotta voit suorittaa sivuston täydellisen ylläpidon muutamassa sekunnissa.

WP-CLI:n käyttäminen etänä SSH:n kautta

Sinun ei tarvitse kirjautua palvelimeen komentojen suorittamiseksi, jos määrität aliakset.

Paikallisessa wp-cli.yml -tiedostossasi:

@prod:
  ssh: [email protected]/var/www/html
@dev:
  ssh: [email protected]/var/www/html

Nyt voit suorittaa komentoja etäpalvelimella paikalliselta koneeltasi:

wp @prod plugin list
wp @dev core version

Parhaat käytännöt

Varmuuskopioi aina: Ennen irtopäivitysten tai haku-korvauskomentojen suorittamista suorita wp db export.
Käytä Dry Runia: Käytä aina ensin --dry-run.
Älä juokse Rootina: WP-CLI varoittaa sinua, jos suoritat rootina. On turvallisempaa ajaa verkkopalvelimen käyttäjänä (esim. www-data) tai omalla käyttäjätililläsi.
Testi vaiheistuksessa: Testaa päivitysskriptit siellä ja siirrä ne sitten tuotantoon.

Päätelmä

WP-CLI muuttaa WordPressin hallinnan sarjasta klikkauksia virtaviivaisiksi, skriptattaviksi toiminnoiksi. Aloittaminen yksinkertaisista komennoista, kuten versioiden tarkistamisesta ja liitännäisten listaamisesta, luo pohjan edistyneelle automaatiolle. WP-CLI:n integroiminen työnkulkuusi jo tänään säästää lukemattomia tunteja kaikissa WordPress-projekteissasi.