WP-CLI: pilnīgs ceļvedis WordPress pārvaldīšanai no komandrindas

WP-CLI ir oficiālais komandrindas rīks WordPress instalāciju pārvaldīšanai tieši no termināļa, neatverot pārlūkprogrammu. Ja esat kādreiz pavadījis pēcpusdienu, klikšķinot pa WordPress administratora paneli, lai atjauninātu spraudņus vairākās vietnēs, jūs jau zināt, kāpēc šis rīks pastāv.

Šajā rokasgrāmatā uzzināsiet visu, sākot no WP-CLI instalēšanas Linux, macOS un Windows un beidzot ar sarežģītu uzturēšanas uzdevumu automatizēšanu, izmantojot skriptus un konfigurācijas failus. Neatkarīgi no tā, vai pārvaldāt vienu blogu vai desmitiem klientu vietņu, WP-CLI apgūšana būtiski mainīs jūsu darbu ar WordPress.

Ko jūs uzzināsiet:

• WP-CLI instalēšana un konfigurēšana dažādās operētājsistēmās
• Būtiskas komandas spraudņu, tēmu, lietotāju un satura pārvaldībai
• Datubāzes operācijas, tostarp eksports, imports un droša meklēšana un aizstāšana
• Automatizācijas paņēmieni, izmantojot skriptus, aizstājējvārdus un cron uzdevumus
• Labākā prakse, lai izvairītos no biežāk sastopamajām kļūdām, strādājot no termināļa

---

Kas ir WP-CLI? (Vispirms īss skaidrojums)

WP-CLI ir WordPress komandrindas saskarne – atvērtā koda rīks, kas ļauj pārvaldīt WordPress vietnes, izmantojot tikai termināli. Tā vietā, lai pieteiktos wp-admin un pārvietotos pa izvēlnēm, jūs varat palaist komandas, piemēram, wp plugin update --all, un sekunžu laikā vērot, kā tiek atjaunināts viss spraudņu kopums.

Projekts tika sākts ap 2011. gadu, un to izveidoja izstrādātāji, kuri vēlējās ātrāk pārvaldīt WordPress. 2017. gadā tas pārgāja zem oficiālā WordPress.org jumta, un tagad to uztur uzticama autoru komanda, tostarp Alain Schlesser un Daniel Bachhuber.

Lūk, kas jums jāzina par WP-CLI:

• Pašreizējā stabilā versija: WP-CLI 2.x sērija
• WordPress saderība: Darbojas ar WordPress 5.x līdz 6.x (un vēsturiski līdz 3.7)
• PHP prasības: PHP 7.4+ vai 8.x ieteicams drošības un veiktspējas nodrošināšanai.
• Komandu ekosistēma: Vairāk nekā 40 vecāku komandu, kas aptver praktiski visas WordPress operācijas.
• Galvenie lietotāji: Izstrādātāji, aģentūras, DevOps inženieri un lietotāji, kas pārvalda sarežģītas vai vairākas vietnes.
• Izplatīšana: Pieejams kā PHAR fails, izmantojot pakešu pārvaldītājus vai iepriekš instalēts daudzos pārvaldītos WordPress hostos.

WP-CLI lietošanas galvenie ieguvumi

Tiklīdz jūs sapratīsiet, kāpēc WP-CLI pastāv, mācīšanās līkne kļūs daudz vieglāk attaisnojama. Šajā sadaļā ir izskaidrotas konkrētas priekšrocības, kuru dēļ šim rīkam ir vērts veltīt laiku.

Laika ietaupījums atkārtotu uzdevumu veikšanai
20 spraudņu atjaunināšana, izmantojot WordPress paneli, nozīmē 20 lapu ielādes, 20 klikšķus un 20 progresa joslu skatīšanos. Izmantojot WP-CLI, vienreiz palaidiet un dodieties tālāk. Aģentūrām, kas pārvalda vairāku klientu vietnes, šī atšķirība nozīmē ietaupītas stundas katru nedēļu.

Lielapjoma un automatizētas operācijas
Apskatiet scenāriju, kurā jūs gatavojat 15 WooCommerce veikalus Melnajai piektdienai. Jums ir jāatjaunina spraudņi, jāiztīra kešatmiņas un jāpārbauda datubāzes integritāte katrā vietnē. WP-CLI ļauj jums izveidot scenāriju visai šai secībai un izpildīt to visās vietnēs dažu minūšu, nevis stundu laikā. Galvenās automatizācijas iespējas ietver:

• Visu spraudņu atjaunināšana vairākās instalācijās ar vienu skriptu
• Lietotāju masveida izveide ar iepriekš noteiktām lomām
• Nakts tehniskās apkopes veikšana, izmantojot cron (datubāzes optimizācija, pārejoša tīrīšana)
• Identisku WordPress konfigurāciju izvietošana jaunās vidēs

Uzticamība attiecībā uz pārlūkprogrammas operācijām
Pārlūkprogrammas operācijas saskaras ar HTTP laika nobīdi. Lielu datubāzu imports neizdodas procesa vidū. Meklēšanas un aizstāšanas operācijas bojā serializētos datus, ja tās tiek veiktas ar neapstrādātu SQL. WP-CLI novērš visas šīs problēmas, jo tas darbojas tieši uz servera bez laika ierobežojumiem, un tā meklēšanas un aizstāšanas komanda pareizi apstrādā serializētas datu struktūras.

Tiešā vadība pār galvenajām WordPress sistēmām
No viena termināļa varat:

• WordPress datubāzes eksportēšana un importēšana
• Mainīt wp-config.php iestatījumus
• Pārbaudīt un izraisīt wp-cron notikumus
• Uzturēšanas režīma ieslēgšana un izslēgšana
• Patvaļīga PHP koda palaišana WordPress kontekstā

Samazināta wp-admin slodze
Aizņemtos ražošanas serveros katra admin paneļa lapas ielāde patērē resursus. Veicot uzturēšanas operācijas, izmantojot WP-CLI, šī slodze neietekmē tīmekļa serveri, kas ir svarīgi lielas apmeklētības periodos.

WP-CLI prasības un atbalstītās vides

Pirms WP-CLI instalēšanas ir jāpārliecinās, ka jūsu serveris vai vietējā vide atbilst pamatprasībām. Labā ziņa ir tā, ka lielākā daļa mūsdienu WordPress iestatījumu jau atbilst prasībām.

PHP versijas prasības:

• Minimālais: PHP 5.6 (lai gan tas ir novecojis)
• Ieteicams: PHP 7.4, 8.0, 8.1, 8.2, 8.3, 8.4 vai 8.5 drošības un veiktspējas nodrošināšanai 2026. gadā.

WordPress versiju saderība:

• Vēsturiskais atbalsts: WordPress 3.7 un jaunāka
• Mūsdienu mērķis: WordPress 5.0 līdz 6.7+ pašreizējiem projektiem

Operētājsistēmas gaidas:

• Labākais atbalsts: UNIX līdzīgas sistēmas (Ubuntu 22.04 LTS, Debian 12, CentOS Stream, macOS).
• Windows: Atbalstīta, izmantojot WSL (Windows apakšsistēma Linux) vai PHP instalāciju.

Papildu prasības:

• PHP ir pieejams komandrindā (jūsu PATH jābūt php binārajam kopīgajam kodam).
• cURL vai wget, lai lejupielādētu wp-cli.phar failu.
• SSH piekļuve attālinātajiem serveriem (lielākajā daļā pārvaldīto WordPress hostinga plānu tas ir iekļauts pēc noklusējuma).

Daudzi populāri hostinga uzņēmumi, piemēram, Kinsta, SiteGround un DreamHost, tagad piegādā WP-CLI ar iepriekš instalētu WP-CLI. WordPress.com arī ietver WP-CLI vietnēm ar iespējotu SSH piekļuvi.

WP-CLI instalēšana Linux un macOS operētājsistēmā

Standarta instalēšanas metode izmanto oficiālo PHAR (PHP arhīva) failu. Šis process darbojas Ubuntu, Debian, CentOS, Fedora un macOS termināļos.

1. solis: Lejupielādēt PHAR failu
Atveriet termināli un lejupielādējiet wp-cli.phar, izmantojot curl:

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

Var izmantot arī wget:

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

2. solis: pārbaudiet lejupielādes rezultātu (nav obligāts, bet ieteicams)
Pārbaudiet SHA-256 kontrolsummas atbilstību oficiālajai vērtībai, kas publicēta WP-CLI dokumentācijā, lai pārliecinātos, ka lejupielādes laikā fails nav ticis bojāts:

sha256sum wp-cli.phar

Salīdziniet iegūto rezultātu ar oficiālajā WP-CLI vietnē norādīto kontrolsummu.

3. solis: PHAR faila pārbaude
Apstipriniet, ka php fails darbojas:

php wp-cli.phar --info

Jums vajadzētu redzēt izvades rezultātu, kurā tiek parādīta WP-CLI versija, PHP versija un sistēmas informācija.

4. solis: padariet to izpildāmu un pārvietojiet uz PATH
Atzīmējiet failu kā izpildāmu un pārvietojiet to uz kādu no katalogiem savā sistēmas PATH:

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

Komanda sudo parasti ir nepieciešama, jo /usr/local/bin ir sistēmas direktorijs. Izvairieties no WP-CLI instalēšanas kā root, ja jūs to galvenokārt darbināsiet kā parasts lietotājs.

5. solis: Pārbaudiet globālo instalāciju
Apstipriniet, ka WP-CLI tagad ir globāli pieejams:

wp --info
wp cli version

Jums vajadzētu redzēt izvades apstiprinot wp kli versiju, PHP bināro atrašanās vietu, un operētājsistēmas informāciju. Šobrīd WP-CLI ir instalēts un gatavs lietošanai.

Kā instalēt WP-CLI operētājsistēmā Windows

Windows lietotājiem ir divi galvenie ceļi: izmantot Windows Linux apakšsistēmu (WSL) vai izveidot Windows instalāciju. WSL nodrošina Linux līdzīgāku pieredzi, un parasti to iesaka.

1. iespēja: izmantojot WSL (ieteicams)
Vispirms iespējojiet WSL operētājsistēmā Windows 10 vai 11:

wsl --install

Instalējiet Ubuntu no Microsoft veikala, pēc tam palaidiet Ubuntu termināli. No turienes izpildiet tieši tos pašus Linux instalēšanas soļus, kas aprakstīti iepriekšējā sadaļā – lejupielādējiet phar failu, padariet to izpildāmu un pārvietojiet uz /usr/local/bin/wp.

2. iespēja: Vietējā Windows instalācija
Lai veiktu vietējo instalāciju, ir nepieciešams instalēt PHP operētājsistēmai Windows ar izpildāmo failu php, kas ir pieejams jūsu sistēmas PATH.

1. Lejupielādēt un instalēt PHP no oficiālās PHP for Windows vietnes
2. Pievienojiet PHP direktoriju savam Windows PATH vides mainīgajam
3. Apstipriniet, ka PHP darbojas, atverot komandu prombūtni un palaižot php -v

Pēc tam lejupielādējiet WP-CLI PHAR failu:

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

Kopš 2018. gada operētājsistēmā Windows pēc noklusējuma ir iekļauts curl, tāpēc tam vajadzētu darboties bez papildu iestatīšanas. Izveidojiet WP-CLI mapi (piemēram, C:\wp-cli) un pārvietojiet tajā lejupielādēto failu.

Pēc tam tajā pašā mapē izveidojiet partijas ietinamo failu ar nosaukumu wp.bat:

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

Pievienojiet C:\wp-cli savas sistēmas PATH vides mainīgajam. Tagad atveriet jaunu komandu uzvednes vai PowerShell logu un pārbaudiet:

wp --info

Jums vajadzētu redzēt WP-CLI versiju un vides informāciju, kas apstiprina, ka WP-CLI ir pareizi instalēts.

WP-CLI lietošanas pamati un palīdzības saņemšana

Kad WP-CLI ir instalēts, jums ir jāizprot komandu pamatveids, pirms sākt veikt konkrētas darbības. Visām WP-CLI komandām ir šāda struktūra:

wp <command> <subcommand> [options]

Komandas tiek izpildītas no WordPress instalācijas direktorija – mapes, kurā atrodas wp-config.php. Ja atrodaties citur, ceļu var norādīt ar --path=/var/www/html/mysite.

Vides pārbaude
Sāciet ar iestatījumu apstiprināšanu:

wp --info

Tas parāda jūsu WP-CLI versiju, PHP versiju, PHP bināro ceļu, operētājsistēmu un citu informāciju par vidi. Lai redzētu tikai WP-CLI versiju:

wp cli version

Pieejamo komandu izpēte
Lai uzskaitītu visas pieejamās wp cli komandas:

wp help

Lai saņemtu palīdzību par konkrētu komandu:

wp help plugin
wp help core update

Jebkurai komandai var pievienot arī --help:

wp user --help

Palīdzības izvads tiek parādīts peidžera veidā, līdzīgi kā Unix man lapas. Nospiediet q, lai izietu.

Pirmās izmēģināmās komandas:

• wp core version – parāda jūsu WordPress versiju
• wp plugin list – parāda visus instalētos WordPress spraudņus ar to statusu
• wp theme list – parāda instalētās tēmas
• wp user list – uzskaita visus vietnes lietotājus.

Šīs tikai lasīšanai paredzētās komandas ļauj jums izpētīt savu WordPress vietni, neko nemainot, un tas ir lieliski piemērots, lai iepazītos ar saskarni.

WordPress instalēšana un konfigurēšana ar WP-CLI

WP-CLI var veikt pilnīgu WordPress instalēšanu ātrāk nekā tradicionālais tīmekļa instalētājs. Tas ir īpaši vērtīgi, kad tiek veidotas izstrādes vides vai programmatiski izvietotas jaunas vietnes.

Priekšnosacījumi
Pirms instalēšanas komandu palaišanas ir jābūt gatavai MySQL vai MariaDB datubāzei. Šajā piemērā pieņemsim, ka esat izveidojis:

• Datubāzes nosaukums: wpsite_db
• Datubāzes lietotājs: wpsite_user
• Parole: securepassword123
• Saimnieks: localhost

1. solis: Lejupielādējiet WordPress kodola failus
Dodieties uz vēlamo instalācijas direktoriju un lejupielādējiet WordPress kodolu:

wp core download

Tas ielādē jaunāko WordPress versiju. Lai norādītu versiju vai vietni:

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

Pēc pabeigšanas tiks parādīts apstiprinājums, ka WordPress ir veiksmīgi lejupielādēts.

2. solis: Izveidot wp-config.php
Izveidojiet konfigurācijas failu, izmantojot wp config create:

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

Tādējādi tiek ģenerēts pilns wp-config.php ar jūsu datubāzes akreditācijas datiem un automātiski ģenerētiem drošības sāļiem.

3. solis: Palaist instalēšanas
Tagad instalējiet WordPress ar savu vietnes informāciju:

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

Jūs redzēsiet paziņojumu “WordPress ir veiksmīgi instalēts”, un jūsu vietne ir gatava lietošanai.

Multisite uzstādīšana
WordPress multisite tīkliem izmantojiet multisite variantu. WP-CLI var konfigurēt multisite instalācijas ar:

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

Tēmu pārvaldība ar WP-CLI

WP-CLI apstrādā visas tēmas darbības, neprasot piekļuvi WordPress administratora panelim. Jūs varat uzskaitīt, instalēt, aktivizēt, atjaunināt un dzēst tēmas tieši no termināļa.

Instalēto tēmu saraksts
Lai skatītu visas pašlaik instalētās tēmas:

wp theme list

Izvades paraugs:

nosaukums	statuss	atjauninājums	versija
twentytwentywentyfour	aktīvā	none	1.0
divdesmittrīsdesmit trīs	neaktīvs	none	1.2
astra	neaktīvs	pieejams	4.5.0

Tēmas aktivizēšana
Pārslēgšanās uz citu tēmu:

wp theme activate astra

Tas uzreiz maina aktīvo tēmu. Pārslēgšanās atpakaļ uz noklusējuma tēmu ir noderīga, lai novērstu ar tēmu saistītas problēmas:

wp theme activate twentytwentyfour

Jaunu tēmu instalēšana
Instalējiet tēmu no WordPress.org repozitorija:

wp theme install astra

Instalēšana un aktivizēšana ar vienu komandu:

wp theme install astra --activate

Tēmu atjaunināšana
Atjaunināt konkrētu tēmu:

wp theme update astra

Vai arī atjauniniet visas tēmas uzreiz:

wp theme update --all

Tēmu dzēšana
Noņemiet tēmu, kas jums vairs nav vajadzīga:

wp theme delete twentytwentythree

Spraudņu pārvaldība ar WP-CLI

WP-CLI ir spraudņu pārvaldība, kas ietaupa visvairāk laika. Jūs varat veikt masveida operācijas, kuru veikšanai vadības panelī būtu nepieciešami vairāki desmiti klikšķu.

Saraksta spraudņi

wp plugin list

Izvades paraugs:

nosaukums	statuss	atjauninājums	versija
woocommerce	aktīvā	none	8.5.1
yoast-seo	aktīvā	pieejams	21.0
elementor	neaktīvs	none	3.18.0

Spraudņu instalēšana
Instalējiet spraudni pēc tā sluga:

wp plugin install woocommerce

Instalēšana un aktivizēšana:

wp plugin install yoast-seo --activate

aktivizēšana un deaktivizēšana Aktivizējiet spraudni:

wp plugin activate elementor

Deaktivizēt spraudni (noderīgi atkļūdošanas novēršanai):

wp plugin deactivate elementor

Deaktivizēt visus spraudņus uzreiz (glābējs “White Screen of Death” atkļūdošanai):

wp plugin deactivate --all

Spraudņu atjaunināšana
Atjauniniet konkrētu spraudni:

wp plugin update yoast-seo

Atjauniniet visus spraudņus:

wp plugin update --all

Varat arī izslēgt konkrētus spraudņus no grupveida atjaunināšanas:

wp plugin update --all --exclude=woocommerce

WordPress kodola atjaunināšana un labošana

Drošībai ir ļoti svarīgi uzturēt WordPress atjauninātu. WP-CLI padara šo procesu pārredzamu un kontrolējamu.

Atjauninājumu pārbaude

wp core check-update

WordPress atjaunināšana
Atjaunināt uz jaunāko versiju:

wp core update

Pēc kodola atjaunināšanas ir ieteicams atjaunināt datubāzes shēmu:

wp core update-db

Kontrolsummu pārbaude
Ja ir aizdomas, ka jūsu vietne ir uzlauzta, varat pārbaudīt, vai pamatfaili nav modificēti:

wp core verify-checksums

Tas salīdzina jūsu failus ar oficiālajām WordPress repozitorija kontrolsummām.

Pamatnes pārinstalēšana
Ja faili ir bojāti, varat veikt atkārtotu instalēšanu, neietekmējot saturu:

wp core download --force --skip-content

Satura, lietotāju un datubāzes pārvaldība

WP-CLI ļauj tieši mijiedarboties ar vietnes datiem.

Lietotāju pārvaldība
Lietotāju saraksts:

wp user list

Izveidojiet jaunu administratoru:

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

Atjaunināt lietotāja paroli:

wp user update 1 --user_pass=newpassword

Dzēst lietotāju un atkārtoti piešķirt tā saturu:

wp user delete 5 --reassign=1

Datubāzes darbības
Eksportēt datubāzi uz failu:

wp db export backup.sql

Importēt datubāzi no faila:

wp db import backup.sql

Datu bāzes optimizēšana:

wp db optimize

Atveriet MySQL konsoli, kas ir tieši savienota ar jūsu WordPress datubāzi:

wp db cli

Meklēšana un aizstāšana (pareizais veids)

Pārvietot WordPress vietni uz jaunu domēnu manuāli ir riskanti, jo datu bāzē dati bieži vien ir serializēti. Vienkārša SQL meklēšana un aizstāšana sabojā logrīkus un tēmas opcijas. WP-CLI pareizi apstrādā serializāciju.

Standarta meklēšana un aizstāšana

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

Dry Run (priekšskatījums)
Pirms komandas izpildes vienmēr pārbaudiet, kas tiks mainīts:

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

Eksportēšana ar aizstāšanu
Datubāzi var eksportēt ar failā veiktajiem aizstāšanas gadījumiem, atstājot datu bāzi neskartu:

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

Uzlabotā apkope: Cron un objektu kešatmiņa

Cron uzdevumu pārvaldība
Skatiet plānotos notikumus:

wp cron event list

Uzreiz palaidiet visus attiecīgos cron notikumus:

wp cron event run --due-now

Pārejas procesu un kešatmiņas pārvaldība
Izdzēst objektu kešatmiņu:

wp cache flush

Izdzēst visus pārejošos režīmus, kuru derīguma termiņš ir beidzies:

wp transient delete --expired

Uzdevumu automatizēšana ar skriptiem

Jūs varat apvienot WP-CLI komandas Bash skriptos automatizētai apkopei.

Piemērs: Nedēļas uzturēšanas skripts
Izveidojiet failu ar nosaukumu 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."

Padariet to izpildāmu (chmod +x maintain.sh) un palaidiet to, lai dažu sekunžu laikā veiktu pilnīgu vietnes uzturēšanu.

WP-CLI izmantošana attālināti, izmantojot SSH

Ja konfigurējat aizstājvārdus, nav nepieciešams pieteikties serverī, lai izpildītu komandas.

Vietējā wp-cli.yml failā:

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

Tagad no sava vietējā datora varat palaist komandas attālajā serverī:

wp @prod plugin list
wp @dev core version

Labākā prakse

• Vienmēr dublējiet dublējumu: Pirms masveida atjauninājumu vai meklēšanas un aizstāšanas komandu palaišanas palaidiet wp db export.
• Izmantojiet sauso braucienu: Meklēšanas un aizstāšanas nolūkā vienmēr vispirms izmantojiet --dry-run.
• Neskrien kā Root: WP-CLI brīdina, ja jūs darbināt kā root. Drošāk ir palaist kā tīmekļa servera lietotājam (piemēram, www-data) vai kā savam īpašajam lietotāja kontam.
• Tests stadijā: Izmantojiet WP-CLI, lai klonētu savu ražošanas vietni uz stadiju, tur pārbaudiet atjaunināšanas skriptus un pēc tam tos ievietojiet ražošanā.

Secinājums

WP-CLI pārveido WordPress pārvaldību no vairākiem klikšķiem par racionālākām, ar skriptu darbināmām operācijām. Sākot ar vienkāršām komandām, piemēram, versiju pārbaudi un spraudņu uzskaitīšanu, tiek izveidots pamats uzlabotai automatizācijai. Integrējot WP-CLI savā darbplūsmā jau šodien, varēsiet ietaupīt neskaitāmas stundas visos savos WordPress projektos.