Настройки WordPress в wp-config.php: какая строка за что отвечает
Главные настройки WordPress — база данных, адрес сайта, отладка, автообновления, задания по расписанию — записаны строками define в файле wp-config.php в папке сайта. Здесь — как править этот файл, чтобы сайт не сломался, и где разбор каждой настройки.
Содержание 8
Что сделать прямо сейчас
- Подключитесь к серверу по SSH (как подключиться).
- Посмотрите, какие настройки уже записаны в файле:
sudo grep -n -o -E "define\( *'[A-Z_]+'" /var/www/example.com/wp-config.phpВместо
/var/www/example.com— папка вашего сайта. Ответ — номер строки и имя настройки, например23:define( 'DB_NAME'. Пароль от базы команда не показывает. - Найдите в таблице ниже то, что хотите поменять, и откройте разбор.
Что где настраивается
| Что нужно | Где разбор |
|---|---|
| понять, где лежит файл и что в нём по порядку, или создать его | wp-config.php |
| имя базы, пользователь, пароль, сервер базы | подключение к базе |
| увидеть текст ошибки вместо белого экрана | WP_DEBUG и журнал ошибок |
| поменять адрес сайта или перейти на https | WP_HOME и WP_SITEURL |
| заменить ключи и выйти из всех аккаунтов | ключи и соли |
узнать или сменить префикс таблиц wp_ | префикс таблиц |
| включить или выключить автообновления | автообновления |
| убрать редактор файлов из админки | DISALLOW_FILE_EDIT |
| запускать задания WordPress по расписанию сервера | DISABLE_WP_CRON |
| ограничить ревизии, настроить корзину | ревизии и корзина |
| проверить и починить таблицы базы | WP_ALLOW_REPAIR |
| войти, если забыли пароль администратора | сброс пароля |
поднять лимит памяти WP_MEMORY_LIMIT | Allowed memory size exhausted |
WordPress просит данные FTP, FS_METHOD | WordPress просит FTP |
Как устроена строка define
define( 'WP_DEBUG', false );| Часть | Что значит |
|---|---|
define( | задать настройку |
'WP_DEBUG' | имя настройки — большими латинскими буквами, в одинарных кавычках |
false | значение |
); | конец строки — без точки с запятой файл не загрузится |
Значения пишут так:
| Значение | Как писать | Пример |
|---|---|---|
| да или нет | true или false без кавычек | define( 'DISALLOW_FILE_EDIT', true ); |
| число | без кавычек | define( 'WP_POST_REVISIONS', 5 ); |
| текст, адрес, путь | в одинарных кавычках | define( 'WP_HOME', 'https://example.com' ); |
true и false без кавычек. 'false' в кавычках — это текст, и WordPress поймёт его не так, как вы ждёте.Каждую настройку записывайте один раз. Если строк с одним именем две, действует первая, а PHP пишет в журнал Constant WP_DEBUG already defined. Прежде чем добавлять строку, проверьте, нет ли её уже: sudo grep -n "'WP_DEBUG'" /var/www/example.com/wp-config.php.
Куда вписывать новые строки
В конце wp-config.php — строки, которые загружают сам WordPress:
/* Add any custom values between this line and the "stop editing" line. */
/* That's all, stop editing! Happy publishing. */
/** Absolute path to the WordPress directory. */
if ( ! defined( 'ABSPATH' ) ) {
define( 'ABSPATH', __DIR__ . '/' );
}
/** Sets up WordPress vars and included files. */
require_once ABSPATH . 'wp-settings.php';Новые строки вписывайте между Add any custom values и That's all, stop editing!. Если первой строки в вашем файле нет — её нет в файлах старых установок, — пишите прямо над That's all, stop editing!.
require_once ABSPATH . 'wp-settings.php'; не действуют: к этому месту WordPress уже загрузился со своими значениями. Строки про ABSPATH и require_once не меняйте и не удаляйте.Как править файл, чтобы сайт не сломался
- Сделайте копию в свою домашнюю папку:
sudo cp /var/www/example.com/wp-config.php ~/wp-config-copy.php! Не кладите копию в папку сайта. Файл
wp-config.php.bakвеб-сервер отдаст как текст, и любой, кто угадает адрес, прочитает пароль от базы. - Откройте файл (редактор nano):
sudo nano /var/www/example.com/wp-config.phpНайти строку:
Ctrl+W, введите имя настройки, Enter. Сохраните:Ctrl+O, Enter,Ctrl+X. - Проверьте файл:
sudo php -l /var/www/example.com/wp-config.phpЕсли в ответе есть
Parse errorиon lineс номером, в этой строке ошибка: пропущена;, кавычка или скобка. Исправьте её и проверьте снова. - Откройте сайт:
curl -sI https://example.com/ | head -n 1Код
200или301— сайт работает. Код500— смотрите таблицу ошибок. - Если сайт сломался, а причину сразу не найти, верните копию:
sudo cp ~/wp-config-copy.php /var/www/example.com/wp-config.php - Когда всё работает, удалите копию:
sudo rm ~/wp-config-copy.php. В ней пароль от базы.
sudo нужен и для чтения: после настройки прав wp-config.php может читать только пользователь www-data.
Ошибки и как их исправить
| Что видите | Причина | Что делать |
|---|---|---|
| после правки ошибка 500 или белый экран | ошибка в строке: пропущена ;, кавычка или скобка | sudo php -l /var/www/example.com/wp-config.php, исправьте строку или верните копию |
Constant WP_DEBUG already defined в журнале | одна настройка записана дважды | sudo grep -n "'WP_DEBUG'" …, оставьте одну строку |
| настройка не действует | строка записана ниже require_once ABSPATH . 'wp-settings.php'; | перенесите её выше That's all, stop editing! |
Cannot modify header information - headers already sent by (output started at …wp-config.php:1) | пробел или пустая строка перед <?php | разбор |
There has been a critical error on this website. | ошибка PHP в теме, плагине или файле | разбор ошибки |
Error establishing a database connection | неверные данные базы | разбор ошибки |
| вместо сайта мастер установки | файла wp-config.php нет в папке сайта | что делать |
Всё сверено с WordPress 7.1.4.
Источники
- Справка WordPress: wp-config.php — на английском: все настройки файла.
- Исходный код WordPress 7.1.4: wp-config-sample.php — на английском: образец файла и место для своих строк.
- Исходный код WordPress 7.1.4: default-constants.php — на английском: значения настроек, если их нет в файле.
Сверено 9 ноября 2026 года.
Что почитать дальше
- wp-config.phpгде лежит файл и что делать, если его нет.
- Ошибки WordPressнайдите свою ошибку и исправьте по шагам.
- Как установить WordPressустановка с нуля.