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

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

В статье представлены все подкоманды wp config с примерами использования, включая описание параметров, чтобы сделать руководство максимально полезным для разработчиков.

1. Команда wp config create

Создает новый файл wp-config.php с указанием параметров базы данных и других настроек.

Синтаксис:

wp config create --dbname=<dbname> --dbuser=<dbuser> [--dbpass=<dbpass>] [--dbhost=<dbhost>] [--dbprefix=<dbprefix>] [--dbcharset=<dbcharset>] [--dbcollate=<dbcollate>] [--locale=<locale>] [--extra-php] [--skip-salts] [--skip-check] [--force]

Описание параметров:

• --dbname — Указывает имя базы данных.
• --dbuser — Указывает имя пользователя базы данных.
• [--dbpass] — Пароль для пользователя базы данных.
• [--dbhost] — Хост базы данных (по умолчанию: localhost).
• [--dbprefix] — Префикс таблиц базы данных (по умолчанию: wp_).
• [--dbcharset] — Кодировка базы данных (по умолчанию: utf8).
• [--dbcollate] — Сортировка базы данных.
• [--locale] — Локализация сайта (например, ru_RU для русского языка).
• [--extra-php] — Добавление дополнительного PHP-кода в wp-config.php из ввода.
• [--skip-salts] — Пропустить генерацию ключей и солей.
• [--skip-check] — Пропустить проверку соединения с базой данных.
• [--force] — Перезаписывает существующий файл wp-config.php.

Примеры:

• Создание стандартного файла wp-config.php:

wp config create --dbname=my_database --dbuser=my_user --dbpass=my_secure_password --locale=ru_RU

Результат:

Success: Generated 'wp-config.php' file.

• Добавление отладочных параметров:

wp config create --dbname=my_database --dbuser=my_user --dbpass=my_secure_password --extra-php <<PHP
define( 'WP_DEBUG', true );
define( 'WP_DEBUG_LOG', true );
PHP

• Создание файла без сохранения пароля в истории:

wp config create --dbname=my_database --dbuser=my_user --prompt=dbpass

2. Команда wp config edit

Открывает файл wp-config.php в системном редакторе.

Синтаксис:

wp config edit

Пример:

wp config edit

Чтобы открыть файл в конкретном редакторе:

EDITOR=nano wp config edit

3. Команда wp config path

Возвращает путь к файлу wp-config.php.

Синтаксис:

wp config path

Пример:

wp config path

Результат: /var/www/html/wp-config.php

4. Команда wp config list

Отображает список всех переменных и констант, определенных в wp-config.php.

Синтаксис:

wp config list [{filter}...] [--fields=<fields>] [--format=<format>] [--strict]

Описание параметров:

• {filter} — Фильтрация списка по имени или его части.
• [--fields] — Указывает конкретные поля для вывода.
• [--format] — Формат вывода (table, json, csv, yaml).
• [--strict] — Включает строгое соответствие при фильтрации.

Примеры:

• Показать все параметры:

wp config list

• Показать только параметры с префиксом _SALT:

wp config list _SALT

5. Команда wp config get

Получает значение определенной переменной или константы.

Синтаксис:

wp config get <name> [--type=<type>]

Примеры:

• Получить значение table_prefix:

wp config get table_prefix

Результат: wp_

• Проверить значение константы WP_DEBUG:

wp config get WP_DEBUG --type=constant

6. Команда wp config set

Устанавливает значение переменной или константы.

Синтаксис:

wp config set <name> <value> [--add] [--raw] [--anchor=<anchor>] [--placement=<placement>] [--separator=<separator>] [--type=<type>]

Примеры:

• Включить отладку:

wp config set WP_DEBUG true --raw

• Добавить новый параметр:

wp config set MY_CUSTOM_OPTION 'custom_value'

7. Команда wp config delete

Удаляет указанную переменную или константу.

Синтаксис:

wp config delete <name> [--type=<type>]

Пример: Удалить COOKIE_DOMAIN:

wp config delete COOKIE_DOMAIN

8. Команда wp config has

Проверяет наличие параметра в wp-config.php.

Синтаксис:

wp config has <name> [--type=<type>]

Пример: Проверить существование DB_PASSWORD:

wp config has DB_PASSWORD

9. Команда wp config shuffle-salts

Перемешивает соли безопасности.

Синтаксис:

wp config shuffle-salts

Пример:

wp config shuffle-salts

Результат: Обновлены соли безопасности.

Заключение

Команда wp config предоставляет гибкие инструменты для управления конфигурацией WordPress, позволяя автоматизировать создание, редактирование и проверку настроек. Используйте приведенные примеры для оптимизации работы с вашим сайтом.