Поиск
Справочник

Ошибки WP-CLI: что значат ответы и как их исправить

WP-CLI отвечает коротко и по-английски, а строка Error: значит, что команда не выполнена. Здесь собраны ответы, которые встречаются на сервере с одним или несколькими сайтами на WordPress: что значит каждый и какую команду запустить, чтобы всё заработало.

≈ 8 мин чтения
Содержание 11

Что сделать прямо сейчас

  1. Подключитесь к серверу по SSH (как подключиться).
  2. Перейдите в папку сайта: cd /var/www/example.com. Вместо /var/www/example.com — папка вашего сайта.
  3. Проверьте, видит ли WP-CLI сайт:
    sudo -u www-data wp core version
    7.1.4

    Если вывелась версия WordPress, WP-CLI находит сайт и базу. Если пришла строка Error:, найдите её в таблице ниже.

Почему команды запускают через sudo -u www-data — WP-CLI от пользователя сайта.

Все ошибки одной таблицей

Что видитеПричинаЧто делать
Если система не нашла команду wpWP-CLI не установленустановка WP-CLI
Error: YIKES! It looks like you're running this as root.команда запущена от rootsudo -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.

Источники

Сверено 10 ноября 2026 года.

Где попробовать. Команды из статьи безопаснее сначала повторить на отдельном тестовом сервере, а не на рабочем. Подойдёт VPS с Ubuntu, например Timeweb Cloud Реклама. АО «ТАЙМВЭБ», ИНН 7810353960. erid: CQH36pWzJpoBWKF332yG5h2XQ4cVubfBmkvqAitFqcpzWs. Как зайти на него после заказа — в статье Как подключиться к VPS по SSH.

Что почитать дальше