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
Пользовательские комментарии
Мы будем рады, если разработчики добавят свои комментарии по практическому использованию методов системы.Для этого нужно всего лишь авторизоваться на сайте
Но помните, что Пользовательские комментарии, несмотря на модерацию, не являются официальной документацией. Ответственность за их использование несет сам пользователь.
Также Пользовательские комментарии не являются местом для обсуждения функционала. По подобным вопросам обращайтесь на форумы.