Класс Form
Абстракция формы, используемая для создания форм, не привязанных к моделям ORM или другим постоянным хранилищам данных. Идеально подходит для реализации форм на основе API-сервисов или форм обратной связи.
Создание формы
Этот класс наиболее полезен при наследовании. В подклассе вы должны определить методы _buildSchema, _buildValidator и необязательно _execute. Они позволяют объявлять поля вашей формы, валидацию и основное действие соответственно.
Вы также можете определить валидацию и схему, вызывая методы из $form->schema() и $form->validator().
Формы обычно размещаются в пространстве имён App\Form.
Краткое описание свойств
-
$_errorsprotectedОшибки, если таковые имеютсяarray -
$_schemaprotectedСхема, используемая этой формой.Cake\Form\Schema; -
$_validatorprotectedВалидатор, используемый этой формой.Cake\Validation\Validator;
Краткое описание методов
- __debugInfo() publicПолучение удобочитаемого представления экземпляра Form.
- _buildSchema() protectedМетод-обработчик, предназначенный для реализации подклассами.
- _buildValidator() protectedМетод-обработчик, предназначенный для реализации подклассами.
- _execute() protectedМетод-обработчик, подлежащий реализации в подклассах.
- errors() publicПолучение ошибок в форме
- execute() publicВыполнение формы, если она валидна.
- schema() publicПолучение/установка схемы для этой формы.
- validate() publicПроверка, соответствует ли $data валидации этой формы.
- validator() publicПолучение/установка валидатора для этой формы.
Подробное описание методов
__debugInfo()source public
__debugInfo( )
Получение удобочитаемого представления экземпляра Form.
Возвращает
массив_buildSchema()source protected
_buildSchema( Cake\Form\Schema $schema )
Метод-обработчик, предназначенный для реализации подклассами.
Вы можете использовать этот метод для определения схемы, используя методы в Cake\Form\Schema, или загрузить предварительно определённую схему из конкретного класса.
Параметры
-
Cake\Form\Schema$schema - Схема для настройки.
Возвращает
Cake\Form\SchemaИспользуемую схему.
_buildValidator()source protected
_buildValidator( Cake\Validation\Validator $validator )
Метод-обработчик, предназначенный для реализации подклассами.
Вы можете использовать этот метод для определения валидатора, используя методы в Cake\Validation\Validator или загрузить предварительно определённый валидатор из конкретного класса.
Параметры
-
Cake\Validation\Validator$validator - Валидатор для настройки.
Возвращает
Cake\Validation\ValidatorИспользуемого валидатора.
_execute()source protected
_execute( array $data )
Метод-обработчик, подлежащий реализации в подклассах.
Используется методом execute() для выполнения действия формы.
Параметры
- массив
$data - Данные формы.
Возвращает
booleanerrors()source public
errors( )
Получение ошибок в форме
Возвращает ошибки из последнего вызова validate() или execute().
Возвращает
массивПоследние установленные ошибки валидации.
execute()source public
execute( array $data )
Выполнение формы, если она валидна.
Сначала валидирует форму, затем вызывает метод-обработчик _execute(). Этот метод-обработчик может быть реализован в подклассах для выполнения действия формы. Это может быть отправка электронной почты, взаимодействие с удалённым API или что-то ещё, что вам нужно.
Параметры
- массив
$data - Данные формы.
Возвращает
booleanFalse при ошибке валидации, в противном случае возвращает результат метода _execute().
schema()source public
schema( Cake\Form\Schema $schema null )
Получение/установка схемы для этой формы.
Этот метод вызовет _buildSchema() при первом построении схемы. Этот метод-обработчик позволяет настроить схему или загрузить предварительно определённую.
Параметры
-
Cake\Form\Schema$schemaнеобязательно null - Схема для установки, или null.
Возвращает
Cake\Form\Schemaэкземпляр схемы.
validate()source public
validate( array $data )
Проверка, соответствует ли $data валидации этой формы.
Параметры
- массив
$data - Данные для проверки.
Возвращает
booleanЯвляются ли данные валидными.
validator()source public
validator( Cake\Validation\Validator $validator null )
Получение/установка валидатора для этой формы.
Этот метод вызовет _buildValidator() при первом построении валидатора. Этот метод-обработчик позволяет настроить валидатор или загрузить предварительно определённый.
Параметры
-
Cake\Validation\Validator$validatorнеобязательно null - Валидатор для установки, или null.
Возвращает
Cake\Validation\Validatorэкземпляр валидатора.
Подробное описание свойств
© 2005–2016 The Cake Software Foundation, Inc.
Licensed under the MIT License.
CakePHP is a registered trademark of Cake Software Foundation, Inc.
We are not endorsed by or affiliated with CakePHP.
http://api.cakephp.org/3.2/class-Cake.Form.Form.html