Версия базы WordPress

Оригинальное название: WordPress database version

Коротко

Число, которым WordPress отмечает текущую структуру своих таблиц; при расхождении с ожидаемым значением ядро запускает обновление базы данных.

Что такое «Версия базы WordPress»

Версия самого WordPress — привычное 6.x — меняется с каждым выпуском. Структура таблиц меняется реже, поэтому для неё ведётся отдельный счётчик. В коде ядра он записан в файле wp-includes/version.php как переменная $wp_db_version, а в базе — как опция db_version в таблице wp_options. Это просто целое число, которое растёт, когда разработчики ядра меняют таблицы или данные в них. Несколько выпусков подряд могут иметь одинаковый номер.

Как это работает при обновлении

После замены файлов ядра при первом входе в админку WordPress сравнивает два числа. Если опция в базе отстаёт, появляется экран «Требуется обновление базы данных» с кнопкой. Скрипт wp-admin/upgrade.php выполняет нужные изменения: добавляет столбцы, индексы, переносит настройки — и записывает новый номер. Автоматические фоновые обновления делают этот шаг сами.

Как проверить и обновить из консоли

На сервере без доступа к админке удобно работать через WP-CLI:

wp core version --extra       # версия ядра и номер схемы базы
wp option get db_version      # что записано в базе
wp core update-db             # выполнить обновление схемы
wp core update-db --network   # то же для всех сайтов сети

Последняя команда нужна в мультисайте: там у каждого сайта свои таблицы, и их обновляют отдельно.

Когда номер подводит

  • Базу с нового сайта переносят на копию со старым ядром — например, при разворачивании локальной среды из свежего дампа. Схема и код не совпадают, и лучше сначала привести ядро к той же версии, что на рабочем сайте.
  • Обновление базы прервалось по таймауту на большом сайте. Тогда его повторяют через WP-CLI, где нет ограничения времени веб-запроса.
  • Похожие счётчики ведут и плагины — например, WooCommerce хранит свою версию схемы отдельной опцией и тоже просит обновить базу после выхода новой версии.

Перед любым обновлением, которое затрагивает базу, нужна свежая резервная копия — порядок действий описан в статье о безопасном обновлении WordPress.

Обновлено:

Все термины раздела «WordPress»

Что будем искать? Например,Продвижение