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

wp-config.php: где лежит, что в нём и что делать, если файла нет

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

≈ 7 мин чтения
Содержание 9

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

  1. Подключитесь к серверу по SSH (как подключиться).
  2. Найдите файл:
    sudo find /var/www -name wp-config.php

    Ответ — путь, например /var/www/example.com/wp-config.php. Если сайтов несколько, строк будет несколько.

  3. Проверьте владельца и права:
    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).

В wp-config.php пароль от базы. Не показывайте его содержимое другим людям и не выкладывайте снимки экрана с ним.

Что в файле по порядку

ЧтоСтрокиРазбор
данные базы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!куда вписывать
загрузка WordPressABSPATH и require_once ABSPATH . 'wp-settings.php';не меняйте

Открыть файл: sudo nano /var/www/example.com/wp-config.php. Перед правкой сделайте копию — как, рассказано на странице настройки WordPress.

Где WordPress ищет файл

  1. В папке сайта, рядом с wp-settings.php и папкой wp-admin, например /var/www/example.com/wp-config.php.
  2. Если там файла нет — в папке на уровень выше, но только если в ней нет своего 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. и покажет текст файла: создайте файл вручную и вставьте этот текст.

Создать файл вручную из образца:

  1. Скопируйте образец:
    sudo cp /var/www/example.com/wp-config-sample.php /var/www/example.com/wp-config.php
  2. Откройте копию: sudo nano /var/www/example.com/wp-config.php.
  3. Впишите имя базы, пользователя и пароль вместо database_name_here, username_here, password_here (подключение к базе).
  4. Замените восемь строк put your unique phrase here новыми ключами (как).
  5. Сохраните, затем поставьте владельца и права:
    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. Если перед ним что-то ещё или ответ другой:

  1. Откройте файл: sudo nano /var/www/example.com/wp-config.php.
  2. Удалите пустые строки и пробелы перед <?php. Если в конце файла есть ?>, удалите и пустые строки после него.
  3. Сохраните и проверьте снова.

Если 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-datasudo 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.

Источники

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

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

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