Документация для разработчиков
Темная тема

Check

Описание и параметры

mixed
CForm::Check(
 int form_id,
 array values = false,
 int result_id = false,
 string check_rights = "Y",
 string return_array = "N"
)

Метод проверяет введенные значения на обязательность, правильность формата даты и правильность типа файла. При необходимости проверяются права текущего пользователя. В случае неудачи - возвращает текст ошибки. Метод нестатический.

Параметры метода

Параметр Описание С версии
form_id ID веб-формы.
values Массив значений введенных в веб-форме.
Параметр необязательный. По умолчанию - "false" (использовать стандартный массив $_REQUEST).

Пример:
Array
(
    [form_text_586] => Иванов Иван Иванович
    [form_date_587] => 10.03.1992
    [form_textarea_588] => г. Мурманск
    [form_radio_VS_MARRIED] => 589
    [form_checkbox_VS_INTEREST] => Array
        (
            [0] => 592
            [1] => 593
            [2] => 594
        )

    [form_dropdown_VS_AGE] => 597
    [form_multiselect_VS_EDUCATION] => Array
        (
            [0] => 603
            [1] => 604
        )

    [form_text_606] => 2345
    [form_image_607] => 1045
    [form_file_607] => 1049
)
result_id Если данный метод вызывается для проверки полей при редактировании результата, то в данном параметре необходимо указать его ID.
Параметр необязательный. По умолчанию - "false" (новый результат).
3.3.10
check_rights Флаг необходимости проверки прав текущего пользователя. Возможны следующие значения:
  • Y - права необходимо проверить;
  • N - право не нужно проверять.
Для успешной проверки прав, производимой данным методом, пользователь должен обладать как минимум правом [10] Заполнение формы на форму, указанную в параметре form_id.
Параметр необязательный. По умолчанию - "Y" (права необходимо проверить).
4.0.0
return_array Если данный параметр не установлен или равен "N", то метод возвращает отформатированный список ошибок.
Если же установлен в "Y", то метод возвращает массив, в котором сообщения об ошибках, связанные с конкретными полями, идут с ключом, равным строковому идентификатору поля, а остальные - с числовым ключом. Например,
array( 
		0 => "Неверно введено слово с картинки",
		"test_fld" => "Не указано значение обязательных полей: Первое поле" 
		)
6.0.2

Смотрите также

Примеры использования

<?
// проверим корректность введенных параметров и 
// права пользователя
$error = CForm::Check($FORM_ID, $_REQUEST, $RESULT_ID);

// если метод не вернул текст ошибки, то
if (strlen($error)<=0) 
{
    // обновляем результат
    CFormResult::Update($RESULT_ID, $_REQUEST);
}
?>


Пользовательские комментарии

Мы будем рады, если разработчики добавят свои комментарии по практическому использованию методов системы.

Для этого нужно всего лишь авторизоваться на сайте

Но помните, что Пользовательские комментарии, несмотря на модерацию, не являются официальной документацией. Ответственность за их использование несет сам пользователь.

Также Пользовательские комментарии не являются местом для обсуждения функционала. По подобным вопросам обращайтесь на форумы.
© «Битрикс», 2001-2020, «1С-Битрикс», 2020
Наверх