Wp cli: WP-CLI Commands | WordPress Developer Resources

На экране появится список наиболее важных подкоманд wp-cli. Чтобы закрыть справку, введите:

q

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

wp <tab><tab>
cache           eval            network-meta    role            theme
cap             eval-file       option          scaffold        transient
cli             export          plugin          search-replace  user


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

wp help theme
NAME
wp theme
DESCRIPTION
Manage themes.
SYNOPSIS
wp theme <subcommand>
SUBCOMMANDS
activate          Activate a theme.
delete            Delete a theme.
. . .

wp help theme install
NAME
wp theme install
DESCRIPTION
Install a theme.
. . .

Установка тем

Попробуйте становить тему для сайта при помощи командной строки wp-cli.

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

wp theme list
+----------------+----------+--------+---------+
| name           | status   | update | version |
+----------------+----------+--------+---------+
| twentythirteen | active   | none   | 1.1     |
| twentytwelve   | inactive | none   | 1.3     |
+----------------+----------+--------+---------+

В списке указаны две установленные ранее темы. Ткущей темой является twentythirteen. Попробуйте изменить это.

Поиск темы выполняется с помощью следующей команды:

wp theme search fancy
Success: Showing 5 of 5 themes.
+---------------+---------------+--------+
| name          | slug          | rating |
+---------------+---------------+--------+
| Bold Headline | bold-headline | 100    |
| Clearly       | clearly       | 90     |
| The Skeleton  | the-skeleton  | 100    |
| Metronome     | metronome     | 0      |
| Shipyard      | shipyard      | 0      |
+---------------+---------------+--------+

Согласно полученному результату, параметру fancy отвечают 5 тем. Установите, к примеру, Bold Headline. Для этого добавьте в следующую команду строку из столбца slug.

wp theme install bold-headline

После этого запросите список установленных тем:

wp theme list
+----------------+----------+--------+---------+
| name           | status   | update | version |
+----------------+----------+--------+---------+
| bold-headline  | inactive | none   | 1. 2.5   |
| twentythirteen | active   | none   | 1.1     |
| twentytwelve   | inactive | none   | 1.3     |
+----------------+----------+--------+---------+

Тема Bold Headline была успешно установлена.

Чтобы включить эту тему, введите:

wp theme activate bold-headline

Посетите сайт и убедитесь, что тема изменилась.

Управление плагинами

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

wp plugin list
+---------+----------+--------+---------+
| name    | status   | update | version |
+---------+----------+--------+---------+
| akismet | inactive | none   | 2.5.9   |
| hello   | inactive | none   | 1.6     |
+---------+----------+--------+---------+

Установите плагин Digg-Digg, предлагающий пользователям поделиться этим контентом на страницах социальных сетей.

wp plugin search Digg

Программа предложит вам список найденных плагинов, выберите aas-digg-digg-alternative и установите его (имя для установки находится в столбце slug)

wp plugin install aas-digg-digg-alternative

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

Управление контентом

Также командная строка wp-cli позволяет создавать записи.

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

wp post list
+----+--------------+-------------+---------------------+-------------+
| ID | post_title   | post_name   | post_date           | post_status |
+----+--------------+-------------+---------------------+-------------+
| 1  | Hello world! | hello-world | 2013-10-31 20:02:18 | publish     |
+----+--------------+-------------+---------------------+-------------+

На данный момент на сайте опубликована только стандартная запись. Отредактируйте её, добавив более полезный контент.

Получить доступ к записи можно с помощью её ID:

wp post edit 1

Удалите стандартный текст и замените его:

Hello.  This is my first official blog post.  I hope to be adding some additional content here soon.
Have a great day!

Сохраните и закройте файл, после чего содержимое записи изменится. Чтобы изменить название записи, введите:

wp post update 1 --post_title="An Introduction..."

Посетите сайт и убедитесь, что запись обновлена.

Чтобы добавить новую запись, введите:

wp post create --post_status=publish --post_title="Second Post" --edit

На экране появится редактор, в котором можно ввести текст новой записи.

Hello.
Here is another post.
I am becoming quite prolific.

Запрос данных

Строка wp-cli может взаимодействовать с данными SQL.

Чтобы открыть интерактивную сессию БД WordPress, наберите:

wp db cli

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

exit

Общие операции БД можно выполнять непосредственно в wp-cli.

Чтобы запросить пользователей и их ID, введите:

wp db query "SELECT user_login,ID FROM wp_users;"
+------------+----+
| user_login | ID |
+------------+----+
| admin      |  1 |
+------------+----+

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

Примечание: Укажите номер записи, которую нужно отредактировать.

wp post update 6 --post_author=1

Итак, теперь на сайте указан автор записи.

Для оптимизации БД используется команда:

wp db optimize

Обновление WordPress

Чтобы обновить WordPress до боле актуальной версии, введите:

wp core update
wp core update-db

Также можно обновить все установленные плагины:

wp plugin update --all

Заключение

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

команд WP-CLI | Ресурсы для разработчиков WordPress

Ниже приведен список всех доступных в настоящее время команд WP-CLI со ссылками на документацию по использованию и подкоманды.

Хотите узнать больше о внутреннем API WP-CLI или внести свой вклад в его разработку? Ознакомьтесь с руководством команды WP-CLI.

Установка — WP-CLI — WordPress.org

• Рекомендуемая установка
  • Обновление WP-CLI
  • Вкладки завершения
    • Bash и Z-Shell
    • О, мой ЗШ
  Рабочий процесс
  • Dash/Alfred
    • Настройка
    • Использование
  • Альтернативные методы установки
    • Установка через Git
    • Ночная установка через Phar
    • Установка через Composer
      • Глобальная установка в виде проекта
    • Установка через Homebrew
    • Установка через Docker
    • Установка в Windows
    • Установка через пакет .deb
    • Установка в Fedora 30+
    • Установка на CentOS
    • Использование пользовательского двоичного файла PHP
    • Установка в MediaTemple

Рекомендуемый способ установки WP-CLIWP-CLI WP-CLI — это интерфейс командной строки для WordPress, используемый для выполнения задач администрирования и разработки программным способом. Страница проекта — http://wp-cli.org/ https://make.wordpress.org/cli/ — скачать сборку Phar (архивы похожи на JAR-файлы Java, подробнее см. в этой статье), пометив ее исполняемый файл и поместить его в PATH.

Сначала загрузите wp-cli.phar, используя wget или curl . Например:

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

Затем проверьте, работает ли он:

 php wp-cli.phar --info
 

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

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

Теперь попробуйте запустить wp --info . Если WP-CLI установлен успешно, вы увидите следующий вывод:

 ОС: Linux 4.10.0-42-generic #46~16.04.1-Ubuntu SMP Пн, 4 декабря 15:57:59 UTC 2017 x86_64
Оболочка: /usr/bin/zsh
Двоичный файл PHP: /usr/bin/php
Версия PHP: 7. 1.12-1+ubuntu16.04.1+deb.sury.org+1
Используемый php.ini: /etc/php/7.1/cli/php.ini
Корневой каталог WP-CLI: /home/wp-cli/.wp-cli
Каталог пакетов WP-CLI: /home/wp-cli/.wp-cli/packages/
Глобальная конфигурация WP-CLI: /home/wp-cli/.wp-cli/config.yml
Конфигурация проекта WP-CLI:
Версия WP-CLI: 1.5.0
 

Вуаля! Теперь вы официальный пользователь WP-CLI.

Хотите знать, что делать дальше? Ознакомьтесь с кратким введением и некоторыми примерами использования в кратком руководстве.

Если вы установили WP-CLI с помощью рекомендованного метода Phar, вы можете обновить его в любое время, запустив wp cli update (хотя, если WP-CLI принадлежит root, это может быть sudo wp cli update ) . Если вы установили WP-CLI с помощью Composer или GitGit, Git — это бесплатная распределенная система управления версиями с открытым исходным кодом, предназначенная для быстрой и эффективной обработки любых проектов, от небольших до очень крупных. Git прост в освоении и имеет крошечный размер с молниеносной производительностью. Большинство современных плагинов и тем разрабатываются с помощью этой системы контроля версий. https://git-scm.com/., смотрите конкретные инструкции по обновлению, связанные с каждым методом ниже.

При запуске wp cli update вам будет предложено подтвердить, что вы хотите выполнить обновление, с сообщением, подобным следующему:

 У вас версия 0.21.1. Хотите обновиться до 0.23.1? [г/н]
 

После принятия вы должны увидеть сообщение об успешном завершении:

 Успех: обновлен WP-CLI до версии 0.23.1.
 

Если вы уже используете последнюю версию WP-CLI, вы увидите это сообщение:

 WP-CLI последней версии.
 

Хотите жить на грани? Выполнить wp cli update --nightly , чтобы использовать последнюю ночную сборку WP-CLI. Ночная сборка более или менее достаточно стабильна для использования в вашей локальной среде и всегда включает самые последние и лучшие версии.

Для получения дополнительной информации о wp cli update , включая флаги и параметры, которые можно использовать, прочитайте полную страницу документации по команде обновления.

WP-CLI также поставляется со сценарием завершения табуляции для Bash и Z-Shell . Просто скачайте wp-completion.bash и получите его с ~/.bash_profile :

 источник /ПОЛНЫЙ/ПУТЬ/К/wp-completion.bash
 

Чтобы это изменение вступило в силу в текущей активной оболочке, после этого запустите source ~/.bash_profile .

Если вы используете фреймворк Oh My Zsh , вы можете включить встроенный плагин wp-cli , добавив его в строку plugins=(wp-cli git [...]) в вашем файле ~/.zshrc .

Примечание. Плагин Oh My Zsh Плагин Плагин — это часть программного обеспечения, содержащая группу функций, которые можно добавить на веб-сайт WordPress. Они могут расширять функциональные возможности или добавлять новые функции на ваши веб-сайты WordPress. Плагины WordPress написаны на языке программирования PHP и легко интегрируются с WordPress. Они могут быть бесплатными в каталоге плагинов WordPress. org https://wordpress.org/plugins/ или могут быть платными плагинами от сторонних производителей, которые поставляются с включенным скриптом завершения bash, поэтому нет необходимости иметь оба.

Чтобы это изменение вступило в силу в текущей активной оболочке, после этого запустите source ~/.zshrc .

Если вы используете Dash и Alfred , вы можете добавить собственный рабочий процесс Alfred для поиска информации о командах WP-CLI.

Откройте Dash и загрузите набор документов WP-CLI:
Dash › Настройки › Загрузки › Вклады пользователей › Поиск WP-CLI

Все еще в Dash, активируйте интеграцию Alfred:
Dash › Настройки › Интеграция › Alfred

Откройте Alfred и попробуйте найти определенную команду. Например, это дает вам обзор команды plugin и ее подкоманд: wp-cli plugin

Если вы собираетесь работать с самим WP-CLI, см. раздел Настройка в Pull Requests.

«Ночная» — это передовая версия WP-CLI, созданная прямо из основной ветки.

Просто следуйте обычным инструкциям по установке, за исключением изменения URLURL Конкретный веб-адрес веб-сайта или веб-страницы в Интернете, например URL-адрес веб-сайта www.wordpress.org в phar-файле:

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

Как часть проекта

Добавьте следующую строку в свой проект Файл composer.json :

 «требуется»: {
    "wp-cli/wp-cli-комплект": "*"
}
 

Чтобы добавить любые дополнительные рекомендуемые пакеты из пакета wp-cli-bundle , например psy/psysh , запустите:

 composer require --dev $(composer предлагает --by-package | awk '/ wp-cli\/wp-cli-bundle/' RS= | grep -o -P '(?<=- ).*(?=:)')
 

При желании (при запуске на сервере или, например, на виртуальной машине локально) вы можете автоматизировать настройку команды и сделать ее доступной в пути пользователя. Предположим, что Composer установлен в /var/www/vendor (вы можете получить переменную конфигурации composer vendor-dir , специфичную для вашей машины, через composer config --list | grep "\[vendor-dir\]" ), мы можем добавить следующие скрипты /commands в файл composer. json . Вторая и третья строки настраивают завершение bash, поэтому нам не нужно запоминать каждую команду:

 "скрипты" : {
    "после установки-cmd": [
        "[[ -f /usr/bin/wp ]] || sudo ln -s /var/www/vendor/wp-cli/wp-cli/bin/wp /usr/bin/wp",
        "источник /var/www/vendor/wp-cli/wp-cli/utils/wp-completion.bash",
    "[[ -f ~/.bash_profile ]] || коснитесь ~/.bash_profile",
        "источник ~/.bash_profile"
    ]
}
 

Приведенный выше сценарий предполагает, что ваша текущая оболочка — bash , что может быть не для всех пользователей. Пример бродячего блока (добавлен в скрипты -blockBlock Блок — это абстрактный термин, используемый для описания единиц разметки, которые, составленные вместе, формируют содержимое или макет веб-страницы с помощью редактора WordPress. Идея объединяет концепции того, что в в прошлом, возможно, были достигнуты короткие коды, настраиваемый HTML и встраивание обнаружения в единый согласованный API и взаимодействие с пользователем. ):

 кошка /etc/passwd | grep $(ктоами)
бродяга: х: 1000: 1000:: / дома / бродяга: / бен / Баш
 

Если у вас есть bash , доступный и установленный для вашей ОС, вы можете переключаться динамически:

 «скрипты»: {
    «после обновления-cmd»: [
        "/bin/bash -c \"[[ -f /usr/local/bin/wp ]] || sudo ln -s /var/www/vendor/wp-cli/wp-cli/bin/wp /usr/bin/wp\"",
        "/bin/bash -c \"источник /var/www/vendor/wp-cli/wp-cli/utils/wp-completion.bash\"",
    "/bin/bash -c \"[[ -f ~/.bash_profile ]] || коснитесь ~/.bash_profile\"",
        "/bin/bash -c \"источник ~/.bash_profile\""
    ]
}
 

В качестве проекта

Требуется php и composer (или php composer.phar ), настроенные как консольные команды.

 композитор создать проект wp-cli/wp-cli-bundle --prefer-source
 

Затем запустите wp-cli-bundle/vendor/wp-cli/wp-cli/bin/wp или добавьте папку wp-cli-bundle/vendor/wp-cli/wp-cli/bin в PATH для глобальной команды wp (в Windows вместо этого используйте wp-cli/bin/wp. bat ).

Для обновления вам необходимо:

 cd wp-cli-bundle
git тянуть источник основной
установка композитора
 

Global require

Если вы предпочитаете иметь PHPPHP PHP (рекурсивная аббревиатура от PHP: препроцессор гипертекста) — это широко используемый язык сценариев общего назначения с открытым исходным кодом, который особенно подходит для веб-разработки и может быть встроен в HTML. http://php.net/manual/en/intro-whatis.php. инструменты, установленные глобально через Composer и имеющие что-то вроде ~/.composer/vendor/bin в вашем PATH (или C:\Users\you\AppData\Roaming\Composer\vendor\bin в Windows), вы можете просто запустить:

 composer global require wp-cli/wp-cli-bundle
 

Чтобы обновить все глобально, запустите composer global update .

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

Если вы хотите установить определенную версию WP-CLI, добавьте номера версий после пакетов

 composer create-project wp-cli/wp-cli-bundle:2. 1.0 - -нет-разработчик
 

Версия должна быть в формате, понятном Composer, и ее можно найти на packagist.org.

Установка новейших технологий

Если вы хотите установить новейшие технологии, используйте dev-main :

 composer create-project wp-cli/wp-cli-bundle:dev-main --no-dev
 

Вы можете указать собственный путь установки для WP-CLI, например:

 composer create-project wp-cli/wp-cli-bundle /usr/share/wp-cli --no-dev
 

Затем просто создайте символическую ссылку на двоичный файл:

 sudo ln -s /usr/share/wp-cli-bundle/vendor/wp-cli/wp-cli/bin /usr/bin/wp
 

 варить установить wp-cli
 

Вот формула.

Сообщество Docker поддерживает образы WordPress и WP-CLI.

Чтобы включить изображение WP-CLI в свой проект:

 изображение: wordpress:cli
 

Установите через композитор, как описано выше, или используйте следующий метод.

Убедитесь, что у вас установлен php и указан ваш путь, чтобы вы могли выполнять его глобально.

Загрузите wp-cli.phar вручную и сохраните его в папке, например c:\wp-cli

Создайте файл с именем wp.bat в c:\wp-cli со следующим содержимым :

 @ЭХО ВЫКЛ.
php "c:/wp-cli/wp-cli.phar" %*
 

Добавьте c:\wp-cli к вашему пути:

 setx path "%path%;c:\wp-cli"
 

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

В Debian или Ubuntu просто загрузите и откройте один из пакетов .deb: https://github.com/wp-cli/builds/tree/gh-pages/deb

 su -c 'dnf установить wp-cli'
 

 su -c 'yum установить wp-cli'
 

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

Чтобы использовать последнюю версию PHP, предоставленную MAMP, вам необходимо изменить переменную среды PATH , добавив следующее в ваш ~/.bash_profile или ~/.zsh_profile :

 PHP_VERSION=$( ls /Applications/MAMP/bin/php/ | sort -n | tail -1)
экспорт PATH=/Applications/MAMP/bin/php/${PHP_VERSION}/bin:$PATH
 

Чтобы использовать определенную версию PHP, предоставленную MAMP, вам необходимо определить путь к исполняемому файлу версии PHP и изменить переменную среды PATH , добавив следующее в ваш ~/.