16 min. olvasd el

WP-CLI: A teljes útmutató a WordPress kezeléséhez a parancssorból

A WP-CLI a hivatalos parancssori eszköz a WordPress telepítések kezelésére közvetlenül a terminálról, anélkül, hogy valaha is megnyitnád a böngészőt. Ha valaha is töltöttél már egy délutánt a WordPress admin műszerfalán kattintgatva, hogy több webhelyen keresztül frissítsd a pluginokat, akkor már tudod, miért létezik ez az eszköz.

Ebben az útmutatóban mindent megtanulhatsz a WP-CLI telepítésétől kezdve a WP-CLI Linux, macOS és Windows rendszereken történő telepítésén át az összetett karbantartási feladatok automatizálásáig szkriptekkel és konfigurációs fájlokkal. Akár egyetlen blogot, akár több tucat ügyféloldalt kezelsz, a WP-CLI elsajátítása alapvetően megváltoztatja a WordPress-szel való munkavégzésedet.

Mit fogsz tanulni:

A WP-CLI telepítése és konfigurálása különböző operációs rendszereken
Alapvető parancsok a bővítmények, témák, felhasználók és tartalmak kezeléséhez
Adatbázis műveletek, beleértve az exportot, importot és a biztonságos keresést-helyettesítést is
Automatizálási technikák szkriptek, aliasok és cron munkák használatával
Legjobb gyakorlatok a terminálról történő munkavégzés gyakori buktatóinak elkerülésére

Mi az a WP-CLI? (Gyors magyarázat először)

A WP-CLI a WordPress Command Line Interface rövidítése – egy nyílt forráskódú eszköz, amellyel a WordPress oldalakat teljes egészében a terminálról kezelheted. Ahelyett, hogy bejelentkeznél a wp-adminba, és menükben navigálnál, olyan parancsokat futtatsz, mint a wp plugin update --all, és nézheted, ahogy a teljes plugin-halmazod másodpercek alatt frissül.

A projekt 2011 körül indult, és olyan fejlesztők hozták létre, akik gyorsabb módot akartak a WordPress méretarányos kezelésére. 2017-ben a hivatalos WordPress.org égisze alá költözött, és jelenleg egy elkötelezett csapat, többek között Alain Schlesser és Daniel Bachhuber közreműködői tartják fenn.

Az alábbiakat kell tudnod a WP-CLI-ről:

Jelenlegi stabil verzió: sorozat
WordPress kompatibilitás: 6.x-ig (és történetileg vissza a 3.7-ig).
PHP követelmények: PHP 7.4+ vagy 8.x ajánlott a biztonság és a teljesítmény érdekében.
Parancsnoki ökoszisztéma: Több mint 40 szülőparancs, amelyek gyakorlatilag minden WordPress műveletet lefednek.
Elsődleges felhasználók: Fejlesztők, ügynökségek, DevOps mérnökök és komplex vagy több webhelyet kezelő power userek.
Elterjedés: PHAR fájlként, csomagkezelőkön keresztül, vagy előre telepítve számos kezelt WordPress tárhelyen.

A WP-CLI használatának fő előnyei

Ha egyszer megérted, hogy miért létezik a WP-CLI, a tanulási görbét sokkal könnyebb lesz igazolni. Ez a szakasz elmagyarázza azokat a konkrét előnyöket, amelyek miatt érdemes erre az eszközre időt szánni.

Időmegtakarítás az ismétlődő feladatoknál
20 bővítmény frissítése a WordPress műszerfalon keresztül 20 oldalletöltést, 20 kattintást és 20 előrehaladási sáv figyelését jelenti. A WP-CLI-vel egyszer futtathatja a wp plugin update --all címet, és máris továbbléphet. A több ügyféloldalt kezelő ügynökségek számára ez a különbség hetente megtakarított órákat jelent.

Tömeges és automatizált műveletek
Gondoljunk egy olyan forgatókönyvre, amelyben 15 WooCommerce áruházat készítesz fel a fekete péntekre. Minden egyes webhelyen frissítenie kell a bővítményeket, törölnie kell a gyorsítótárakat, és ellenőriznie kell az adatbázis sértetlenségét. A WP-CLI segítségével ezt a teljes műveletsort szkriptelheti, és órák helyett percek alatt végrehajthatja az összes webhelyen. A legfontosabb automatizálási képességek a következők:

Az összes bővítmény frissítése több telepítésen keresztül egyetlen szkripttel
Előre meghatározott szerepkörökkel rendelkező felhasználók tömeges létrehozása
Éjszakai karbantartás futtatása cronon keresztül (adatbázis optimalizálás, átmeneti tisztítás)
Azonos WordPress konfigurációk telepítése új környezetekbe

A böngészőalapú műveletek megbízhatósága
A böngészőalapú műveletek HTTP-időzavarral járnak. A nagy adatbázis-importok meghiúsulnak a folyamat közepén. A keresés-helyettesítés műveletek elrontják a sorba rendezett adatokat, ha nyers SQL-el végzik. A WP-CLI elkerüli mindezeket a problémákat, mivel közvetlenül a szerveren fut, nincs időkorlátozás, és a keresés-helyettesítés parancs helyesen kezeli a szerializált adatszerkezeteket.

Közvetlen irányítás a WordPress alaprendszerei felett
Egy terminálról:

A WordPress adatbázis exportálása és importálása
A wp-config.php beállításainak módosítása
A wp-cron események vizsgálata és kiváltása
Karbantartási üzemmód be- és kikapcsolása
Tetszőleges PHP kód futtatása a WordPress környezetében

Csökkentett terhelés a wp-admin
A forgalmas termelési szervereken minden admin műszerfal oldal betöltése erőforrásokat fogyaszt. A karbantartási műveletek WP-CLI-n keresztül történő futtatása ezt a terhelést a webszerverről távol tartja, ami nagy forgalmú időszakokban fontos.

WP-CLI követelmények és támogatott környezetek

A WP-CLI telepítése előtt meg kell győződnie arról, hogy szervere vagy helyi környezete megfelel az alapvető követelményeknek. A jó hír az, hogy a legtöbb modern WordPress beállítás már megfelel.

PHP verziókövetelmények:

Minimum: PHP 5.6 (bár ez már elavult)
Ajánlott: PHP 7.4, 8.0, 8.1, 8.2, 8.3, 8.4 vagy 8.5 a biztonság és a teljesítmény érdekében 2026-ban.

WordPress verzió kompatibilitás:

Történelmi támogatás: és újabbak: WordPress 3.7 és újabb
Modern célpont: 6.7+ a jelenlegi projektekhez.

Operációs rendszer elvárások:

Legjobb támogatás: LTS, Debian 12, CentOS Stream, macOS).
Windows: (Windows Subsystem for Linux) vagy natív PHP telepítéssel támogatott: WSL (Windows Subsystem for Linux) vagy natív PHP telepítéssel támogatott

További követelmények:

PHP elérhető a parancssorban (a php binárisnak benne kell lennie a PATH-ban)
cURL vagy wget a wp-cli.phar fájl letöltéséhez.
SSH hozzáférés a távoli szerverekhez (a legtöbb menedzselt WordPress hosting csomag alapértelmezés szerint tartalmazza ezt)

Sok népszerű tárhelyszolgáltató, például a Kinsta, a SiteGround és a DreamHost már előre telepített WP-CLI-vel rendelkezik. A WordPress.com is tartalmazza a WP-CLI-t az SSH-hozzáféréssel rendelkező oldalakhoz.

A WP-CLI telepítése Linuxon és macOS-en

A standard telepítési módszer a hivatalos PHAR (PHP Archive) fájlt használja. Ez az eljárás Ubuntu, Debian, CentOS, Fedora és macOS terminálokon működik.

1. lépés: Töltse le a PHAR fájlt
Nyissa meg a terminálját és töltse le a wp-cli.phar címet a curl segítségével:

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

Alternatívaként használhatja a wget-et:

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

2. lépés: Ellenőrizze a letöltést (nem kötelező, de ajánlott)
Ellenőrizze az SHA-256 ellenőrző összeget a WP-CLI dokumentációban közzétett hivatalos értékkel, hogy megbizonyosodjon arról, hogy a fájlt nem manipulálták a letöltés során:

sha256sum wp-cli.phar

Hasonlítsa össze a kimenetet a WP-CLI hivatalos weboldalán szereplő ellenőrző összeggel.

3. lépés: A PHAR fájl tesztelése
Ellenőrizze, hogy a php fájl működik-e:

php wp-cli.phar --info

Látnia kell a WP-CLI verzióját, a PHP verzióját és a rendszerinformációkat.

4. lépés: Tegye végrehajthatóvá és helyezze át a PATH-ba
Jelölje meg a fájlt végrehajthatónak, és helyezze át a rendszer PATH könyvtárába:

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

A sudo parancsra általában azért van szükség, mert a /usr/local/bin egy rendszerkönyvtár. Kerülje a WP-CLI root felhasználóként történő telepítését, ha elsősorban normál felhasználóként fogja futtatni.

5. lépés: A globális telepítés ellenőrzése
A WP-CLI globálisan elérhetővé vált:

wp --info
wp cli version

Meg kell látnia a wp cli verzióját, a PHP bináris helyét és az operációs rendszer adatait megerősítő kimenetet. Ezen a ponton a WP-CLI telepítve van, és készen áll a használatra.

A WP-CLI telepítése Windows alatt

A Windows-felhasználóknak két fő lehetőségük van: a Windows Subsystem for Linux (WSL) használata vagy egy natív Windows telepítés beállítása. A WSL inkább Linux-szerű élményt nyújt, és általában ajánlott.

1. lehetőség: A WSL használata (ajánlott)
Először engedélyezze a WSL-t a Windows 10 vagy 11 rendszeren:

wsl --install

Telepítse az Ubuntut a Microsoft Store-ból, majd indítsa el az Ubuntu terminált. Onnan kövesse pontosan ugyanazokat a Linux-telepítési lépéseket, amelyeket az előző szakaszban ismertettünk – töltse le a phar fájlt, tegye futtathatóvá, és helyezze át a /usr/local/bin/wp címre.

2. lehetőség: Natív Windows telepítés
A natív telepítéshez a PHP for Windows-ra telepített PHP-ra van szükség, és a php futtatható fájlnak a rendszer PATH-jában kell lennie.

A PHP letöltése és telepítése a hivatalos PHP for Windows oldalról
Adja hozzá a PHP könyvtárat a Windows PATH környezeti változójához
Erősítse meg, hogy a PHP működik a parancssor megnyitásával és a következő futtatásával php -v

Ezután töltse le a WP-CLI PHAR fájlt:

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

A Windows 2018 óta alapértelmezés szerint tartalmazza a curl-t, így ennek további beállítások nélkül is működnie kell. Hozzon létre egy mappát a WP-CLI számára (pl. C:\wp-cli), és helyezze oda a letöltött fájlt.

Ezután hozzon létre egy wp.bat nevű batch wrapper fájlt ugyanabban a mappában:

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

Adja hozzá a C:\wp-cli címet a rendszer PATH környezeti változójához. Most nyisson egy új parancssoros vagy PowerShell ablakot, és ellenőrizze:

wp --info

Látnia kell a WP-CLI verzióját és a környezet adatait, amelyek megerősítik, hogy a WP-CLI megfelelően telepítve van.

Alapvető WP-CLI használat és segítségkérés

A WP-CLI telepítése után meg kell értenie az alapvető parancssémát, mielőtt belemerülne a konkrét műveletekbe. Minden WP-CLI parancs ezt a struktúrát követi:

wp <command> <subcommand> [options]

A parancsok a WordPress telepítési könyvtárából – a wp-config.php mappából – kerülnek végrehajtásra. Ha máshol van, akkor az elérési utat a --path=/var/www/html/mysite címmel adhatja meg.

A környezet ellenőrzése
Kezdje a beállítások megerősítésével:

wp --info

Ez megjeleníti a WP-CLI verzióját, a PHP verzióját, a PHP bináris elérési útvonalát, az operációs rendszert és egyéb környezeti adatokat. Ha csak a WP-CLI verzióját szeretné látni:

wp cli version

Az elérhető parancsok felfedezése
Az összes elérhető wp cli parancs listázása:

wp help

Egy adott parancsra vonatkozó segítségért:

wp help plugin
wp help core update

A --help címet bármely parancshoz csatolhatja:

wp user --help

A súgó kimenete a Unix man oldalakhoz hasonlóan egy lapozóban jelenik meg. A kilépéshez nyomja meg a q gombot.

Első kipróbálandó parancsok:

wp core version – megjeleníti a WordPress verzióját
wp plugin list – megmutatja az összes telepített WordPress bővítményt az állapotukkal együtt
wp theme list – a telepített témákat mutatja
wp user list – felsorolja az összes felhasználót a webhelyen

Ezek a csak olvasható parancsok lehetővé teszik, hogy felfedezd a WordPress webhelyedet anélkül, hogy bármit is megváltoztatnál, ami tökéletes ahhoz, hogy megbarátkozz a felülettel.

A WordPress telepítése és konfigurálása a WP-CLI-vel

A WP-CLI gyorsabban képes teljes friss WordPress telepítést végezni, mint a hagyományos webes telepítő. Ez különösen értékes a fejlesztői környezetek felpörgetésekor vagy új webhelyek programozott telepítésekor.

Előfeltételek
A telepítési parancsok futtatása előtt készen kell állnia egy MySQL vagy MariaDB adatbázisra. Ehhez a példához feltételezzük, hogy létrehozta:

Adatbázis neve: wpsite_db
Adatbázis felhasználó: wpsite_user
Jelszó: securepassword123
Házigazda: localhost

1. lépés: WordPress core fájlok letöltése
Navigálj a kívánt telepítési könyvtárba, és töltsd le a WordPress core-t:

wp core download

Ez a legújabb WordPress-verziót hozza be. Verzió vagy nyelvterület megadása:

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

A befejezés után megerősítést fog látni, hogy a WordPress sikeresen letöltődött.

2. lépés: A wp-config.php létrehozása
Hozzuk létre a konfigurációs fájlt a wp config create segítségével:

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

Ez egy teljes wp-config.php címet generál az adatbázis hitelesítő adataival és az automatikusan generált biztonsági sókkal.

3. lépés: Futtassa a telepítést
Most telepítse a WordPress-t a webhelye adataival:

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

Megjelenik a „WordPress sikeresen telepítve” üzenet, és az oldalad készen áll a használatra.

Multisite telepítés
A WordPress multisite hálózatokhoz használja a multisite változatot. A WP-CLI segítségével a multisite telepítések konfigurálhatók:

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

Témák kezelése WP-CLI-vel

A WP-CLI a téma összes műveletét kezeli anélkül, hogy hozzáférést igényelne a WordPress adminisztrációs műszerfalához. A témákat közvetlenül a terminálról listázhatja, telepítheti, aktiválhatja, frissítheti és törölheti.

Telepített témák listázása
A jelenleg telepített témák megtekintéséhez:

wp theme list

Kimeneti minta:

név	státusz	frissítés	verzió
twentytwentywentyfour	aktív	none	1.0
twentytwentywentythree	inaktív	none	1.2
astra	inaktív	elérhető	4.5.0

Téma aktiválása
Témaváltás:

wp theme activate astra

Ez azonnal megváltoztatja az aktív témát. Az alapértelmezett témára való visszaváltás hasznos a témával kapcsolatos problémák elhárításakor:

wp theme activate twentytwentyfour

Új témák telepítése
Telepítsen egy témát a WordPress.org tárolóból:

wp theme install astra

Telepítés és aktiválás egyetlen paranccsal:

wp theme install astra --activate

Témák frissítése
Egy adott téma frissítése:

wp theme update astra

Vagy frissítse az összes témát egyszerre:

wp theme update --all

Témák törlése
Távolítson el egy olyan témát, amelyre már nincs szüksége:

wp theme delete twentytwentythree

Pluginok kezelése WP-CLI-vel

A WP-CLI a legtöbb időt a pluginok kezelésével spórolja meg. Olyan tömeges műveleteket végezhet, amelyekhez a műszerfalon több tucat kattintásra lenne szükség.

Pluginok listázása

wp plugin list

Kimeneti minta:

név	státusz	frissítés	verzió
woocommerce	aktív	none	8.5.1
yoast-seo	aktív	elérhető	21.0
elementor	inaktív	none	3.18.0

A bővítmények telepítése
Telepítsen egy bővítményt a slugja alapján:

wp plugin install woocommerce

Telepítse és aktiválja:

wp plugin install yoast-seo --activate

Aktiválás és deaktiválás
Plugin aktiválása:

wp plugin activate elementor

Egy bővítmény kikapcsolása (hasznos hibakereséshez):

wp plugin deactivate elementor

Az összes bővítmény egyszerre történő kikapcsolása (életmentő a „White Screen of Death” hibakereséshez):

wp plugin deactivate --all

A bővítmények frissítése
Egy adott bővítmény frissítése:

wp plugin update yoast-seo

Frissítse az összes bővítményt:

wp plugin update --all

Bizonyos bővítményeket ki is zárhat a tömeges frissítésből:

wp plugin update --all --exclude=woocommerce

WordPress Core frissítése és javítása

A WordPress frissítése kritikus fontosságú a biztonság szempontjából. A WP-CLI átláthatóvá és ellenőrizhetővé teszi ezt a folyamatot.

Frissítések ellenőrzése

wp core check-update

A WordPress frissítése
Frissítés a legújabb verzióra:

wp core update

Egy core frissítés után jó gyakorlat az adatbázis sémájának frissítése:

wp core update-db

Ellenőrző összegek ellenőrzése
Ha azt gyanítja, hogy webhelyét feltörték, ellenőrizheti, hogy az alapfájlokat nem módosították-e:

wp core verify-checksums

Ez összehasonlítja a fájljaidat a hivatalos WordPress-tárhely ellenőrző összegével.

Core újratelepítése
Ha a fájlok sérültek, akkor a tartalmak befolyásolása nélkül kényszerítheti ki az újratelepítést:

wp core download --force --skip-content

Tartalom, felhasználók és adatbázis kezelése

A WP-CLI lehetővé teszi, hogy közvetlenül interakcióba lépjen webhelye adataival.

Felhasználókezelés
Felhasználók listázása:

wp user list

Új rendszergazda létrehozása:

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

Felhasználói jelszó frissítése:

wp user update 1 --user_pass=newpassword

Felhasználó törlése és tartalmainak újbóli hozzárendelése:

wp user delete 5 --reassign=1

Adatbázisműveletek
Az adatbázis exportálása egy fájlba:

wp db export backup.sql

Adatbázis importálása fájlból:

wp db import backup.sql

Az adatbázis optimalizálása:

wp db optimize

Nyisson meg egy MySQL konzolt, amely közvetlenül a WordPress adatbázisához kapcsolódik:

wp db cli

Keresés és csere (A helyes út)

Egy WordPress oldal kézzel történő áthelyezése egy új domainre kockázatos, mivel az adatok gyakran sorba vannak rendezve az adatbázisban. Egy egyszerű SQL keresés-helyettesítés tönkreteszi a widgeteket és a témaopciókat. A WP-CLI helyesen kezeli a szerializálást.

Standard keresés-helyettesítés

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

Száraz futtatás (előnézet)
A parancs futtatása előtt mindig ellenőrizze, hogy mi fog változni:

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

Exportálás cserével
Az adatbázist a fájlban végrehajtott cserékkel együtt exportálhatja, az élő adatbázist érintetlenül hagyva:

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

Haladó karbantartás: Cron és objektum gyorsítótár

Cron-feladatok kezelése
Ütemezett események megtekintése:

wp cron event list

Az összes esedékes cron esemény azonnali futtatása:

wp cron event run --due-now

Tranziensek és gyorsítótár kezelése
Törölje az objektum gyorsítótárat:

wp cache flush

Törölje az összes lejárt tranzienst:

wp transient delete --expired

Feladatok automatizálása szkriptekkel

A WP-CLI parancsokat Bash szkriptekbe kombinálhatja az automatizált karbantartás érdekében.

Példa:
Hozzon létre egy maintain.sh nevű fájlt:

#!/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."

Tedd futtathatóvá (chmod +x maintain.sh) és futtasd, hogy másodpercek alatt elvégezd a teljes webhely karbantartását.

WP-CLI használata távolról SSH-n keresztül

Ha aliasokat konfigurál, nem kell bejelentkeznie a kiszolgálóra a parancsok futtatásához.

A helyi wp-cli.yml fájlban:

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

Most már a helyi gépről is futtathat parancsokat a távoli kiszolgálón:

wp @prod plugin list
wp @dev core version

Legjobb gyakorlatok

Mindig biztonsági mentés: Mielőtt tömeges frissítéseket vagy keresés-helyettesítés parancsokat futtatna, futtassa a wp db export.
Használja a száraz futást: A keresés-helyettesítéshez először mindig a --dry-run címet használja.
Ne Rootként fuss: A WP-CLI figyelmeztet, ha root-ként futtatod. Biztonságosabb, ha a webszerver felhasználójaként (pl. www-data) vagy az adott felhasználói fiókodként futtatod.
Tesztelés a stádiumban: Használja a WP-CLI-t a termelési webhely klónozásához a stagingre, tesztelje a frissítési szkripteket ott, majd alkalmazza a termelésben.

Következtetés

A WP-CLI a WordPress kezelését kattintások sorozatából racionalizált, szkriptelhető műveletekké alakítja át. Az olyan egyszerű parancsokkal kezdve, mint a verziók ellenőrzése és a bővítmények listázása, megteremti a fejlett automatizálás alapjait. A WP-CLI integrálása a munkafolyamataiba még ma számtalan órát takarít meg a WordPress-projektjei során.