Подключение WordPress к базе: DB_NAME, DB_USER, DB_PASSWORD, DB_HOST
Шесть строк в начале wp-config.php говорят WordPress, к какой базе подключаться: имя базы, пользователь, пароль, адрес сервера базы, кодировка и правило сравнения букв. Если хоть одна строка неверна, вместо сайта появится Error establishing a database connection. Здесь — что в каждую строку вписать и как проверить данные до того, как их править.
Содержание 10
Что сделать прямо сейчас
- Подключитесь к серверу по SSH (как подключиться).
- Посмотрите данные базы — без пароля:
sudo grep -E "'DB_(NAME|USER|HOST|CHARSET|COLLATE)'" /var/www/example.com/wp-config.phpВместо
/var/www/example.com— папка вашего сайта. Ответ — пять строк, напримерdefine( 'DB_NAME', 'wordpress' );. - Проверьте, что с этими данными можно войти в базу, — как, ниже.
Что в каждой строке
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
| Что вписать | Когда |
|---|---|
localhost | MySQL на этом же сервере — так после установки |
127.0.0.1 | MySQL на этом же сервере, подключение по сети на порт 3306 |
127.0.0.1:3307 | MySQL на этом же сервере, но на другом порту — номер после : |
localhost:/run/mysqld/mysqld.sock | нужно указать путь к файлу сокета MySQL |
[::1]:3306 | подключение по IPv6 — адрес в квадратных скобках |
10.0.0.5 или db.example.com | база на другом сервере |
Если база на другом сервере, MySQL там должен принимать подключения не только с самого себя, а порт 3306 — быть открыт для вашего сервера сайта (порт 3306).
Пароль с кавычкой или обратной косой чертой
Пароль записан в одинарных кавычках. Если в нём есть ' или \, поставьте перед каждым таким знаком \:
| Пароль | Как записать |
|---|---|
Ab'cd | define( 'DB_PASSWORD', 'Ab\'cd' ); |
Ab\cd | define( '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.
Как проверить данные
- Подключитесь к базе с данными из 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. - На строке
Enter password:введите пароль изDB_PASSWORDи нажмите Enter. Знаки при вводе не видны — так и должно быть. - Если появилась строка
mysql>, данные верные. Выйдите:exit. - Если вместо этого ошибка — найдите её в таблице ниже.
Пароль из файла можно посмотреть так: sudo grep "'DB_PASSWORD'" /var/www/example.com/wp-config.php. Не делайте этого при посторонних.
Как поменять данные
- Сделайте копию файла и откройте его — по шагам на странице настройки WordPress.
- Найдите нужную строку:
Ctrl+W, введите, например,DB_PASSWORD, Enter. - Замените значение между кавычками. Кавычки, скобки и
;не трогайте. - Сохраните:
Ctrl+O, Enter,Ctrl+X. - Проверьте файл:
sudo php -l /var/www/example.com/wp-config.php. Затем откройте сайт.
Ошибки и как их исправить
| Что видите | Причина | Что делать |
|---|---|---|
Error establishing a database connection | WordPress не подключился к базе | проверьте данные командой 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 socket | MySQL не запущен или путь к сокету другой | разбор ошибки 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.
Источники
- Справка WordPress: wp-config.php — на английском: строки базы и варианты DB_HOST.
- Исходный код WordPress 7.1.4: wp-config-sample.php — на английском: образец строк базы.
- Исходный код WordPress 7.1.4: class-wpdb.php — на английском: как WordPress разбирает DB_HOST и выбирает кодировку.
Сверено 9 ноября 2026 года.
Что почитать дальше
- Error establishing a database connectionчто проверить по шагам.
- Сменить пароль в MySQLновый пароль пользователю сайта.
- Настройки WordPressвсе настройки на одной странице.