14 min. prečítajte si

WP-CLI: Kompletný sprievodca správou WordPress z príkazového riadku

WP-CLI je oficiálny nástroj príkazového riadka na správu inštalácií WordPress priamo z terminálu bez toho, aby ste museli otvoriť prehliadač. Ak ste už niekedy strávili popoludnie klikaním v paneli správcu WordPress, aby ste aktualizovali pluginy na viacerých stránkach, už viete, prečo tento nástroj existuje.

V tejto príručke sa dozviete všetko od inštalácie WP-CLI v systémoch Linux, macOS a Windows až po automatizáciu zložitých úloh údržby pomocou skriptov a konfiguračných súborov. Bez ohľadu na to, či spravujete jeden blog alebo desiatky klientských lokalít, zvládnutie WP-CLI zásadne zmení spôsob vašej práce so systémom WordPress.

Čo sa naučíte:

Ako nainštalovať a nakonfigurovať WP-CLI v rôznych operačných systémoch
Základné príkazy na správu pluginov, tém, používateľov a obsahu
Operácie s databázou vrátane exportov, importov a bezpečného vyhľadávania a nahrádzania
Techniky automatizácie pomocou skriptov, aliasov a úloh cron
Osvedčené postupy, ako sa vyhnúť bežným nástrahám pri práci z terminálu

Čo je WP-CLI? (najprv rýchle vysvetlenie)

WP-CLI je skratka pre WordPress Command Line Interface (rozhranie príkazového riadka) – nástroj s otvoreným zdrojovým kódom, ktorý vám umožňuje spravovať stránky WordPress výhradne z terminálu. Namiesto prihlasovania sa do wp-admin a prechádzania cez ponuky môžete spúšťať príkazy, ako napríklad wp plugin update --all, a sledovať, ako sa celý zásobník zásuvných modulov aktualizuje v priebehu niekoľkých sekúnd.

Projekt vznikol okolo roku 2011 a vytvorili ho vývojári, ktorí chceli rýchlejšie spravovať WordPress vo veľkom meradle. V roku 2017 sa presunul pod oficiálnu strechu WordPress.org a teraz ho udržiava špecializovaný tím prispievateľov vrátane Alaina Schlessera a Daniela Bachhubera.

Tu sú informácie, ktoré potrebujete vedieť o WP-CLI:

Aktuálna stabilná verzia: WP-CLI série 2.x
Kompatibilita so systémom WordPress: Funguje s WordPress 5.x až 6.x (a historicky späť do 3.7)
Požiadavky na PHP: PHP 7.4+ alebo 8.x sa odporúča kvôli bezpečnosti a výkonu
Príkazový ekosystém: Viac ako 40 nadradených príkazov pokrývajúcich prakticky všetky operácie WordPress
Primárni používatelia: Vývojári, agentúry, inžinieri DevOps a výkonní používatelia, ktorí spravujú komplexné alebo viacero lokalít
Distribúcia: K dispozícii ako súbor PHAR, prostredníctvom správcov balíkov alebo predinštalovaný na mnohých spravovaných hostiteľoch WordPress

Hlavné výhody používania WP-CLI

Keď pochopíte, prečo WP-CLI existuje, bude oveľa jednoduchšie ospravedlniť krivku učenia. V tejto časti sú vysvetlené konkrétne výhody, pre ktoré sa vám oplatí venovať tomuto nástroju čas.

Úspora času pri opakujúcich sa úlohách
Aktualizácia 20 pluginov prostredníctvom ovládacieho panela WordPress znamená 20 načítaní stránok, 20 kliknutí a sledovanie 20 panelov priebehu. S WP-CLI spustíte stránku wp plugin update --all raz a idete ďalej. Pre agentúry, ktoré spravujú viacero klientskych webov, sa tento rozdiel premietne do ušetrených hodín každý týždeň.

Hromadné a automatizované operácie
Zoberte si scenár, v ktorom pripravujete 15 obchodov WooCommerce na Black Friday. Potrebujete aktualizovať doplnky, vymazať vyrovnávaciu pamäť a overiť integritu databázy na každom webe. WP-CLI vám umožní celú túto sekvenciu naskriptovať a vykonať ju na všetkých lokalitách v priebehu niekoľkých minút namiesto hodín. Medzi kľúčové možnosti automatizácie patria:

Aktualizácia všetkých zásuvných modulov vo viacerých inštaláciách pomocou jediného skriptu
Hromadné vytváranie používateľov s preddefinovanými rolami
Spustenie nočnej údržby prostredníctvom cronu (optimalizácia databázy, prechodné čistenie)
Nasadenie identických konfigurácií WordPress do nových prostredí

Spoľahlivosť operácií v prehliadači
Operácie v prehliadači narážajú na časový limit HTTP. Veľké importy databáz zlyhávajú uprostred procesu. Operácie vyhľadávania a nahrádzania poškodzujú serializované údaje, ak sa vykonávajú pomocou surového jazyka SQL. WP-CLI sa vyhýba všetkým týmto problémom, pretože beží priamo na serveri bez obmedzenia časového limitu a jeho príkaz search-replace správne spracúva serializované dátové štruktúry.

Priame ovládanie základných systémov WordPress
Z jedného terminálu môžete:

Export a import databázy WordPress
Úprava nastavení stránky wp-config.php
Kontrola a spúšťanie udalostí wp-cron
Zapnutie a vypnutie režimu údržby
Spustenie ľubovoľného kódu PHP v kontexte WordPress

Zníženie záťaže wp-admin
Na vyťažených produkčných serveroch každé načítanie stránky administrátorského panelu spotrebúva zdroje. Spúšťanie údržbových operácií prostredníctvom WP-CLI znižuje zaťaženie webového servera, čo je dôležité v obdobiach s vysokou návštevnosťou.

Požiadavky a podporované prostredia WP-CLI

Pred inštaláciou WP-CLI musíte potvrdiť, že váš server alebo miestne prostredie spĺňa základné požiadavky. Dobrou správou je, že väčšina moderných nastavení WordPress už spĺňa tieto požiadavky.

Požiadavky na verziu PHP:

Minimálne: PHP 5.6 (aj keď je to už zastarané)
Odporúčame: PHP 7.4, 8.0, 8.1, 8.2, 8.3, 8.4 alebo 8.5 pre bezpečnosť a výkon v roku 2026

Kompatibilita s verziami WordPress:

Historická podpora: WordPress 3.7 a novšie
Moderný cieľ: WordPress 5.0 až 6.7+ pre aktuálne projekty

Očakávania operačného systému:

Najlepšia podpora: (Ubuntu 22.04 LTS, Debian 12, CentOS Stream, macOS)
Windows: Podporované prostredníctvom WSL (Windows Subsystem for Linux) alebo vlastnej inštalácie PHP

Ďalšie požiadavky:

PHP dostupné v príkazovom riadku (binárny súbor php musí byť vo vašom PATH)
cURL alebo wget na stiahnutie súboru wp-cli.phar
Prístup SSH pre vzdialené servery (väčšina spravovaných hostingových plánov WordPress ho štandardne obsahuje)

Mnohí populárni hostitelia, ako napríklad Kinsta, SiteGround a DreamHost, sú teraz dodávaní s predinštalovaným WP-CLI. WordPress.com tiež obsahuje WP-CLI pre weby s povoleným prístupom SSH.

Ako nainštalovať WP-CLI na Linux a macOS

Štandardný spôsob inštalácie používa oficiálny súbor PHAR (archív PHP). Tento postup funguje na termináloch Ubuntu, Debian, CentOS, Fedora a macOS.

Krok 1: Stiahnutie súboru PHAR
Otvorte terminál a stiahnite súbor wp-cli.phar pomocou curl:

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

Prípadne použite wget:

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

Krok 2: Overenie stiahnutia (nepovinné, ale odporúčané)
Skontrolujte, či kontrolný súčet SHA-256 zodpovedá oficiálnej hodnote zverejnenej v dokumentácii WP-CLI, aby ste sa uistili, že so súborom nebolo počas sťahovania manipulované:

sha256sum wp-cli.phar

Porovnajte výstup s kontrolným súčtom uvedeným na oficiálnej webovej stránke WP-CLI.

Krok 3: Testovanie súboru PHAR
Overte si, či súbor php funguje:

php wp-cli.phar --info

Mali by ste vidieť výstup so zobrazením verzie WP-CLI, verzie PHP a systémových informácií.

Krok 4: Urobte ho spustiteľným a presuňte ho do adresára PATH
Označte súbor ako spustiteľný a presuňte ho do adresára v systéme PATH:

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

Príkaz sudo je zvyčajne potrebný, pretože /usr/local/bin je systémový adresár. Vyhnite sa inštalácii WP-CLI ako root, ak ho budete primárne spúšťať ako bežný používateľ.

Krok 5: Overenie globálnej inštalácie
Potvrďte, že WP-CLI je teraz globálne dostupný:

wp --info
wp cli version

Mali by ste vidieť výstup potvrdzujúci verziu wp cli, binárne umiestnenie PHP a údaje o operačnom systéme. V tomto okamihu máte WP-CLI nainštalovaný a pripravený na používanie.

Ako nainštalovať WP-CLI v systéme Windows

Používatelia systému Windows majú dve hlavné možnosti: použitie subsystému Windows pre Linux (WSL) alebo nastavenie vlastnej inštalácie systému Windows. WSL poskytuje viac skúseností s Linuxom a vo všeobecnosti sa odporúča.

Možnosť 1: Použitie WSL (odporúčané)
Najprv povoľte WSL v systéme Windows 10 alebo 11:

wsl --install

Nainštalujte Ubuntu z obchodu Microsoft Store a potom spustite terminál Ubuntu. Odtiaľ postupujte presne podľa rovnakých krokov inštalácie Linuxu uvedených v predchádzajúcej časti – stiahnite súbor phar, vytvorte ho spustiteľný a presuňte ho na stránku /usr/local/bin/wp.

Možnosť 2: Natívna inštalácia systému Windows
Pre natívnu inštaláciu je potrebné mať nainštalovaný PHP pre Windows so spustiteľným súborom php, ktorý je k dispozícii v systémovej ceste PATH.

Prevzatie a inštalácia PHP z oficiálnej stránky PHP pre Windows
Pridanie adresára PHP do premennej prostredia PATH systému Windows
Potvrďte, že PHP funguje, otvorením Príkazového riadku a spustením php -v

Potom si stiahnite súbor WP-CLI PHAR:

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

Systém Windows obsahuje curl v predvolenom nastavení od roku 2018, takže by to malo fungovať bez ďalšieho nastavovania. Vytvorte priečinok pre WP-CLI (napr. C:\wp-cli) a presuňte doň stiahnutý súbor.

Potom vytvorte dávkový obalový súbor s názvom wp.bat v tom istom priečinku:

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

Do systémovej premennej prostredia PATH pridajte adresu C:\wp-cli. Teraz otvorte nové okno príkazového riadku alebo PowerShellu a overte:

wp --info

Mali by sa zobraziť údaje o verzii WP-CLI a prostredí, ktoré potvrdzujú, že WP-CLI je správne nainštalovaný.

Základné používanie WP-CLI a získavanie nápovedy

Po nainštalovaní WP-CLI musíte pochopiť základný vzor príkazov predtým, ako sa pustíte do konkrétnych operácií. Všetky príkazy WP-CLI majú túto štruktúru:

wp <command> <subcommand> [options]

Príkazy sa vykonávajú z adresára inštalácie WordPress – adresára obsahujúceho wp-config.php. Ak sa nachádzate inde, cestu môžete zadať pomocou adresy --path=/var/www/html/mysite.

Kontrola prostredia
Začnite potvrdením nastavenia:

wp --info

Zobrazí sa verzia WP-CLI, verzia PHP, binárna cesta PHP, operačný systém a ďalšie údaje o prostredí. Ak chcete zobraziť len verziu WP-CLI:

wp cli version

Preskúmanie dostupných príkazov
Zoznam všetkých dostupných príkazov wp cli:

wp help

Nápoveda k určitému príkazu:

wp help plugin
wp help core update

K ľubovoľnému príkazu môžete pripojiť aj adresu --help:

wp user --help

Výstup nápovedy sa zobrazí v pageri podobne ako manuálové stránky Unixu. Stlačením tlačidla q ukončíte prácu.

Prvé príkazy na vyskúšanie:

wp core version – zobrazí vašu verziu WordPress
wp plugin list – zobrazuje všetky nainštalované pluginy WordPress s ich stavom
wp theme list – zobrazuje nainštalované témy
wp user list – zoznam všetkých používateľov na stránke

Tieto príkazy len na čítanie vám umožnia preskúmať vašu lokalitu WordPress bez toho, aby ste čokoľvek zmenili, čo je ideálne na zoznámenie sa s rozhraním.

Inštalácia a konfigurácia WordPress pomocou WP-CLI

WP-CLI dokáže vykonať kompletnú novú inštaláciu WordPress rýchlejšie ako tradičný webový inštalátor. To je cenné najmä pri vytváraní vývojových prostredí alebo pri programovom nasadzovaní nových lokalít.

Predpoklady
Pred spustením inštalačných príkazov musíte mať pripravenú databázu MySQL alebo MariaDB. Pre tento príklad predpokladáme, že ste ju vytvorili:

Názov databázy: wpsite_db
Používateľ databázy: wpsite_user
Heslo: securepassword123
Hostiteľ: localhost

Krok 1: Stiahnite si súbory jadra WordPress
Prejdite do požadovaného inštalačného adresára a stiahnite si jadro WordPress:

wp core download

Tým sa načíta najnovšia verzia systému WordPress. Zadanie verzie alebo lokálneho prostredia:

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

Po dokončení sa zobrazí potvrdenie, že WordPress bol úspešne stiahnutý.

Krok 2: Generovanie wp-config.php
Vytvorte konfiguračný súbor pomocou wp config create:

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

Tým sa vygeneruje kompletná stránka wp-config.php s vašimi povereniami databázy a automaticky vygenerovanými bezpečnostnými soľami.

Krok 3: Spustite inštaláciu
Teraz nainštalujte WordPress s údajmi o vašej stránke:

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

Zobrazí sa správa „WordPress bol úspešne nainštalovaný“ a vaša stránka je pripravená na používanie.

Inštalácia na viacerých stránkach
Pre siete viacerých stránok WordPress použite variant multisite. WP-CLI môže konfigurovať multisite inštalácie pomocou:

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

Správa tém pomocou WP-CLI

WP-CLI spracúva všetky operácie s témou bez toho, aby bol potrebný prístup do riadiaceho panela WordPress. Témy môžete vypisovať, inštalovať, aktivovať, aktualizovať a odstraňovať priamo z terminálu.

Zobrazenie zoznamu nainštalovaných tém
Ak chcete zobraziť všetky aktuálne nainštalované témy:

wp theme list

Ukážka výstupu:

názov	stav	aktualizácia	verzia
dvadsaťštyri	aktívny	none	1.0
dvadsaťtri	neaktívne	none	1.2
astra	neaktívne	k dispozícii na	4.5.0

Aktivácia témy
Prepnutie na inú tému:

wp theme activate astra

Tým sa okamžite zmení aktívna téma. Prepnutie späť na predvolenú tému je užitočné pri riešení problémov súvisiacich s témou:

wp theme activate twentytwentyfour

Inštalácia nových tém
Nainštalujte tému z úložiska WordPress.org:

wp theme install astra

Inštalácia a aktivácia jedným príkazom:

wp theme install astra --activate

Aktualizácia tém
Aktualizácia konkrétnej témy:

wp theme update astra

Alebo aktualizujte všetky témy naraz:

wp theme update --all

Odstránenie tém
Odstráňte tému, ktorú už nepotrebujete:

wp theme delete twentytwentythree

Správa zásuvných modulov pomocou WP-CLI

Správa zásuvných modulov je oblasť, kde WP-CLI šetrí najviac času. Môžete vykonávať hromadné operácie, ktoré by v ovládacom paneli zabrali desiatky kliknutí.

Zoznam zásuvných modulov

wp plugin list

Ukážka výstupu:

názov	stav	aktualizácia	verzia
woocommerce	aktívny	none	8.5.1
yoast-seo	aktívny	k dispozícii na	21.0
elementor	neaktívne	none	3.18.0

Inštalácia zásuvných modulov
Inštalácia zásuvného modulu podľa jeho slugu:

wp plugin install woocommerce

Inštalácia a aktivácia:

wp plugin install yoast-seo --activate

Aktivácia a deaktivácia
Aktivácia zásuvného modulu:

wp plugin activate elementor

Deaktivácia zásuvného modulu (užitočné na ladenie):

wp plugin deactivate elementor

Deaktivujte všetky pluginy naraz (záchrana pri ladení „bielej obrazovky smrti“):

wp plugin deactivate --all

Aktualizácia zásuvných modulov
Aktualizácia konkrétneho zásuvného modulu:

wp plugin update yoast-seo

Aktualizujte všetky pluginy:

wp plugin update --all

Z hromadnej aktualizácie môžete vylúčiť aj konkrétne zásuvné moduly:

wp plugin update --all --exclude=woocommerce

Aktualizácia a oprava jadra WordPress

Udržiavanie aktualizovaného systému WordPress je z hľadiska bezpečnosti veľmi dôležité. Vďaka WP-CLI je tento proces transparentný a kontrolovateľný.

Kontrola aktualizácií

wp core check-update

Aktualizácia WordPress
Aktualizujte na najnovšiu verziu:

wp core update

Po aktualizácii jadra je vhodné aktualizovať schému databázy:

wp core update-db

Overenie kontrolných súm
Ak máte podozrenie, že vaše stránky boli napadnuté hackermi, môžete si overiť, či základné súbory neboli upravené:

wp core verify-checksums

Porovná vaše súbory s kontrolnými súčtami oficiálneho úložiska WordPress.

Preinštalovanie jadra
Ak sú súbory poškodené, môžete si vynútiť ich preinštalovanie bez toho, aby to ovplyvnilo váš obsah:

wp core download --force --skip-content

Správa obsahu, používateľov a databázy

WP-CLI umožňuje priamu interakciu s údajmi vašej stránky.

Správa používateľov
Zoznam používateľov:

wp user list

Vytvorte nového správcu:

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

Aktualizácia používateľského hesla:

wp user update 1 --user_pass=newpassword

Odstránenie používateľa a opätovné priradenie jeho obsahu:

wp user delete 5 --reassign=1

Operácie s databázou
Export databázy do súboru:

wp db export backup.sql

Importovať databázu zo súboru:

wp db import backup.sql

Optimalizujte databázu:

wp db optimize

Otvorte konzolu MySQL priamo pripojenú k databáze WordPress:

wp db cli

Vyhľadávanie a nahrádzanie (správny spôsob)

Ručné presúvanie stránky WordPress na novú doménu je riskantné, pretože údaje sú často serializované v databáze. Jednoduché nájdenie a nahradenie v SQL poruší widgety a možnosti témy. WP-CLI spracúva serializáciu správne.

Štandardné vyhľadávanie – nahradenie

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

Suché spustenie (náhľad)
Pred spustením príkazu vždy skontrolujte, čo sa zmení:

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

Export s nahradením
Databázu môžete exportovať s nahradeniami vykonanými v súbore, pričom živá databáza zostane nedotknutá:

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

Pokročilá údržba: Cron a vyrovnávacia pamäť objektov

Správa úloh Cron
Zobrazenie naplánovaných udalostí:

wp cron event list

Okamžité spustenie všetkých náležitých udalostí cronu:

wp cron event run --due-now

Správa prechodných stavov a vyrovnávacej pamäte
Vymazanie vyrovnávacej pamäte objektov:

wp cache flush

Odstránenie všetkých prechodných stavov, ktorým vypršala platnosť:

wp transient delete --expired

Automatizácia úloh pomocou skriptov

Príkazy WP-CLI môžete kombinovať do skriptov Bash na automatizovanú údržbu.

Príklad: Týždenný skript údržby
Vytvorte súbor s názvom 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."

Vytvorte ho spustiteľný (chmod +x maintain.sh) a spustite ho, aby ste v priebehu niekoľkých sekúnd vykonali úplnú údržbu webu.

Používanie WP-CLI na diaľku cez SSH

Ak nakonfigurujete aliasy, nemusíte sa prihlasovať na server, aby ste spustili príkazy.

V miestnom súbore wp-cli.yml:

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

Teraz môžete spúšťať príkazy na vzdialenom serveri z miestneho počítača:

wp @prod plugin list
wp @dev core version

Osvedčené postupy

Vždy zálohujte: Pred spustením hromadných aktualizácií alebo príkazov na nahradenie vyhľadávania spustite stránku wp db export.
Použite suchú jazdu: Pri vyhľadávaní a nahrádzaní vždy najprv použite stránku --dry-run.
Nespúšťajte ho ako Root: WP-CLI vás varuje, ak ho spustíte ako root. Bezpečnejšie je spustiť ho ako používateľ webového servera (napr. www-data) alebo ako vaše konkrétne používateľské konto.
Testovanie v štádiu stagingu: Použite WP-CLI na klonovanie vašej produkčnej stránky do staging, otestujte tam svoje aktualizačné skripty a potom ich aplikujte na produkciu.

Záver

WP-CLI transformuje správu WordPress zo série kliknutí na zjednodušené operácie, ktoré možno skriptovať. Začínajúc jednoduchými príkazmi, ako je kontrola verzií a výpis zásuvných modulov, buduje základ pre pokročilú automatizáciu. Integrácia WP-CLI do vášho pracovného postupu ešte dnes ušetrí nespočetné množstvo hodín v rámci vašich projektov WordPress.