WP-CLI: Kompletní průvodce správou WordPressu z příkazového řádku

WP-CLI je oficiální nástroj příkazového řádku pro správu instalací WordPressu přímo z terminálu, aniž byste museli otevírat prohlížeč. Pokud jste někdy strávili odpoledne klikáním na ovládací panel správce WordPressu, abyste aktualizovali pluginy na více webech, už víte, proč tento nástroj existuje.

V této příručce se dozvíte vše od instalace WP-CLI v systémech Linux, macOS a Windows až po automatizaci složitých úloh údržby pomocí skriptů a konfiguračních souborů. Ať už spravujete jeden blog nebo desítky klientských webů, zvládnutí WP-CLI zásadně změní způsob vaší práce se systémem WordPress.

Co se naučíte:

• Jak nainstalovat a nakonfigurovat WP-CLI v různých operačních systémech
• Základní příkazy pro správu pluginů, témat, uživatelů a obsahu
• Operace s databází včetně exportů, importů a bezpečného nahrazení při vyhledávání
• Techniky automatizace pomocí skriptů, aliasů a úloh cron
• Osvědčené postupy, jak se vyhnout běžným nástrahám při práci z terminálu

---

Co je WP-CLI? (nejprve stručné vysvětlení)

WP-CLI je zkratka pro WordPress Command Line Interface – open-source nástroj, který umožňuje spravovat weby WordPress výhradně z terminálu. Místo přihlašování do wp-admin a procházení nabídek můžete spouštět příkazy jako wp plugin update --all a sledovat, jak se celý zásobník zásuvných modulů během několika sekund aktualizuje.

Projekt vznikl kolem roku 2011 a vytvořili ho vývojáři, kteří chtěli rychlejší způsob správy WordPressu ve velkém měřítku. V roce 2017 se přesunul pod oficiální záštitu WordPress.org a nyní jej spravuje specializovaný tým přispěvatelů včetně Alaina Schlessera a Daniela Bachhubera.

Zde jsou informace o WP-CLI:

• Aktuální stabilní verze: WP-CLI řady 2.x
• Kompatibilita se systémem WordPress: Funguje s WordPress 5.x až 6.x (a historicky zpět na 3.7)
• Požadavky na PHP: Doporučuje se PHP 7.4+ nebo 8.x kvůli bezpečnosti a výkonu.
• Příkazový ekosystém: Více než 40 nadřazených příkazů pokrývajících prakticky všechny operace WordPressu.
• Primární uživatelé: Vývojáři, agentury, inženýři DevOps a zkušení uživatelé spravující komplexní nebo více webů.
• Distribuce: K dispozici jako soubor PHAR, prostřednictvím správců balíčků nebo předinstalovaný na mnoha spravovaných hostitelích WordPressu.

Hlavní výhody používání WP-CLI

Jakmile pochopíte, proč WP-CLI existuje, bude mnohem snazší ospravedlnit křivku učení. V této části jsou vysvětleny konkrétní výhody, kvůli kterým stojí za to tomuto nástroji věnovat čas.

Úspora času při opakovaných úkonech
Aktualizace 20 pluginů prostřednictvím ovládacího panelu WordPressu znamená 20 načtení stránek, 20 kliknutí a sledování 20 ukazatelů průběhu. S WP-CLI spustíte wp plugin update --all jednou a jdete dál. Pro agentury spravující více klientských webů se tento rozdíl promítá do hodin ušetřených každý týden.

Hromadné a automatizované operace
Vezměte si scénář, kdy připravujete 15 obchodů WooCommerce na Black Friday. Na každém webu potřebujete aktualizovat pluginy, vymazat mezipaměť a ověřit integritu databáze. WP-CLI vám umožní celou tuto sekvenci naskriptovat a provést ji na všech webech během několika minut, nikoli hodin. Mezi klíčové automatizační funkce patří:

• Aktualizace všech zásuvných modulů ve více instalacích pomocí jediného skriptu
• Hromadné vytváření uživatelů s předdefinovanými rolemi
• Provádění noční údržby pomocí cronu (optimalizace databáze, přechodné čištění)
• Nasazení identických konfigurací WordPressu do nových prostředí

Spolehlivost operací v prohlížeči
Operace v prohlížeči narážejí na časové limity HTTP. Velké databázové importy selhávají uprostřed procesu. Operace hledání a nahrazování poškozují serializovaná data, pokud jsou prováděny pomocí surového SQL. WP-CLI se všem těmto problémům vyhýbá, protože běží přímo na serveru bez omezení časového limitu a jeho příkaz search-replace správně zpracovává serializované datové struktury.

Přímé ovládání hlavních systémů WordPress
Z jednoho terminálu můžete:

• Export a import databáze WordPress
• Úprava nastavení wp-config.php
• Kontrola a spouštění událostí wp-cron
• Zapnutí a vypnutí režimu údržby
• Spuštění libovolného kódu PHP v kontextu WordPress

Snížení zátěže wp-admin
Na vytížených produkčních serverech spotřebovává každé načtení stránky s ovládacím panelem administrátora prostředky. Provádění operací údržby prostřednictvím WP-CLI snižuje zatížení webového serveru, což je důležité v obdobích s vysokou návštěvností.

Požadavky na WP-CLI a podporovaná prostředí

Před instalací WP-CLI je třeba ověřit, zda váš server nebo místní prostředí splňuje základní požadavky. Dobrou zprávou je, že většina moderních nastavení WordPressu již tyto požadavky splňuje.

Požadavky na verzi PHP:

• Minimálně: PHP 5.6 (i když je zastaralé)
• Doporučujeme: PHP 7.4, 8.0, 8.1, 8.2, 8.3, 8.4 nebo 8.5 pro bezpečnost a výkon v roce 2026.

Kompatibilita s verzí WordPressu:

• Historická podpora: WordPress 3.7 a novější
• Moderní cíl: WordPress 5.0 až 6.7+ pro současné projekty

Očekávání operačního systému:

• Nejlepší podpora: (Ubuntu 22.04 LTS, Debian 12, CentOS Stream, MacOS)
• Windows: Podporováno prostřednictvím WSL (Windows Subsystem for Linux) nebo nativní instalací PHP.

Další požadavky:

• PHP je k dispozici na příkazovém řádku (binární soubor php musí být ve vašem PATH).
• cURL nebo wget pro stažení souboru wp-cli.phar
• přístup SSH pro vzdálené servery (většina spravovaných hostingových plánů WordPress jej zahrnuje ve výchozím nastavení).

Mnoho populárních hostitelů, jako jsou Kinsta, SiteGround a DreamHost, nyní dodává WP-CLI s předinstalovaným rozhraním. WordPress.com také obsahuje WP-CLI pro weby s povoleným přístupem SSH.

Jak nainstalovat WP-CLI na Linux a macOS

Standardní způsob instalace používá oficiální soubor PHAR (archiv PHP). Tento postup funguje na terminálech Ubuntu, Debian, CentOS, Fedora a MacOS.

Krok 1: Stažení souboru PHAR
Otevřete terminál a stáhněte soubor wp-cli.phar pomocí příkazu curl:

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

Případně použijte wget:

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

Krok 2: Ověření stahování (nepovinné, ale doporučené)
Zkontrolujte kontrolní součet SHA-256 oproti oficiální hodnotě zveřejněné v dokumentaci WP-CLI, abyste se ujistili, že se souborem nebylo při stahování manipulováno:

sha256sum wp-cli.phar

Porovnejte výstup s kontrolním součtem uvedeným na oficiálních webových stránkách WP-CLI.

Krok 3: Otestujte soubor PHAR
Ověřte si, že soubor php funguje:

php wp-cli.phar --info

Měli byste vidět výstup zobrazující verzi WP-CLI, verzi PHP a systémové informace.

Krok 4: Uveďte soubor jako spustitelný a přesuňte jej do adresáře PATH
Označte soubor jako spustitelný a přesuňte jej do adresáře v systémovém adresáři PATH:

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

Příkaz sudo je obvykle vyžadován, protože /usr/local/bin je systémový adresář. Pokud budete WP-CLI primárně spouštět jako běžný uživatel, vyhněte se instalaci jako root.

Krok 5: Ověření globální instalace
Potvrďte, že WP-CLI je nyní globálně k dispozici:

wp --info
wp cli version

Měli byste vidět výstup potvrzující verzi wp cli, binární umístění PHP a údaje o operačním systému. V tuto chvíli máte WP-CLI nainstalovaný a připravený k použití.

Jak nainstalovat WP-CLI v systému Windows

Uživatelé systému Windows mají dvě hlavní možnosti: použití subsystému Windows Subsystem for Linux (WSL) nebo nastavení vlastní instalace systému Windows. WSL poskytuje prostředí podobnější Linuxu a obecně se doporučuje.

Možnost 1: Použití WSL (doporučeno)
Nejprve povolte WSL v systému Windows 10 nebo 11:

wsl --install

Nainstalujte Ubuntu z obchodu Microsoft Store a spusťte terminál Ubuntu. Odtud postupujte přesně podle stejného postupu instalace Linuxu, který byl popsán v předchozí části – stáhněte soubor phar, vytvořte jej spustitelný a přesuňte jej na adresu /usr/local/bin/wp.

Možnost 2: Nativní instalace pro Windows
Pro nativní instalaci je třeba mít nainstalovaný PHP pro Windows se spustitelným souborem php dostupným v systémové cestě PATH.

1. Stáhněte si a nainstalujte PHP z oficiálních stránek PHP pro Windows
2. Přidání adresáře PHP do proměnné prostředí PATH systému Windows
3. Ověřte si, že PHP funguje, otevřením Příkazového řádku a spuštěním příkazu php -v

Poté stáhněte soubor WP-CLI PHAR:

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

Od roku 2018 systém Windows standardně obsahuje curl, takže by to mělo fungovat bez dalšího nastavení. Vytvořte složku pro WP-CLI (např. C:\wp-cli) a přesuňte do ní stažený soubor.

Poté ve stejné složce vytvořte dávkový obalový soubor s názvem wp.bat:

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

Do systémové proměnné prostředí PATH přidejte adresu C:\wp-cli. Nyní otevřete nové okno příkazového řádku nebo prostředí PowerShell a ověřte to:

wp --info

Měli byste vidět verzi WP-CLI a údaje o prostředí, které potvrzují, že WP-CLI je správně nainstalován.

Základní používání WP-CLI a získávání nápovědy

Po instalaci WP-CLI je třeba pochopit základní vzorec příkazů, než se pustíte do konkrétních operací. Všechny příkazy WP-CLI mají tuto strukturu:

wp <command> <subcommand> [options]

Příkazy se spouštějí z instalačního adresáře WordPressu – složky obsahující wp-config.php. Pokud se nacházíte jinde, můžete cestu zadat pomocí --path=/var/www/html/mysite.

Kontrola prostředí
Začněte potvrzením nastavení:

wp --info

Zobrazí se verze WP-CLI, verze PHP, binární cesta PHP, operační systém a další údaje o prostředí. Chcete-li zobrazit pouze verzi WP-CLI:

wp cli version

Prozkoumání dostupných příkazů
Seznam všech dostupných příkazů wp cli:

wp help

Nápověda ke konkrétnímu příkazu:

wp help plugin
wp help core update

K jakémukoli příkazu můžete také připojit adresu --help:

wp user --help

Výstup nápovědy se zobrazí v pageru podobně jako manuálové stránky Unixu. Stisknutím tlačítka q nápovědu ukončíte.

První příkazy k vyzkoušení:

• wp core version – zobrazí vaši verzi WordPressu
• wp plugin list – zobrazí všechny nainstalované pluginy WordPress s jejich stavem
• wp theme list – zobrazuje nainstalovaná témata
• wp user list – seznam všech uživatelů na webu

Tyto příkazy pouze pro čtení vám umožní prozkoumat web WordPress, aniž byste cokoli měnili, což je ideální pro seznámení se s rozhraním.

Instalace a konfigurace WordPressu pomocí WP-CLI

WP-CLI dokáže provést kompletní novou instalaci WordPressu rychleji než tradiční webový instalátor. To je cenné zejména při vytváření vývojových prostředí nebo programovém nasazování nových webů.

Předpoklady
Před spuštěním instalačních příkazů je třeba mít připravenou databázi MySQL nebo MariaDB. Pro tento příklad předpokládejme, že jste ji vytvořili:

• Název databáze: wpsite_db
• Uživatel databáze: wpsite_user
• Heslo: securepassword123
• Hostitel: localhost

Krok 1: Stažení souborů jádra WordPressu
Přejděte do požadovaného instalačního adresáře a stáhněte jádro WordPressu:

wp core download

Tím se načte nejnovější verze systému WordPress. Zadání verze nebo locale:

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

Po dokončení se zobrazí potvrzení, že WordPress byl úspěšně stažen.

Krok 2: Vytvoření wp-config.php
Vytvořte konfigurační soubor pomocí wp config create:

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

Tím se vygeneruje kompletní stránka wp-config.php s přihlašovacími údaji k databázi a automaticky vygenerovanými bezpečnostními solemi.

Krok 3: Spusťte instalaci
Nyní nainstalujte WordPress s údaji o svých stránkách:

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

Zobrazí se zpráva „WordPress byl úspěšně nainstalován“ a váš web je připraven k použití.

Instalace více webů
Pro sítě WordPress s více weby použijte variantu multisite. WP-CLI dokáže konfigurovat multisite instalace pomocí:

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

Správa témat pomocí WP-CLI

WP-CLI zpracovává všechny operace s motivem bez nutnosti přístupu do správcovského panelu WordPressu. Motivy můžete vypisovat, instalovat, aktivovat, aktualizovat a odstraňovat přímo z terminálu.

Seznam nainstalovaných motivů
Zobrazení všech aktuálně nainstalovaných motivů:

wp theme list

Ukázka výstupu:

název	stav	aktualizace	verze
twentytwentyfour	aktivní	none	1.0
twentytwentythree	neaktivní	none	1.2
astra	neaktivní	k dispozici na	4.5.0

Aktivace motivu
Přepnutí na jiný motiv:

wp theme activate astra

Tím se okamžitě změní aktivní téma. Přepnutí zpět na výchozí motiv je užitečné při řešení problémů souvisejících s motivem:

wp theme activate twentytwentyfour

Instalace nových témat
Nainstalujte téma z úložiště WordPress.org:

wp theme install astra

Instalace a aktivace jedním příkazem:

wp theme install astra --activate

Aktualizace motivů
Aktualizace konkrétního motivu:

wp theme update astra

Nebo aktualizujte všechna témata najednou:

wp theme update --all

Odstranění motivů
Odstraňte motiv, který již nepotřebujete:

wp theme delete twentytwentythree

Správa zásuvných modulů pomocí WP-CLI

Správa zásuvných modulů je oblast, kde WP-CLI šetří nejvíce času. Můžete provádět hromadné operace, které by v ovládacím panelu zabraly desítky kliknutí.

Seznam zásuvných modulů

wp plugin list

Ukázka výstupu:

název	stav	aktualizace	verze
woocommerce	aktivní	none	8.5.1
yoast-seo	aktivní	k dispozici na	21.0
elementor	neaktivní	none	3.18.0

Instalace zásuvných modulů
Instalace zásuvného modulu podle jeho slugu:

wp plugin install woocommerce

Instalace a aktivace:

wp plugin install yoast-seo --activate

Aktivace a deaktivace
Aktivace zásuvného modulu:

wp plugin activate elementor

Deaktivace zásuvného modulu (užitečné pro ladění):

wp plugin deactivate elementor

Deaktivace všech zásuvných modulů najednou (záchrana při ladění „bílé obrazovky smrti“):

wp plugin deactivate --all

Aktualizace zásuvných modulů
Aktualizace konkrétního zásuvného modulu:

wp plugin update yoast-seo

Aktualizujte všechny pluginy:

wp plugin update --all

Z hromadné aktualizace můžete také vyloučit konkrétní zásuvné moduly:

wp plugin update --all --exclude=woocommerce

Aktualizace a oprava jádra WordPressu

Aktualizace systému WordPress je z hlediska bezpečnosti velmi důležitá. Díky WP-CLI je tento proces transparentní a kontrolovatelný.

Kontrola aktualizací

wp core check-update

Aktualizace WordPressu
Aktualizace na nejnovější verzi:

wp core update

Po aktualizaci jádra je vhodné aktualizovat schéma databáze:

wp core update-db

Ověření kontrolních součtů
Pokud máte podezření, že byl váš web napaden hackery, můžete ověřit, zda nebyly upraveny základní soubory:

wp core verify-checksums

Porovná vaše soubory s kontrolními součty oficiálního úložiště WordPress.

Přeinstalace jádra
Pokud jsou soubory poškozené, můžete si vynutit přeinstalaci, aniž by to ovlivnilo obsah:

wp core download --force --skip-content

Správa obsahu, uživatelů a databáze

WP-CLI umožňuje přímou interakci s daty vašeho webu.

Správa uživatelů
Seznam uživatelů:

wp user list

Vytvoření nového správce:

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

Aktualizace uživatelského hesla:

wp user update 1 --user_pass=newpassword

Odstranění uživatele a nové přiřazení jeho obsahu:

wp user delete 5 --reassign=1

Operace s databází
Export databáze do souboru:

wp db export backup.sql

Importovat databázi ze souboru:

wp db import backup.sql

Optimalizace databáze:

wp db optimize

Otevřete konzolu MySQL přímo připojenou k databázi WordPress:

wp db cli

Hledání a nahrazování (správný způsob)

Ruční přesun webu WordPress na novou doménu je riskantní, protože data jsou často v databázi serializována. Jednoduché nalezení a nahrazení SQL naruší widgety a možnosti témat. WP-CLI zvládá serializaci správně.

Standardní vyhledávání a nahrazování

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

Suché spuštění (náhled)
Před spuštěním příkazu vždy zkontrolujte, co se změní:

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

Export s nahrazením
Databázi můžete exportovat s nahrazením provedeným v souboru, přičemž živá databáze zůstane nedotčena:

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

Pokročilá údržba: Cron a mezipaměť objektů

Správa úloh Cron
Zobrazení naplánovaných událostí:

wp cron event list

Okamžité spuštění všech řádných událostí cronu:

wp cron event run --due-now

Správa přechodných stavů a mezipaměti
Vymazání mezipaměti objektů:

wp cache flush

Odstranění všech přechodných stavů, jejichž platnost vypršela:

wp transient delete --expired

Automatizace úloh pomocí skriptů

Příkazy WP-CLI můžete kombinovat do skriptů Bash pro automatizovanou údržbu.

Příklad:
Vytvořte soubor s názvem 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."

Vytvořte jej spustitelný (chmod +x maintain.sh) a spusťte jej, abyste během několika sekund provedli kompletní údržbu webu.

Vzdálené používání WP-CLI přes SSH

Pokud nakonfigurujete aliasy, nemusíte se ke spuštění příkazů přihlašovat na server.

V místním souboru wp-cli.yml:

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

Nyní můžete spouštět příkazy na vzdáleném serveru z místního počítače:

wp @prod plugin list
wp @dev core version

Osvědčené postupy

• Vždy zálohujte: Před spuštěním hromadných aktualizací nebo příkazů pro vyhledávání a nahrazování spusťte wp db export.
• Použijte funkci Dry Run: Pro vyhledávání a nahrazování vždy nejprve použijte stránku --dry-run.
• Nespouštějte jako Root: WP-CLI vás varuje, pokud jste spuštěni jako root. Bezpečnější je spustit jej jako uživatel webového serveru (např. www-data) nebo jako váš konkrétní uživatelský účet.
• Test na staging: Pomocí WP-CLI naklonujte produkční web na staging, otestujte tam aktualizační skripty a poté je použijte na produkční web.

Závěr

WP-CLI mění správu WordPressu z řady kliknutí na zjednodušené, skriptovatelné operace. Začínáte jednoduchými příkazy, jako je kontrola verzí a výpis zásuvných modulů, a vytváříte tak základ pro pokročilou automatizaci. Integrace WP-CLI do vašeho pracovního postupu ještě dnes ušetří nespočet hodin napříč vašimi projekty WordPress.