Před spuštěním příkazu vypište URL, cestu a prostředí, použijte explicitní rozsah a nejprve náhled nebo čtecí variantu. Při zápisu vytvořte ověřenou zálohu a protokol, velké změny rozdělte do dávek a navrhněte je jako opakovatelné. WP-CLI nespouštějte pod zbytečně privilegovaným systémovým účtem. Automatický běh chraňte zámkem, timeoutem, nenulovým chybovým kódem a upozorněním na chybějící výsledek. Search-replace provádějte nástrojem, který bezpečně zachová serializované hodnoty a nejprve podporuje dry-run.
WP-CLI umožňuje spravovat WordPress bez klikání v administraci. Umí vypsat pluginy, spustit cron, pracovat s databází, měnit obsah i provádět vlastní příkazy. Stejná síla však znamená, že nepřesný filtr nebo příkaz ve špatném prostředí může změnit tisíce záznamů dříve, než si člověk chyby všimne.
Bezpečné používání stojí na ověření cíle, náhledu, záloze, idempotenci a záznamu výsledku. Tento návod se neomezuje na seznam příkazů. Ukazuje provozní postup pro ruční zásahy i automatizaci, ochranu přihlašovacích údajů, práci s více weby a návrh vlastního příkazu, který lze zopakovat bez nepředvídatelného dopadu.
Ověřte binárku, cestu a cílové prostředí
Zjistěte původ a verzi WP-CLI i použitého PHP. Před každým zásahem vypište cestu k instalaci, hodnotu home URL a případně kontext multisite. Alias pomáhá, ale jeho název není důkaz; automatizace má mít explicitní cestu a kontrolu očekávané domény či značky prostředí.
Shellový účet má mít pouze nezbytná oprávnění k souborům a databázi. Nespouštějte příkazy WordPressu jako globální administrátor systému bez důvodu, protože vytvořené soubory mohou získat nesprávné vlastnictví. Produkční a stagingové přístupové údaje oddělte a nevkládejte hesla přímo do historie příkazů.
Začněte čtením a vytvořte bezpečný náhled
Před hromadnou změnou spočítejte cíle a vypište jejich reprezentativní vzorek. Filtr podle typu, stavu a přesného meta klíče je bezpečnější než neomezený seznam ID. Pokud příkaz nemá dry-run, vytvořte vlastní režim, který provede stejný výběr a validaci, ale pouze zobrazí plánovaný výsledek.
Výstup ukládejte ve strojově čitelném formátu, pokud na něj navazuje skript. Nepřebírejte textovou tabulku, jejíž sloupce se mohou s verzí měnit. Každý automatický krok kontroluje návratový kód i očekávaný počet záznamů; prázdný výsledek nemusí být úspěchem, pokud jste čekali tisíc položek.
- Potvrzená cesta a doména
- Přesný filtr cílových záznamů
- Dry-run nebo náhled pouze pro čtení
- Očekávané počty a návratové kódy
Zápisy dávkujte a připravte návrat
Před nevratnou databázovou změnou vytvořte zálohu a ověřte, že je čitelná. Velké operace rozdělte do dávek s kurzorem, aby nevyčerpaly paměť a daly se po výpadku obnovit. Po každé dávce uložte počet úspěchů, odmítnutí a poslední stabilní identifikátor.
Search-replace testujte s dry-run a správnou serializací; obyčejná textová náhrada v SQL může poškodit uložené struktury. Při mazání používejte explicitní seznam ověřených ID a retenční pravidlo. Rollback nemusí být jen obnova celé databáze; při dobře navržené migraci lze zachovat původní hodnotu a vrátit konkrétní dávku.
Vlastní příkazy navrhujte jako veřejné rozhraní
Příkaz má popsané argumenty, výchozí hodnoty, příklady a chybové stavy. Validaci provede před prvním zápisem a podporuje dry-run. Opakované spuštění se stejným vstupem vytvoří stejný výsledek, nebo bezpečně oznámí, že práce již proběhla. Interaktivní otázky nesmí blokovat automatizovaný režim.
Obchodní logiku držte v testovatelné službě pluginu a CLI ať je pouze adaptérem. Stejnou funkci pak může bezpečně použít fronta nebo administrace. Průběžný výstup neobsahuje hesla, tokeny ani celé osobní záznamy. Při částečné chybě příkaz skončí nenulovým kódem a uvede bezpečný způsob pokračování.
Automatizaci uzamkněte a monitorujte
Naplánovaný příkaz chraňte před paralelním spuštěním zámkem s bezpečnou expirací. Nastavte timeout, limit dávky a samostatný log s rotací. Upozornění přijde při selhání, neobvykle dlouhém běhu i při chybějícím běhu. Zpráva o úspěchu obsahuje počty, ne jen slovo hotovo.
Po aktualizaci WordPressu, PHP nebo závislého pluginu spusťte ve stagingu integrační test příkazu. Runbook vysvětlí ruční náhled, obnovení kurzoru a odstranění zatuchlého zámku. Každý automatický příkaz má vlastníka a datum revize; zapomenutý cron se starou syntaxí je provozní riziko.
Časté dotazy
Je bezpečné používat WP-CLI na produkci?
Ano, pokud ověříte cíl a použijete minimální systémová oprávnění, přesný rozsah, náhled, zálohu a monitoring. Riziko vzniká hlavně u neomezeného příkazu bez možnosti návratu.
Jak provést dry-run příkazu, který ho nepodporuje?
Nejprve proveďte stejný výběr čtecím příkazem a uložte explicitní ID. U vlastního řešení přidejte přepínač, který validuje a vypíše plán bez zápisu. Nekopírujte naslepo produkční příkaz.
Může WP-CLI nahradit plánovač úloh?
WP-CLI může být výkonný mechanismus spouštěný systémovým plánovačem, ale stále potřebujete časování, zámek, timeout, log a upozornění na chybějící běh. Samotný příkaz monitoring nenahrazuje.
Zdroje a další čtení
Adam Antoni vyvíja weby, aplikácie a softvér na mieru. Prepája firemné systémy, automatizuje procesy a vytvára AI agentov. Pôsobí v Spišskej Novej Vsi a spolupracuje s firmami na celom Slovensku.
