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" (права необходимо проверить). |
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