Spec-Zone.ru › CakePHP 3.2

Класс Form

Абстракция формы, используемая для создания форм, не привязанных к моделям ORM или другим постоянным хранилищам данных. Идеально подходит для реализации форм на основе API-сервисов или форм обратной связи.

Создание формы

Этот класс наиболее полезен при наследовании. В подклассе вы должны определить методы _buildSchema, _buildValidator и необязательно _execute. Они позволяют объявлять поля вашей формы, валидацию и основное действие соответственно.

Вы также можете определить валидацию и схему, вызывая методы из $form->schema() и $form->validator().

Формы обычно размещаются в пространстве имён App\Form.

Пространство имён: Cake\Form
Расположение: Form/Form.php

Краткое описание свойств

  • $_errors protected
    array
    Ошибки, если таковые имеются
  • $_schema protected
    Cake\Form\Schema;
    Схема, используемая этой формой.
  • $_validator protected
    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
Данные формы.

Возвращает

boolean

errors()source public

errors( )

Получение ошибок в форме

Возвращает ошибки из последнего вызова validate() или execute().

Возвращает

массив
Последние установленные ошибки валидации.

execute()source public

execute( array $data )

Выполнение формы, если она валидна.

Сначала валидирует форму, затем вызывает метод-обработчик _execute(). Этот метод-обработчик может быть реализован в подклассах для выполнения действия формы. Это может быть отправка электронной почты, взаимодействие с удалённым API или что-то ещё, что вам нужно.

Параметры

массив $data
Данные формы.

Возвращает

boolean

False при ошибке валидации, в противном случае возвращает результат метода _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
экземпляр валидатора.

Подробное описание свойств

$_errorssource

protected массив

Ошибки, если таковые имеются

[]

$_schemasource

protected Cake\Form\Schema;

Схема, используемая этой формой.

$_validatorsource

protected 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

Spec-Zone.ru

Настройки Оффлайн Что нового Помощь О нас
Spec-Zone .ru
спецификации, руководства, описания, API