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

Введение

WP-CLI — это официальная утилита командной строки для WordPress. Она позволяет управлять сайтом без входа в админ-панель: устанавливать плагины, обновлять ядро, управлять пользователями и даже выполнять миграции базы. Такой подход экономит время, позволяет автоматизировать задачи и особенно полезен администраторам, которые ведут несколько проектов.

В этой статье разберём, что такое WP-CLI, как его установить и приведём практические примеры команд.

Что такое WP-CLI?

WP-CLI (WordPress Command Line Interface) — это инструмент на PHP для работы с WordPress через терминал. Он охватывает почти все задачи, доступные в графической панели, а иногда даёт даже больше возможностей:

• установка и обновление ядра, плагинов и тем;
• управление пользователями, постами и БД;
• массовые операции (bulk actions);
• удалённое управление через SSH;
• автоматизация через Bash/PHP-скрипты.

Преимущества WP-CLI

• Эффективность: команды выполняются быстрее, чем те же действия через интерфейс.
• Массовые операции: обновление плагинов или очистка кэша сразу на всех сайтах.
• Автоматизация: скрипты для бэкапов, миграций или деплоя.
• Удалённое управление: работа через SSH без браузера.
• Расширенные функции: команды, которых нет в админке (например, wp transient delete --all).

Установка WP-CLI

Требования

• UNIX-среда (Linux, macOS, FreeBSD).
• PHP 5.6+.
• WordPress 3.7+.

Шаги установки

1. Скачать Phar-файл:

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

2. Сделать его исполняемым:

   chmod +x wp-cli.phar
   

3. Переместить в $PATH:

   sudo mv wp-cli.phar /usr/local/bin/wp
   

4. Проверить:

   wp --info
   

Если у вас cPanel без root-доступа:

alias wp='~/wp-cli.phar'
echo "alias wp='~/wp-cli.phar'" >> ~/.bashrc

💡 Также можно установить WP-CLI через Composer, Homebrew или Docker.

Основные команды WP-CLI

Управление ядром

wp core download --path=wp-site
wp core install --url="http://example.com" --title="My Site" --admin_user="admin" --admin_password="securepassword" --admin_email="admin@example.com"
wp core update
wp core install --skip-content   # переустановка без затрагивания контента

Плагины

wp plugin install akismet --activate
wp plugin update --all
wp plugin deactivate --all

Темы

wp theme install twentytwentyone --activate
wp theme list

База данных

wp db export backup.sql
wp db import backup.sql
wp search-replace 'http://old.com' 'https://new.com' --dry-run

Пользователи

wp user create newuser user@example.com --role=editor --user_pass=123secure
wp user delete 42 --reassign=1

Контент

wp post create --post_type=post --post_title="Новый пост" --post_status=publish
wp post generate --count=10

Дополнительно

wp transient delete --all
wp config set WP_DEBUG true --raw
wp eval 'echo get_option("siteurl");'

Расширенные возможности

Кастомные команды

Через wp scaffold package можно создать собственные WP-CLI команды на PHP.

Удалённое управление

wp --ssh=user@host:/path/to/wordpress plugin install akismet --activate

Интеграция со скриптами

#!/bin/bash
for site in /var/www/site1 /var/www/site2; do
  wp --path=$site plugin update --all
done

Траблшутинг

• Проверка версии: wp cli version
• Помощь по команде: wp help plugin install
• Отладка: wp plugin install akismet --debug

Типовые проблемы:

• Permission denied → запуск от пользователя без прав.
• Не находит WordPress → указываем --path=/var/www/site.

Заключение

WP-CLI — must-have для разработчиков и администраторов WordPress. Он ускоряет рутину, позволяет автоматизировать обновления, миграции и обслуживание сайтов. Освоив его базовые команды, вы сможете работать с WordPress эффективнее и надёжнее.

📚 Полный справочник: wp-cli.org

Команда для помощи: wp help