Поиск
Справочник

Подключение WordPress к базе: DB_NAME, DB_USER, DB_PASSWORD, DB_HOST

Шесть строк в начале wp-config.php говорят WordPress, к какой базе подключаться: имя базы, пользователь, пароль, адрес сервера базы, кодировка и правило сравнения букв. Если хоть одна строка неверна, вместо сайта появится Error establishing a database connection. Здесь — что в каждую строку вписать и как проверить данные до того, как их править.

≈ 6 мин чтения
Содержание 10

Что сделать прямо сейчас

  1. Подключитесь к серверу по SSH (как подключиться).
  2. Посмотрите данные базы — без пароля:
    sudo grep -E "'DB_(NAME|USER|HOST|CHARSET|COLLATE)'" /var/www/example.com/wp-config.php

    Вместо /var/www/example.com — папка вашего сайта. Ответ — пять строк, например define( 'DB_NAME', 'wordpress' );.

  3. Проверьте, что с этими данными можно войти в базу, — как, ниже.

Что в каждой строке

define( 'DB_NAME', 'wordpress' );
define( 'DB_USER', 'wpuser' );
define( 'DB_PASSWORD', 'пароль' );
define( 'DB_HOST', 'localhost' );
define( 'DB_CHARSET', 'utf8mb4' );
define( 'DB_COLLATE', '' );
СтрокаЧто вписать
DB_NAMEимя базы, которую вы создали для сайта
DB_USERпользователь MySQL, у которого есть права на эту базу
DB_PASSWORDпароль этого пользователя
DB_HOSTгде работает MySQL; если на этом же сервере — localhost
DB_CHARSETкодировка — оставьте utf8mb4
DB_COLLATEправило сравнения букв — оставьте пустым: ''

В образце wp-config-sample.php вместо имени, пользователя и пароля стоят database_name_here, username_here и password_here. Если они остались в файле, WordPress не подключится.

Создать базу и пользователя — на странице установка MySQL. Посмотреть, какие базы и пользователи уже есть, — список баз и таблиц.

Варианты DB_HOST

Что вписатьКогда
localhostMySQL на этом же сервере — так после установки
127.0.0.1MySQL на этом же сервере, подключение по сети на порт 3306
127.0.0.1:3307MySQL на этом же сервере, но на другом порту — номер после :
localhost:/run/mysqld/mysqld.sockнужно указать путь к файлу сокета MySQL
[::1]:3306подключение по IPv6 — адрес в квадратных скобках
10.0.0.5 или db.example.comбаза на другом сервере

Если база на другом сервере, MySQL там должен принимать подключения не только с самого себя, а порт 3306 — быть открыт для вашего сервера сайта (порт 3306).

Пароль с кавычкой или обратной косой чертой

Пароль записан в одинарных кавычках. Если в нём есть ' или \, поставьте перед каждым таким знаком \:

ПарольКак записать
Ab'cddefine( 'DB_PASSWORD', 'Ab\'cd' );
Ab\cddefine( 'DB_PASSWORD', 'Ab\\cd' );

Без \ перед кавычкой файл не загрузится: sudo php -l покажет Parse error и номер строки. Проще придумать пароль без ' и \: другие знаки, например !, #, $, %, в одинарных кавычках записываются как есть.

Сменили пароль пользователя в MySQL (как) — сразу впишите новый в DB_PASSWORD, иначе сайт перестанет подключаться к базе.

DB_CHARSET и DB_COLLATE

utf8mb4 — кодировка, в которой хранятся любые буквы и эмодзи. В образце файла она уже стоит; если в старом файле записано utf8, WordPress сам будет работать с utf8mb4.

Пустой DB_COLLATE значит: WordPress выбирает правило сравнения сам — utf8mb4_unicode_520_ci, если его поддерживает MySQL, иначе utf8mb4_unicode_ci. Менять не нужно. Что такое кодировка и правило сравнения — utf8mb4 в MySQL.

Как проверить данные

  1. Подключитесь к базе с данными из wp-config.php:
    mysql -u wpuser -p -h localhost wordpress

    Вместо wpuser — значение DB_USER, вместо localhost — DB_HOST, вместо wordpress — DB_NAME. Если в DB_HOST есть порт, например 127.0.0.1:3307, пишите -h 127.0.0.1 -P 3307.

  2. На строке Enter password: введите пароль из DB_PASSWORD и нажмите Enter. Знаки при вводе не видны — так и должно быть.
  3. Если появилась строка mysql>, данные верные. Выйдите: exit.
  4. Если вместо этого ошибка — найдите её в таблице ниже.

Пароль из файла можно посмотреть так: sudo grep "'DB_PASSWORD'" /var/www/example.com/wp-config.php. Не делайте этого при посторонних.

Как поменять данные

  1. Сделайте копию файла и откройте его — по шагам на странице настройки WordPress.
  2. Найдите нужную строку: Ctrl+W, введите, например, DB_PASSWORD, Enter.
  3. Замените значение между кавычками. Кавычки, скобки и ; не трогайте.
  4. Сохраните: Ctrl+O, Enter, Ctrl+X.
  5. Проверьте файл: sudo php -l /var/www/example.com/wp-config.php. Затем откройте сайт.

Ошибки и как их исправить

Что видитеПричинаЧто делать
Error establishing a database connectionWordPress не подключился к базепроверьте данные командой mysql; подробно — разбор ошибки
ERROR 1045 (28000): Access denied for user 'wpuser'@'localhost'неверный пароль или пользовательразбор ошибки 1045
ERROR 1049 (42000): Unknown database 'wordpress'базы с таким именем нетразбор ошибки 1049
ERROR 1044 (42000): Access denied for user 'wpuser'@'localhost' to database 'wordpress'у пользователя нет прав на эту базуразбор ошибки 1044
ERROR 2002 (HY000): Can't connect to local MySQL server through socketMySQL не запущен или путь к сокету другойразбор ошибки 2002
ERROR 2003 (HY000): Can't connect to MySQL server on '127.0.0.1:3306'MySQL не принимает подключения на этом адресе или портуразбор ошибки 2003
в базу вручную входит, а сайт не подключаетсяв файле значение с пробелом, другой буквой или старый парольсравните строки из шага 2 в начале страницы с тем, что вводили
после правки пароля ошибка 500в пароле ' без \ перед нейsudo php -l …/wp-config.php, запишите пароль с \

Всё сверено с WordPress 7.1.4.

Источники

Сверено 9 ноября 2026 года.

Если выбираете хостинг под WordPress. Что важно в тарифе и нужен ли «специальный» хостинг — в статье Хостинг для WordPress. Один из вариантов — хостинг для WordPress у Timeweb Реклама. АО «ТАЙМВЭБ», ИНН 7810353960. erid: CQH36pWzJpoBWKF332yG5h2XQ4cVubfBmkvqAitFqcpzWs.

Что почитать дальше