Встановлення та використання WP-CLI у Windows

Повний посібник: що таке WP-CLI, для чого він потрібен, як встановити, налаштувати та використовувати у Windows.

---

Що таке WP-CLI

WP-CLI (WordPress Command Line Interface) — це інструмент командного рядка для керування сайтами WordPress без використання браузера.

Він дозволяє:

• встановлювати та оновлювати WordPress;
• керувати плагінами, темами та користувачами;
• виконувати пошук і заміну в базі даних;
• автоматизувати завдання за допомогою скриптів.

Офіційний сайт: https://wp-cli.org

---

Навіщо це потрібно

Переваги WP-CLI:

• Автоматизація — можна створювати скрипти для масових операцій.
• Швидкість — робота через термінал швидша, ніж у графічному інтерфейсі.
• Гнучкість — можна керувати WordPress навіть без веб-інтерфейсу.
• Безпека — можна відключити адмінпанель і працювати лише через командний рядок.

---

Вимоги

• PHP 7.4 або новіше (рекомендовано 8.x)
• WordPress 3.7 або новіше
• PHP CLI має бути додано до змінної середовища PATH
• Потрібне підключення до інтернету для завантаження файлів

Перевірити PHP:

php -v

---

Встановлення WP-CLI у Windows

1. Завантажити wp-cli.phar

Відкрий PowerShell і виконай:

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

(Або завантаж файл вручну й помісти його в C:\wp-cli\.)

---

2. Перевірити роботу

php C:\wp-cli\wp-cli.phar --info

Якщо з’явилась інформація про версію — все працює правильно.

---

3. Створити wp.bat

Створи файл C:\wp-cli\wp.bat із таким вмістом:

@ECHO OFF
php "%~dp0wp-cli.phar" %*

Тепер можна викликати WP-CLI просто командою wp.

---

4. Додати до PATH

Щоб запускати wp з будь-якої директорії:

setx PATH "$($env:PATH);C:\wp-cli" /M

Після цього перезапусти PowerShell і перевір:

wp --info

Якщо команда працює — встановлення завершено.

---

Альтернатива: встановлення через Composer

composer global require wp-cli/wp-cli

Додай шлях:

%USERPROFILE%\AppData\Roaming\Composer\vendor\bin

---

Використання WP-CLI

Приклади команд:

Встановити WordPress:

wp core download --locale=uk_UA

Створити файл wp-config.php:

wp config create --dbname=wordpress --dbuser=root --dbpass=secret

Встановити сайт:

wp core install --url="http://localhost" --title="Мій сайт" --admin_user=admin --admin_password=1234 --admin_email=test@example.com

Оновлення:

wp core update
wp plugin update --all

Користувачі:

wp user create editor editor@example.com --role=editor --user_pass=pass123

---

Корисні команди

• wp plugin list — показати список плагінів
• wp theme list — список тем
• wp search-replace "http://staryj" "https://novyj" — масова заміна рядків
• wp db export / wp db import — резервне копіювання та відновлення бази даних
• wp shell — інтерактивна PHP-консоль

Повний список: https://developer.wordpress.org/cli/commands/

---

PowerShell-скрипт для автоматичного встановлення

Збережи як install-wp-cli.ps1 і запусти від імені адміністратора:

$targetDir = "C:\wp-cli"
$pharUrl   = "https://raw.githubusercontent.com/wp-cli/builds/gh-pages/phar/wp-cli.phar"
$pharPath  = "$targetDir\wp-cli.phar"
$batPath   = "$targetDir\wp.bat"

Write-Host "Встановлення WP-CLI..." -ForegroundColor Cyan

if (!(Test-Path $targetDir)) {
    New-Item -ItemType Directory -Force -Path $targetDir | Out-Null
}

Invoke-WebRequest -Uri $pharUrl -OutFile $pharPath

"@ECHO OFF
php ""%~dp0wp-cli.phar"" %*" | Out-File $batPath -Encoding ASCII

$envPath = [Environment]::GetEnvironmentVariable("Path", "Machine")
if ($envPath -notlike "*$targetDir*") {
    [Environment]::SetEnvironmentVariable("Path", "$envPath;$targetDir", "Machine")
    Write-Host "✅ Додано $targetDir до PATH (перезапусти термінал)" -ForegroundColor Green
}

php $pharPath --info

Після виконання перевір:

wp --info

---

Поради

• Запускай PowerShell від імені адміністратора, коли змінюєш PATH.
• Для віддалених сайтів використовуй --ssh=<user>@<host>.
• Якщо виникають SSL-помилки, додай --skip-ssl-check.
• Завжди роби резервну копію бази даних перед масовими діями.

---

Висновок

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

Автор: hypo69
Ліцензія: MIT (https://opensource.org/licenses/MIT)