Spec-Zone.ru › CakePHP 3.3

Класс 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
Данные формы.

Возвращаемое значение

логическое значение

errors()source public

errors( )

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

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

Возвращаемое значение

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

execute()source public

execute( array $data )

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

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

Параметры

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

Возвращаемое значение

логическое значение

Возвращает 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
Данные для проверки.

Возвращаемое значение

логическое значение
Результат проверки данных.

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–2017 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.
https://api.cakephp.org/3.3/class-Cake.Form.Form.html

Spec-Zone.ru

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