check_form_key — Проверка ключа формы

Описание

boolean check_form_key (string $form_name, [int $timespan = false], [string $return_page = ''], [bool $trigger = false])

Эта функция используется для проверки переданного ключа формы, который был сгенерирован функцией add_form_key.

Замечание: Эта проверка требуется для всех действий, затрагивающих базу данных и еще не защищенных при помощи confirm_box !

Параметры

Примеры

Все эти примеры используют значение параметра form_name, заданное в первом примере статьи add_form_token!

Пример №1: Только проверка

Если вы хотите всего лишь проверить, верна ли отправленная форма, вы должны организовать обработчик ошибок в своем PHP-коде.

if (!check_form_key($form_key))
{
   trigger_error($user->lang['FORM_INVALID']);
}

Пример №2: Ограничение по времени

Используя эту функцию, вы имеете возможность ограничивать отправку формы пользователем определенным количеством секунд. Для этого вам нужно передать второй параметр.

// Дадим пользователю 30 секунд для заполнения и отправки данных с формы
if (!check_form_key($form_key, 30))
{
   trigger_error($user->lang['FORM_INVALID']);
}

Пример №3: Обработка ошибки

Чтобы позволить функции отлавливать ошибку при проверке, вы должны установить четвертому параметру значение true.

check_form_key($form_key, false, '', true);