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

Check

Array

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

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-2022, «1С-Битрикс», 2022
Наверх