Как установить WP-CLI. Шпаргалка с основными командами

WP-CLI (WP Command Line Interface) – утилита для работы с сайтами на WordPress, которая позволяет выполнять различные административные задачи непосредственно из командной строки.

С помощью этой утилиты можно без использования браузера:

• Управлять WordPress-сайтом. С WP-CLI можно обновлять ядро WordPress, плагины и темы, создавать резервные копии базы данных, чистить кэш и многое другое.
  
• Управлять контентом. WP-CLI позволяет вам импортировать, экспортировать, создавать, обновлять и удалять посты, страницы, пользователей, медиафайлы и комментарии.
  
• Изменять настройки сайта. В частности URL сайта, хедер, структуру постоянных ссылок и прочее.
• Управлять разработкой. WP-CLI включает команды для работы с темами и плагинами, в частности проверку кода на соответствие стандартам WordPress и запуск юнит-тестов.
  
• Пользоваться WordPress Multisite. WP-CLI позволяет управлять сетью сайтов, включая создание и удаление сайтов, управление пользователями сети и многое другое.

WP-CLI доступна как на нашем WordPress Хостинге, так и на всех других тарифах шаред-хостинга. 

Но поскольку WP-CLI не установлена по умолчанию в большинстве дистрибутивов ОС, то на VPS ее обычно нет. При необходимости ее можно установить либо самостоятельно, либо обратившись в нашу техподдержку. 

В этой статье покажем, как можно установить утилиту WP CLI. А также дадим список команд, которыми пользуются в командной строке WordPress чаще всего.

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

Шаг 1. 

Сначала необходимо получить доступ к файлам на сервере через SSH. Обратите внимание, что доступ через SSH по умолчанию на нашем shared-хостинге закрыт в целях безопасности, а на услугах виртуальных серверов с панелью cPanel активируется отдельно.

Поэтому, пожалуйста, обратитесь с запросом в техподдержку, и мы откроем вам доступ в режиме 24/7.

Как только мы включим SSH со своей стороны, в панели cPanel, в разделе «Расширенный» вы увидите пункт «Terminal».

Шаг 2. 

Выбираем каталог, куда будем устанавливать WP-CLI. И загружаем файл wp-cli.phar с помощью утилит wget или curl:

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

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

Эта команда загрузит файл WP-CLI. 

Проверяем, работает ли WP-CLI (версия РНР не ниже 7.0):

php wp-cli.phar --info

php wp-cli.phar --info

Если WP-CLI был установлен успешно, при запуске вы увидите что-то вроде этого:

Шаг 3. 

Далее обязательно устанавливаем права на выполнение:

chmod +х wp-cli.phar

chmod +х wp-cli.phar

И чтобы иметь возможность вводить просто wp вместо php wp-cli.phar, создаем псевдоним, указав локальный путь к исполняемому файлу. Открываем файл через текстовый редактор:

vim ~/.bashrc

vim ~/.bashrc

Чтобы перейти в режим редактирования в редакторе VIM, следует нажать клавишу Insert и внести изменения. 

В конец файла добавляем псевдоним в таком формате:

alias wp='php ~/wp-cli.phar'  

alias wp='php ~/wp-cli.phar'  

В кавычках должна быть команда и путь к файлу, который будет выполняться. После этого сохраняем.

Чтобы сохранить изменения и выйти, нажимаем «ESC» , вводим «:» (двоеточие) и «wq». И нажимаем «Enter».

Шаг 4. 

Чтобы изменения применились, выполняем команду:

source ~/.bashrc

source ~/.bashrc

А теперь перейдем к основным командам.

Ядро WordPress

Проверка текущей версии WordPress

wp core version 

wp core version 

Эта команда покажет текущую версию WP.

Обновление WordPress 

wp core update 

wp core update 

Эта команда обновит вашу версию WordPress до последней доступной версии.

Создание резервной копии базы данных

wp db export

wp db export

Эта команда экспортирует вашу базу данных WordPress в файл .sql.

Работа с медиа

1. Список размеров изображений

wp media image-size 

wp media image-size 

2. Создание медиа из локальных файлов 

wp media import /path/to/your/image.jpg

wp media import /path/to/your/image.jpg

Эта команда импортирует медиафайл с вашего локального компьютера на ваш сайт WordPress.

3. Регенерация миниатюр

При изменении темы WordPress или в случаях изменения размера миниатюр или использования плагинов оптимизации, посетителям могут отображаться «кривые» изображения. Тогда следует восстановить миниатюры, то есть сбросить размеры изображения в основных настройках WP. Сделать это можно с помощью специальных плагинов (например, «Regenerate Thumbnails»), но через WP-CLI будет гораздо быстрее, поскольку он не подлежит ограничениям и тайм-аутам HTTP.  

wp media regenerate 

wp media regenerate 

Эта команда регенерирует все миниатюры для ваших медиафайлов.

4. Регенерация миниатюр (только отсутствующих)

wp media regenerate --only-missing 

wp media regenerate --only-missing 

Эта команда восстановит только отсутствующие маниатюры.

5. Удаление медиафайла 

wp media delete <id>

wp media delete <id>

Эта команда удаляет изображение с сайта по его ID.  

Работа с плагинами

Поиск плагинов

wp plugin search 

wp plugin search 

Осуществляет поиск в каталоге плагинов WordPress.org. 

Весь список плагинов

wp plugin list

wp plugin list

Эта команда отображает список установленных на сайте плагинов со статусом активации, наличием или отсутствием обновлений и тому подобное. 

Обновление плагинов

wp plugin update --all

wp plugin update --all

Эта команда обновит все установленные плагины.

Установка плагина 

wp plugin install 

wp plugin install 

Активация плагина 

wp plugin activate 

wp plugin activate 

Установка и активация плагинов

wp plugin install --activate 

wp plugin install --activate 

Будет установлена самая свежая версия плагина с WordPress.org и активирована сразу после установки.

Установка конкретной версии плагина

wp plugin install --version=<version>

wp plugin install --version=<version>

Деактивация плагина

wp plugin deactivate

wp plugin deactivate

Удаление плагина

wp plugin delete

wp plugin delete

Список редиректов

wp rewrite list --format=csv

wp rewrite list --format=csv

Пометить комментарий как спам / удалить его

Обозначение комментария как спам

wp comment spam 1111

wp comment spam 1111

На месте 1111 вставляем ID комментария, который следует пометить как спам.

Удаление одного или нескольких комментариев 

wp comment delete 1111 2222 

wp comment delete 1111 2222 

Пример, если удалить надо несколько комментариев за раз. На месте 1111 и 2222 вставляем их ID.

Работа с записями

Открытие записи в текстовом редакторе

wp post edit 123

wp post edit 123

123 – ID записи 

Создание записи

wp post create --post_type=post --post_title='A sample post'

wp post create --post_type=post --post_title='A sample post'

Удаление записи

wp post delete 123

wp post delete 123

123 – ID записи, которую вы хотите удалить

В завершение 

На самом деле почти все, что можно делать с WordPress, можно делать с помощью WP-CLI. Возможности очень широкие, и конечно, не все мы могли представить в этой статье. 

Поэтому при необходимости обращайтесь к официальной документации. Также список всех доступных команд можно получить через wp --help.