WP-CLI: Popoln vodnik za upravljanje WordPressa iz ukazne vrstice

WP-CLI je uradno orodje ukazne vrstice za upravljanje namestitev WordPressa neposredno iz terminala, ne da bi odprli brskalnik. Če ste že kdaj preživeli popoldne s klikanjem po nadzorni plošči upravitelja WordPressa, da bi posodobili vtičnike na več spletnih mestih, že veste, zakaj to orodje obstaja.

V tem vodniku boste izvedeli vse od namestitve WP-CLI v operacijske sisteme Linux, macOS in Windows do avtomatizacije zapletenih vzdrževalnih opravil s skriptami in konfiguracijskimi datotekami. Ne glede na to, ali upravljate en blog ali več deset strankinih spletnih mest, bo obvladovanje WP-CLI temeljito spremenilo vaše delo z WordPressom.

Kaj se boste naučili:

• Kako namestiti in konfigurirati WP-CLI v različnih operacijskih sistemih
• Bistveni ukazi za upravljanje vtičnikov, tem, uporabnikov in vsebine
• Operacije podatkovne zbirke, vključno z izvozom, uvozom in varnim iskanjem ter nadomeščanjem.
• Tehnike avtomatizacije z uporabo skript, aliasov in delovnih mest cron
• Najboljše prakse za izogibanje pogostim pastem pri delu s terminala

---

Kaj je WP-CLI? (Najprej kratka razlaga)

WP-CLI je kratica za WordPress Command Line Interface – odprtokodno orodje, s katerim lahko spletna mesta WordPress v celoti upravljate iz terminala. Namesto da bi se prijavili v wp-admin in brskali po menijih, zaženete ukaze, kot je wp plugin update --all, in v nekaj sekundah opazujete, kako se posodobi celoten sveženj vtičnikov.

Projekt se je začel okoli leta 2011, ustvarili pa so ga razvijalci, ki so želeli hitrejši način upravljanja WordPressa v velikem obsegu. Leta 2017 je prešel pod uradno okrilje WordPress.org, zdaj pa ga vzdržuje predana ekipa sodelavcev, vključno z Alainom Schlesserjem in Danielom Bachhuberjem.

Tukaj je vse, kar morate vedeti o WP-CLI:

• Trenutna stabilna različica: WP-CLI serije 2.x
• Združljivost z WordPressom: Deluje z WordPress 5.x do 6.x (in zgodovinsko nazaj do 3.7)
• Zahteve PHP: PHP 7.4+ ali 8.x priporočljivo zaradi varnosti in zmogljivosti
• Ekosistem ukazov: Več kot 40 nadrejenih ukazov, ki pokrivajo praktično vse operacije WordPressa
• Glavni uporabniki: Razvijalci, agencije, inženirji DevOps in izkušeni uporabniki, ki upravljajo kompleksna ali več spletnih mest
• Razširjenost: Na voljo kot datoteka PHAR, prek upraviteljev paketov ali predhodno nameščena na številnih upravljanih gostiteljih WordPress

Glavne prednosti uporabe WP-CLI

Ko enkrat razumete, zakaj WP-CLI obstaja, je krivuljo učenja veliko lažje upravičiti. V tem poglavju so pojasnjene konkretne prednosti, zaradi katerih je to orodje vredno vašega časa.

Prihranek časa pri ponavljajočih se opravilih
Posodobitev 20 vtičnikov prek nadzorne plošče WordPress pomeni 20 nalaganj strani, 20 klikov in spremljanje 20 vrstic napredka. Z WP-CLI enkrat zaženete wp plugin update --all in greste naprej. Za agencije, ki upravljajo več strankinih spletnih mest, ta razlika pomeni prihranjene ure vsak teden.

Množične in avtomatizirane operacije
Razmislite o scenariju, v katerem za črni petek pripravljate 15 trgovin WooCommerce. Na vsakem spletnem mestu morate posodobiti vtičnike, počistiti predpomnilnike in preveriti celovitost podatkovne zbirke. WP-CLI vam omogoča, da celotno zaporedje napišete v scenarij in ga izvedete na vseh spletnih mestih v nekaj minutah in ne urah. Ključne zmožnosti avtomatizacije vključujejo:

• Posodabljanje vseh vtičnikov v več namestitvah z eno samo skripto
• Množično ustvarjanje uporabnikov z vnaprej določenimi vlogami
• Izvajanje nočnega vzdrževanja prek crona (optimizacija podatkovne baze, prehodno čiščenje)
• Nameščanje enakih konfiguracij WordPressa v nova okolja

Zanesljivost operacij v brskalniku
Pri operacijah v brskalniku prihaja do časovnih omejitev HTTP. Veliki uvozi podatkovnih zbirk ne uspejo sredi postopka. Operacije iskanja in nadomeščanja poškodujejo serializirane podatke, če se izvajajo s surovim SQL. WP-CLI se izogne vsem tem težavam, ker deluje neposredno v strežniku brez omejitev časovnega zamika, njegov ukaz search-replace pa pravilno obdeluje serializirane podatkovne strukture.

Neposreden nadzor nad osrednjimi sistemi WordPressa
Z enega terminala lahko:

• Izvoz in uvoz podatkovne baze WordPress
• Spreminjanje nastavitev wp-config.php
• Preglejte in sprožite dogodke wp-cron
• Vklop in izklop načina vzdrževanja
• Zagon poljubne kode PHP v kontekstu WordPressa

Manjša obremenitev wp-admin
Na zasedenih produkcijskih strežnikih vsako nalaganje strani upravljalne plošče porabi vire. Z izvajanjem vzdrževalnih operacij prek WP-CLI se ta obremenitev razbremeni spletni strežnik, kar je pomembno v obdobjih velikega prometa.

WP-CLI Zahteve in podprta okolja

Pred namestitvijo WP-CLI morate preveriti, ali vaš strežnik ali lokalno okolje izpolnjuje osnovne zahteve. Dobra novica je, da večina sodobnih namestitev WordPressa že izpolnjuje te pogoje.

Zahteve za različico PHP:

• Najmanj: PHP 5.6 (čeprav je zastarel)
• Priporočljivo: PHP 7.4, 8.0, 8.1, 8.2, 8.3, 8.4 ali 8.5 za varnost in zmogljivost v letu 2026

Združljivost z različicami WordPressa:

• Zgodovinska podpora: WordPress 3.7 in novejše
• Sodobni cilj: WordPress 5.0 do 6.7+ za trenutne projekte

Pričakovanja operacijskega sistema:

• Najboljša podpora: (Ubuntu 22.04 LTS, Debian 12, CentOS Stream, macOS)
• Okna: Podprto prek WSL (podsistem Windows za Linux) ali lastne namestitve PHP

Dodatne zahteve:

• PHP je na voljo v ukazni vrstici (binarni strežnik php mora biti v vaši poti PATH).
• cURL ali wget za prenos datoteke wp-cli.phar
• Dostop SSH za oddaljene strežnike (večina upravljanih načrtov gostovanja WordPress to privzeto vključuje).

Številni priljubljeni gostitelji, kot so Kinsta, SiteGround in DreamHost, imajo zdaj prednameščen WP-CLI. Tudi WordPress.com vključuje WP-CLI za spletna mesta z omogočenim dostopom SSH.

Kako namestiti WP-CLI na Linux in macOS

Standardni način namestitve uporablja uradno datoteko PHAR (arhiv PHP). Ta postopek deluje na terminalih Ubuntu, Debian, CentOS, Fedora in macOS.

Korak 1: Prenos datoteke PHAR
Odprite terminal in prenesite wp-cli.phar z uporabo curla:

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

Uporabite tudi program wget:

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

Korak 2: Preverite prenos (neobvezno, vendar priporočljivo)
Preverite kontrolno vsoto SHA-256 glede na uradno vrednost, objavljeno v dokumentaciji WP-CLI, da se prepričate, da datoteka med prenosom ni bila zlorabljena:

sha256sum wp-cli.phar

Primerjajte rezultat s kontrolno vsoto, navedeno na uradni spletni strani WP-CLI.

Korak 3: Preizkusite datoteko PHAR
Potrdite, da php datoteka deluje:

php wp-cli.phar --info

Prikazati se morajo podatki o različici WP-CLI, različici PHP in sistemskih informacijah.

Korak 4: Naredite jo izvršljivo in jo premaknite v imenik PATH
Datoteko označite kot izvršljivo in jo premaknite v imenik v sistemskem imeniku PATH:

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

Ukaz sudo je običajno potreben, ker je /usr/local/bin sistemski imenik. Izogibajte se namestitvi WP-CLI kot root, če ga boste večinoma uporabljali kot običajni uporabnik.

5. korak: Preveri globalno namestitev
Potrdi, da je WP-CLI zdaj globalno na voljo:

wp --info
wp cli version

Videli bi morali izhod, ki potrjuje različico wp cli, binarno lokacijo PHP in podrobnosti o operacijskem sistemu. Na tej točki je WP-CLI nameščen in pripravljen za uporabo.

Kako namestiti WP-CLI v operacijski sistem Windows

Uporabniki operacijskega sistema Windows imajo dve glavni možnosti: uporabo podsistema Windows za Linux (WSL) ali vzpostavitev lastne namestitve operacijskega sistema Windows. WSL zagotavlja bolj podobno izkušnjo kot Linux in je na splošno priporočljiv.

Možnost 1: uporaba WSL (priporočeno)
Najprej omogočite WSL v operacijskem sistemu Windows 10 ali 11:

wsl --install

Namestite Ubuntu iz trgovine Microsoft Store in zaženite terminal Ubuntu. Od tam sledite popolnoma enakim korakom namestitve Linuxa, opisanim v prejšnjem razdelku – prenesite datoteko phar, jo naredite izvršljivo in jo premaknite v /usr/local/bin/wp.

Možnost 2: Nativna namestitev za Windows
Za nativno namestitev morate imeti nameščen PHP za Windows z izvršnim programom php, ki je na voljo v sistemski poti PATH.

1. Prenesite in namestite PHP z uradnega spletnega mesta PHP za Windows
2. Dodajte imenik PHP v spremenljivko okolja Windows PATH
3. Potrdite delovanje PHP tako, da odprete ukazno vrstico in zaženete php -v

Nato prenesite datoteko WP-CLI PHAR:

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

Windows od leta 2018 privzeto vključuje curl, zato bi to moralo delovati brez dodatnih nastavitev. Ustvarite mapo za WP-CLI (npr. C:\wp-cli) in vanjo premaknite preneseno datoteko.

Nato v isti mapi ustvarite datoteko za ovijanje serije z imenom wp.bat:

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

Dodajte C:\wp-cli v sistemsko okoljsko spremenljivko PATH. Zdaj odprite novo okno ukazne vrstice ali PowerShell in preverite:

wp --info

Videli boste različico WP-CLI in podatke o okolju, ki potrjujejo, da je WP-CLI pravilno nameščen.

Osnovna uporaba WP-CLI in pridobivanje pomoči

Z nameščenim WP-CLI morate razumeti osnovni vzorec ukazov, preden se lotite posebnih operacij. Vsi ukazi WP-CLI imajo to strukturo:

wp <command> <subcommand> [options]

Ukazi se izvajajo v imeniku namestitve WordPressa – v mapi, ki vsebuje wp-config.php. Če ste drugje, lahko pot določite s --path=/var/www/html/mysite.

Preverjanje okolja
Najprej potrdite svojo nastavitev:

wp --info

Prikaže različico WP-CLI, različico PHP, binarno pot PHP, operacijski sistem in druge podrobnosti o okolju. Če želite prikazati samo različico WP-CLI:

wp cli version

Raziskovanje razpoložljivih ukazov
Seznam vseh razpoložljivih ukazov wp cli:

wp help

Za pomoč pri določenem ukazu:

wp help plugin
wp help core update

Kateremu koli ukazu lahko dodate tudi --help:

wp user --help

Izpis pomoči se prikaže v pagerju, podobnem stranem priročnika Unix. Za izhod pritisnite q.

Prvi ukazi, ki jih poskusite:

• wp core version – prikaže vašo različico WordPressa
• wp plugin list – prikaže vse nameščene vtičnike WordPress z njihovim stanjem
• wp theme list – prikazuje nameščene teme
• wp user list – seznam vseh uporabnikov na spletnem mestu.

S temi ukazi za branje lahko raziskujete svoje spletno mesto WordPress, ne da bi kar koli spremenili, kar je idealno za spoznavanje vmesnika.

Namestitev in konfiguriranje WordPressa z WP-CLI

WP-CLI lahko opravi popolno svežo namestitev WordPressa hitreje kot običajni spletni namestitveni program. To je še posebej dragoceno pri vzpostavljanju razvojnih okolij ali programski namestitvi novih spletnih mest.

Predpogoji
Pred zagonom namestitvenih ukazov morate pripraviti podatkovno zbirko MySQL ali MariaDB. Za ta primer predpostavimo, da ste ustvarili:

• Ime zbirke podatkov: wpsite_db
• Uporabnik zbirke podatkov: wpsite_user
• Geslo: securepassword123
• Gostitelj: localhost

Korak 1: Prenesite osnovne datoteke WordPressa
Pojdite v želeni namestitveni imenik in prenesite WordPress core:

wp core download

S tem pridobite najnovejšo različico WordPressa. Navedba različice ali lokalnega okolja:

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

Po zaključku boste videli potrditev, da je bil WordPress uspešno prenesen.

Korak 2: Ustvarite wp-config.php
Ustvarite konfiguracijsko datoteko z uporabo wp config create:

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

Tako se ustvari celoten naslov wp-config.php s poverilnicami podatkovne zbirke in samodejno ustvarjenimi varnostnimi solmi.

Korak 3: Zaženite namestitev
Zdaj namestite WordPress s podatki o svojem spletnem mestu:

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

Prikazalo se bo sporočilo “WordPress je uspešno nameščen” in vaše spletno mesto je pripravljeno za uporabo.

Namestitev na več spletnih mest
Za omrežja WordPress z več spletnimi mesti uporabite različico multisite. WP-CLI lahko konfigurira namestitve multisite z:

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

Upravljanje tem z WP-CLI

WP-CLI izvaja vse operacije teme, ne da bi za to potreboval dostop do nadzorne plošče upravitelja WordPressa. Teme lahko naštejete, namestite, aktivirate, posodobite in izbrišete neposredno iz terminala.

Seznam nameščenih tem
Če si želite ogledati vse trenutno nameščene teme:

wp theme list

Izhodni vzorec:

ime	status	posodobitev	različica
twentytwentywentyfour	aktivni	none	1.0
twentytwentythree	neaktivni	none	1.2
astra	neaktivni	na voljo	4.5.0

Aktivacija teme
Preklopite na drugo temo:

wp theme activate astra

To takoj spremeni aktivno temo. Preklop nazaj na privzeto temo je uporaben pri odpravljanju težav, povezanih s temami:

wp theme activate twentytwentyfour

Namestitev novih tem
Namestite temo iz skladišča WordPress.org:

wp theme install astra

Namestite in aktivirajte z enim ukazom:

wp theme install astra --activate

Posodabljanje tem
Posodobitev določene teme:

wp theme update astra

Ali pa posodobite vse teme naenkrat:

wp theme update --all

Brisanje tem
Odstranite temo, ki je ne potrebujete več:

wp theme delete twentytwentythree

Upravljanje vtičnikov z WP-CLI

Upravljanje vtičnikov je področje, kjer WP-CLI prihrani največ časa. V nadzorni plošči lahko izvedete množične operacije, za katere bi potrebovali več deset klikov.

Dodajanje vtičnikov na seznam

wp plugin list

Izhodni vzorec:

ime	status	posodobitev	različica
woocommerce	aktivni	none	8.5.1
yoast-seo	aktivni	na voljo	21.0
elementor	neaktivni	none	3.18.0

Nameščanje vtičnikov
Vtičnik namestite po njegovem slugu:

wp plugin install woocommerce

Namestite in aktivirajte:

wp plugin install yoast-seo --activate

Aktivacija in deaktivacija
Aktivacija vtičnika:

wp plugin activate elementor

Deaktiviranje vtičnika (uporabno za odpravljanje napak):

wp plugin deactivate elementor

Deaktivirajte vse vtičnike naenkrat (rešitelj za odpravljanje napak na belem zaslonu smrti):

wp plugin deactivate --all

Posodabljanje vtičnikov
Posodobitev določenega vtičnika:

wp plugin update yoast-seo

Posodobite vse vtičnike:

wp plugin update --all

Iz množične posodobitve lahko izključite tudi določene vtičnike:

wp plugin update --all --exclude=woocommerce

Posodabljanje in popravljanje jedra WordPressa

Posodabljanje WordPressa je ključnega pomena za varnost. WP-CLI omogoča, da je ta postopek pregleden in nadzorovan.

Preverjanje posodobitev

wp core check-update

Posodabljanje WordPressa
Posodobite na najnovejšo različico:

wp core update

Po posodobitvi jedra je dobro posodobiti shemo podatkovne zbirke:

wp core update-db

Preverjanje kontrolnih vsot
Če sumite, da je bilo vaše spletno mesto napadeno, lahko preverite, ali osnovne datoteke niso bile spremenjene:

wp core verify-checksums

Ta primerja vaše datoteke z uradnimi kontrolnimi vsotami iz skladišča WordPress.

Ponovna namestitev jedra
Če so datoteke poškodovane, jih lahko ponovno namestite, ne da bi to vplivalo na vsebino:

wp core download --force --skip-content

Upravljanje vsebine, uporabnikov in podatkovne zbirke

WP-CLI vam omogoča neposredno interakcijo s podatki vašega spletnega mesta.

Upravljanje uporabnikov
Seznam uporabnikov:

wp user list

Ustvarite novega skrbnika:

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

Posodobitev uporabniškega gesla:

wp user update 1 --user_pass=newpassword

Izbrišite uporabnika in ponovno dodelite njegovo vsebino:

wp user delete 5 --reassign=1

Operacije s podatkovno bazo
Izvoz podatkovne baze v datoteko:

wp db export backup.sql

Uvoz podatkovne zbirke iz datoteke:

wp db import backup.sql

Optimizacija podatkovne zbirke:

wp db optimize

Odprite konzolo MySQL, ki je neposredno povezana s podatkovno bazo WordPress:

wp db cli

Iskanje in nadomeščanje (na pravi način)

Ročno premikanje spletnega mesta WordPress v novo domeno je tvegano, saj so podatki v zbirki podatkov pogosto serializirani. Enostavno iskanje in zamenjava SQL bo uničilo gradnike in možnosti teme. WP-CLI pravilno obdeluje serializacijo.

Standardno iskanje in nadomeščanje

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

Suhi zagon (predogled)
Vedno preverite, kaj se bo spremenilo, preden zaženete ukaz:

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

Izvoz z zamenjavo
Podatkovno zbirko lahko izvozite z zamenjavami v datoteki, pri čemer ostane živa podatkovna zbirka nedotaknjena:

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

Napredno vzdrževanje: Cron in objektni predpomnilnik

Upravljanje Cron Jobs
Oglejte si načrtovane dogodke:

wp cron event list

Takoj zaženite vse dolžne dogodke cron:

wp cron event run --due-now

Upravljanje prehodnih pojavov in predpomnilnika
Počistite predpomnilnik predmetov:

wp cache flush

Izbriši vse prehodne faze, ki jim je potekel rok trajanja:

wp transient delete --expired

Avtomatizacija opravil s skripti

Ukaze WP-CLI lahko združite v skripte Bash za avtomatizirano vzdrževanje.

Primer:
Ustvarite datoteko z imenom 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."

Naredite ga izvršljiv (chmod +x maintain.sh) in ga zaženite, da v nekaj sekundah opravite celotno vzdrževanje spletnega mesta.

Uporaba WP-CLI na daljavo prek SSH

Če konfigurirate vzdevke, se vam za izvajanje ukazov ni treba prijaviti v strežnik.

V lokalni datoteki wp-cli.yml:

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

Zdaj lahko v oddaljenem strežniku zaženete ukaze iz lokalnega računalnika:

wp @prod plugin list
wp @dev core version

Najboljše prakse

• Vedno varnostno kopiranje: Preden zaženete množične posodobitve ali ukaze za iskanje in zamenjavo, zaženite wp db export.
• Uporabite suho vožnjo: Pri iskanju in zamenjavi vedno najprej uporabite spletno stran --dry-run.
• Ne vodite kot Root: WP-CLI vas opozori, če ga zaženete kot root. Varneje je, če ga zaženete kot uporabnik spletnega strežnika (npr. www-data) ali kot svoj uporabniški račun.
• Preizkus na stopnji: Uporabite WP-CLI za kloniranje produkcijskega spletnega mesta v staging, tam preizkusite skripte za posodobitve in jih nato uporabite v produkcijskem okolju.

Zaključek

WP-CLI spreminja upravljanje WordPressa iz niza klikov v poenostavljene operacije, ki jih je mogoče zapisati v skripte. S preprostimi ukazi, kot sta preverjanje različic in naštevanje vtičnikov, lahko zgradite temelje za napredno avtomatizacijo. Če boste WP-CLI v svoj delovni proces vključili že danes, boste prihranili nešteto ur pri svojih projektih WordPress.