WP-CLI: Пълно ръководство за управление на WordPress от командния ред

WP-CLI е официалният инструмент с команден ред за управление на инсталациите на WordPress директно от терминала, без да отваряте браузър. Ако някога сте прекарвали следобед в кликване върху таблото за управление на WordPress, за да актуализирате плъгини в няколко сайта, вече знаете защо съществува този инструмент.

В това ръководство ще научите всичко – от инсталирането на WP-CLI в Linux, macOS и Windows до автоматизирането на сложни задачи за поддръжка със скриптове и конфигурационни файлове. Независимо дали управлявате един блог или десетки клиентски сайтове, овладяването на WP-CLI ще промени из основи начина ви на работа с WordPress.

Какво ще научите:

• Как да инсталирате и конфигурирате WP-CLI в различни операционни системи
• Основни команди за управление на плъгини, теми, потребители и съдържание
• Операции с бази данни, включително експорт, импорт и безопасно търсене и замяна
• Техники за автоматизация с помощта на скриптове, псевдоними и задачи cron
• Най-добри практики за избягване на често срещани капани при работа от терминала

---

Какво е WP-CLI? (първо кратко обяснение)

WP-CLI е съкращение от WordPress Command Line Interface (интерфейс на командния ред на WordPress) – инструмент с отворен код, който ви позволява да управлявате сайтове на WordPress изцяло от терминала. Вместо да влизате в wp-admin и да навигирате из менютата, изпълнявате команди като wp plugin update --all и наблюдавате как целият ви набор от плъгини се актуализира за секунди.

Проектът стартира през 2011 г. и е създаден от разработчици, които искат по-бърз начин за управление на WordPress в голям мащаб. През 2017 г. той премина под официалната шапка на WordPress.org и сега се поддържа от специален екип от сътрудници, сред които са Ален Шлесер и Даниел Баххубер.

Ето какво трябва да знаете за WP-CLI:

• Текуща стабилна версия: WP-CLI серия 2.x
• Съвместимост с WordPress: Работи с WordPress от 5.x до 6.x (и исторически обратно до 3.7)
• Изисквания за PHP: Препоръчва се PHP 7.4+ или 8.x за сигурност и производителност
• Командна екосистема: Над 40 родителски команди, покриващи почти всяка операция на WordPress
• Основни потребители: Разработчици, агенции, DevOps инженери и потребители, които управляват сложни или множество сайтове
• Разпространение: Наличен като PHAR файл, чрез мениджъри на пакети или предварително инсталиран на много управлявани хостове на WordPress

Основни предимства на използването на WP-CLI

След като разберете защо съществува WP-CLI, кривата на обучение става много по-лесна за оправдаване. В този раздел са обяснени конкретните предимства, заради които този инструмент си заслужава да му отделите време.

Спестяване на време за повтарящи се задачи
Актуализирането на 20 плъгина чрез таблото за управление на WordPress означава 20 зареждания на страници, 20 кликвания и гледане на 20 ленти за напредък. С WP-CLI стартирате wp plugin update --all веднъж и продължавате. За агенциите, които управляват множество клиентски сайтове, тази разлика се изразява в спестени часове всяка седмица.

Масови и автоматизирани операции
Разгледайте сценарий, при който подготвяте 15 магазина на WooCommerce за Черния петък. Трябва да актуализирате плъгините, да изчистите кеша и да проверите целостта на базата данни на всеки сайт. WP-CLI ви позволява да съставите сценарий за цялата тази последователност и да я изпълните във всички сайтове за минути, а не за часове. Основните възможности за автоматизация включват:

• Актуализиране на всички плъгини в няколко инсталации с един скрипт
• Създаване на потребители в насипно състояние с предварително дефинирани роли
• Извършване на нощна поддръжка чрез cron (оптимизация на базата данни, почистване на преходни процеси)
• Разгръщане на идентични конфигурации на WordPress в нови среди

Надеждност на операциите, базирани на браузъра
Операциите в браузъра се сблъскват с HTTP таймаути. Големи импорти на бази данни се провалят по средата на процеса. Операциите за търсене и замяна повреждат сериализираните данни, когато се извършват с необработен SQL. WP-CLI избягва всички тези проблеми, тъй като работи директно на сървъра без ограничения за времетраене, а командата му за търсене и замяна обработва правилно сериализирани структури от данни.

Директен контрол върху основните системи на WordPress
От един терминал можете да:

• Експортиране и импортиране на базата данни на WordPress
• Промяна на настройките на wp-config.php
• Инспектиране и задействане на събитията на wp-cron
• Включване и изключване на режима на поддръжка
• Изпълнение на произволен PHP код в контекста на WordPress

Намалено натоварване на wp-admin
На натоварени производствени сървъри всяко зареждане на страница на таблото за управление отнема ресурси. Извършването на операции по поддръжка чрез WP-CLI намалява това натоварване на уеб сървъра, което е от значение в периоди на голям трафик.

Изисквания към WP-CLI и поддържани среди

Преди да инсталирате WP-CLI, трябва да потвърдите, че вашият сървър или локална среда отговарят на основните изисквания. Добрата новина е, че повечето съвременни настройки на WordPress вече отговарят на изискванията.

Изисквания за версия на PHP:

• Минимум: PHP 5.6 (въпреки че е остарял)
• Препоръчва се: PHP 7.4, 8.0, 8.1, 8.2, 8.3, 8.4 или 8.5 за сигурност и производителност през 2026 г.

Съвместимост с версиите на WordPress:

• Историческа подкрепа: WordPress 3.7 и по-нови версии
• Съвременна цел: WordPress 5.0 до 6.7+ за текущи проекти

Очаквания за операционната система:

• Най-добра поддръжка: UNIX-подобни системи (Ubuntu 22.04 LTS, Debian 12, CentOS Stream, macOS)
• Windows: Поддържа се чрез WSL (подсистема на Windows за Linux) или собствена инсталация на PHP

Допълнителни изисквания:

• PHP, достъпен от командния ред (двоичната програма php трябва да е в PATH)
• cURL или wget за изтегляне на файла wp-cli.phar
• SSH достъп до отдалечени сървъри (повечето управлявани хостинг планове за WordPress включват това по подразбиране)

Много популярни хостове като Kinsta, SiteGround и DreamHost вече се доставят с предварително инсталиран WP-CLI. WordPress.com също включва WP-CLI за сайтове с активиран SSH достъп.

Как да инсталирате WP-CLI на Linux и macOS

Стандартният метод за инсталиране използва официалния файл PHAR (PHP Archive). Този процес работи на терминалите на Ubuntu, Debian, CentOS, Fedora и macOS.

Стъпка 1: Изтегляне на файла PHAR
Отворете терминала си и изтеглете wp-cli.phar, като използвате curl:

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

Алтернативно, използвайте wget:

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

Стъпка 2: Проверка на изтеглянето (незадължителна, но препоръчителна)
Проверете контролната сума SHA-256 спрямо официалната стойност, публикувана в документацията на WP-CLI, за да се уверите, че файлът не е бил подправен по време на изтеглянето:

sha256sum wp-cli.phar

Сравнете резултата с контролната сума, посочена на официалния уебсайт на WP-CLI.

Стъпка 3: Тестване на файла PHAR
Потвърдете, че php файлът работи:

php wp-cli.phar --info

Трябва да видите изходна информация, показваща версията на WP-CLI, версията на PHP и системната информация.

Стъпка 4: Направете го изпълним и го преместете в PATH
Маркирайте файла като изпълним и го преместете в директория в системния PATH:

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

Обикновено се изисква командата sudo, тъй като /usr/local/bin е системна директория. Избягвайте да инсталирате WP-CLI като root, ако ще го използвате предимно като обикновен потребител.

Стъпка 5: Проверка на глобалната инсталация
Потвърдете, че WP-CLI вече е достъпен в световен мащаб:

wp --info
wp cli version

Трябва да видите изходни данни, потвърждаващи версията на wp cli, местоположението на двоичния файл на PHP и данните за операционната система. В този момент WP-CLI е инсталиран и готов за използване.

Как да инсталирате WP-CLI в Windows

Потребителите на Windows имат два основни пътя: използване на Windows Subsystem for Linux (WSL) или създаване на собствена инсталация на Windows. WSL осигурява по-подобно на Linux изживяване и обикновено се препоръчва.

Вариант 1: Използване на WSL (препоръчително)
Първо разрешете WSL в Windows 10 или 11:

wsl --install

Инсталирайте Ubuntu от Microsoft Store, след което стартирайте терминала на Ubuntu. Оттам следвайте абсолютно същите стъпки за инсталиране на Linux, описани в предишния раздел – изтеглете файла phar, направете го изпълним и го преместете в /usr/local/bin/wp.

Вариант 2: Собствена инсталация за Windows
За собствена инсталация е необходимо PHP за Windows да бъде инсталиран с изпълнимия файл php, наличен в системния PATH.

1. Изтеглете и инсталирайте PHP от официалния сайт на PHP за Windows
2. Добавете директорията PHP към променливата на средата PATH на Windows
3. Потвърдете, че PHP работи, като отворите Command Prompt и стартирате php -v

След това изтеглете файла WP-CLI PHAR:

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

От 2018 г. насам Windows включва curl по подразбиране, така че това би трябвало да работи без допълнителни настройки. Създайте папка за WP-CLI (напр. C:\wp-cli) и преместете изтегления файл там.

След това създайте файл за пакетна обвивка с име wp.bat в същата папка:

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

Добавете C:\wp-cli към системната променлива на средата PATH. Сега отворете нов прозорец на Command Prompt или PowerShell и проверете:

wp --info

Трябва да видите версията на WP-CLI и данните за средата, потвърждаващи, че WP-CLI е правилно инсталиран.

Основно използване на WP-CLI и получаване на помощ

След като инсталирате WP-CLI, трябва да разберете основния модел на командите, преди да се впуснете в конкретни операции. Всички команди на WP-CLI следват тази структура:

wp <command> <subcommand> [options]

Командите се изпълняват от директорията на инсталацията на WordPress – папката, съдържаща wp-config.php. Ако се намирате на друго място, можете да посочите пътя с --path=/var/www/html/mysite.

Проверка на средата
Започнете с потвърждаване на настройките:

wp --info

Това показва версията на WP-CLI, версията на PHP, двоичния път на PHP, операционната система и други данни за средата. За да видите само версията на WP-CLI:

wp cli version

Проучване на наличните команди
За да видите всички налични команди на wp cli:

wp help

За помощ за определена команда:

wp help plugin
wp help core update

Можете също така да добавите --help към всяка команда:

wp user --help

Изходът на справката се показва в пейджър, подобен на страниците man в Unix. Натиснете q, за да излезете.

Първи команди, които да опитате:

• wp core version – показва версията на вашата WordPress
• wp plugin list – показва всички инсталирани плъгини на WordPress с техния статус
• wp theme list – показва инсталираните теми
• wp user list – списък на всички потребители в сайта

Тези команди, предназначени само за четене, ви позволяват да разгледате сайта на WordPress, без да променяте нищо, което е идеално за запознаване с интерфейса.

Инсталиране и конфигуриране на WordPress с WP-CLI

WP-CLI може да извърши пълна нова инсталация на WordPress по-бързо от традиционния уеб базиран инсталатор. Това е особено ценно при създаване на среди за разработка или програмно внедряване на нови сайтове.

Предварителни условия
Преди да стартирате командите за инсталиране, трябва да имате готова база данни MySQL или MariaDB. За този пример приемаме, че сте създали:

• Име на базата данни: wpsite_db
• Потребител на базата данни: wpsite_user
• Парола: securepassword123
• Домакин: localhost

Стъпка 1: Изтегляне на основните файлове на WordPress
Отидете в желаната от вас директория за инсталиране и изтеглете основните файлове на WordPress:

wp core download

По този начин се извлича най-новата версия на WordPress. За да посочите версия или локал:

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

След приключване ще видите потвърждение, че WordPress е изтеглен успешно.

Стъпка 2: Генериране на wp-config.php
Създайте конфигурационния файл, като използвате wp config create:

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

Това генерира пълен wp-config.php с вашите данни за база данни и автоматично генерирани соли за сигурност.

Стъпка 3: Стартирайте инсталацията
Сега инсталирайте WordPress с данните на сайта си:

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

Ще видите съобщението „WordPress е инсталиран успешно“ и сайтът ви е готов за използване.

Инсталиране на многосайтове
За многосайтови мрежи на WordPress използвайте варианта за многосайтове. WP-CLI може да конфигурира мултисайт инсталации с:

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

Управление на темите с WP-CLI

WP-CLI обработва всички операции с темата, без да изисква достъп до таблото за управление на WordPress. Можете да изброявате, инсталирате, активирате, актуализирате и изтривате теми директно от терминала.

Списък на инсталираните теми
За да видите всички теми, които са инсталирани в момента:

wp theme list

Примерен изход:

име	статус	актуализация	версия
двадесет и двадесет и четири	активен	none	1.0
двадесет и двадесет и три	неактивен	none	1.2
astra	неактивен	на разположение	4.5.0

Активиране на тема
Преминаване към друга тема:

wp theme activate astra

Това незабавно променя активната тема. Връщането към темата по подразбиране е полезно за отстраняване на проблеми, свързани с темата:

wp theme activate twentytwentyfour

Инсталиране на нови теми
Инсталирайте тема от хранилището на WordPress.org:

wp theme install astra

Инсталиране и активиране с една команда:

wp theme install astra --activate

Актуализиране на теми
Актуализиране на конкретна тема:

wp theme update astra

Или актуализирайте всички теми наведнъж:

wp theme update --all

Изтриване на теми
Премахване на тема, от която вече не се нуждаете:

wp theme delete twentytwentythree

Управление на плъгини с WP-CLI

Управлението на плъгини е мястото, където WP-CLI спестява най-много време. Можете да извършвате групови операции, които биха отнели десетки кликвания в таблото за управление.

Изброяване на плъгини

wp plugin list

Примерен изход:

име	статус	актуализация	версия
woocommerce	активен	none	8.5.1
yoast-seo	активен	на разположение	21.0
elementor	неактивен	none	3.18.0

Инсталиране на плъгини
Инсталирайте плъгин по неговия slug:

wp plugin install woocommerce

Инсталирайте и активирайте:

wp plugin install yoast-seo --activate

Активиране и деактивиране на
Активиране на плъгин:

wp plugin activate elementor

Деактивиране на приставка (полезно за отстраняване на грешки):

wp plugin deactivate elementor

Деактивирайте всички плъгини наведнъж (спасително за отстраняване на грешки при „бял екран на смъртта“):

wp plugin deactivate --all

Актуализиране на плъгини
Актуализиране на определена плъгина:

wp plugin update yoast-seo

Актуализирайте всички плъгини:

wp plugin update --all

Можете също така да изключите определени плъгини от групово актуализиране:

wp plugin update --all --exclude=woocommerce

Актуализиране и поправка на ядрото на WordPress

Поддържането на WordPress в актуално състояние е от решаващо значение за сигурността. WP-CLI прави този процес прозрачен и контролируем.

Проверка за актуализации

wp core check-update

Актуализиране на WordPress
Актуализирайте до най-новата версия:

wp core update

След актуализация на ядрото е добра практика да актуализирате схемата на базата данни:

wp core update-db

Проверка на контролните суми
Ако подозирате, че сайтът ви е бил хакнат, можете да проверите дали основните файлове не са били модифицирани:

wp core verify-checksums

Това сравнява файловете ви с контролните суми на официалното хранилище на WordPress.

Преинсталиране на ядрото
Ако файловете са повредени, можете да извършите принудително преинсталиране, без да засегнете съдържанието си:

wp core download --force --skip-content

Управление на съдържание, потребители и база данни

WP-CLI ви позволява да взаимодействате директно с данните на вашия сайт.

Управление на потребители
Списък на потребителите:

wp user list

Създайте нов администратор:

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

Актуализиране на потребителска парола:

wp user update 1 --user_pass=newpassword

Изтриване на потребител и пренасочване на неговото съдържание:

wp user delete 5 --reassign=1

Операции с бази данни
Експортиране на базата данни във файл:

wp db export backup.sql

Импортиране на база данни от файл:

wp db import backup.sql

Оптимизиране на базата данни:

wp db optimize

Отворете конзолата на MySQL, директно свързана към базата данни на WordPress:

wp db cli

Търсене и заместване (по правилния начин)

Ръчното преместване на сайт на WordPress в нов домейн е рисковано, тъй като данните често са сериализирани в базата данни. Обикновеното намиране и замяна на SQL ще наруши работата на уиджетите и опциите на темите. WP-CLI обработва сериализирането правилно.

Стандартно търсене-заместване

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

Изпитване (предварителен преглед)
Винаги проверявайте какво ще се промени, преди да стартирате командата:

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

Експортиране със заместване
Можете да експортирате база данни със заместванията, направени във файла, като оставите базата данни в реално време непроменена:

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

Разширена поддръжка: Cron и кеш за обекти

Управление на Cron Jobs
Преглед на планираните събития:

wp cron event list

Незабавно стартирайте всички дължими събития cron:

wp cron event run --due-now

Управление на преходни процеси и кеш
Изчистете кеша на обекта:

wp cache flush

Изтриване на всички изтекли преходни процеси:

wp transient delete --expired

Автоматизиране на задачите със скриптове

Можете да комбинирате WP-CLI команди в Bash скриптове за автоматизирана поддръжка.

Пример: Скрипт за седмична поддръжка
Създайте файл с име 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."

Направете го изпълним (chmod +x maintain.sh) и го стартирайте, за да извършите пълна поддръжка на сайта за секунди.

Използване на WP-CLI от разстояние чрез SSH

Ако конфигурирате псевдоними, не е необходимо да влизате в сървъра, за да изпълнявате команди.

В локалния си файл wp-cli.yml:

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

Сега можете да изпълнявате команди на отдалечения сървър от локалната си машина:

wp @prod plugin list
wp @dev core version

Най-добри практики

• Винаги правете резервно копие: Преди да стартирате групови актуализации или команди за търсене и замяна, стартирайте wp db export.
• Използвайте сух пробег: При търсене и замяна винаги първо използвайте --dry-run.
• Не работете като Root: WP-CLI ви предупреждава, ако се стартирате като root. По-безопасно е да се стартира като потребител на уеб сървъра (например www-data) или като конкретен потребителски акаунт.
• Тест за етапна оценка: Използвайте WP-CLI, за да клонирате производствения си сайт в стадийно състояние, да тествате скриптовете за актуализация там и след това да ги приложите в производственото състояние.

Заключение

WP-CLI трансформира управлението на WordPress от поредица от кликвания в рационализирани операции, които могат да се изпълняват със скриптове. Започвайки с прости команди, като проверка на версии и изброяване на плъгини, изграждате основата за разширена автоматизация. Интегрирането на WP-CLI в работния ви процес още днес ще спести безброй часове в проектите ви за WordPress.