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

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-2024, «1С-Битрикс», 2024