Установка и использование WP-CLI на Windows

Полное руководство: что такое WP-CLI, зачем он нужен, как установить, настроить и использовать на Windows.

---

Что такое WP-CLI

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

Он позволяет:

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

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

---

Почему это полезно

Преимущества использования WP-CLI:

• Автоматизация — можно писать скрипты для массовых операций.
• Скорость — работа через 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=ru_RU

Создание wp-config.php:

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

Установка сайта:

wp core install --url="http://localhost" --title="My Site" --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://old" "https://new" — массовая замена строк
• 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 от имени администратора.
• Для удалённых сайтов можно использовать --ssh=<user>@<host>.
• Если есть ошибки SSL, добавь --skip-ssl-check.
• Перед массовыми операциями делай резервную копию БД.

---

Заключение

WP-CLI — мощный инструмент для администраторов и разработчиков WordPress.
Он экономит время, автоматизирует задачи и делает работу безопаснее и удобнее.

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