wp-config.php: где лежит, что в нём и что делать, если файла нет
wp-config.php — главный файл настроек WordPress: в нём пароль от базы, ключи для входа и строки, которые запускают сам WordPress. Его нет в архиве WordPress — он появляется при установке. Здесь — где он лежит, что в нём по порядку и что делать, если его нет или он мешает сайту открыться.
Содержание 9
Что сделать прямо сейчас
- Подключитесь к серверу по SSH (как подключиться).
- Найдите файл:
sudo find /var/www -name wp-config.phpОтвет — путь, например
/var/www/example.com/wp-config.php. Если сайтов несколько, строк будет несколько. - Проверьте владельца и права:
sudo stat -c '%a %U:%G %n' /var/www/example.com/wp-config.phpОтвет вида
440 www-data:www-data /var/www/example.com/wp-config.php— всё в порядке (почему 440).
Что в файле по порядку
| Что | Строки | Разбор |
|---|---|---|
| данные базы | DB_NAME, DB_USER, DB_PASSWORD, DB_HOST, DB_CHARSET, DB_COLLATE | подключение к базе |
| ключи и соли | восемь строк от AUTH_KEY до NONCE_SALT | ключи и соли |
| префикс таблиц | $table_prefix = 'wp_'; | префикс таблиц |
| отладка | define( 'WP_DEBUG', false ); | WP_DEBUG |
| место для ваших строк | между Add any custom values и That's all, stop editing! | куда вписывать |
| загрузка WordPress | ABSPATH и require_once ABSPATH . 'wp-settings.php'; | не меняйте |
Открыть файл: sudo nano /var/www/example.com/wp-config.php. Перед правкой сделайте копию — как, рассказано на странице настройки WordPress.
Где WordPress ищет файл
- В папке сайта, рядом с
wp-settings.phpи папкойwp-admin, например/var/www/example.com/wp-config.php. - Если там файла нет — в папке на уровень выше, но только если в ней нет своего
wp-settings.php.
Второй вариант нужен, когда файлы сайта лежат во вложенной папке, например /var/www/example.com/public. Тогда файл можно положить в /var/www/example.com/wp-config.php: он окажется вне папки, которую веб-сервер отдаёт посетителям.
/var/www/example.com, папка выше — /var/www, общая для всех сайтов сервера. Не кладите туда wp-config.php: его подхватит любой WordPress из /var/www, у которого нет своего файла.Если файла нет
Если wp-config.php нет ни в папке сайта, ни выше, WordPress переадресует на мастер /wp-admin/setup-config.php с текстом There doesn't seem to be a wp-config.php file. It is needed before the installation can continue.
Это нормально для новой установки (как установить WordPress). Мастер спросит данные базы и запишет файл сам. Если записать не получится, он ответит Unable to write to wp-config.php file. и покажет текст файла: создайте файл вручную и вставьте этот текст.
Создать файл вручную из образца:
- Скопируйте образец:
sudo cp /var/www/example.com/wp-config-sample.php /var/www/example.com/wp-config.php - Откройте копию:
sudo nano /var/www/example.com/wp-config.php. - Впишите имя базы, пользователя и пароль вместо
database_name_here,username_here,password_here(подключение к базе). - Замените восемь строк
put your unique phrase hereновыми ключами (как). - Сохраните, затем поставьте владельца и права:
sudo chown www-data:www-data /var/www/example.com/wp-config.php sudo chmod 440 /var/www/example.com/wp-config.php
Если файл есть, а вы открыли мастер вручную, он ответит The file wp-config.php already exists. и ничего не изменит.
Права на файл
| Что | Как должно быть |
|---|---|
| владелец | пользователь, от которого работает PHP, — www-data |
| права | 440: читать может только владелец и его группа, менять — никто, кроме root |
Поставить:
sudo chown www-data:www-data /var/www/example.com/wp-config.php
sudo chmod 440 /var/www/example.com/wp-config.phpПравить файл после этого можно через sudo nano. Если сайт после смены прав перестал открываться — например, ответил ошибкой 500, — PHP не может прочитать файл: проверьте владельца командой stat из шага 3 в начале страницы. Подробно — права на файлы сайта.
Пробелы и невидимые символы в начале файла
Файл должен начинаться ровно с <?php. Если перед ним пробел, пустая строка или невидимая метка BOM — её добавляют некоторые редакторы в Windows, — WordPress не сможет отправить браузеру заголовки, и в журнале или на экране появится:
Cannot modify header information - headers already sent by (output started at /var/www/example.com/wp-config.php:1)Проверить:
sudo head -c 5 /var/www/example.com/wp-config.php; echoОтвет — <?php. Если перед ним что-то ещё или ответ другой:
- Откройте файл:
sudo nano /var/www/example.com/wp-config.php. - Удалите пустые строки и пробелы перед
<?php. Если в конце файла есть?>, удалите и пустые строки после него. - Сохраните и проверьте снова.
Если head по-прежнему показывает лишнее, хотя в nano ничего не видно, в начале файла метка BOM. Уберите её:
sudo sed -i '1s/^\xEF\xBB\xBF//' /var/www/example.com/wp-config.phpОшибки и как их исправить
| Что видите | Причина | Что делать |
|---|---|---|
There doesn't seem to be a wp-config.php file. | файла нет в папке сайта и выше | новая установка — пройдите мастер; работающий сайт — верните файл из копии |
Unable to write to wp-config.php file. | мастер не может записать файл в папку сайта | создайте файл вручную из текста, который показал мастер |
The file wp-config.php already exists. | файл уже есть | правьте его в nano, мастер не нужен |
Cannot modify header information - headers already sent by (output started at …wp-config.php:1) | пробел, пустая строка или BOM перед <?php | уберите их |
ошибка 500 после chmod 440 | владелец файла не www-data | sudo chown www-data:www-data …/wp-config.php |
| после правки белый экран или ошибка 500 | ошибка в строке файла | sudo php -l /var/www/example.com/wp-config.php (как проверить) |
Error establishing a database connection | неверные данные базы | разбор ошибки |
Всё сверено с WordPress 7.1.4.
Источники
- Справка WordPress: wp-config.php — на английском: что в файле и как его создать.
- Справка WordPress: защита сайта — на английском: права на wp-config.php и перенос на уровень выше.
- Исходный код WordPress 7.1.4: wp-load.php — на английском: где WordPress ищет файл.
- Исходный код WordPress 7.1.4: setup-config.php — на английском: мастер создания файла и его сообщения.
Сверено 9 ноября 2026 года.
Что почитать дальше
- Подключение к базеDB_NAME, DB_USER, DB_PASSWORD и DB_HOST.
- Права на файлы сайтакому отдать файлы и какие права поставить.
- Настройки WordPressвсе настройки на одной странице.