WP-CLI: Täielik juhend WordPressi haldamiseks käsurealt

WP-CLI on ametlik käsurea tööriist WordPressi installatsioonide haldamiseks otse terminalist, ilma et peaks avama brauserit. Kui olete kunagi veetnud pärastlõuna WordPressi halduspaneelil klõpsates, et uuendada pluginad mitmel saidil, siis teate juba, miks see tööriist on olemas.

Selles juhendis õpid kõike alates WP-CLI installimisest Linuxis, macOSis ja Windowsis kuni keeruliste hooldusülesannete automatiseerimiseni skriptide ja konfiguratsioonifailide abil. Olenemata sellest, kas haldate ühte blogi või kümneid kliendisaite, WP-CLI valdamine muudab põhjalikult teie töötamist WordPressiga.

Mida sa õpid:

• Kuidas paigaldada ja konfigureerida WP-CLI eri operatsioonisüsteemides
• Olulised käsud pluginate, teemade, kasutajate ja sisu haldamiseks
• Andmebaasioperatsioonid, sealhulgas eksport, import ja turvaline otsing-asendus
• Automatiseerimistehnikad skriptide, aliase ja cron-tööde abil
• Parimad tavad terminalist töötamise tavapäraste lõksude vältimiseks

---

Mis on WP-CLI? (Kõigepealt kiire selgitus)

WP-CLI tähendab WordPressi käsurea liidest – avatud lähtekoodiga tööriista, mis võimaldab teil hallata WordPressi saite täielikult terminalist. Selle asemel, et logida sisse wp-admin’i ja navigeerida menüüdes, käivitad käske nagu wp plugin update --all ja vaatad, kuidas kogu su pluginate virn sekunditega uuendatakse.

Projekt sai alguse umbes 2011. aastal ja selle lõid arendajad, kes soovisid kiiremat viisi WordPressi haldamiseks mastaabis. 2017. aastal kolis see ametliku WordPress.org-i alla ja seda hooldab nüüd pühendunud meeskond, kuhu kuuluvad ka Alain Schlesser ja Daniel Bachhuber.

Siin on kõik, mida pead WP-CLI kohta teadma:

• Praegune stabiilne versioon: WP-CLI 2.x seeria
• WordPressi ühilduvus: 6.x (ja ajalooliselt tagasi 3.7).
• PHP nõuded: PHP 7.4+ või 8.x soovitatav turvalisuse ja jõudluse tagamiseks.
• Käskude ökosüsteem: Üle 40 vanemkäsu, mis hõlmavad praktiliselt kõiki WordPressi toiminguid.
• Peamised kasutajad: Arendajad, agentuurid, DevOps insenerid ja võimekad kasutajad, kes haldavad keerulisi või mitut saiti.
• Levik: PHAR-failina, paketihaldurite kaudu või eelinstalleerituna paljudes hallatud WordPressi hostides.

WP-CLI kasutamise peamised eelised

Kui sa mõistad, miks WP-CLI on olemas, on õppimise kõverust palju lihtsam põhjendada. Selles jaotises selgitatakse konkreetseid eeliseid, mis muudavad selle tööriista teie aega väärtuslikuks.

Aja kokkuhoid korduvatelt ülesannetelt
20 pistikprogrammi uuendamine WordPressi armatuurlaua kaudu tähendab 20 lehekülje laadimist, 20 klõpsu ja 20 eduriba vaatamist. WP-CLI abil käivitate wp plugin update --all üks kord ja liigute edasi. Mitut kliendisaiti haldavate agentuuride jaoks tähendab see erinevus igal nädalal kokkuhoitud tundide arvu.

Massilised ja automatiseeritud toimingud
Mõelge stsenaariumile, kus te valmistate 15 WooCommerce’i poodi mustaks reedeks ette. Peate uuendama pluginad, puhastama vahemälu ja kontrollima andmebaasi terviklikkust igal saidil. WP-CLI võimaldab teil skriptida kogu seda jada ja teostada seda kõigil saitidel minutite, mitte tundide jooksul. Peamised automatiseerimisvõimalused hõlmavad järgmist:

• Kõikide pluginate uuendamine mitme paigalduse puhul ühe skripti abil
• Kasutajate loomine massiliselt koos eelnevalt määratletud rollidega
• Öiste hooldustööde teostamine croni kaudu (andmebaasi optimeerimine, ajutine puhastamine)
• Identsete WordPressi konfiguratsioonide juurutamine uutesse keskkondadesse

Usaldusväärsus brauseripõhiste toimingute puhul
Brauseriga tehtavad toimingud tabavad HTTP-aegumist. Suurte andmebaaside importimine ebaõnnestub keset protsessi. Otsingu-asendusoperatsioonid rikuvad seeriaviisilisi andmeid, kui neid tehakse toore SQL-iga. WP-CLI väldib kõiki neid probleeme, sest see töötab otse serveris ilma ajapiiranguteta ja selle otsingu-asendamiskäsk käitleb korrektselt serialiseeritud andmestruktuure.

Otsene kontroll WordPressi põhisüsteemide üle
Ühelt terminalilt saate:

• WordPressi andmebaasi eksportimine ja importimine
• Muuda wp-config.php seadeid
• Kontrollida ja käivitada wp-cron sündmusi
• Hooldusrežiimi sisse- ja väljalülitamine
• Käivitada suvaline PHP-kood WordPressi kontekstis

Vähendatud koormus wp-adminile
Kiirete tootmisserverite puhul kulutab iga admin-töölaua lehekülje koormus ressursse. Hooldustoimingute teostamine WP-CLI kaudu hoiab selle koormuse veebiserverilt eemal, mis on suure liiklusega perioodidel oluline.

WP-CLI nõuded ja toetatud keskkonnad

Enne WP-CLI paigaldamist peate kinnitama, et teie server või kohalik keskkond vastab põhinõuetele. Hea uudis on see, et enamik kaasaegseid WordPressi seadistusi juba vastab nõuetele.

Nõuded PHP versioonile:

• Minimaalne: PHP 5.6 (kuigi see on vananenud)
• Soovitatav: PHP 7.4, 8.0, 8.1, 8.2, 8.3, 8.4 või 8.5 turvalisuse ja jõudluse tagamiseks 2026. aastal.

WordPressi versiooni ühilduvus:

• Ajalooline toetus: WordPress 3.7 ja uuemad versioonid: WordPress 3.7 ja uuemad
• Kaasaegne sihtmärk: WordPress 5.0 kuni 6.7+ praeguste projektide jaoks.

Operatsioonisüsteemi ootused:

• Parim toetus: UNIX-taolised süsteemid (Ubuntu 22.04 LTS, Debian 12, CentOS Stream, macOS).
• Windows: WSL (Windows Subsystem for Linux) või PHP algupärase installeerimise kaudu.

Täiendavad nõuded:

• PHP on käsurealt saadaval ( php binaarsüsteem peab olema teie PATH-is).
• cURL või wget faili wp-cli.phar allalaadimiseks.
• SSH-juurdepääs kaugserveritele (enamik hallatavaid WordPressi hostingupakette sisaldab seda vaikimisi)

Paljudel populaarsetel veebimajutajatel, nagu Kinsta, SiteGround ja DreamHost, on WP-CLI nüüdseks eelinstallitud. WordPress.com sisaldab WP-CLI ka saitidele, millel on lubatud SSH-juurdepääs.

Kuidas paigaldada WP-CLI Linuxi ja macOS-i

Standardne paigaldusmeetod kasutab ametlikku PHAR (PHP Archive) faili. See protsess töötab Ubuntu, Debian, CentOS, Fedora ja macOS terminalidel.

Samm 1: PHAR-faili allalaadimine
Avage terminal ja laadige alla wp-cli.phar, kasutades curl-i:

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

Teise võimalusena kasutage wget:

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

2. samm: Kontrolli allalaadimist (vabatahtlik, kuid soovitatav)
Kontrollige SHA-256 kontrollsummat WP-CLI dokumentatsioonis avaldatud ametliku väärtusega, et veenduda, et faili ei ole allalaadimise ajal võltsitud:

sha256sum wp-cli.phar

Võrdle väljundit WP-CLI ametlikul veebisaidil loetletud kontrollsummaga.

3. samm: testige PHAR-faili
Kinnitage, et php-fail töötab:

php wp-cli.phar --info

Te peaksite nägema väljundit, mis näitab WP-CLI versiooni, PHP versiooni ja süsteemiteavet.

Samm 4: Tee see käivitatavaks ja liiguta PATH-i
Märgi fail käivitatavaks ja liiguta see kataloogi sinu süsteemi PATH-is:

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

Käsk sudo on tavaliselt vajalik, sest /usr/local/bin on süsteemikataloog. Vältige WP-CLI installimist root’ina, kui te kasutate seda peamiselt tavakasutajana.

5. samm: Kontrollida globaalset paigaldust
Kinnitage, et WP-CLI on nüüd globaalselt saadaval:

wp --info
wp cli version

Te peaksite nägema väljundit, mis kinnitab wp cli versiooni, PHP binaarkoodi asukohta ja operatsioonisüsteemi andmeid. Sel hetkel on WP-CLI paigaldatud ja kasutusvalmis.

Kuidas paigaldada WP-CLI Windowsis

Windowsi kasutajatel on kaks peamist võimalust: Windows Subsystem for Linux (WSL) kasutamine või Windowsi algupärase installeerimise seadistamine. WSL pakub rohkem Linuxi sarnast kogemust ja on üldiselt soovitatav.

Võimalus 1: WSL-i kasutamine (soovitatav)
Kõigepealt aktiveerige WSL Windows 10 või 11:

wsl --install

Installige Ubuntu Microsoft Store’ist, seejärel käivitage Ubuntu terminal. Sealt edasi järgige täpselt samu Linuxi paigaldamise samme, mis on kirjeldatud eelmises jaotises – laadige alla phar-fail, tehke see käivitatavaks ja viige see aadressile /usr/local/bin/wp.

Võimalus 2: Native Windows Installation
Native setup’i jaoks on vaja, et PHP for Windows oleks installeeritud ja käivitatav php oleks saadaval teie süsteemi PATH-is.

1. Laadige PHP alla ja installige see ametlikust PHP for Windows veebilehelt.
2. Lisage PHP kataloog oma Windowsi PATH keskkonnamuutujale
3. Kinnitage, et PHP töötab, avades Command Prompt ja käivitades järgmise programmi php -v

Seejärel laadige alla WP-CLI PHAR fail:

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

Windows sisaldab curl’i vaikimisi alates 2018. aastast, seega peaks see toimima ilma täiendavate seadistusteta. Loo WP-CLI jaoks kaust (nt C:\wp-cli) ja liiguta allalaaditud fail sinna.

Seejärel looge samasse kausta batch wrapper fail nimega wp.bat:

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

Lisage C:\wp-cli oma süsteemi PATH keskkonnamuutujasse. Nüüd avage uus Command Prompt või PowerShell aken ja kontrollige:

wp --info

Sa peaksid nägema WP-CLI versiooni ja keskkonnaandmeid, mis kinnitavad, et WP-CLI on korralikult paigaldatud.

WP-CLI kasutamine ja abi saamine

Kui WP-CLI on paigaldatud, peate enne konkreetsete toimingute tegemisse sukeldumist mõistma põhilist käsumustrit. Kõik WP-CLI käsud järgivad seda struktuuri:

wp <command> <subcommand> [options]

Käsklusi täidetakse WordPressi paigalduskataloogist – kaustast, mis sisaldab wp-config.php. Kui olete mujal, saate te määrata teekonna koos --path=/var/www/html/mysite.

Keskkonna kontrollimine
Alustage oma seadistuse kinnitamisest:

wp --info

See näitab teie WP-CLI versiooni, PHP versiooni, PHP binaarset teekonda, operatsioonisüsteemi ja muid keskkonnaandmeid. Vaadata ainult WP-CLI versiooni:

wp cli version

Kättesaadavate käskude uurimine
Kõigi olemasolevate wp cli käskude loetlemiseks:

wp help

Konkreetse käsu kohta abi saamiseks:

wp help plugin
wp help core update

Samuti saate lisada igale käsule --help:

wp user --help

Abiväljund kuvatakse Unixi man-lehtede sarnaselt. Väljumiseks vajutage q.

Esimesed käsud, mida proovida:

• wp core version – kuvab teie WordPressi versiooni
• wp plugin list – näitab kõiki paigaldatud WordPressi pistikprogramme koos nende olekuga
• wp theme list – näitab paigaldatud teemasid
• wp user list – loetleb kõik saidi kasutajad

Need ainult lugemiseks mõeldud käsud võimaldavad teil uurida oma WordPressi saiti ilma midagi muutmata, mis on täiuslik, et saada mugavaks kasutajaliidesega.

WordPressi paigaldamine ja konfigureerimine WP-CLI abil

WP-CLI suudab täieliku värske WordPressi paigalduse teha kiiremini kui traditsiooniline veebipõhine paigaldaja. See on eriti väärtuslik arenduskeskkondade käivitamisel või uute saitide programmeeritud juurutamisel.

Eeltingimused
Enne paigalduskäskude käivitamist peab olema valmis MySQL- või MariaDB-andmebaas. Selle näite puhul eeldame, et olete loonud:

• Andmebaasi nimi: wpsite_db
• Andmebaasi kasutaja: wpsite_user
• Parool: securepassword123
• Peremees: localhost

1. samm: Lae alla WordPressi põhifailid
Mine soovitud paigalduskataloogi ja lae alla WordPressi põhifailid:

wp core download

See toob välja WordPressi uusima versiooni. Versiooni või asukoha määramiseks:

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

Pärast lõpetamist näete kinnitust, et WordPress on edukalt alla laaditud.

Samm 2: Loo wp-config.php
Loo konfiguratsioonifail kasutades wp config create:

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

See genereerib täieliku wp-config.php koos teie andmebaasi volituste ja automaatselt genereeritud turvasooladega.

3. samm: Käivita paigaldus
Nüüd paigalda WordPress koos oma saidi andmetega:

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

Sa näed sõnumit “WordPress on edukalt paigaldatud” ja sinu sait on valmis kasutamiseks.

Multisite’i paigaldus
WordPressi multisite’i võrgustike jaoks kasuta multisite’i varianti. WP-CLI abil saab konfigureerida multisite’i paigaldusi:

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

Teemade haldamine WP-CLI-ga

WP-CLI tegeleb kõigi teemaga seotud toimingutega, ilma et oleks vaja juurdepääsu WordPressi halduspaneelile. Teemasid saab loetleda, paigaldada, aktiveerida, uuendada ja kustutada otse terminalist.

Installeeritud teemade loend
Kõikide hetkel paigaldatud teemade vaatamiseks:

wp theme list

Näidistulemus:

nimi	staatus	uuendus	versioon
twentytwentyfour	aktiivne	none	1.0
twentytwentythree	mitteaktiivne	none	1.2
astra	mitteaktiivne	saadaval	4.5.0

Teema aktiveerimine
Üleminek teisele teemale:

wp theme activate astra

See muudab kohe aktiivset teemat. Tagasi lülitamine vaikimisi teemale on kasulik teemaga seotud probleemide lahendamiseks:

wp theme activate twentytwentyfour

Uute teemade paigaldamine
Paigalda teema WordPress.org repositooriumist:

wp theme install astra

Paigaldage ja aktiveerige ühe käsuga:

wp theme install astra --activate

Teemade uuendamine
Konkreetse teema uuendamine:

wp theme update astra

Või uuendage kõiki teemasid korraga:

wp theme update --all

Teemade kustutamine
Eemaldage teema, mida te enam ei vaja:

wp theme delete twentytwentythree

Pluginate haldamine WP-CLI-ga

WP-CLI säästab kõige rohkem aega pluginate haldamisel. Saate teha hulgioperatsioone, milleks armatuurlaual kuluksid kümneid klõpsamisi.

Pluginate loetlemine

wp plugin list

Näidistulemus:

nimi	staatus	uuendus	versioon
woocommerce	aktiivne	none	8.5.1
yoast-seo	aktiivne	saadaval	21.0
elementor	mitteaktiivne	none	3.18.0

Pluginate paigaldamine
Paigaldage plugin selle slug’i järgi:

wp plugin install woocommerce

Paigaldage ja aktiveerige:

wp plugin install yoast-seo --activate

Aktiveerimine ja deaktiveerimine
Aktiveerige plugin:

wp plugin activate elementor

Deaktiveerida plugin (kasulik silumiseks):

wp plugin deactivate elementor

Deaktiveeri kõik pluginad korraga (päästab “White Screen of Death” silumise):

wp plugin deactivate --all

Pluginate uuendamine
Konkreetse plugina uuendamine:

wp plugin update yoast-seo

Uuendage kõiki pistikprogramme:

wp plugin update --all

Te saate ka teatud pistikprogrammid massuuendusest välja jätta:

wp plugin update --all --exclude=woocommerce

WordPressi tuumiku uuendamine ja parandamine

WordPressi uuendamine on turvalisuse seisukohalt kriitilise tähtsusega. WP-CLI muudab selle protsessi läbipaistvaks ja kontrollitavaks.

Uuenduste kontrollimine

wp core check-update

WordPressi uuendamine
Värskenda uusimale versioonile:

wp core update

Pärast tuumiku uuendamist on hea tava uuendada andmebaasi skeemi:

wp core update-db

Kontrollsummade kontrollimine
Kui kahtlustate, et teie veebilehte on häkitud, saate kontrollida, et põhifaile ei ole muudetud:

wp core verify-checksums

See võrdleb teie faile WordPressi ametliku repositooriumi kontrollsummadega.

Core
uuesti installimine Kui failid on rikutud, saate sundida uuesti installimist, ilma et see mõjutaks teie sisu:

wp core download --force --skip-content

Sisu, kasutajate ja andmebaasi haldamine

WP-CLI võimaldab teil oma saidi andmetega otse suhelda.

Kasutajate haldamine
Kasutajate loetelu:

wp user list

Looge uus administraator:

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

Kasutaja parooli uuendamine:

wp user update 1 --user_pass=newpassword

Kustutage kasutaja ja määrake tema sisu uuesti:

wp user delete 5 --reassign=1

Andmebaasi toimingud
Andmebaasi eksportimine faili:

wp db export backup.sql

Andmebaasi importimine failist:

wp db import backup.sql

Andmebaasi optimeerimine:

wp db optimize

Avage MySQLi konsool, mis on otse ühendatud teie WordPressi andmebaasiga:

wp db cli

Otsimine ja asendamine (õige viis)

WordPressi saidi käsitsi uude domeeni viimine on riskantne, sest andmed on sageli andmebaasis seeriaviisiliselt salvestatud. Lihtne SQL-i leidmine ja asendamine rikub vidinaid ja teemavalikuid. WP-CLI käsitleb serialiseerimist korrektselt.

Standardne otsing-asendus

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

Kuivkäik (eelvaade)
Kontrollige alati enne käsu käivitamist, mis muutub:

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

Eksportimine koos asendustega
Saate eksportida andmebaasi koos failis tehtud asendustega, jättes live-andmebaasi muutmata:

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

Täiustatud hooldus: Cron ja objektide vahemälu

Cron-tööde haldamine
Vaadake planeeritud sündmusi:

wp cron event list

Käivita kõik vajalikud cron-sündmused kohe:

wp cron event run --due-now

Transientide ja vahemälu haldamine
Objektide vahemälu tühjendamine:

wp cache flush

Kustuta kõik aegunud transiendid:

wp transient delete --expired

Ülesannete automatiseerimine skriptidega

WP-CLI käske saab kombineerida Bash-skriptideks, et automatiseeritud hooldustööd teha.

Näide: Nädalane hooldusskript
Loo fail nimega 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."

Tehke see käivitatavaks (chmod +x maintain.sh) ja käivitage see, et teostada saidi täielikku hooldust sekundite jooksul.

WP-CLI kasutamine eemalt SSH kaudu

Te ei pea käskude käivitamiseks serverisse sisse logima, kui te seadistate aliase.

Teie kohalikus failis wp-cli.yml:

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

Nüüd saate oma kohalikust masinast kaugserveri käske käivitada:

wp @prod plugin list
wp @dev core version

Parimad tavad

• Alati varundada: Enne hulgiuuenduste või otsingu-asenduskäskude käivitamist käivitage wp db export.
• Kasutage Dry Run: Kasutage alati esmalt --dry-run.
• Ärge kandideerige Rootina: WP-CLI hoiatab teid, kui käivitate root’ina. Ohutum on käivitada veebiserveri kasutajana (nt www-data) või oma konkreetse kasutajakontoga.
• Testi staadiumis: Kasutage WP-CLI-d, et kloonida oma tootmissivusto staging’ile, testige seal oma uuendusskripte ja seejärel rakendage need tootmisesse.

Kokkuvõte

WP-CLI muudab WordPressi haldamise rea klõpsude seeriast sujuvaks, skripteeritavaks toiminguks. Alustades lihtsatest käskudest, nagu versioonide kontrollimine ja pluginate loetlemine, luuakse alus täiustatud automatiseerimiseks. WP-CLI integreerimine teie töövoogudesse juba täna säästab teie WordPressi projektides lugematuid tunde.