Функция cot_import_buffer_save в Cotonti

Разбор функции cot_import_buffer_save
Функция cot_import_buffer_save отвечает за сохранение данных POST-запроса в буфер сессии. Эти данные могут быть использованы в дальнейшем для восстановления состояния формы или выполнения дополнительных проверок, например, на наличие повторных запросов.

Код функции

/**
 * Puts POST data into the cross-request buffer
 */
function cot_import_buffer_save()
{
    // Clear old data
    if (!empty($_SESSION['cot_buffer']) && is_array($_SESSION['cot_buffer'])) {
        $validTime = Cot::$sys['now'] - 86400; // 24 hours
        foreach ($_SESSION['cot_buffer'] as $hash => $buffer) {
            if (!isset($buffer['createdAt']) || $buffer['createdAt'] < $validTime) {
                unset($_SESSION['cot_buffer'][$hash]);
            }
        }
    }

    if (
        $_SERVER['REQUEST_METHOD'] !== 'POST'
        || !isset($_SERVER['HTTP_REFERER'])
        || !cot_url_check($_SERVER['HTTP_REFERER'])
    ) {
        return;
    }

    $hash = cot_importBufferKey($_SERVER['HTTP_REFERER']);

    if (empty($_POST)) {
        unset($_SESSION['cot_buffer'][$hash]);
        return;
    }

    // Save the buffer
    $_SESSION['cot_buffer'][$hash] = [
        'createdAt' => Cot::$sys['now'],
        'data' => $_POST,
    ];
}

Описание:
cot_import_buffer_save()

Логика работы:
Очищение старых данных:

Функция проверяет, существует ли в сессии ранее сохранённый буфер данных (массив $_SESSION['cot_buffer']).
Для каждого элемента в этом массиве проверяется время его создания.
Если данные были созданы более 24 часов назад, они удаляются из сессии.
Проверка метода запроса и реферера:

Функция проверяет, является ли текущий HTTP-метод POST (чтобы убедиться, что запрос содержит данные, которые нужно сохранить).
Также проверяется, что в запросе присутствует HTTP_REFERER (ссылающаяся страница), и она проходит проверку с помощью функции cot_url_check (на корректность URL).
Генерация хеша для хранения данных в буфере:

Хеш для сохранения данных POST в сессии генерируется с использованием функции cot_importBufferKey и ссылки из реферера (HTTP_REFERER).
Удаление пустых POST данных:

Если данные POST пустые (например, форма была отправлена без данных), то соответствующий элемент из сессии удаляется.
Сохранение данных в буфер сессии:

Если данные POST существуют, они сохраняются в сессии в массиве

$_SESSION['cot_buffer'][$hash]

, где:
createdAt: время создания записи (текущее время).
data: данные POST-запроса.

Примечания:

Буферизация данных:

Функция полезна для хранения данных POST-запроса в сессии на определённое время (например, для предотвращения повторных отправок данных или для их дальнейшего использования).

Проверка реферера:

Это повышает безопасность, поскольку данные сохраняются только при условии, что запрос пришёл с допустимого источника (проверяется через cot_url_check).
Очистка старых данных: Удаление данных, не актуальных более 24 часов, помогает поддерживать актуальность и предотвращать излишнюю загрузку сессии старыми данными.

Пример использования:
Предположим, что данные из формы нужно сохранить, чтобы восстановить их позже:

// В начале процесса запроса
cot_import_buffer_save();

// Позже, когда нужно восстановить данные:
$bufferedData = $_SESSION['cot_buffer'][$hash]['data'] ?? null;

Потенциальные улучшения:
Настройки времени хранения: Вместо жёстко заданных 24 часов можно сделать это настраиваемым параметром.
Обработка ошибок: Можно добавить обработку ситуации, когда данные не могут быть сохранены из-за проблем с сессией или неправильным реферером.
Поддержка других HTTP-методов: Функция ориентирована только на POST-запросы. Если нужно, можно добавить поддержку других методов (например, PUT).