Установка WP-CLI на VPS с Ubuntu
WP-CLI — один файл wp-cli.phar, который запускается через PHP. Установка — скачать этот файл, проверить и переложить туда, где система найдёт его по команде wp. Это пять команд, и ставится WP-CLI один раз на весь сервер.
Содержание 8
Что сделать прямо сейчас
- Подключитесь к серверу по SSH (как подключиться).
- Проверьте, что на сервере есть PHP:
php -vПервая строка ответа начинается с
PHP 8.3— PHP есть. Если система не нашла командуphp, сначала установите PHP. - Скачайте WP-CLI:
curl -O https://raw.githubusercontent.com/wp-cli/builds/gh-pages/phar/wp-cli.pharПока файл скачивается, curl показывает таблицу с размером и скоростью. Файл
wp-cli.pharляжет в папку, где вы стоите. - Проверьте, что файл работает:
php wp-cli.phar --infoВ ответе — строки
OS:,PHP version:,php.ini used:и в концеWP-CLI version:с номером версии, например2.12.0. - Сделайте файл запускаемым и перенесите его в
/usr/local/bin:chmod +x wp-cli.phar sudo mv wp-cli.phar /usr/local/bin/wpОтвета нет — файл перенесён. Теперь WP-CLI запускается командой
wpиз любой папки и от любого пользователя сервера. - Проверьте:
wp cli versionWP-CLI 2.12.0
Дальше — как запускать команды для сайта и все команды WP-CLI.
Что нужно для WP-CLI
| Что | Как проверить | Где взять |
|---|---|---|
| PHP 5.6 или новее | php -v | установка PHP: в Ubuntu 24.04 — PHP 8.3 |
| WordPress 3.7 или новее | после установки — wp core version в папке сайта | установка WordPress |
| curl | curl --version | в Ubuntu 24.04 есть сразу |
| права sudo | sudo -v | команда sudo |
Команда php появляется на сервере вместе с PHP-FPM: в Ubuntu пакет php8.3-fpm ставит и php8.3-cli. WP-CLI работает через php, а сайт — через PHP-FPM. Настройки у них разные: php wp-cli.phar --info в строке php.ini used: показывает файл настроек, который читает WP-CLI.
Какие ключи у wp --info
wp --info выводит, с чем работает WP-CLI. Строки разделены табуляцией:
| Строка | Что значит |
|---|---|
OS: | система сервера |
PHP version: | версия PHP, через которую запущен WP-CLI |
php.ini used: | файл настроек PHP для командной строки |
WP-CLI version: | версия WP-CLI |
Только версия WP-CLI: wp cli version.
Обновить WP-CLI
sudo wp cli updateЕсли обновлять нечего:
Success: WP-CLI is at the latest version.Если вышла новая версия, WP-CLI спросит: You have version 2.12.0. Would you like to update to …? [y/n]. Нажмите y и Enter. Затем WP-CLI скачает новую версию, проверит её строкой New version works. Proceeding to replace. и закончит строкой Success: Updated WP-CLI to … с номером новой версии.
sudo здесь нужен: файл /usr/local/bin/wp принадлежит root. Без sudo WP-CLI ответит Error: /usr/local/bin/wp is not writable by current user. Команды для сайта, наоборот, запускайте не от root, а от пользователя сайта — почему.
Удалить WP-CLI
sudo rm /usr/local/bin/wpОтвета нет — WP-CLI удалён. Сайт от этого не меняется: WP-CLI только управляет WordPress, но не нужен для его работы.
Ошибки и как их исправить
| Что видите | Причина | Что делать |
|---|---|---|
Если система не нашла команду php | PHP не установлен | установка PHP |
curl: (6) Could not resolve host | сервер не может найти адрес по имени | разбор |
curl: (28) и слова timed out | сервер не дождался ответа | разбор |
после mv система не нашла команду wp | файл не перенесён или не сделан запускаемым | ls -l /usr/local/bin/wp: в начале строки должны быть буквы x, иначе sudo chmod +x /usr/local/bin/wp |
Error: /usr/local/bin/wp is not writable by current user. при wp cli update | обновление без sudo | sudo wp cli update |
Error: YIKES! It looks like you're running this as root. | команда для сайта запущена от root | sudo -u www-data wp … (разбор) |
Команды и ответы сверены с документацией и исходным кодом WP-CLI 2.12.0; WordPress в примерах — 7.1.4.
Источники
- WP-CLI на GitHub: установка — на английском: адрес wp-cli.phar, требования к PHP и WordPress, команды установки и обновления.
- Документация WP-CLI: wp cli update — на английском: обновление WP-CLI и его ответы.
Сверено 10 ноября 2026 года.
Что почитать дальше
- WP-CLI от пользователя сайтапочему команды запускают через
sudo -u www-data. - wp coreкак узнать версию и обновить WordPress.
- Команды WP-CLIвсе команды на одной странице.