Коллектор данных формы
класс FormDataCollector расширяет DataCollector и реализует FormDataCollectorInterface
Коллектор данных для экземпляров {@link FormInterface}.
Методы
| serialize() | из DataCollector | |
| unserialize($data) | из DataCollector | |
| __construct(FormDataExtractorInterface $dataExtractor) | ||
| collect(Request $request, Response $response, Exception $exception = null) Ничего не делает. Данные собираются во время обработчиков событий формы. | ||
| associateFormWithView(FormInterface $form, FormView $view) Указывает, что данные объекты представляют одну и ту же концептуальную форму. | ||
| collectConfiguration(FormInterface $form) Хранит данные конфигурации заданной формы и её дочерних элементов. | ||
| collectDefaultData(FormInterface $form) Хранит данные по умолчанию заданной формы и её дочерних элементов. | ||
| collectSubmittedData(FormInterface $form) Хранит отправленные данные заданной формы и её дочерних элементов. | ||
| collectViewVariables(FormView $view) Хранит переменные представления заданного представления формы и его дочерних элементов. | ||
| buildPreliminaryFormTree(FormInterface $form) Собирает собранные данные о данной форме и её дочерних элементах в виде древовидной структуры данных. | ||
| buildFinalFormTree(FormInterface $form, FormView $view) Собирает собранные данные о заданной форме и её дочерних элементах в виде древовидной структуры данных. Результат можно запросить с помощью {@link getData()}. | ||
| строка | getName() Возвращает имя коллектора. | |
| массив | getData() Возвращает все собранные данные. |
Подробности
serialize()
unserialize($data)
Параметры
| $data |
__construct(FormDataExtractorInterface $dataExtractor)
Параметры
| FormDataExtractorInterface | $dataExtractor |
collect(Request $request, Response $response, Exception $exception = null)
Ничего не делает. Данные собираются во время обработчиков событий формы.
Параметры
| Request | $request | Экземпляр Request |
| Response | $response | Экземпляр Response |
| Exception | $exception | Экземпляр Exception |
associateFormWithView(FormInterface $form, FormView $view)
Указывает, что данные объекты представляют одну и ту же концептуальную форму.
Параметры
| FormInterface | $form | Объект формы |
| FormView | $view | Объект представления |
collectConfiguration(FormInterface $form)
Хранит данные конфигурации заданной формы и её дочерних элементов.
Параметры
| FormInterface | $form | Корневая форма |
collectDefaultData(FormInterface $form)
Хранит данные по умолчанию заданной формы и её дочерних элементов.
Параметры
| FormInterface | $form | Корневая форма |
collectSubmittedData(FormInterface $form)
Хранит отправленные данные заданной формы и её дочерних элементов.
Параметры
| FormInterface | $form | Корневая форма |
collectViewVariables(FormView $view)
Хранит переменные представления заданного представления формы и его дочерних элементов.
Параметры
| FormView | $view | Корневое представление формы |
buildPreliminaryFormTree(FormInterface $form)
Собирает собранные данные о данной форме и её дочерних элементах в виде древовидной структуры данных.
Результат можно запросить с помощью {@link getData()}.
Параметры
| FormInterface | $form | Корневая форма |
buildFinalFormTree(FormInterface $form, FormView $view)
Собирает собранные данные о заданной форме и её дочерних элементах в виде древовидной структуры данных.
Результат можно запросить с помощью {@link getData()}.
В отличие от {@link buildPreliminaryFormTree()}, необходимо передать объект {@link FormView}. Структура дерева этого объекта представления будет использоваться для структурирования результирующих данных. Это означает, что если дочерний элемент присутствует в представлении, но отсутствует в форме, он всё равно будет присутствовать в результирующем массиве данных.
Если экземпляры {@link FormView} присутствуют в дереве представлений, для которых не могут быть найдены соответствующие объекты {@link FormInterface} в дереве формы, в результат будут включены только данные представления. Если соответствующий {@link FormInterface} существует, вызовите {@link associateFormWithView()} перед вызовом этого метода.
Параметры
| FormInterface | $form | Корневая форма |
| FormView | $view | Корневое представление |
string getName()
Возвращает имя коллектора.
Значение возврата
| string | Имя коллектора |
array getData()
Возвращает все собранные данные.
Значение возврата
| массив |
© 2004–2017 Fabien Potencier
Licensed under the MIT License.
http://api.symfony.com/3.1/Symfony/Component/Form/Extension/DataCollector/FormDataCollector.html