Команды WP-CLI: как управлять WordPress из терминала сервера
WP-CLI — программа, которая управляет WordPress из терминала: обновляет WordPress и плагины, меняет пароль администратора, выгружает базу и меняет адрес сайта без входа в админку. Она выручает, когда админка не открывается или после переноса сайт ведёт на старый адрес. Здесь — все основные команды на одной странице и ссылки на подробные разборы.
Содержание 8
Что сделать прямо сейчас
- Подключитесь к серверу по SSH (как подключиться).
- Перейдите в папку сайта:
cd /var/www/example.comВместо
/var/www/example.com— папка вашего сайта. - Проверьте, что WP-CLI видит сайт:
sudo -u www-data wp core version7.1.4Ответ — версия WordPress, значит WP-CLI работает. Вместо
www-data— владелец файлов сайта: почему команды запускают от его имени — WP-CLI от пользователя сайта.
Если система не нашла команду wp — установите WP-CLI.
Какая команда что делает
В таблице команды без начала sudo -u www-data — добавляйте его перед wp.
| Что нужно | Команда | Разбор |
|---|---|---|
| узнать версию WordPress | wp core version | wp core |
| обновить WordPress | wp core update, затем wp core update-db | wp core |
| проверить, не изменены ли файлы WordPress | wp core verify-checksums | wp core |
| посмотреть плагины | wp plugin list | wp plugin |
| отключить плагин, который сломал сайт | wp plugin deactivate имя | wp plugin |
| обновить все плагины | wp plugin update --all | wp plugin |
| сменить тему | wp theme activate имя | wp theme |
| посмотреть пользователей | wp user list | wp user |
| новый пароль администратора | wp user reset-password логин --show-password --skip-email | wp user |
| заменить старый адрес сайта в базе | wp search-replace 'старый' 'новый' --dry-run | wp search-replace |
| выгрузить базу в файл | wp db export - > ~/site.sql | wp db |
| посмотреть и сменить адрес сайта | wp option get home, wp option update home адрес | wp option |
| поменять строку в wp-config.php | wp config set WP_DEBUG true --raw | wp config |
| сбросить кэш, правила ссылок, запустить cron | wp cache flush, wp rewrite flush, wp cron event run --due-now | кэш, ссылки и cron |
Как запускать команды
Файлы сайта на VPS принадлежат пользователю, от которого работает сайт, — www-data (права на файлы сайта). Команды WP-CLI запускайте от его имени:
sudo -u www-data wp plugin listТогда файлы, которые создаст WP-CLI, — новые плагины, обновлённый WordPress — достанутся тому же владельцу, и сайт сможет с ними работать.
От root WP-CLI откажется: Error: YIKES! It looks like you're running this as root. Разбор — WP-CLI от пользователя сайта.
Если вы не в папке сайта, укажите её ключом --path:
sudo -u www-data wp core version --path=/var/www/example.comПрежде чем что-то менять
Команды wp core update, wp plugin update, wp search-replace и wp db import меняют файлы и базу сразу, без кнопки «Отмена». Перед ними выгрузите базу:
sudo -u www-data wp db export - > ~/site.sqlОтвета нет — дамп записан в файл site.sql в вашей домашней папке. Проверьте размер: ls -lh ~/site.sql. Подробнее — wp db и резервные копии сайта.
Как читать ответ WP-CLI
| Начало строки | Что значит |
|---|---|
Success: | команда выполнена |
Warning: | что-то пропущено или уже сделано раньше: прочитайте строку, команда при этом могла выполниться |
Error: | команда остановилась или выполнена не вся: после Error: — причина |
| строка без такого начала | ход работы, например Plugin 'akismet' activated. |
Не у всех команд в конце Success:. wp core version и wp option get home просто печатают значение.
Строки о скачивании и распаковке при обновлении пишет сам WordPress: на русском сайте они будут по-русски. Строки Success:, Warning: и Error: WP-CLI пишет на английском.
Ошибки и как их исправить
| Что видите | Причина | Что делать |
|---|---|---|
Error: YIKES! It looks like you're running this as root. | команда запущена от root | sudo -u www-data wp … (разбор) |
Error: This does not seem to be a WordPress installation. | команда запущена не в папке сайта | cd /var/www/example.com или ключ --path (разбор) |
Если система не нашла команду wp | WP-CLI не установлен | установка WP-CLI |
Error: 'wp-config.php' not found. | в папке нет файла настроек WordPress | проверьте папку: ls /var/www/example.com (разбор) |
Warning: Failed to create directory '/var/www/.wp-cli/cache/' | у www-data нет своей папки для кэша WP-CLI | команда работает и без кэша (разбор) |
| другие ответы | ошибки WP-CLI |
Команды и ответы сверены с документацией и исходным кодом WP-CLI 2.12.0; WordPress в примерах — 7.1.4.
Источники
- Документация WP-CLI: команды — на английском: все команды и их ключи.
- WP-CLI на GitHub — на английском: установка, требования и исходный код.
Сверено 10 ноября 2026 года.
Что почитать дальше
- Установка WP-CLIкак поставить WP-CLI на сервер и проверить.
- Ошибки WP-CLIчто значат ответы Error и Warning и что делать.
- Настройки WordPressчто лежит в wp-config.php и как его править.