Работа с WordPress CLI

Все разработчики и пользователи движка WordPress наверняка знакомы с разделом администрирования /wp-admin.

Данное руководство будет полезно как администраторам, так и обычным пользователям. Мне не раз доводилось слышать кучу жалоб (в частности от админов) о том, что бывает сложно понять куда именно кликнуть чтобы выполнить нужное действие или запомнить где находится та или иная настройка. Во многом по причине ориентации на создателей плагинов, до определённого момента не существовало централизованного места для работы с WordPress напрямую через CLI.

К счастью, теперь это не так: в WordPress появился консольный инструмент, который поможет сэкономить кучу времени!

Установка инструмента

Скачать инструмент WP-CLI можно, выполнив следующую команду в командной строке:

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

Проверка работоспособности осуществляется командой:

php wp-cli.phar --info

Для того чтобы команда wp была доступна из любого места вашей системы необходимо выполнить несколько действий:

chmod +x wp-cli.phar
sudo mv wp-cli.phar /usr/local/bin/wp

Команда sudo потребует ввести пароль пользователя root.

На сайте WP-CLI вы сможете найти инструкцию и подробную информацию по работе с инструментом WP-CLI (конфигурацию для сборки MAMP, а также другие темы).

Работа с инструментом

Для работы с WP-CLI перейдите (cd) в каталог с установкой WordPress и выполните команду wp:

$ wp

Работа с wp интуитивно-понятна. Теперь, из командной строки можно выполнить любые действия, которые вы когда-либо совершали через веб-интерфейс. Всё тут: создание блога, запуск кода, работа с плагинами.

Для того чтобы получить подробную информацию о возможностях инструмента wp, достаточно выполнить команду wp help <command>:

$ wp help cli
ОПИСАНИЕ

Подробная информация по работе с инструментом WP-CLI.

СИНТАКСИС

wp cli <command>

КОМАНДЫ

check-update Проверка на наличие обновлений через Github API. Команда вернёт список доступных обновлений или пустой ответ в случае актуальной версия движка.
cmd-dump     Вывод списка доступных команд в формате JSON.
completions  Генератор строк авто-заполнения по клавише Tab.
info         Вывод данных о среде CLI.
param-dump   Вывод списка глобальных параметров в формате JSON или var_export.
update       Установка наиболее свежего обновления, удовлетворяющего требованиям. Команда вернёт список доступных обновлений или пустой ответ в случае актуальной версия движка.
version      Вывод версии WP-CLI.


Теперь из этой точки вы можете проверить наличие обновлений с помощью check-update, и непосредственно обновить движок, выполнив команду update.

Создания резервной копии

Для создания резервной копии вашего WordPress сайта выполните следующую команду:

$ wp db export

В результате вы получите не сжатую копию движка и .SQL файл который можно превратить в архив, выполнив следующую команду:

$ tar -vczf yourbackupfilename.gz .

Восстановление из резервной копии

Настройте ваш проект на каталог, созданный в результате работы wp db export. Также необходимо импортировать .SQL файл, используйте команду mysql:

$ mysql -u -p wordpress < backup.sql

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

Чтобы установить плагин будет достаточно выполнить команду:

$ wp plugin install <plugin name>

Для получения списка установленных плагинов нужно выполнить wp plugin list:

$ wp plugin list

+-------------+--------+-----------+---------+
| name | status | update | version |
+-------------+--------+-----------+---------+
| jetpack | active | none | 3.7.2 |
| woocommerce | active | available | 2.4.7 |
+-------------+--------+-----------+---------+


Вы можете переключать состояние плагина, используя аргументы activate и deactivate:

$ wp plugin activate jetpack
Success: Plugin 'jetpack' activated.

Работа с сетью блогов (опция Multisite)

Для адекватной работы команды wp с сетью WordPress сайтов, необходимо передать аргумент --url:

$ wp theme status --url=localhost/wp/test
# For a subdomain just specify the url
$ wp theme status --url=subdomain.my-wordpress-site.com

Вы также можете указать параметр --url в файле конфигурации wp-cli.yml, который необходимо поместить в корневой каталог WordPress проекта. Это позволит избавиться от необходимости каждый раз указывать данный параметр при вызове команды wp.

Добавьте следующую строку в файл wp-cli.yml:

url: test.example.com

Теперь при вызове команды wp параметр --url можно опустить:

$ wp theme status

В результате скрипт извлечёт настройки из файла конфигурации wp-cli.yml и параметр --url test.example.com будет выставлен автоматически.

Заключение

Теперь, не покидая командной строки, вы можете проверить наличие обновлений Wordpress, создать резервную копию сайта, а также установить/удалить плагин или тему. Все эти возможности делают wp-cli поистине мощным инструментом.

Для более подробной информации о возможностях wp-cli вы можете узнать из руководства по работе с WP-CLI.