3 min. читати

WP-CLI: Повний посібник з керування WordPress з командного рядка

WP-CLI – це офіційний інструмент командного рядка для керування установками WordPress безпосередньо з вашого терміналу, без необхідності відкривати браузер. Якщо ви коли-небудь витрачали цілий день на те, щоб оновити плагіни на кількох сайтах в адміністративній панелі WordPress, ви вже знаєте, навіщо існує цей інструмент.

У цьому посібнику ви дізнаєтеся все: від встановлення WP-CLI на Linux, macOS і Windows до автоматизації складних завдань з обслуговування за допомогою скриптів і конфігураційних файлів. Незалежно від того, чи керуєте ви одним блогом або десятками клієнтських сайтів, освоєння WP-CLI докорінно змінить вашу роботу з WordPress.

Чого ви навчитеся:

Як встановити та налаштувати WP-CLI на різних операційних системах
Основні команди для керування плагінами, темами, користувачами та вмістом
Операції з базами даних, включаючи експорт, імпорт та безпечний пошук-заміну
Методи автоматизації за допомогою скриптів, псевдонімів і завдань cron
Найкращі практики для уникнення поширених помилок при роботі з терміналом

Що таке WP-CLI? (Спочатку коротке пояснення)

WP-CLI розшифровується як інтерфейс командного рядка 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 Subsystem for 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.

Завантажте та встановіть PHP з офіційного сайту PHP для Windows
Додайте каталог PHP до змінної середовища Windows PATH
Переконайтеся, що PHP працює, відкривши командний рядок і запустивши php -v

Далі завантажте файл WP-CLI PHAR:

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

Windows включає curl за замовчуванням з 2018 року, тому це повинно працювати без додаткових налаштувань. Створіть папку для WP-CLI (наприклад, C:\wp-cli) і перемістіть туди завантажений файл.

Потім створіть файл пакетної обгортки з ім’ям wp.bat у тій самій теці:

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

Додайте C:\wp-cli до системної змінної середовища PATH. Тепер відкрийте нове вікно командного рядка або 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

Виведення довідки відображається у вигляді пейджера, подібного до сторінок довідки 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
астра	неактивний	доступний	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
елементор	неактивний	none	3.18.0

Встановлення плагінів
Встановлюйте плагін за його міткою:

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
Перегляд запланованих подій:

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.