WP-CLI: išsamus „WordPress” valdymo iš komandinės eilutės vadovas

WP-CLI yra oficialus komandinės eilutės įrankis, skirtas „WordPress” įrenginiams valdyti tiesiogiai iš terminalo, neatidarant naršyklės. Jei kada nors praleidote popietę spragtelėdami „WordPress” administratoriaus skydelyje, kad atnaujintumėte įskiepius keliose svetainėse, jau žinote, kodėl egzistuoja šis įrankis.

Šiame vadove sužinosite viską, pradedant WP-CLI diegimu „Linux”, „MacOS” ir „Windows” sistemoje ir baigiant sudėtingų techninės priežiūros užduočių automatizavimu naudojant scenarijus ir konfigūracijos failus. Nesvarbu, ar valdote vieną tinklaraštį, ar dešimtis klientų svetainių, WP-CLI įvaldymas iš esmės pakeis jūsų darbą su „WordPress”.

Ko išmoksite:

• Kaip įdiegti ir konfigūruoti WP-CLI skirtingose operacinėse sistemose
• Svarbiausios įskiepių, temų, naudotojų ir turinio valdymo komandos
• Duomenų bazės operacijos, įskaitant eksportą, importą ir saugią paiešką bei pakeitimą
• Automatizavimo būdai naudojant scenarijus, slapyvardžius ir „cron” darbo vietas
• Geriausia praktika, kaip išvengti dažniausiai pasitaikančių spąstų dirbant iš terminalo

---

Kas yra WP-CLI? (Pirmiausia trumpas paaiškinimas)

WP-CLI reiškia „WordPress” komandinės eilutės sąsają – atvirojo kodo įrankį, kuriuo galite valdyti „WordPress” svetaines tik iš terminalo. Užuot prisijungę prie wp-admin ir naršę po meniu, galite paleisti tokias komandas kaip wp plugin update --all ir stebėti, kaip per kelias sekundes atnaujinamas visas įskiepių paketas.

Projektas pradėtas maždaug 2011 m., jį sukūrė programuotojai, kurie norėjo greičiau valdyti „WordPress”. 2017 m. jis buvo perkeltas į oficialią „WordPress.org” tarnybą ir dabar jį prižiūri atsidavusi bendradarbių komanda, įskaitant Alainą Schlesserį ir Danielį Bachhuberį.

Štai ką reikia žinoti apie WP-CLI:

• Dabartinė stabili versija: WP-CLI 2.x serija
• „WordPress” suderinamumas: veikia su „WordPress” 5.x iki 6.x (ir istoriškai atgal į 3.7)
• PHP reikalavimai: PHP 7.4+ arba 8.x rekomenduojama dėl saugumo ir našumo
• Komandų ekosistema: Daugiau nei 40 pagrindinių komandų, apimančių beveik visas WordPress operacijas
• Pagrindiniai naudotojai: Kūrėjai, agentūros, „DevOps” inžinieriai ir profesionalūs naudotojai, valdantys sudėtingas ar kelias svetaines.
• Pasiskirstymas: Daugelyje valdomų „WordPress” prieglobos namų iš anksto įdiegta arba prieinama kaip PHAR failas, per paketų tvarkykles

Pagrindiniai WP-CLI naudojimo privalumai

Kai suprasite, kodėl egzistuoja WP-CLI, mokymosi kreivę bus daug lengviau pateisinti. Šiame skyriuje paaiškinami konkretūs privalumai, dėl kurių verta skirti laiko šiam įrankiui.

Laiko taupymas atliekant pasikartojančias užduotis
Atnaujinti 20 įskiepių per „WordPress” prietaisų skydelį reiškia 20 puslapių įkėlimų, 20 paspaudimų ir 20 pažangos juostų stebėjimą. Naudodami WP-CLI vieną kartą paleidžiate wp plugin update --all ir judate toliau. Agentūroms, valdančioms kelias klientų svetaines, šis skirtumas reiškia kiekvieną savaitę sutaupytas valandas.

Masinės ir automatizuotos operacijos
Apsvarstykite scenarijų, kai Juodajam penktadieniui ruošiate 15 „WooCommerce” parduotuvių. Kiekvienoje svetainėje reikia atnaujinti įskiepius, išvalyti talpyklas ir patikrinti duomenų bazės vientisumą. Naudodami WP-CLI galite sukurti scenarijų ir atlikti visą šią seką visose svetainėse per kelias minutes, o ne valandas. Pagrindinės automatizavimo galimybės:

• Visų įskiepių atnaujinimas keliuose įrenginiuose naudojant vieną scenarijų
• Masinis naudotojų su iš anksto nustatytais vaidmenimis kūrimas
• Naktinės priežiūros vykdymas per cron (duomenų bazės optimizavimas, pereinamojo laikotarpio valymas)
• Tapačių „WordPress” konfigūracijų diegimas naujose aplinkose

Naršyklės operacijų patikimumas
Naršyklės operacijos susiduria su HTTP laiko tarpais. Didelės duomenų bazės importas nepavyksta proceso viduryje. Paieškos ir pakeitimo operacijos sugadina serijinius duomenis, kai atliekamos naudojant neapdorotą SQL. WP-CLI išvengiama visų šių problemų, nes ji veikia tiesiogiai serveryje be jokių laiko apribojimų, o jos paieškos ir pakeitimo komanda teisingai tvarko serijines duomenų struktūras.

Tiesioginis pagrindinių „WordPress” sistemų valdymas
Iš vieno terminalo galite:

• „WordPress” duomenų bazės eksportavimas ir importavimas
• Keisti wp-config.php nustatymus
• Tikrinti ir sukelti wp-cron įvykius
• Techninės priežiūros režimo įjungimas ir išjungimas
• Savavališko PHP kodo paleidimas „WordPress” kontekste

Mažesnė wp-admin apkrova
Užimtuose gamybiniuose serveriuose kiekviena administratoriaus skydelio puslapio apkrova reikalauja išteklių. Atliekant priežiūros operacijas per WP-CLI ši apkrova neapkrauna žiniatinklio serverio, o tai labai svarbu didelės apkrovos laikotarpiais.

WP-CLI reikalavimai ir palaikomos aplinkos

Prieš diegdami WP-CLI turite įsitikinti, kad jūsų serveris arba vietinė aplinka atitinka pagrindinius reikalavimus. Gera žinia ta, kad dauguma šiuolaikinių „WordPress” sąrankų jau atitinka šiuos reikalavimus.

PHP versijos reikalavimai:

• Minimalus: PHP 5.6 (nors ši versija jau pasenusi)
• Rekomenduojama: PHP 7.4, 8.0, 8.1, 8.2, 8.3, 8.4 arba 8.5 dėl saugumo ir našumo 2026 m.

„WordPress” versijų suderinamumas:

• Istorinė parama: WordPress 3.7 ir naujesnės
• Šiuolaikinis tikslas: WordPress 5.0 iki 6.7+ dabartiniams projektams

Operacinės sistemos lūkesčiai:

• Geriausias palaikymas: UNIX tipo sistemos (Ubuntu 22.04 LTS, Debian 12, CentOS Stream, MacOS)
• „Windows”: Palaikoma per WSL (Windows Subsystem for Linux) arba įdiegus PHP

Papildomi reikalavimai:

• PHP galima naudoti komandinėje eilutėje ( php dvejetainis failas turi būti jūsų PATH).
• cURL arba wget wp-cli.phar failui atsisiųsti
• SSH prieiga prie nuotolinių serverių (daugumoje valdomų „WordPress” prieglobos planų tai numatyta pagal nutylėjimą)

Daugelis populiarių prieglobos namų, tokių kaip „Kinsta”, „SiteGround” ir „DreamHost”, dabar turi iš anksto įdiegtą WP-CLI. WordPress.com taip pat apima WP-CLI svetainėms su įjungta SSH prieiga.

Kaip įdiegti WP-CLI „Linux” ir „macOS

Standartinis diegimo būdas naudoja oficialų PHAR (PHP archyvo) failą. Šis procesas veikia „Ubuntu”, „Debian”, „CentOS”, „Fedora” ir „MacOS” terminaluose.

1 žingsnis: Atsisiųskite PHAR failą
Atidarykite terminalą ir atsisiųskite wp-cli.phar naudodami curl:

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

Taip pat galite naudoti wget:

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

2 veiksmas: patikrinti atsisiuntimą (neprivaloma, bet rekomenduojama)
Patikrinkite, ar SHA-256 kontrolinė suma atitinka WP-CLI dokumentacijoje paskelbtą oficialią vertę, kad įsitikintumėte, jog atsisiunčiant failą nebuvo padaryta pažeidimų:

sha256sum wp-cli.phar

Palyginkite išvestį su kontroline suma, nurodyta oficialioje WP-CLI svetainėje.

3 žingsnis: PHAR failo testavimas
Patikrinkite, ar php failas veikia:

php wp-cli.phar --info

Turėtumėte pamatyti išvestį, kurioje būtų rodoma WP-CLI versija, PHP versija ir sistemos informacija.

4 veiksmas: padarykite jį vykdytinu ir perkelkite į PATH
Pažymėkite failą kaip vykdytiną ir perkelkite jį į sistemos PATH katalogą:

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

Komanda sudo paprastai reikalinga, nes /usr/local/bin yra sisteminis katalogas. Venkite diegti WP-CLI kaip root, jei pirmiausia jį paleisite kaip paprastas naudotojas.

5 veiksmas: Patikrinkite visuotinį įdiegimą
Patvirtinkite, kad WP-CLI dabar prieinamas visame pasaulyje:

wp --info
wp cli version

Turėtumėte pamatyti išvestį, patvirtinančią wp klipo versiją, PHP dvejetainę vietą ir operacinės sistemos duomenis. Šiuo metu WP-CLI yra įdiegtas ir paruoštas naudoti.

Kaip įdiegti WP-CLI sistemoje „Windows

„Windows” naudotojai gali rinktis du pagrindinius būdus: naudoti „Windows” posistemę „Linux” (WSL) arba įdiegti vietinę „Windows” instaliaciją. WSL suteikia daugiau į „Linux” panašios patirties ir paprastai yra rekomenduojama.

1 galimybė: naudojant WSL (rekomenduojama)
Pirmiausia „Windows 10” arba „11” sistemoje įjunkite WSL:

wsl --install

Įdiekite „Ubuntu” iš „Microsoft Store”, tada paleiskite „Ubuntu” terminalą. Iš ten atlikite lygiai tuos pačius „Linux” diegimo veiksmus, aprašytus ankstesniame skyriuje – atsisiųskite phar failą, padarykite jį vykdytinu ir perkelkite į /usr/local/bin/wp.

2 variantas: vietinis „Windows” diegimas
Norint atlikti vietinį diegimą, reikia įdiegti „Windows” skirtą PHP su php vykdomąja programa, esančia jūsų sistemos PATH.

1. Atsisiųskite ir įdiekite PHP iš oficialios „PHP for Windows” svetainės
2. PHP katalogą įtraukite į „Windows” PATH aplinkos kintamąjį
3. Patvirtinkite, kad PHP veikia, atidarę komandų eilutę ir paleidę php -v

Tada atsisiųskite WP-CLI PHAR failą:

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

Nuo 2018 m. „Windows” pagal numatytuosius nustatymus apima „curl”, todėl tai turėtų veikti be papildomų nustatymų. Sukurkite WP-CLI aplanką (pvz., C:\wp-cli) ir perkelkite į jį atsisiųstą failą.

Tada tame pačiame aplanke sukurkite paketinį įvyniojimo failą pavadinimu wp.bat:

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

Į sistemos PATH aplinkos kintamąjį įtraukite C:\wp-cli. Dabar atidarykite naują komandų eilutę arba „PowerShell” langą ir patikrinkite:

wp --info

Turėtumėte pamatyti WP-CLI versiją ir aplinkos informaciją, patvirtinančią, kad WP-CLI yra tinkamai įdiegtas.

Pagrindinis WP-CLI naudojimas ir pagalbos gavimas

Įdiegę WP-CLI, prieš pradėdami atlikti konkrečias operacijas, turite suprasti pagrindinį komandų modelį. Visos WP-CLI komandos atitinka šią struktūrą:

wp <command> <subcommand> [options]

Komandos vykdomos iš „WordPress” diegimo katalogo – aplanko, kuriame yra wp-config.php. Jei esate kitur, galite nurodyti kelią su --path=/var/www/html/mysite.

Aplinkos tikrinimas
Pradėkite nuo to, kad patvirtintumėte savo sąranką:

wp --info

Čia rodoma jūsų WP-CLI versija, PHP versija, PHP dvejetainis kelias, operacinė sistema ir kiti aplinkos duomenys. Jei norite matyti tik WP-CLI versiją:

wp cli version

Prieinamų komandų tyrimas
Norėdami peržiūrėti visas prieinamas wp cli komandas:

wp help

Pagalba apie konkrečią komandą:

wp help plugin
wp help core update

Taip pat prie bet kurios komandos galite pridėti --help:

wp user --help

Pagalbos išvestis rodoma peidžeryje, panašiame į „Unix man” puslapius. Paspauskite q, kad išeitumėte.

Pirmosios komandos, kurias reikia išbandyti:

• wp core version – rodo jūsų WordPress versiją
• wp plugin list – rodo visus įdiegtus „WordPress” įskiepius ir jų būseną
• wp theme list – rodo įdiegtas temas
• wp user list – visų svetainės naudotojų sąrašai

Šiomis tik skaitymo komandomis galite tyrinėti savo „WordPress” svetainę nieko nekeisdami, o tai puikiai tinka norint susipažinti su sąsaja.

WordPress diegimas ir konfigūravimas naudojant WP-CLI

„WP-CLI” gali atlikti visą naują „WordPress” diegimą greičiau nei tradicinė internetinė diegimo programa. Tai ypač vertinga kuriant kūrimo aplinką arba programiniu būdu diegiant naujas svetaines.

Būtinosios sąlygos
Prieš paleisdami diegimo komandas, turite paruošti MySQL arba MariaDB duomenų bazę. Šiame pavyzdyje darykite prielaidą, kad sukūrėte:

• Duomenų bazės pavadinimas: wpsite_db
• Duomenų bazės naudotojas: wpsite_user
• Slaptažodis: securepassword123
• Šeimininkas: localhost

1 žingsnis: Atsisiųskite „WordPress” branduolio failus
Nueikite į norimą diegimo katalogą ir atsisiųskite „WordPress” branduolį:

wp core download

Taip parsisiunčiama naujausia „WordPress” versija. Jei norite nurodyti versiją arba vietovę:

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

Baigę pamatysite patvirtinimą, kad „WordPress” buvo sėkmingai atsisiųstas.

2 žingsnis: Sukurti wp-config.php
Sukurkite konfigūracijos failą naudodami wp config create:

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

Taip sukuriamas visas wp-config.php su jūsų duomenų bazės prisijungimo duomenimis ir automatiškai sugeneruotomis saugumo druskomis.

3 žingsnis: paleiskite diegimo programą
Dabar įdiekite „WordPress” su savo svetainės duomenimis:

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

Pamatysite pranešimą „WordPress įdiegta sėkmingai” ir svetainė bus paruošta naudoti.

Daugiaviečių svetainių diegimas
„WordPress” daugiaviečių svetainių tinklams naudokite daugiaviečių svetainių variantą. WP-CLI gali konfigūruoti daugiaviečių svetainių įrenginius su:

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

Temų valdymas naudojant WP-CLI

„WP-CLI” atlieka visas temos operacijas nereikalaudama prieigos prie „WordPress” administratoriaus skydelio. Temas galite išvardyti, įdiegti, aktyvuoti, atnaujinti ir ištrinti tiesiai iš terminalo.

Įdiegtų temų sąrašas
Norėdami peržiūrėti visas šiuo metu įdiegtas temas:

wp theme list

Išvesties pavyzdys:

pavadinimas	statusas	atnaujinti	versija
dvidešimt keturios	aktyvus	none	1.0
dvidešimt dvidešimt trys	neaktyvus	none	1.2
astra	neaktyvus	galima rasti	4.5.0

Temos įjungimas
Perjunkite kitą temą:

wp theme activate astra

Tai iš karto pakeičia aktyviąją temą. Perjungimas atgal į numatytąją temą yra naudingas sprendžiant su tema susijusias problemas:

wp theme activate twentytwentyfour

Naujų temų diegimas
Įdiekite temą iš WordPress.org saugyklos:

wp theme install astra

Įdiekite ir aktyvuokite viena komanda:

wp theme install astra --activate

Temų atnaujinimas
Atnaujinkite konkrečią temą:

wp theme update astra

Arba atnaujinkite visas temas vienu metu:

wp theme update --all

Temų šalinimas
Pašalinkite temą, kurios jums nebereikia:

wp theme delete twentytwentythree

Įskiepių valdymas naudojant WP-CLI

Įskiepių valdymas yra ta sritis, kurioje WP-CLI sutaupo daugiausiai laiko. Galite atlikti masines operacijas, kurioms atlikti prietaisų skydelyje prireiktų dešimčių paspaudimų.

Įskiepių sąrašo sudarymas

wp plugin list

Išvesties pavyzdys:

pavadinimas	statusas	atnaujinti	versija
woocommerce	aktyvus	none	8.5.1
yoast-seo	aktyvus	galima rasti	21.0
elementor	neaktyvus	none	3.18.0

Įskiepių diegimas
Įdiekite įskiepį pagal jo slugą:

wp plugin install woocommerce

Įdiekite ir aktyvuokite:

wp plugin install yoast-seo --activate

Įjungimas ir išjungimas
Įjungti įskiepį:

wp plugin activate elementor

Išjungti įskiepį (naudinga derinant):

wp plugin deactivate elementor

Išjungti visus įskiepius vienu metu (gelbsti derinant „baltąjį mirties ekraną”):

wp plugin deactivate --all

Įskiepių atnaujinimas
Atnaujinkite konkretų įskiepį:

wp plugin update yoast-seo

Atnaujinkite visus įskiepius:

wp plugin update --all

Taip pat galite neįtraukti konkrečių įskiepių į masinį atnaujinimą:

wp plugin update --all --exclude=woocommerce

„WordPress” branduolio atnaujinimas ir taisymas

Saugumui užtikrinti labai svarbu nuolat atnaujinti „WordPress”. Su WP-CLI šis procesas tampa skaidrus ir valdomas.

Atnaujinimų tikrinimas

wp core check-update

WordPress atnaujinimas
Atnaujinkite iki naujausios versijos:

wp core update

Atnaujinus duomenų bazės branduolį, pravartu atnaujinti duomenų bazės schemą:

wp core update-db

Kontrolinių sumų tikrinimas
Jei įtariate, kad į jūsų svetainę buvo įsilaužta, galite patikrinti, ar pagrindiniai failai nebuvo pakeisti:

wp core verify-checksums

Taip jūsų failai palyginami su oficialiomis „WordPress” saugyklos kontrolinėmis sumomis.

Pagrindinio
diegimas Iš naujo Jei failai sugadinti, galite priverstinai įdiegti iš naujo, nedarydami poveikio turiniui:

wp core download --force --skip-content

Turinio, naudotojų ir duomenų bazės valdymas

„WP-CLI” leidžia tiesiogiai sąveikauti su svetainės duomenimis.

Vartotojų valdymas
Vartotojų sąrašas:

wp user list

Sukurkite naują administratorių:

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

Atnaujinkite naudotojo slaptažodį:

wp user update 1 --user_pass=newpassword

Ištrinkite naudotoją ir iš naujo priskirkite jo turinį:

wp user delete 5 --reassign=1

Duomenų bazės operacijos
Eksportuokite duomenų bazę į failą:

wp db export backup.sql

Importuokite duomenų bazę iš failo:

wp db import backup.sql

Optimizuokite duomenų bazę:

wp db optimize

Atidarykite „MySQL” konsolę, tiesiogiai prijungtą prie „WordPress” duomenų bazės:

wp db cli

Paieška ir pakeitimas (teisingas būdas)

Rankiniu būdu perkelti „WordPress” svetainę į naują domeną yra rizikinga, nes duomenų bazėje duomenys dažnai yra serijiniai. Paprastas SQL suradimas ir pakeitimas sugadins valdiklius ir temos parinktis. WP-CLI tinkamai tvarko serializavimą.

Standartinė paieška-pakeitimas

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

Sausas paleidimas (peržiūra)
Prieš paleisdami komandą visada patikrinkite, kas bus pakeista:

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

Eksportavimas su pakeitimu
Galite eksportuoti duomenų bazę su faile atliktais pakeitimais, palikdami gyvą duomenų bazę nepakeistą:

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

Išplėstinė priežiūra: „Cron” ir objektų talpykla

„Cron” užduočių valdymas
Peržiūrėkite suplanuotus įvykius:

wp cron event list

Nedelsiant paleiskite visus privalomus „cron” įvykius:

wp cron event run --due-now

Pereinamųjų procesų ir talpyklos valdymas
Išvalykite objektų talpyklą:

wp cache flush

Ištrinkite visus pasibaigusius pereinamuosius laikotarpius:

wp transient delete --expired

Užduočių automatizavimas naudojant scenarijus

Galite sujungti WP-CLI komandas į „Bash” scenarijus, kad galėtumėte atlikti automatizuotą priežiūrą.

Pavyzdys: Savaitės techninės priežiūros scenarijus
Sukurkite failą pavadinimu 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."

Padarykite ją vykdytiną (chmod +x maintain.sh) ir paleiskite, kad per kelias sekundes atliktumėte visą svetainės priežiūrą.

Nuotolinis WP-CLI naudojimas per SSH

Jei sukonfigūruojate slapyvardžius, jums nereikia prisijungti prie serverio, kad paleistumėte komandas.

Vietiniame wp-cli.yml faile:

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

Dabar galite paleisti komandas nutolusiame serveryje iš vietinio kompiuterio:

wp @prod plugin list
wp @dev core version

Geriausia praktika

• Visada darykite atsarginę kopiją: Prieš paleisdami masinius atnaujinimus arba paieškos ir pakeitimo komandas, paleiskite wp db export.
• Naudokite sausą važiavimą: ieškodami ir keisdami visada pirmiausia naudokite --dry-run.
• Nebėkite kaip „Root”: WP-CLI įspėja, jei paleidžiate kaip root. Saugiau paleisti kaip žiniatinklio serverio naudotojui (pvz., www-data) arba kaip konkretaus naudotojo paskyrai.
• Bandymas etapais: Naudokite WP-CLI, kad klonuotumėte savo gamybinę svetainę, išbandykite atnaujinimo scenarijus ir tada pritaikykite gamybai.

Išvada

„WP-CLI” paverčia „WordPress” valdymą iš kelių paspaudimų į supaprastintas, scenarijais valdomas operacijas. Pradėję nuo paprastų komandų, tokių kaip versijų tikrinimas ir įskiepių sąrašo sudarymas, sukursite pagrindą pažangiam automatizavimui. Įtraukę WP-CLI į savo darbo eigą jau šiandien, sutaupysite daugybę valandų, vykdydami „WordPress” projektus.