Префикс таблиц WordPress: $table_prefix, как узнать и сменить
Все таблицы WordPress в базе начинаются с одного префикса — после установки это wp_: wp_posts, wp_users, wp_options. Префикс записан в wp-config.php, и он должен совпадать с названиями таблиц в базе. Здесь — как узнать префикс, зачем он нужен и как сменить его на работающем сайте, ничего не потеряв.
Содержание 9
Что сделать прямо сейчас
- Подключитесь к серверу по SSH (как подключиться).
- Узнайте префикс:
sudo grep -n 'table_prefix' /var/www/example.com/wp-config.phpВместо
/var/www/example.com— папка вашего сайта. Ответ, например,$table_prefix = 'wp_';— префиксwp_. - Посмотрите таблицы сайта:
sudo mysql -e "SHOW TABLES;" wordpressВместо
wordpress— имя базы изDB_NAME(где посмотреть). Названия таблиц начинаются с префикса из шага 2.
Какие таблицы у WordPress
Сам WordPress на одном сайте создаёт 12 таблиц:
| Таблица | Что в ней |
|---|---|
wp_posts, wp_postmeta | записи, страницы, ревизии, медиафайлы и их свойства |
wp_comments, wp_commentmeta | комментарии |
wp_users, wp_usermeta | пользователи, их роли и настройки |
wp_options | настройки сайта: адрес, тема, включённые плагины |
wp_terms, wp_termmeta, wp_term_taxonomy, wp_term_relationships | рубрики и метки |
wp_links | старый список ссылок |
Плагины добавляют свои таблицы с тем же префиксом, например wp_wc_orders.
Зачем нужен префикс
- В одной базе могут жить несколько сайтов WordPress: у каждого свой префикс, например
wp_иshop_. - Префикс, отличный от
wp_, немного мешает автоматическим атакам, которые рассчитаны наwp_users. Защищает это слабо: главное — пароли и обновления.
Для нового сайта префикс проще выбрать при установке (как установить WordPress). Менять его на работающем сайте ради защиты не обязательно.
Какой префикс можно
- только латинские буквы, цифры и
_; - пишите строчными буквами, например
wpn_илиsite2_; - в конце ставьте
_, чтобы названия читались:wpn_posts.
Если в префиксе другой знак, например -, WordPress не загрузится и покажет Error: $table_prefix in wp-config.php can only contain numbers, letters, and underscores.
Как сменить префикс на работающем сайте
Пример: был wp_, станет wpn_, база — wordpress. Порядок только для одиночного сайта, не для сети сайтов.
- Сделайте копию базы и проверьте её (mysqldump):
sudo mysqldump wordpress > ~/wordpress-before-prefix.sql - Создайте файл с командами переименования:
sudo mysql -N -e "SELECT CONCAT('RENAME TABLE ', table_name, ' TO wpn_', SUBSTRING(table_name, 4), ';') FROM information_schema.tables WHERE table_schema = 'wordpress' AND table_name LIKE 'wp\\_%'" > ~/prefix.sql4— с какой буквы начинается название без старого префикса: уwp_три знака, значит с четвёртой. - Откройте файл:
nano ~/prefix.sql. В конец допишите две строки:UPDATE wpn_options SET option_name = 'wpn_user_roles' WHERE option_name = 'wp_user_roles'; UPDATE wpn_usermeta SET meta_key = CONCAT('wpn_', SUBSTRING(meta_key, 4)) WHERE meta_key LIKE 'wp\_%';Сохраните:
Ctrl+O, Enter,Ctrl+X. Эти строки нужны, потому что префикс записан не только в названиях таблиц, но и внутри них: в опции с ролями пользователей и в ключах прав, напримерwp_capabilities. - Проверьте файл:
cat ~/prefix.sql. В нём строкаRENAME TABLEна каждую таблицу и две строкиUPDATEв конце. - Выполните команды и сразу поменяйте префикс в wp-config.php — одной строкой, чтобы сайт не остался без таблиц:
sudo mysql wordpress < ~/prefix.sql && sudo sed -i "s/table_prefix = 'wp_'/table_prefix = 'wpn_'/" /var/www/example.com/wp-config.php - Проверьте:
sudo grep -n 'table_prefix' /var/www/example.com/wp-config.php sudo mysql -e "SHOW TABLES;" wordpressВ файле
$table_prefix = 'wpn_';, все таблицы начинаются сwpn_. - Откройте сайт и войдите в админку.
- Когда всё работает, удалите временный файл:
rm ~/prefix.sql. Копию базы из шага 1 оставьте на несколько дней.
/wp-admin/install.php — его может заполнить любой посетитель. Поэтому обе команды — в одной строке через &&.Как вернуть всё назад
Если после смены сайт не работает, а причину сразу не найти:
- Загрузите копию базы (как загрузить дамп): таблицы со старым префиксом
wp_появятся снова.sudo mysql wordpress < ~/wordpress-before-prefix.sql - Верните строку в wp-config.php:
sudo sed -i "s/table_prefix = 'wpn_'/table_prefix = 'wp_'/" /var/www/example.com/wp-config.php - Откройте сайт: он работает с таблицами
wp_из копии. - Таблицы с новым префиксом больше не нужны. Посмотрите их:
sudo mysql -e "SHOW TABLES LIKE 'wpn\_%';" wordpress— и удалите каждую командойDROP TABLE, если уверены.
Именно в таком порядке: если сначала поменять файл, сайт останется без таблиц и откроет мастер установки.
Ошибки и как их исправить
| Что видите | Причина | Что делать |
|---|---|---|
| вместо сайта мастер установки | префикс в wp-config.php не совпадает с таблицами в базе | сравните шаги 2 и 3 в начале страницы и поправьте $table_prefix |
Error: $table_prefix in wp-config.php can only contain numbers, letters, and underscores. | в префиксе недопустимый знак | оставьте буквы, цифры и _ |
Sorry, you are not allowed to access this page. после смены | не выполнены строки UPDATE из шага 3 | выполните их; подробно — разбор ошибки |
One or more database tables are unavailable. The database may need to be repaired. | нет таблицы настроек с этим префиксом | проверьте таблицы командой SHOW TABLES и префикс в файле |
ERROR 1146 (42S02): Table 'wordpress.wp_options' doesn't exist в своих командах | вы пишете старый префикс | подставьте новый (разбор ошибки 1146) |
| плагин после смены потерял настройки | плагин хранит старый префикс в своих данных | загляните в справку плагина или верните копию |
Всё сверено с WordPress 7.1.4.
Источники
- Справка WordPress: wp-config.php — на английском: $table_prefix.
- Исходный код WordPress 7.1.4: load.php — на английском: проверка знаков в префиксе.
- Исходный код WordPress 7.1.4: schema.php — на английском: таблицы, которые создаёт WordPress.
- Исходный код WordPress 7.1.4: class-wp-roles.php — на английском: опция user_roles с префиксом.
Сверено 9 ноября 2026 года.
Что почитать дальше
- mysqldumpкопия базы перед любыми правками.
- Перенос сайта на другой хостингфайлы, база и DNS по шагам.
- Настройки WordPressвсе настройки на одной странице.