Как создать таблицу в WordPress через functions.php: Полный гид по типам данных

Иногда стандартных возможностей WordPress (постов и мета-полей) не хватает. В таких случаях создание собственной таблицы в базе данных — это самый эффективный путь.

1. Эталонный код для создания таблицы

Для создания таблицы мы используем функцию dbDelta. Она умная: если таблица уже существует, она не создаст её заново, а лишь обновит структуру (если вы добавите новые колонки).

Добавьте этот код в свой functions.php:

function create_custom_table() {
    global $wpdb;

    // Имя таблицы с учетом префикса (например, wp_custom_table)
    $table_name = $wpdb->prefix . 'custom_table'; 

    // Получаем кодировку сайта (обычно utf8mb4)
    $charset_collate = $wpdb->get_charset_collate();

    $sql = "CREATE TABLE $table_name (
        id INT NOT NULL AUTO_INCREMENT,
        column_name1 VARCHAR(255) NOT NULL,
        column_name2 TEXT NOT NULL,
        column_name3 INT DEFAULT 0,
        PRIMARY KEY (id)
    ) $charset_collate;";

    // Подключаем файл для работы с dbDelta
    require_once(ABSPATH . 'wp-admin/includes/upgrade.php');
    dbDelta($sql);
}

// Вызываем функцию при инициализации или активации темы
add_action('after_setup_theme', 'create_custom_table');

2. Основные типы данных MySQL

Чтобы ваша таблица работала быстро и занимала мало места, важно правильно выбрать тип данных для каждой колонки.

Числовые типы

Строковые типы

Дата и время

3. Важные правила синтаксиса dbDelta

Функция dbDelta — очень «капризная». Если проигнорировать эти правила, таблица просто не создастся:

1. Два пробела: Между словами PRIMARY KEY и определением ключа (id) должно быть строго два пробела.

2. Заглавные буквы: Все команды SQL (CREATE TABLE, NOT NULL, INT) лучше писать капсом.

3. Длина VARCHAR: Вы обязаны указывать длину для VARCHAR, например VARCHAR(255).

Как проверить результат?

После сохранения functions.php, обновите любую страницу вашего сайта. Затем зайдите в phpMyAdmin. В списке таблиц вашей базы данных должна появиться новая строка: wp_custom_table.