Сериализация в D7 ORM: Хранение массивов и объектов в базе с save_data_modification

Часто возникает задача сохранить в одном поле базы данных сложную структуру: массив настроек, JSON-объект или список ID.

D7 ORM позволяет автоматизировать процесс «упаковки» данных при записи и «распаковки» при чтении.

Вариант 1: Встроенная сериализация (для serialize)

Если вам подходит стандартная PHP-сериализация, у полей TextField и StringField есть готовая опция serialized.

// В методе getMap() вашей сущности
new Entity\TextField('SETTINGS', [
    'serialized' => true
])

Теперь вы можете передавать массив в add/update, и он вернется массивом в getList.
Минус: Данные в БД будут лежать в формате PHP serialize, который трудно читать и нельзя использовать в SQL-запросах (JSON удобнее).

Вариант 2: Кастомная модификация (для JSON)

Если мы хотим хранить данные в формате JSON (что является современным стандартом), нам помогут колбэки save_data_modification и fetch_data_modification.

Пример описания поля в getMap():

new Entity\TextField('PARAMS', [
    // Преобразование перед записью в БД
    'save_data_modification' => function () {
        return [
            function ($value) {
                // Если передали массив, кодируем в JSON
                if (is_array($value) || is_object($value)) {
                    return json_encode($value, JSON_UNESCAPED_UNICODE);
                }
                return $value;
            }
        ];
    },
    // Преобразование после чтения из БД
    'fetch_data_modification' => function () {
        return [
            function ($value) {
                // Декодируем JSON обратно в массив
                if (is_string($value) && !empty($value)) {
                    return json_decode($value, true);
                }
                return [];
            }
        ];
    }
])

Как с этим работать

Теперь ORM делает всю грязную работу за вас.

// Сохраняем массив
MyTable::add([
    'NAME' => 'Item 1',
    'PARAMS' => ['color' => 'red', 'size' => 'XL'] // Передаем массив!
]);

// Читаем
$item = MyTable::getByPrimary(1)->fetch();
echo $item['PARAMS']['color']; // red (Это уже массив!)

В базе данных при этом будет лежать строка: {«color»:»red»,»size»:»XL»}.

Важно: Этот механизм работает на уровне PHP. Вы не сможете сделать эффективную выборку средствами SQL по содержимому этого JSON (например, «найти все, у кого color=red»), если ваша СУБД не поддерживает JSON-индексы. Но для хранения настроек или логов это идеальное решение.

Вывод:
Используйте save_data_modification, чтобы превратить простые текстовые поля вашей БД в хранилища сложных структур данных.

Это избавляет от ручного вызова json_encode/decode по всему коду проекта.

save_data_modification, fetch_data_modification, D7 ORM, serialized, хранение массива в БД, JSON в базе данных, ORM callback.