Správa WordPressu nemusí znamenat jen klikání v administraci. Pro naše klienty provozujeme dedikovaný WP-CLI server, který jsme právě kompletně přepracovali na moderní základ Debian 13 s nejnovějšími nástroji. Ať už spravujete jeden web nebo desítky projektů, příkazová řádka vám ušetří hodiny práce, které byste jinak strávili proklikáváním administrace.

Co je WP-CLI?

WP-CLI je oficiální nástroj pro správu WordPressu z příkazové řádky. Vyvíjí ho komunita pod záštitou projektu WordPress a používají ho vývojáři, správci serverů i hostingové společnosti po celém světě.

Princip je jednoduchý – místo přihlašování do administrace, hledání správné stránky a klikání na tlačítka zadáte jeden příkaz a je hotovo. Co v administraci trvá minuty, na příkazové řádce zvládnete za sekundy.

WP-CLI přitom umí prakticky vše, co webová administrace – a v mnoha případech výrazně víc. Pracuje přímo s databází a soubory WordPressu, takže funguje i v situacích, kdy se do administrace nedá přihlásit. Bílá stránka, zablokovaný přístup, poškozený plugin? WP-CLI si s tím poradí.

K čemu se WP-CLI hodí v praxi?

Aktualizace bez stresu

Udržovat WordPress aktuální je základ bezpečnosti. S WP-CLI aktualizujete celý web jedním příkazem:

wp core update
wp plugin update --all
wp theme update --all
wp core update-db

Tyto čtyři příkazy provedou kompletní aktualizaci – jádro WordPressu, všechny pluginy, všechny šablony a databázové migrace. V administraci by vás to stálo desítky kliknutí a několik minut čekání na načítání stránek.

Chcete před aktualizací vědět, co se změní?

wp plugin list --update=available

Zobrazí přehlednou tabulku pluginů, u kterých je dostupná novější verze, včetně aktuální a dostupné verze.

Správa uživatelů

Potřebujete vytvořit nový administrátorský účet? Například když klient zapomněl heslo a nemá přístup k e-mailu:

wp user create jan jan@example.cz --role=administrator --user_pass=silneHeslo123

Uživatel je vytvořen okamžitě. Stejně snadno změníte heslo existujícímu uživateli:

wp user update admin --user_pass=noveHeslo456

Nebo zobrazíte přehled všech administrátorů na webu:

wp user list --role=administrator

Práce s databází

WP-CLI nabízí přímou práci s WordPress databází bez nutnosti phpMyAdmina. Export celé databáze:

wp db export zaloha.sql

Import ze souboru:

wp db import databaze.sql

Spuštění libovolného SQL dotazu:

wp db query "SELECT COUNT(*) FROM wp_posts WHERE post_type='post' AND post_status='publish'"

Optimalizace databázových tabulek:

wp db optimize

Search-Replace: nepostradatelný nástroj pro migrace

Jedním z nejvýkonnějších příkazů WP-CLI je wp search-replace. WordPress ukládá do databáze absolutní URL adresy – v obsahu článků, nastavení pluginů, widgetech i serializovaných datech. Při změně domény nebo přechodu na HTTPS je nutné tyto adresy nahradit.

Ruční úprava databáze by byla zdlouhavá a riskantní – WordPress používá serializované pole, kde prostý find-replace rozbije datovou strukturu. WP-CLI toto řeší automaticky:

wp search-replace 'http://stara-domena.cz' 'https://nova-domena.cz'

Příkaz projde všechny tabulky, najde výskyty starého řetězce a nahradí je novým. U serializovaných dat automaticky přepočítá délky řetězců, takže nedojde k poškození konfigurace pluginů ani widgetů.

Před ostrým zásahem si můžete nechat zobrazit náhled změn bez jejich provedení:

wp search-replace 'http://stara-domena.cz' 'https://nova-domena.cz' --dry-run

Výstup ukáže, kolik nahrazení by se provedlo v každé tabulce. Typické scénáře použití:

Přechod na HTTPS:

wp search-replace 'http://mujweb.cz' 'https://mujweb.cz'

Změna domény:

wp search-replace 'stary-web.cz' 'novy-web.cz'

Přesun z podadresáře:

wp search-replace 'example.cz/wordpress' 'example.cz'

Nastavení viditelnosti pro vyhledávače

Při migraci webu, přípravě nového projektu nebo práci na staging kopii často potřebujete zakázat indexování vyhledávači. WordPress má pro to volbu „Viditelnost pro vyhledávače“, kterou přes WP-CLI nastavíte jedním příkazem:

Vypnutí indexování (vyhledávače nebudou web indexovat):

wp option update blog_public 0

Zapnutí indexování (web bude viditelný pro vyhledávače):

wp option update blog_public 1

To je užitečné zejména při přípravě webu, kdy nechcete, aby Google indexoval nedokončený obsah. Jakmile je web připraven, indexování jednoduše zapnete zpět.

Nastavení trvalých odkazů (permalinks)

Struktura trvalých odkazů ovlivňuje SEO i čitelnost URL adres. WP-CLI umožňuje nastavit strukturu bez přístupu do administrace:

Nastavení SEO-friendly struktury (nejčastější volba – název příspěvku):

wp rewrite structure '/%postname%/'

Vyprázdnění pravidel přesměrování (nutné po změně struktury):

wp rewrite flush

Další běžné formáty:

wp rewrite structure '/%category%/%postname%/'
wp rewrite structure '/%year%/%monthnum%/%postname%/'

Generování testovacího obsahu

Při vývoji šablony nebo testování pluginu potřebujete realistický obsah. Ruční vytváření desítek článků a stránek je zdlouhavé. WP-CLI vygeneruje testovací obsah během sekund:

Generování článků:

wp post generate --count=50 --post_type=post --post_status=publish

Generování stránek:

wp post generate --count=10 --post_type=page --post_status=publish

Generování uživatelů pro testování:

wp user generate --count=20 --role=subscriber

Až testování skončí, vygenerovaný obsah snadno smažete:

wp post delete $(wp post list --post_type=post --format=ids) --force

Diagnostika a řešení problémů

WP-CLI je neocenitelný při řešení problémů, zvláště když administrace nefunguje:

Deaktivace všech pluginů (řeší bílou stránku):

wp plugin deactivate --all

Postupná aktivace pro nalezení problematického pluginu:

wp plugin activate kontaktni-formular
wp plugin activate seo-plugin
wp plugin activate problem-plugin

Kontrola integrity souborů jádra:

wp core verify-checksums

Přehled systémových informací:

wp core version
wp option get siteurl
wp plugin list --status=active

Vyčištění cache:

wp cache flush
wp transient delete --all

Kompletní sada nástrojů pro práci i migraci

WP-CLI server nenabízí jen samotné WP-CLI. Připravili jsme kompletní prostředí se všemi nástroji, které potřebujete pro každodenní správu i jednorázové operace jako migrace.

Composer – správce PHP závislostí. Ideální pro projekty, které využívají vlastní knihovny nebo moderní workflow vývoje WordPressu. Instalace balíčků přímo na serveru bez nutnosti nahrávat je přes FTP.

Git – verzovací systém přímo na serveru. Klonujte repozitáře, stahujte pluginy z GitHubu nebo spravujte vlastní kód z příkazové řádky. Užitečný i pro deployment – stáhněte aktuální verzi projektu jedním příkazem git pull.

rsync – nástroj pro efektivní synchronizaci souborů. Při migraci webu z jiného hostingu přenesete i desítky GB dat spolehlivě a rychle. Rsync přenáší pouze změněné soubory a umí pokračovat v přerušeném přenosu. V kombinaci s wp db export a wp search-replace zvládnete kompletní migraci webu:

rsync -avz user@stary-server:/var/www/web/ /data/
wp db import databaze.sql
wp search-replace 'stary-hosting.cz' 'nas-hosting.cz'
wp rewrite flush
wp option update blog_public 1

MySQL klient – přímý přístup k databázi bez phpMyAdmina. Spusťte SQL dotazy, exportujte a importujte databáze, analyzujte strukturu tabulek.

Midnight Commander (mc) – dvoupanelový správce souborů pro vizuální práci v terminálu. Kopírování, přesouvání, porovnávání souborů – vše v přehledném rozhraní.

nano – jednoduchý textový editor pro rychlé úpravy konfiguračních souborů přímo na serveru. Úprava wp-config.php nebo .htaccess bez stahování a nahrávání souborů.

zip, rar, tar – kompletní podpora archivů. Zabalte zálohu, rozbalte migrační archiv nebo komprimujte velké soubory pro stažení.

Čtyři verze PHP s okamžitým přepínáním

Na WP-CLI serveru máte k dispozici PHP 7.4, 8.0, 8.4 a 8.5. Přepnutí mezi verzemi je okamžité – stačí jeden příkaz:

phpswitch 8.0
PHP přepnuto na 8.0:
PHP 8.0.30 (cli)

Bez parametrů zobrazí aktuální verzi a seznam dostupných:

phpswitch
Aktuální PHP:
PHP 8.4.4 (cli)

Dostupné verze: 7.4 8.0 8.4 8.5
Použití: phpswitch <verze>

Všechny verze mají nainstalovaná shodná rozšíření jako na webovém serveru – mysql, curl, gd, imagick, redis, memcached, intl, bcmath a další. Co funguje na webu, funguje i v CLI. To je důležité zejména pro testování kompatibility – přepněte na jinou verzi PHP a ověřte, zda web funguje bez chyb.

Bezpečný přístup přes SSH

K serveru se připojíte přes SSH s klíčovou autentizací. Žádná hesla, žádné riziko odposlechnutí. Každý klient pracuje ve vlastním izolovaném prostředí s přístupem výhradně ke svým webovým datům.

Po přihlášení vás uvítá přehledná obrazovka s výpisem dostupných nástrojů, informací o posledním přihlášení a odpočtem zbývajícího času relace.

Důležité: weby s Redis Object Cache

Pokud váš web používá Redis Object Cache, je nutné při práci s WP-CLI přidat parametr --skip-plugins=redis-cache:

wp --skip-plugins=redis-cache plugin update --all
wp --skip-plugins=redis-cache search-replace 'stara.cz' 'nova.cz'
wp --skip-plugins=redis-cache option update blog_public 1

Redis server běží lokálně na webovém serveru a z WP-CLI serveru není dostupný. Bez tohoto parametru by WP-CLI hlásilo chybu při pokusu o připojení k Redisu. Na funkčnost webu ani prováděných příkazů to nemá žádný vliv – parametr pouze přeskočí načtení pluginu redis-cache během provádění CLI příkazu. Samotný Redis na webovém serveru běží dál bez přerušení.

Kompletní přehled nástrojů

WP-CLI – kompletní správa WordPressu z příkazové řádky
Composer – správa PHP závislostí a balíčků
Git – verzování kódu, deployment z repozitářů
rsync – synchronizace a migrace souborů
MySQL klient – přímá práce s databází
mc – vizuální správce souborů
nano – textový editor
php – PHP 7.4, 8.0, 8.4, 8.5 s přepínáním
phpswitch – okamžité přepnutí verze PHP
zip / rar / tar – práce s archivy
bash completion – TAB doplňování příkazů i WP-CLI parametrů

Jak se připojit

WP-CLI server je dostupný všem klientům WP Hosting / WPCloud. Stačí mít nahraný SSH veřejný klíč v klientské sekci – připojení zajistíme automaticky. Pokud s SSH klíči potřebujete poradit, rádi vám pomůžeme.

Podrobnosti naleznete v klientské sekci nebo nás kontaktujte na podpora@wp-hosting.cz.

Máte tip na zajímavé WP-CLI skripty a chcete se o ně podělit s ostatními? Budeme rádi, když nám je zašlete na podpora@wp-hosting.cz.

Doporučeno k dalšímu čtení: