Unlimited Plugins, WordPress themes, videos & courses! Unlimited asset downloads! From $16.50/m
Advertisement
  1. Code
  2. WordPress
Code

Что такое WP-CLI? Руководство для новичков

by
Difficulty:BeginnerLength:LongLanguages:

Russian (Pусский) translation by Masha Kolesnikova (you can also view the original English article)

WP-CLI существует уже довольно давно (примерно с 2011 года) и неуклонно набирает популярность в сообществе разработчиков WordPress. Но что это такое, и как вы можете использовать его в своем рабочем процессе WordPress?

Идея WP-CLI заключается в том, что она позволяет вам взаимодействовать с сайтами WordPress и управлять ими через интерфейс командной строки. Согласно официальной документации, это альтернатива командной строке, использующая традиционный пользовательский интерфейс администратора WordPress.

Подход к командной строке имеет смысл, поскольку вы обычно можете делать что-то на компьютере гораздо быстрее с помощью командной строки, а WP-CLI при этом ничем от нее не отличается. Если вы когда-либо использовали командную строку в Windows или терминал на macOS, то будете чувствовать себя очень комфортно, используя WP-CLI.

Однако это учебник, ориентирован на новичков, поэтому не беспокойтесь, если вы не гуру командной строки. Если вы никогда раньше не использовали WP-CLI или командную строку, то вы оказались в хорошей компании и, безусловно, в нужном месте!

Прежде чем мы двинемся дальше, нужно кое в чем признаться. Как я уже говорил, я никогда раньше не использовал WP-CLI! Я знал о нем уже довольно долго и постоянно хотел попробовать, но так и не добрался до фактической установки и использования. До сих пор ...

Таким образом, мы будем буквально вместе разбираться в том, как использовать WP-CLI. Мне очень интересно посмотреть, как WP-CLI вписывается в мой существующий рабочий процесс разработки WordPress, и сможет ли он помочь повысить производительность.

Вы готовы начать? Хорошо, вперед!

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

Установка WP-CLI в первый раз может показаться немного сложной. Я должен был прочитать инструкции по установке пару раз, прежде чем понял в чем там смысл. Но, как оказалось, это не так сложно, когда вы точно понимаете, что требуется.

Для начала нам нужно получить последнюю версию WP-CLI. Рекомендуемый способ сделать это - загрузить WP-CLI в виде файла Phar через командную строку. Это всего лишь файл архива PHP, содержащий все файлы PHP, необходимые для запуска WP-CLI, все завернутые в один удобный файл, готовый для скачивания.

Установка на macOS

Откройте окно терминала и введите следующее:

Это загрузит файл Phar WP-CLI на ваш компьютер. Давайте проверим что все в порядке, протестировав архив WP-CLI.

Вы должны будете увидеть результат, похожий на следующий:

Чтобы сделать использование WP-CLI более удобным, мы хотим иметь возможность запускать его из любого места и с помощью более короткой команды, такой как wp, вместо того, чтобы каждый раз вводить wp-cli.phar.

Мы можем сделать это с помощью следующих двух команд:

Теперь попробуйте запустить wp -info в окне терминала (указывая на любой каталог). Если вы видите тот же результат, что и раньше, когда вы запускали php wp-cli.phar -info, значит вы все сделали правильно. WP-CLI настроен и готов к использованию!

Существуют и другие способы установки WP-CLI, например, с помощью Composer, поэтому вы можете проверить альтернативные методы.

Установка в Windows

Установка в Windows немного больше сложнее, так как PHP по умолчанию недоступен из командной строки. Вы можете установить PHP вручную, но самый простой способ - использовать локальный сервер разработки, такой как MAMP, потому что PHP автоматически устанавливается как часть общего пакета.

Когда PHP будет доступен в вашей системе, вам нужно будет найти путь к исполняемому файлу PHP и сделать его доступным глобально (это подробно описано в руководстве по PHP).

Если PHP установлен и доступен из любого каталога, загрузите файл wp-cli.phar вручную и сохраните его в папке, такой как c:\wp-cli. Чтобы иметь возможность запускать WP-CLI с помощью команды wp так же, как мы делали на macOS, создайте командный файл wp.bat внутри той же папки, в которой вы сохранили файл архива wp-cli.phar.

Добавьте это в командный файл:

Наконец, добавьте c:\wp-cli в свой глобальный путь:

WP-CLI теперь должен быть доступен из любого окна командной строки.

Даже еще проще!

Если прямо сейчас вы чувствуете себя немного потерянным, то у меня кое-что для вас есть. Если вы пользователь DesktopServer, тогда WP-CLI очень прост в настройке. С DesktopServer 3.8.2 доступен новый плагин разработчика, который устанавливает WP-CLI на всех ваших сайтах!

Installing WP-CLI Using DesktopServer

После его активации вы можете получить доступ к WP-CLI через основной сайт сайта DesktopServer или панель инструментов WordPress.

Access WP-CLI via the web browser
Accessing WP-CLI via WordPress

Если у вас есть доступ к DesktopServer, то я определенно рекомендую установить WP-CLI таким образом, поскольку это самый простой способ установки. Я использовал DesktopServer последние пару лет, поэтому мне повезло, что установка WP-CLI была для меня еще проще.

Удаленное использование WP-CLI

Это руководство предназначено для новичков WP-CLI, используя локальную установку WordPress. Однако, если вы хотите выполнять команды на удаленном сервере (т. е. в реальном времени на сайте WordPress), вы можете продолжать читать, если у вас установлен WP-CLI.

Вам нужно будет подключиться к серверу через SSH-клиент. После подключения и входа в систему вы сможете использовать все команды WP-CLI в этом учебнике.

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

Тестирование

Надеюсь, к настоящему времени у вас будет установлен WP-CLI, и в этом случае вы сможете немного расслабиться, так как мы уже сделали самую сложную часть!

Откройте окно командной строки в корневом каталоге веб-сайта WordPress, с которым вы хотите работать, что должно выглядеть похоже на снимок экрана ниже.

Preparing to use WP-CLI

Одним из преимуществ использования DesktopServer является то, что он автоматически открывает окно команд, указывающее на правильный корневой каталог сайта WordPress. Я думаю, что это приятная мелочь, особенно если вы работаете на нескольких сайтах.

Давайте теперь протестируем нашу установку WP-CLI. Вот наша первая команда ...

Таким образом, для доступа к WP-CLI вы вводите wp, за которым следует команда и / или параметр. Если wp введен, вы просто получите длинный список доступных команд и параметров (которые я не буду показывать здесь, но попробуйте сами).

Наша первая команда содержала параметр. Разница в том, что перед параметром предшествуют два дефиса. Ключевым моментом в WP-CLI является то, что почти все команды содержат подкоманды (и параметры). Эта иерархия очень хорошо организована, ее легко понять и следовать ей.

Все команды следуют аналогичной структуре, поэтому, как только вы освоите пару команд, вам будет легко двигаться дальше, чтобы узнать больше команд. Остальная часть этого руководства будет посвящена изучению некоторых команд и параметров, доступных в WP-CLI.

Давайте рассмотрим несколько основных команд WP-CLI и их вывод, чтобы понять, как это работает.

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

wp --version

Мы можем запустить аналогичную команду, чтобы найти текущую версию WordPress.

Как насчет списка всех тем, установленных в настоящее время?

Обратите внимание, как мы получаем полезную информацию, такую как статус темы и ее версию, а также доступно ли обновление.

Мы можем сделать то же самое для плагинов.

Мы можем использовать параметры для уточнения списка плагинов.

Здесь мы имеем параметр, который требует указания одного или нескольких значений. Это очень распространено, и вы привыкнете к этому очень быстро. В этом случае мы указали только поля, которые мы хотели показать (имя, версия).

Мы можем также показывать только плагины, которые отвечают определенным критериям.

Это просто выводило все плагины снова, так как все они неактивны. Мы скоро это изменим, когда начнем вводить команды для управления плагинами (и темами).

Вы могли заметить в приведенных выше командах, что используются два командных слова (plugin и list). Если вы введете wp plugin самостоятельно, это не приведет к выполнению команды, а перечислит все под-команды wp plugin. Попробуйте сами.

Таким образом, команда list - это только одна из нескольких под-команд, доступных для «родительской» команды plugin. Многие другие команды работают аналогичным образом.

Введите wp core и wp theme, чтобы просмотреть список их под-команд.

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

По умолчанию вы получаете результаты команды WP-CLI, выведенной в формате таблицы, но это можно легко заменить на JSON или значения, разделенное запятыми (CSV) с помощью параметра --format.

Теперь, когда у нас есть инструкция по вводу основных команд WP-CLI, давайте посмотрим, как мы можем выполнить некоторые полезные задачи администратора WordPress через командную строку.

Плагины и темы

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

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

Давайте снова выведем список плагинов, чтобы убедиться, что Jetpack установлен, но на этот раз просто укажите имя плагина.

Мы можем установить темы таким же образом:

И давайте просто проверим, что тема Twenty Eleven установлена правильно:

Для плагинов и тем, размещенных в другом месте, просто введите полный путь к zip-файлу. Имя плагина/темы на самом деле является slug, что удобно запомнить, если ваше имя плагина/темы составлено из нескольких слов.

Например, чтобы установить плагин проверки темы из репозитория WordPress:

Чтобы активировать плагин, используйте команду activate.

Или вы можете установить и активировать плагин в одну строчку.

Чтобы удалить плагин, используйте команду delete.

Обратите внимание, что вам не нужно было деактивировать плагин до того, как мы его удалили, как вам нужно сделать в администраторе WordPress. Процесс установки/активации/удаления одинаковый для тем.

Посты и страницы

Существуют различные команды WP-CLI для управления любыми типами сообщений, включая способ массового создания сообщений.

Сначала давайте выведем текущий список сообщений.

Теперь давайте создадим несколько сообщений.

Давайте еще раз взглянем на обновленный список сообщений.

Как вы можете видеть, создано пять новых сообщений, каждое из которых имеет общий заголовок и не содержит контента. Мы можем генерировать любое количество сообщений и для любого типа сообщений.

Это создает три новые страницы с универсальными заголовками и без содержимого страницы. Я не уверен, насколько полезен массовый постинг. Однако это может быть очень полезно для целей тестирования.

Если мы хотим создать отдельные сообщения, то у нас есть полный контроль над контентом. Давайте создадим одно сообщение с определенным заголовком и образцом.

Это создает сообщение с определенным заголовком и контентом. По умолчанию сообщения будут создаваться со статусом проекта, поэтому, если мы хотим, чтобы они были опубликованы сразу, нам нужно установить параметр post_status в publish.

Создание страницы с содержимым так же просто - просто установите параметр post_type в page (для этого по умолчанию задано сообщение).

Мы также можем обновлять существующие сообщения, используя команду update.

Убедитесь, что идентификатор сообщения правильный; в противном случае вы получите сообщение об ошибке «Warning: Invalid post ID». И снова вы можете обновить любой тип сообщения, а не только сообщения!

Как и следовало ожидать, вы также можете удалять сообщения через WP-CLI.

Это отправит сообщение в корзину. Если вы хотите обойти это и просто навсегда удалить сообщение, добавьте параметр --force.

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

Это здорово, так как это означает, что я с большей вероятностью буду возвращаться к WP-CLI, а не вернусь назад, используя удобный пользовательский интерфейс администратора WordPress, к которому привык.

Комментарии WordPress

Управление комментариями довольно похоже на сообщения. Чтобы просмотреть все комментарии на своем сайте, используйте следующую команду:

Будьте осторожны, так как это может занять некоторое время, если у вас будет много комментариев на вашем сайте!

Чтобы создать комментарий, используйте команду create, с которой мы теперь уже знакомы.

Обратите внимание, что для генерации комментария нам нужно было указать идентификатор существующего сообщения, а также контент комментария.

Точно так же, как мы сделали для сообщений, массовые комментарии также могут быть легко сгенерированы.

Не забудьте указать параметр count, если вы не хотите создавать 100 фиктивных комментариев, поскольку 100 - значение по умолчанию!

Чтобы удалить комментарий, просто используйте следующую команду с идентификатором вашего комментария и необязательным параметром --force, если вы хотите пропустить отправку его в корзину.

Однако помните, что идентификатор здесь - это идентификатор комментария, а не идентификатор сообщения.

Рекомендуемые ресурсы WP-CLI

Вот это для нашего основного введения в WP-CLI. Ниже приведен список ресурсов, если вы хотите немного углубиться и расширить свои знания.

Заключение

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

Мы узнали, что такое WP-CLI, и насколько он полезен в повседневной разработке WordPress. Несмотря на то, что команды, которые мы рассматривали, были довольно базовыми, они так же были очень полезными!

Это был первый раз, когда я лично использовал WP-CLI, и в ретроспективе я могу честно сказать, что не знаю, как я раньше обходился без него. Я точно буду теперь чаще его использовать.

Я хотел бы получить некоторый опыт с гораздо более сложными командами, чтобы действительно увидеть, что вы можете сделать с WP-CLI.

Однако некоторые пользователи, особенно новички, могут быть отброшены  так как это не входит в установку по умолчанию. Стадно, поскольку WP-CLI чрезвычайно полезен, и все разработчики WordPress должны хотя бы попробовать его.

Это очень весело, а также полезно. Если у вас есть доступ к DesktopServer, то определенно используйте его, чтобы установить WP-CLI - это будет действительно полезно.

Наконец, если вы заинтересованы в разработке WordPress, не забудьте проверить другие материалы по WordPress, который у нас имеется на Envato Tuts +.

Вы уже используете WP-CLI, или это ваш первый эксперимент с ним? Если да, то как вам? Я хотел бы услышать ваши комментарии!

Advertisement
Advertisement
Advertisement
Advertisement
Looking for something to help kick start your next project?
Envato Market has a range of items for sale to help get you started.