Ошибки WP-CLI: что значат ответы и как их исправить
WP-CLI отвечает коротко и по-английски, а строка Error: значит, что команда не выполнена. Здесь собраны ответы, которые встречаются на сервере с одним или несколькими сайтами на WordPress: что значит каждый и какую команду запустить, чтобы всё заработало.
Содержание 11
- Что сделать прямо сейчас
- Все ошибки одной таблицей
- This does not seem to be a WordPress installation
- 'wp-config.php' not found
- Error establishing a database connection
- The site you have requested is not installed
- is not a registered wp command
- Strange wp-config.php file
- Fatal error в плагине или теме
- Источники
- Что почитать дальше
Что сделать прямо сейчас
- Подключитесь к серверу по SSH (как подключиться).
- Перейдите в папку сайта:
cd /var/www/example.com. Вместо/var/www/example.com— папка вашего сайта. - Проверьте, видит ли WP-CLI сайт:
sudo -u www-data wp core version7.1.4Если вывелась версия WordPress, WP-CLI находит сайт и базу. Если пришла строка
Error:, найдите её в таблице ниже.
Почему команды запускают через sudo -u www-data — WP-CLI от пользователя сайта.
Все ошибки одной таблицей
| Что видите | Причина | Что делать |
|---|---|---|
Если система не нашла команду wp | WP-CLI не установлен | установка 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. | вы не в папке сайта | ниже |
Error: 'wp-config.php' not found. | файлы WordPress есть, файла настроек нет | ниже |
Error establishing a database connection или то же по-русски | WordPress не может подключиться к базе | ниже |
Error: The site you have requested is not installed. | в базе нет таблиц сайта | ниже |
is not a registered wp command | опечатка в команде или команду добавляет выключенный плагин | ниже |
Error: Strange wp-config.php file: wp-settings.php is not loaded directly. | в конце wp-config.php нет строки, которая загружает WordPress | ниже |
It seems, the WordPress core files do not have the proper file permissions. | WP-CLI не может прочитать файлы WordPress | проверьте владельца и права (права на файлы сайта) |
Reason: wp-config.php is not writable. | у wp-config.php права 440 | разбор |
Error: The --path parameter cannot be empty when provided. | после --path= ничего не написано | --path=/var/www/example.com |
Fatal error и путь в wp-content/plugins/ или wp-content/themes/ | ошибка в коде плагина или темы | ниже |
Warning: Failed to create directory '/var/www/.wp-cli/cache/' | у www-data нет своей папки для кэша WP-CLI | команда работает и без кэша (разбор) |
Error: — команда не выполнена, Warning: — выполнена, но с замечанием. Как читать остальные ответы — команды WP-CLI.
This does not seem to be a WordPress installation
Error: This does not seem to be a WordPress installation.WP-CLI ищет WordPress в папке, где вы стоите, и выше по дереву папок. Строкой ниже — The used path is: и папка, где он искал. Перейдите в папку сайта или укажите её ключом --path:
sudo -u www-data wp core version --path=/var/www/example.comНе помните, где лежит сайт, — посмотрите папки сайтов в настройках nginx:
grep -h 'root ' /etc/nginx/sites-enabled/* root /var/www/example.com;'wp-config.php' not found
Error: 'wp-config.php' not found.
Either create one manually or use `wp config create`.Файлы WordPress в папке есть, а файла настроек нет — ни в ней, ни на уровень выше. Проверьте папку:
ls /var/www/example.com| Что видите в списке | Что делать |
|---|---|
есть wp-config.php | вы в другой папке: перейдите в папку из списка выше, cd /var/www/example.com |
wp-config.php нет, сайт открывается в браузере | вы в копии WordPress, а не в папке сайта: найдите папку командой grep -h 'root ' /etc/nginx/sites-enabled/* |
wp-config.php нет, сайт не открывается | WordPress скачан, но не настроен: создайте базу и файл по шагам установки WordPress |
Что значит каждая строка файла — wp-config.php.
Error establishing a database connection
Error: Error establishing a database connection.Строка та же, что и на сайте: в русской версии WordPress она по-русски, об ошибке соединения с базой данных. WP-CLI берёт имя базы, пользователя и пароль из wp-config.php, поэтому с ним эта ошибка значит одно из двух: в файле неверные данные базы или сервер баз данных не работает. Проверьте, что записано в файле:
sudo -u www-data wp config get DB_NAME
sudo -u www-data wp config get DB_USER
sudo -u www-data wp config get DB_HOSTКак проверить пароль и сервер баз данных — разбор ошибки, если MySQL отвечает Access denied for user — ошибка 1045.
The site you have requested is not installed
Error: The site you have requested is not installed.
Run `wp core install` to create database tables.WP-CLI подключился к базе, но таблиц сайта в ней нет. Так бывает, если база новая или дамп в неё ещё не загружен. Загрузить дамп — wp db import. wp core install запускайте, только если ставите новый сайт (установка WordPress).
Если ниже есть строка Your table prefix is 'wp_'. Found installation with table prefix: и другой префикс, например abc_, таблицы сайта на месте, а в wp-config.php записан другой префикс. Так бывает после переноса. Запишите префикс из ответа:
sudo -u www-data wp config set table_prefix abc_Если ответ — Reason: wp-config.php is not writable., сначала разрешите запись (как).
wp core install: WordPress создаст рядом новые пустые таблицы, и сайт откроется пустым.is not a registered wp command
Error: 'plugn' is not a registered wp command. See 'wp help' for available commands.
Did you mean 'plugin'?Строка Did you mean — подсказка: в команде опечатка, WP-CLI предлагает похожую. Если подсказки нет, команду, может быть, добавляет плагин: такие команды работают, только когда плагин включён. Проверьте:
sudo -u www-data wp plugin list --status=inactiveСписок встроенных команд — wp help, все главные — на одной странице.
Strange wp-config.php file
Error: Strange wp-config.php file: wp-settings.php is not loaded directly.WP-CLI читает wp-config.php и ищет в нём строку, которая загружает WordPress. Посмотрите конец файла:
sudo tail -n 3 wp-config.phpПоследней должна быть строка:
require_once ABSPATH . 'wp-settings.php';Если её нет или файл wp-settings.php подключается через другой файл, верните эту строку в конец wp-config.php. Перед правкой сделайте копию файла — как править файл, чтобы сайт не сломался.
Fatal error в плагине или теме
Если команда обрывается строкой Fatal error с путём в wp-content/plugins/ или wp-content/themes/, запустите её без плагинов и темы:
sudo -u www-data wp plugin list --skip-plugins --skip-themes--skip-plugins и --skip-themes работают с любой командой. Имя папки после wp-content/plugins/ — имя плагина с ошибкой: как его отключить — wp plugin, тему — wp theme.
Если та же ошибка на сайте — критическая ошибка WordPress.
Команды и ответы сверены с документацией и исходным кодом WP-CLI 2.12.0; WordPress в примерах — 7.1.4.
Источники
- Документация WP-CLI: глобальные ключи — на английском: --path, --skip-plugins, --skip-themes.
- Исходный код WP-CLI 2.12.0: Runner.php — на английском: тексты ошибок при запуске WP-CLI.
Сверено 10 ноября 2026 года.
Что почитать дальше
- WP-CLI от пользователя сайтапочему команды запускают через
sudo -u www-data. - Ошибки WordPressесли ошибка на сайте, а не в терминале.
- Команды WP-CLIвсе команды на одной странице.