Команда wp cli предназначена для управления WP-CLI, включая проверку версии, обновление, просмотр доступных псевдонимов и других возможностей. Эта статья содержит детальное описание команды, всех её параметров и уникальные примеры использования.
Список доступных подкоманд
| Команда | Описание |
|---|---|
| wp cli version | Выводит текущую версию WP-CLI. |
| wp cli info | Показывает информацию о текущей среде WP-CLI. |
| wp cli check-update | Проверяет доступность обновлений WP-CLI. |
| wp cli update | Обновляет WP-CLI до последней версии. |
| wp cli param-dump | Выводит список глобальных параметров. |
| wp cli cmd-dump | Выводит список всех установленных команд. |
| wp cli completions | Создаёт строки для автозаполнения. |
| wp cli alias | Показывает доступные псевдонимы WP-CLI. |
| wp cli has-command | Проверяет, зарегистрирована ли указанная команда. |
Глобальные параметры
Большинство подкоманд WP-CLI поддерживают следующие глобальные параметры:
| Параметр | Описание |
|---|---|
--path=<path> | Указывает путь к файлам WordPress. |
--url=<url> | Указывает URL сайта, если это мультисайт. |
--ssh=[<scheme>:][<user>@]<host>:<port>[<path>] | Выполняет операцию на удалённом сервере через SSH. |
| `—user=<id | login |
--skip-plugins[=<plugins>] | Пропускает загрузку всех плагинов или перечисленных через запятую. |
--skip-themes[=<themes>] | Пропускает загрузку всех тем или перечисленных через запятую. |
--debug[=<group>] | Выводит отладочную информацию. |
--format=<format> | Указывает формат вывода (например, table, json). |
1. Команда wp cli version
Эта команда выводит текущую установленную версию WP-CLI.
Использование:
wp cli version
Пример:
$ wp cli version
WP-CLI 2.8.0
2. Команда wp cli info
Показывает информацию о среде WP-CLI, включая:
- Версию WP-CLI;
- Версию PHP;
- Используемый
php.ini; - Локальные конфигурационные файлы WP-CLI.
Параметры:
| Параметр | Описание |
|---|---|
--format=<format> | Указывает формат вывода (list, json). |
Пример:
$ wp cli info --format=json
{
"OS": "Linux",
"PHP binary": "/usr/bin/php",
"PHP version": "8.1.2",
"WP-CLI version": "2.8.0"
}
3. Команда wp cli check-update
Проверяет наличие обновлений WP-CLI.
Параметры:
| Параметр | Описание |
|---|---|
--format=<format> | Указывает формат вывода (table, json). |
Пример:
Если WP-CLI актуальна:
$ wp cli check-update
Success: WP-CLI is at the latest version.
Если доступно обновление:
$ wp cli check-update
+---------+-------------+------------------------------------------+
| version | update_type | package_url |
+---------+-------------+------------------------------------------+
| 2.8.1 | patch | https://example.com/wp-cli-2.8.1.phar |
+---------+-------------+------------------------------------------+
4. Команда wp cli update
Обновляет WP-CLI до последней версии.
Параметры:
| Параметр | Описание |
|---|---|
--stable | Устанавливает последнюю стабильную версию. |
--nightly | Устанавливает последнюю разработческую версию. |
--yes | Подтверждает обновление без запроса. |
Пример:
$ wp cli update --yes
Downloading from https://github.com/wp-cli/wp-cli/releases/latest...
Success: Updated WP-CLI to 2.8.1.
5. Команда wp cli param-dump
Выводит список глобальных параметров в различных форматах.
Параметры:
| Параметр | Описание |
|---|---|
--with-values | Показывает текущие значения параметров. |
--format=<format> | Указывает формат вывода (json, var_export). |
Пример:
$ wp cli param-dump --format=var_export
array (
'path' => 'Path to the WordPress files.',
'url' => 'Pretend request came from given URL.',
)
6. Команда wp cli cmd-dump
Выводит список всех установленных команд в формате JSON.
Использование:
wp cli cmd-dump
Пример:
$ wp cli cmd-dump
{
"name": "wp",
"description": "Manage WordPress through the command-line."
}
7. Команда wp cli completions
Создаёт строки для автозавершения.
Пример:
$ wp cli completions --line="wp cl" --point=5
cli
8. Команда wp cli alias
Показывает доступные псевдонимы WP-CLI.
Пример:
$ wp cli alias
@prod: ssh://[email protected]
@dev: ssh://[email protected]
9. Команда wp cli has-command
Проверяет, существует ли указанная команда.
Пример:
$ wp cli has-command "post create"
$ echo $?
0
Заключение
Команда wp cli предоставляет мощные инструменты для управления WP-CLI, что делает её важной для разработчиков WordPress. Она позволяет не только диагностировать проблемы, но и обновлять WP-CLI, проверять версии, управлять псевдонимами и использовать автозавершение.