Полное руководство по команде wp db в WP-CLI для WordPress

Команда wp db в WP-CLI предоставляет мощный инструмент для управления базой данных WordPress с использованием учетных данных из файла wp-config.php. Этот инструмент полезен для разработчиков и администраторов, которым требуется автоматизация задач или выполнение сложных операций с базой данных.

Основные команды wp db

1. Создание базы данных: wp db create

Эта команда выполняет SQL-запрос CREATE DATABASE с использованием учетных данных из wp-config.php.

Параметры:

• --dbuser=<value> — Имя пользователя для MySQL. По умолчанию: DB_USER.
• --dbpass=<value> — Пароль для MySQL. По умолчанию: DB_PASSWORD.

Пример:

$ wp db create --dbuser=admin --dbpass=securepassword
Success: Database created.

2. Удаление базы данных: wp db drop

Удаляет существующую базу данных.

Параметры:

• --dbuser=<value> — Имя пользователя для MySQL. По умолчанию: DB_USER.
• --dbpass=<value> — Пароль для MySQL. По умолчанию: DB_PASSWORD.
• --yes — Подтверждение удаления без дополнительных вопросов.

Пример:

$ wp db drop --yes
Success: Database dropped.

3. Сброс базы данных: wp db reset

Удаляет все таблицы из базы данных и создает новую структуру.

Параметры:

• --dbuser=<value> — Имя пользователя для MySQL. По умолчанию: DB_USER.
• --dbpass=<value> — Пароль для MySQL. По умолчанию: DB_PASSWORD.
• --yes — Подтверждение сброса без дополнительных вопросов.

Пример:

$ wp db reset --yes
Success: Database reset.

4. Очистка базы данных: wp db clean

Удаляет все таблицы из базы данных с указанным префиксом.

Параметры:

• --dbuser=<value> — Имя пользователя для MySQL. По умолчанию: DB_USER.
• --dbpass=<value> — Пароль для MySQL. По умолчанию: DB_PASSWORD.
• --yes — Подтверждение очистки без вопросов.

Пример:

$ wp db clean --yes
Success: Tables dropped.

5. Проверка состояния базы данных: wp db check

Проверяет состояние всех таблиц базы данных с помощью утилиты mysqlcheck.

Параметры:

• --dbuser=<value> — Имя пользователя для MySQL. По умолчанию: DB_USER.
• --dbpass=<value> — Пароль для MySQL. По умолчанию: DB_PASSWORD.

Пример:

$ wp db check
database_name.wp_posts                             OK
database_name.wp_options                           OK
Success: Database checked.

6. Оптимизация базы данных: wp db optimize

Оптимизирует таблицы базы данных.

Параметры:

• --dbuser=<value> — Имя пользователя для MySQL. По умолчанию: DB_USER.
• --dbpass=<value> — Пароль для MySQL. По умолчанию: DB_PASSWORD.

Пример:

$ wp db optimize
Success: Database optimized.

7. Ремонт базы данных: wp db repair

Восстанавливает таблицы базы данных.

Параметры:

• --dbuser=<value> — Имя пользователя для MySQL. По умолчанию: DB_USER.
• --dbpass=<value> — Пароль для MySQL. По умолчанию: DB_PASSWORD.

Пример:

$ wp db repair
Success: Database repaired.

8. Консоль MySQL: wp db cli

Открывает консоль MySQL с учетными данными из wp-config.php.

Параметры:

• --database=<database> — Указание базы данных (по умолчанию: DB_NAME).
• --default-character-set=<character-set> — Указание кодировки (по умолчанию: DB_CHARSET).

Пример:

$ wp db cli
mysql>

9. SQL-запросы: wp db query

Выполняет произвольные SQL-запросы.

Пример:

$ wp db query "SELECT * FROM wp_options WHERE option_name = 'siteurl';"
+-----------+----------+-----------------------+-----+
| option_id | option_name | option_value       | autoload |
+-----------+----------+-----------------------+-----+
| 1         | siteurl    | http://example.com | yes |
+-----------+----------+-----------------------+-----+

10. Экспорт базы данных: wp db export

Экспортирует базу данных в файл.

Пример:

$ wp db export my_database_backup.sql
Success: Exported to my_database_backup.sql

11. Импорт базы данных: wp db import

Импортирует базу данных из файла или стандартного ввода (STDIN).

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

wp db import [{file}] [--dbuser={value}] [--dbpass={value}] [--skip-optimization]

Параметры:

• [{file}] — Имя SQL файла для импорта. Если указано -, то будет использоваться стандартный ввод. Если параметр пропущен, то по умолчанию будет использоваться файл {dbname}.sql.
• [—dbuser={value}] — Имя пользователя для MySQL. По умолчанию: DB_USER.
• [—dbpass={value}] — Пароль для MySQL. По умолчанию: DB_PASSWORD.
• [—skip-optimization] — При импорте SQL файла не включать оптимизации скорости (например, отключение авто-коммита и проверок ключей).

Примеры:

• Импорт из .gz архива:

gzip -c -d db_backup-2021-09-21-120609.sql.gz | wp db import -

• Импорт из SQL файла:

wp db import wordpress_dbase.sql

Ответ:

Success: Imported from 'wordpress_dbase.sql'.

12. Отображение таблиц: wp db tables

Отображает таблицы базы данных. По умолчанию выводятся все таблицы, зарегистрированные в $wpdb.

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

wp db tables [{table}...] [--scope={scope}] --network --all-tables-with-prefix --all-tables [--format={format}]

Параметры:

• [{table}…] — Список таблиц для поиска по шаблонам, например, wp_*_options или wp_post?.
• [—scope={scope}] — Может быть all, global, ms_global, blog или старые таблицы. По умолчанию: all.
• —network — Показывает таблицы в многосайтовой установке. Переопределяет --scope={scope}.
• —all-tables-with-prefix — Отображает все таблицы с данным префиксом, даже если они не зарегистрированы в $wpdb.
• [—format={format}] — Формат вывода: list, csv. По умолчанию: list.

Примеры:

• Отображение таблиц:

wp db tables

Ответ:

wp_users
wp_usermeta
wp_posts
wp_comments
wp_links
wp_options
wp_postmeta
wp_terms
wp_term_taxonomy
wp_term_relationships
wp_termmeta
wp_commentmeta

13. Инфо базы данных: wp db size

Отображает имя и размер базы данных.

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

wp db size [--size_format] [--tables] [--format] [--scope={scope}] [--network] [--all-tables-with-prefix] [--all-tables]

Параметры:

• [—size_format] — Формат вывода размера базы данных: байты, килобайты, мегабайты, и т. д. По умолчанию: b (байты).
• [—tables] — Отображает размер каждой таблицы в базе данных.
• [—format] — Формат вывода: table, csv, json. По умолчанию: table.

Примеры:

wp db size

Ответ:

+-------------------+------+
| Name              | Size |
+-------------------+------+
| wordpress_default | 6 MB |
+-------------------+------+

14. Префикс базы данных: wp db prefix

Отображает префикс таблиц базы данных, определенный в конфигурации WordPress.

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

wp db prefix

Пример:

wp db prefix

Ответ:

wp_

15. Поиск строк в базе данных: wp db search

Поиск строки в базе данных. Выводит цветные ссылки на найденные строки.

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

wp db search {search} [{tables}...] [--network] [--all-tables-with-prefix] [--all-tables] [--before_context={num}] [--after_context={num}] [--regex] [--regex-flags={regex-flags}] [--regex-delimiter={regex-delimiter}] [--table_column_once] [--one_line] [--matches_only] [--stats] [--table_column_color={color_code}] [--id_color={color_code}] [--match_color={color_code}]

Примеры:

• Поиск строки wordpress-develop:

wp db search wordpress-develop

16. Инфо о столбцах: wp db columns

Отображает информацию о столбцах указанной таблицы.

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

wp db columns [{table}] [--format]

Параметры:

• [{table}] — Имя таблицы базы данных.
• [—format] — Формат вывода: table, csv, json, yaml.

Пример:

wp db columns wp_posts

Ответ:

+-----------------------+---------------------+------+-----+---------------------+----------------+
|         Field         |        Type         | Null | Key |       Default       |     Extra      |
+-----------------------+---------------------+------+-----+---------------------+----------------+
| ID                    | bigint(20) unsigned | NO   | PRI |                     | auto_increment |
| post_author           | bigint(20) unsigned | NO   | MUL | 0                   |                |
| post_date             | datetime            | NO   |     | 0000-00-00 00:00:00 |                |
| post_date_gmt         | datetime            | NO   |     | 0000-00-00 00:00:00 |                |
...

Советы по использованию

• Бэкап базы данных перед выполнением изменений: Используйте команду wp db export перед изменениями для сохранения текущего состояния.
• Проверка прав доступа: Убедитесь, что пользователь MySQL имеет все необходимые права на управление базой данных.
• Изучение доп.параметров: Используйте флаг --help для каждой команды, чтобы увидеть доступные параметры.

Заключение

Команда wp db в WP-CLI — мощный инструмент для работы с базой данных WordPress. Она позволяет выполнять операции от диагностики до сложных SQL-запросов. Освоив эту команду, вы сможете значительно ускорить выполнение рутинных задач и управление сайтом.