Быстрый старт

Поздравляем! Вы впервые установили WP-CLI и готовы усовершенствовать использование WordPress. Эта страница содержит краткое введение в WP-CLI с некоторыми примерами использования.

Вступление

WP-CLI — это интерфейс командной строки для WordPress.

Цель проекта — предложить полную альтернативу административной панели WordPress (админке); для любого действия, которое вы захотите выполнить в админке WordPress, должна существовать эквивалентная команда WP-CLI.

Например, поскольку вы можете установить плагин из админки WordPress, вы также можете установить плагин с помощью WP-CLI:

$ wp plugin install akismet
Installing Akismet (3.1.8)
Downloading install package from https://downloads.wordpress.org/plugin/akismet.3.1.8.zip...
Unpacking the package...
Installing the plugin...
Plugin installed successfully.

И, поскольку вы также можете активировать плагины из админки WordPress, вы можете активировать плагин с помощью WP-CLI:

$ wp plugin activate akismet
Success: Plugin 'akismet' activated.
Одно из ключевых различий между использованием админки WordPress и WP-CLI: для выполнения любого действия требуется гораздо меньше кликов.

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

Общие термины

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

Например, команда — это атомарная единица функциональности WP-CLI. wp plugin install является одной из таких команд, как и wp plugin activate. Команды представляют собой имя (например, ‘plugin install’) и обратный вызов, и регистрируются с помощью WP_CLI::add_command().

Синопсис определяет, какие позиционные и ассоциативные аргументы принимает команда. Давайте рассмотрим синопсис для команды wp plugin install:

$ wp plugin install
usage: wp plugin install <plugin|zip|url>... [--version=<version>] [--force] [--activate] [--activate-network]

В этом примере … является принятым позиционным аргументом. На самом деле, wp plugin install принимает один и тот же позиционный аргумент (slug (строка идентификатор), ZIP или URL плагина для установки) несколько раз. [--version=<version>] — один из принятых ассоциативных аргументов. Он используется для обозначения версии устанавливаемого плагина.

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

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

Практические примеры

Готовы погрузиться? Вот несколько распространенных примеров использования WP-CLI:

Скачивание и установка WordPress за считанные секунды

1. Скачайте последнюю версию WordPress с помощью wp core download:

$ wp core download --path=wpclidemo.dev
Creating directory '/srv/www/wpclidemo.dev/'.
Downloading WordPress 4.6.1 (en_US)...
Using cached file '/home/vagrant/.wp-cli/cache/core/wordpress-4.6.1-en_US.tar.gz'...
Success: WordPress downloaded.

2. Создайте новый файл wp-config.php с помощью wp config create:

$ cd wpclidemo.dev
$ wp config create --dbname=wpclidemo --dbuser=root --prompt=dbpass
1/10 [--dbpass=<dbpass>]:
Success: Generated 'wp-config.php' file.

3. Создайте базу данных на основе wp-config.php с помощью wp db create:

$ wp db create
Success: Database created.

4. Установите WordPress с помощью wp core install:

$ wp core install --url=wpclidemo.dev --title="WP-CLI" --admin_user=wpcli --admin_password=wpcli --admin_email=info@wp-cli.org
Success: WordPress installed successfully.

Вот и все!

Обновление плагинов до последней версии

Используйте wp plugin update --all, чтобы обновить все плагины до последней версии.

$ wp plugin update --all
Enabling Maintenance mode...
Downloading update from https://downloads.wordpress.org/plugin/akismet.3.1.11.zip...
Unpacking the update...
Installing the latest version...
Removing the old version of the plugin...
Plugin updated successfully.
Downloading update from https://downloads.wordpress.org/plugin/nginx-champuru.3.2.0.zip...
Unpacking the update...
Installing the latest version...
Removing the old version of the plugin...
Plugin updated successfully.
Disabling Maintenance mode...
Success: Updated 2/2 plugins.
+------------------------+-------------+-------------+---------+
| name                   | old_version | new_version | status  |
+------------------------+-------------+-------------+---------+
| akismet                | 3.1.3       | 3.1.11      | Updated |
| nginx-cache-controller | 3.1.1       | 3.2.0       | Updated |
+------------------------+-------------+-------------+---------+

Добавление пользователя в качестве супер-админа

На многосайтовом сайте используйте wp super-admin add для предоставления полномочий супер администратора существующему пользователю.

$ wp super-admin add wpcli
Success: Granted super-admin capabilities.

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

Если вы добавили или изменили размер изображения, зарегистрированного с помощью add_image_size(), вы можете использовать wp media regenerate, чтобы ваша тема отображала правильный размер изображения.

wp media regenerate --yes
Found 1 image to regenerate.
1/1 Regenerated thumbnails for "charlie-gpa" (ID 4).
Success: Finished regenerating the image.

Интересно, что дальше? Просмотрите все команды WP-CLI, чтобы открыть для себя новый мир.

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