====== WP-CLI, установка и примеры использования ======

WP-CLI это интерфейс командной строки для управления сайтами на Wordpress.

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

Как установить предельно понятно [[https://wp-cli.org/#installing|написано на оф сайте]].

Скачиваем через wget или curl

<code>
# wget https://raw.githubusercontent.com/wp-cli/builds/gh-pages/phar/wp-cli.phar
# curl -O https://raw.githubusercontent.com/wp-cli/builds/gh-pages/phar/wp-cli.phar
</code>

Если ''--info'' покажет нечто подобное
<code>
# php wp-cli.phar --info        
OS:     Linux 3.10.0-957.1.3.el7.x86_64 #1 SMP Thu Nov 29 14:49:43 UTC 2018 x86_64
Shell:  /bin/bash
PHP binary:     /usr/bin/php
PHP version:    7.3.1
php.ini used:   /etc/php.ini
WP-CLI root dir:        phar://wp-cli.phar/vendor/wp-cli/wp-cli
WP-CLI vendor dir:      phar://wp-cli.phar/vendor
WP_CLI phar path:       /root
WP-CLI packages dir:
WP-CLI global config:
WP-CLI project config:
WP-CLI version: 2.1.0
</code>

то можно копировать в желаемый каталог

<code>
# chmod +x wp-cli.phar
# mv wp-cli.phar /usr/local/bin/wp
</code>

Если запустить под root

<code># wp --info</code>

то будет страшное предупреждение

<code>
Error: YIKES! It looks like you're running this as root. You probably meant to run this as the user that your WordPress installation exists under.

If you REALLY mean to run this as root, we won't stop you, but just bear in mind that any code on this site will then have full control of your server, making it quite DANGEROUS.

If you'd like to continue as root, please run this again, adding this flag:  --allow-root

If you'd like to run it as the user that this site is under, you can run the following to become the respective user:

    sudo -u USER -i -- wp <command>

</code>

Для храбрых людей есть следующий ключ ''––allow-root'', но лучше работать под простым пользователем.

<code># wp --allow-root</code>

Картинка для привлечения внимания к возможной опасности при работе под root'ом

{{:web:otvaga.jpg?nolink|}}

WP-CLI готов к использованию.

===== Обновление Wordpress =====

Смотрим текущую версию

<code>
$ wp core version
4.9.9
</code>

Проверяем доступные обновления
<code>
$ wp core check-update 
+---------+-------------+-------------------------------------------------------------------+
| version | update_type | package_url                                                       |
+---------+-------------+-------------------------------------------------------------------+
| 5.0.3   | major       | https://downloads.wordpress.org/release/ru_RU/wordpress-5.0.3.zip |
+---------+-------------+-------------------------------------------------------------------+
</code>

Обновление Wordpress

<code>
$ wp core update
Updating to version 5.0.3 (ru_RU)...
Скачивание обновления из https://downloads.wordpress.org/release/ru_RU/wordpress-5.0.3.zip...
Извлечение обновления...
Cleaning up files...
No files found that need cleaning up.
Success: WordPress updated successfully.
</code>

Обновление базы сайта

<code>
$ wp core update-db
Success: WordPress database already at latest db version 43764.
</code>

===== Работа с плагинами =====

Установить/активировать/деактивировать/обновить [[https://ru.wordpress.org/plugins/gutenberg/|плагин Gutenberg]]
<code>
$ wp plugin install gutenberg
$ wp plugin activate gutenberg
$ wp plugin deactivate gutenberg
$ wp plugin update gutenberg
</code>

Список плагинов

<code>$ wp plugin list</code>

===== Search/Replace =====

Любимая операция по замене данных по всему сайту search-n-<del>destroy</del>-replace, перед непосредственным изменением лучше добавить ключ ''––dry-run''

Новый домен
<code>$ wp search-replace --dry-run 'foobar.ru' 'foobar.com'</code>

Переход на https
<code>$ wp search-replace --dry-run 'http://foobar.ru' 'https://foobar.ru'</code>

===== Импорт/экспорт базы =====

Экспорт

<code>
$ wp db export          
Success: Exported to 'wordpress-2019-01-14-2f9b587.sql'.
</code>

Импорт

<code>
$ wp db import wordpress.sql
Success: Imported from 'wordpress.sql'.
</code>

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

<code># wp cli update --allow-root</code>

{{tag>wordpress cli cms}}