Установка

Рассмотрим самые основные варианты установки WP-CLI.

Рекомендуемая установка

Рекомендуемая установка WP-CLI — скачать сборку Phar (архивы, похожие на Java JAR-файлы, подробнее см. в этой статье), пометить ее как исполняемую и поместить в 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 установлен успешно, вы увидите вывод, подобный этому:

OS:  Linux 4.10.0-42-generic #46~16.04.1-Ubuntu SMP Mon Dec 4 15:57:59 UTC 2017 x86_64
Shell:   /usr/bin/zsh
PHP binary:    /usr/bin/php
PHP version:     7.1.12-1+ubuntu16.04.1+deb.sury.org+1
php.ini used:   /etc/php/7.1/cli/php.ini
WP-CLI root dir:        /home/wp-cli/.wp-cli
WP-CLI packages dir:    /home/wp-cli/.wp-cli/packages/
WP-CLI global config:   /home/wp-cli/.wp-cli/config.yml
WP-CLI project config:
WP-CLI version: 1.5.0

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

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

Обновление WP-CLI

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

Когда вы запустите wp cli update, вам будет предложено подтвердить обновление. Вы увидите сообщение, похожее на следующее:

You have version 0.21.1. Would you like to update to 0.23.1? [y/n]

После согласия вы должны увидеть сообщение об успехе:

Success: Updated WP-CLI to 0.23.1

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

WP-CLI is at the latest version.

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

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

Tab completions

Bash & Z-Shell

WP-CLI также идет со скриптом tab completion (скрипт заполнения через Tab) для Bash и Z-Shell.

Просто скачайте wp-completion.bash и извлеките его из ~/.bash_profile:

source /FULL/PATH/TO/wp-completion.bash

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

Oh My Zsh

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

Примечание: плагин Oh My Zsh поставляется с включенным скриптом bash completion, поэтому нет необходимости иметь оба плагина.

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

Рабочий процесс Dash/Alfred

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

Настройка

Откройте Dash и скачайте набор документов WP-CLI:

Dash -> Preferences -> Downloads -> User Contributions -> Search for WP-CLI

Все еще находясь в Dash, активируйте интеграцию Alfred:

Dash -> Preferences -> Integration -> Alfred

Использование

Откройте Alfred и попробуйте поискать определенную команду. Например, команда ниже покажет обзор команды plugin и ее подкоманд:

wp-cli plugin

Альтернативные методы установки

Установка WP-CLI через Git

Если вы собираетесь работать над самим WP-CLI, обратитесь к блоку Setting up (Настройка) в разделе Pull Requests этого справочника.

Установка nightly через Phar

Nightly — это самая современная версия WP-CLI, собранная прямо из ветки master.

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

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

Установка через Composer

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

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

"require" : {
    "wp-cli/wp-cli-bundle": "*"
}

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

composer require --dev $(composer suggests --by-package | awk '/wp-cli\/wp-cli-bundle/' RS= | grep -o -P '(?<=- ).*(?=:)')

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

"scripts" : {
    "post-install-cmd" : [
        "[[ -f /usr/bin/wp ]] || sudo ln -s /var/www/vendor/wp-cli/wp-cli/bin/wp /usr/bin/wp",
        "source /var/www/vendor/wp-cli/wp-cli/utils/wp-completion.bash",
    "[[ -f ~/.bash_profile ]] || touch ~/.bash_profile",
        "source ~/.bash_profile"
    ]
}

Вышеприведенный скрипт предполагает, что ваша текущая оболочка — bash, что может быть не у всех пользователей. Пример для vagrant box (добавлен в scriptsblock):

cat /etc/passwd | grep $(whoami)
vagrant:x:1000:1000::/home/vagrant:/bin/bash

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

"scripts" : {
    "post-update-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 \"source /var/www/vendor/wp-cli/wp-cli/utils/wp-completion.bash\"",
    "/bin/bash -c \"[[ -f ~/.bash_profile ]] || touch ~/.bash_profile\"",
        "/bin/bash -c \"source ~/.bash_profile\""
    ]
}

Как проект

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

composer create-project 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 pull origin main
composer install

Глобальные требования

Если вы предпочитаете, чтобы инструменты PHP были установлены глобально через Composer и у вас в PATH есть что-то вроде ~/.composer/vendor/bin (или 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 --no-dev

Версия должна быть в формате, понятном 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

Установка через Homebrew

brew install wp-cli

Вот формула.

Установка через Docker

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

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

image: wordpress:cli

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

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

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

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

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

@ECHO OFF
php "c:/wp-cli/wp-cli.phar" %*

Добавьте c:\wp-cli в свой путь:

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

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

Установка через пакет .deb

В Debian или Ubuntu просто скачайте и откройте один из пакетов .deb:

https://github.com/wp-cli/builds/tree/gh-pages/deb

Установка на Fedora 30+

su -c 'dnf install wp-cli'

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

su -c 'yum install wp-cli'

Использование пользовательского двоичного файла PHP

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

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

PHP_VERSION=$(ls /Applications/MAMP/bin/php/ | sort -n | tail -1)
export PATH=/Applications/MAMP/bin/php/${PHP_VERSION}/bin:$PATH

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

export PATH=/Applications/MAMP/bin/php/php5.5.26/bin:$PATH

Обратите внимание, что в этом случае переменная PHP_VERSION не присваивается, потому что мы не ищем динамически последнюю версию PHP.

После того, как вы добавили всё и сохранили файл, перезагрузите его с помощью:

source ~/.bash_profile

После этого запустите wp --info, чтобы убедиться, что изменения были применены правильно.

Для установки WP-CLI на базе Composer и Git можно альтернативно установить переменную окружения WP_CLI_PHP, если вы по каким-то причинам не хотите изменять PATH.

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

См. ссылку:

http://razorfrog.com/installing-wp-cli-on-mediatemple-grid-server/

Была ли эта страница полезной?