К содержимому

Настройка wp-config.php через WP-CLI: пошаговое руководство

Файл wp-config.php хранит параметры подключения WordPress к MySQL и уникальные ключи. Его можно создать вручную или командой wp config create из WP-CLI.

Руководство WordPress 2 мин чтения

01Проверьте PHP и WP-CLI

WordPress 7.1 требует PHP не ниже 7.4 и MySQL не ниже 5.5.5. На Ubuntu 24.04 подойдут PHP 8.3 и MySQL 8.0 из штатных пакетов. Убедитесь, что PHP-FPM и WP-CLI установлены. Если WP-CLI нет, установите его по официальной инструкции.

bash
php -v
wp --info

02Создайте базу данных и пользователя MySQL

Создайте базу и отдельного пользователя с паролем. Не используйте root для WordPress. Пользователь определяется парой имени и хоста: 'blog'@'localhost' подходит для подключения с этого же сервера.

bash
sudo mysql -e "CREATE DATABASE blog CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_ci;"
sudo mysql -e "CREATE USER 'blog'@'localhost' IDENTIFIED BY 'strongpassword';"
sudo mysql -e "GRANT ALL PRIVILEGES ON blog.* TO 'blog'@'localhost';"

03Скачайте WordPress в каталог сайта

Перейдите в каталог, где будет лежать сайт, и скачайте русскую сборку WordPress. Команда wp core download создаст файлы ядра в текущем каталоге. Убедитесь, что каталог принадлежит пользователю, от которого вы запускаете WP-CLI.

bash
cd /var/www/example.com
sudo -u deploy wp core download --locale=ru_RU

04Создайте wp-config.php командой wp config create

Команда wp config create запишет файл wp-config.php с указанными параметрами базы, а также сгенерирует уникальные ключи и соли. По умолчанию DB_HOST будет localhost, а префикс таблиц wp_. Запускайте команду от владельца файлов сайта, иначе WP-CLI откажется работать под root.

bash
sudo -u deploy wp config create --dbname=blog --dbuser=blog --dbpass='strongpassword'

05Проверьте содержимое wp-config.php

Откройте файл и убедитесь, что параметры DB_NAME, DB_USER, DB_PASSWORD и DB_HOST верны. Ключи и соли должны быть уникальными длинными строками. Не добавляйте лишние пробелы до открывающего тега <?php.

bash
sudo -u deploy cat wp-config.php

06Запустите установку WordPress

Откройте сайт в браузере и пройдите мастер установки: укажите название сайта, логин администратора и пароль. Если мастер не открывается, проверьте настройки nginx и PHP-FPM. После установки войдите в админку по адресу /wp-admin/.

07Проверьте работу сайта и подключение к базе

Убедитесь, что главная страница открывается без ошибок. В админке не должно быть сообщения «Ошибка установки соединения с базой данных». Если оно появилось, проверьте данные в wp-config.php и статус MySQL.

bash
curl -I http://example.com
sudo systemctl status mysql

Частые ошибки

  • При запуске wp config create от root появляется ошибка «Error: YIKES! It looks like you're running this as root.»

    Запускайте WP-CLI от владельца файлов сайта: sudo -u deploy wp config create... из каталога сайта.

  • После создания wp-config.php сайт пишет «Ошибка установки соединения с базой данных».

    Проверьте DB_NAME, DB_USER, DB_PASSWORD и DB_HOST в wp-config.php. Убедитесь, что MySQL запущен: sudo systemctl status mysql.

  • В wp-config.php остались ключи и соли из примера или с другого сайта.

    Сгенерируйте новые ключи и соли командой wp config shuffle-salts или заново создайте файл через wp config create.

Deploykin

Как это делается в Deploykin

В Deploykin WordPress ставится из шаблона: ядро, база и wp-config.php создаются сами, WP-CLI ставится вместе с сайтом. WP-Cron заменяется системным cron, XML-RPC отключается переключателем, а файлы и база уходят в бэкап по расписанию на ваше хранилище.

7 дней бесплатно на тарифе Про, без привязки карты.

Вопросы и ответы

Можно ли создать wp-config.php вручную?

Да, скопируйте wp-config-sample.php в wp-config.php и заполните параметры базы. Но WP-CLI делает это быстрее и сразу генерирует уникальные ключи и соли.

Где WP-CLI ищет wp-config.php?

В текущем каталоге и выше по дереву. Запускайте команды из каталога сайта, где лежит файл.

Что делать, если забыли пароль администратора WordPress?

Смените его командой wp user update admin --user_pass="новыйпароль" от владельца файлов сайта.

Нужно ли добавлять define('WP_DEBUG', true) в wp-config.php?

Для отладки да, но на рабочем сайте лучше держать WP_DEBUG выключенным, чтобы не показывать ошибки посетителям.

Ещё по теме

Установка WordPress на собственный сервер: все материалы темы

Мы используем cookies и сервис веб-аналитики «Яндекс Метрика» (включая Вебвизор) для улучшения работы сайта. Подробности — в политике конфиденциальности.