title: Symfony forms name: sflive_page class: animation-fade layout: true
class: impact
Laurent VOULLEMIER
@lvodev
class: section
class: thesis
Created by Bernhard Schussek (@Webmozart)
Subject of his bachelor thesis:
"An algorithm and architecture for server-side
processing of model-bound compositional web forms"
https://webmozart.io/files/bsc-thesis.pdf
class: aim
-
maximizes reusability of forms by abstracting their individual components,
-
allows to compose such components to create new components of a higher complexity,
-
reduces the effects of crosscutting to a minimum and
-
provides an integration with the application’s domain model (model binding).
(© Bernhard Schussek, excerpt from his thesis)
class: section
.center[.handling_img[
]]
class: section2
class: section
.factory_img[
]
class: formfactory_needs
Form factory needs:
-
ResolvedFormTypes: wrappers around FormTypes that have knowledge of their parents and their type extensions.
-
FormTypeGuesser: when the type isn't provided, allows to guess form type and some view settings based on metadata (ex: DoctrineOrmTypeGuesser, ValidatorTypeGuesser).
The FormRegistry provides these elements.
.formregistry[
]
.resolved1[
]
.resolved2[
]
.resolved3[
]
??? https://carbon.now.sh/?bg=rgba%28243%2C243%2C243%2C0%29&t=a11y-dark&wt=none&l=text%2Fx-php&ds=true&dsyoff=10px&dsblur=26px&wc=false&wa=true&pv=56px&ph=56px&ln=true&fl=1&fm=Hack&fs=14px&lh=133%25&si=false&es=2x&wm=false&code=class%2520ResolvedFormType%250A%257B%250A%2520%2520%2520%2520public%2520function%2520buildView%28FormView%2520%2524view%252C%2520FormInterface%2520%2524form%252C%2520array%2520%2524options%29%250A%2520%2520%2520%2520%257B%250A%2520%2520%2520%2520%2520%2520%2520%2520if%2520%28null%2520%21%253D%253D%2520%2524this-%253Eparent%29%2520%257B%250A%2520%2520%2520%2520%2520%2520%2520%2520%2520%2520%2520%2520%2524this-%253Eparent-%253EbuildView%28%2524view%252C%2520%2524form%252C%2520%2524options%29%253B%250A%2520%2520%2520%2520%2520%2520%2520%2520%257D%250A%250A%2520%2520%2520%2520%2520%2520%2520%2520%2524this-%253EinnerType-%253EbuildView%28%2524view%252C%2520%2524form%252C%2520%2524options%29%253B%250A%250A%2520%2520%2520%2520%2520%2520%2520%2520foreach%2520%28%2524this-%253EtypeExtensions%2520as%2520%2524extension%29%2520%257B%250A%2520%2520%2520%2520%2520%2520%2520%2520%2520%2520%2520%2520%2524extension-%253EbuildView%28%2524view%252C%2520%2524form%252C%2520%2524options%29%253B%250A%2520%2520%2520%2520%2520%2520%2520%2520%257D%250A%2520%2520%2520%2520%257D%250A%2520%2520%250A%2520%2520%2520%2520%252F%252F...%250A%257D
.resolved3[
]
.resolved4[
]
??? https://carbon.now.sh/?bg=rgba%28243%2C243%2C243%2C0%29&t=a11y-dark&wt=none&l=text%2Fx-php&ds=true&dsyoff=10px&dsblur=26px&wc=false&wa=true&pv=56px&ph=56px&ln=true&fl=1&fm=Hack&fs=14px&lh=133%25&si=false&es=2x&wm=false&code=class%2520ResolvedFormType%250A%257B%250A%2520%2520%2520%2520public%2520function%2520getOptionsResolver%28%29%250A%2520%2520%2520%2520%257B%250A%2520%2520%2520%2520%2520%2520%2520%2520if%2520%28null%2520%253D%253D%253D%2520%2524this-%253EoptionsResolver%29%2520%257B%250A%2520%2520%2520%2520%2520%2520%2520%2520%2520%2520%2520%2520if%2520%28null%2520%21%253D%253D%2520%2524this-%253Eparent%29%2520%257B%250A%2520%2520%2520%2520%2520%2520%2520%2520%2520%2520%2520%2520%2520%2520%2520%2520%2524this-%253EoptionsResolver%2520%253D%2520clone%2520%2524this-%253Eparent-%253EgetOptionsResolver%28%29%253B%250A%2520%2520%2520%2520%2520%2520%2520%2520%2520%2520%2520%2520%257D%2520else%2520%257B%250A%2520%2520%2520%2520%2520%2520%2520%2520%2520%2520%2520%2520%2520%2520%2520%2520%2524this-%253EoptionsResolver%2520%253D%2520new%2520OptionsResolver%28%29%253B%250A%2520%2520%2520%2520%2520%2520%2520%2520%2520%2520%2520%2520%257D%250A%250A%2520%2520%2520%2520%2520%2520%2520%2520%2520%2520%2520%2520%2524this-%253EinnerType-%253EconfigureOptions%28%2524this-%253EoptionsResolver%29%253B%250A%250A%2520%2520%2520%2520%2520%2520%2520%2520%2520%2520%2520%2520foreach%2520%28%2524this-%253EtypeExtensions%2520as%2520%2524extension%29%2520%257B%250A%2520%2520%2520%2520%2520%2520%2520%2520%2520%2520%2520%2520%2520%2520%2520%2520%2524extension-%253EconfigureOptions%28%2524this-%253EoptionsResolver%29%253B%250A%2520%2520%2520%2520%2520%2520%2520%2520%2520%2520%2520%2520%257D%250A%2520%2520%2520%2520%2520%2520%2520%2520%257D%250A%250A%2520%2520%2520%2520%2520%2520%2520%2520return%2520%2524this-%253EoptionsResolver%253B%250A%2520%2520%2520%2520%257D%250A%2520%2520%250A%2520%2520%2520%2520%252F%252F...%250A%257D
class: section
.setdata_img[
]
- Form::initialize is only called on the root form
- Form::setData uses the content of the data option or the value passed to the FormFactory creation method otherwise.
class: setdata
-
Dispatch PreSetDataEvent with the provided data (model data) and retrieve eventually modified model data
-
Data transformer are used (if availables):
.setdata_transformers[
]
-
Compound forms use
DataMapperInterface::mapDataToFormsto set data on child forms -
Dispatch PostSetDataEvent with the provided data (model data)
??? No transformers for root form DataMapper = PropertyPathMapper
.mapper1_img[
]
class: section
class: request_handler1
A request handler (RequestHandlerInterface implementation) retrieve data from the request (depending on the HTTP method).
-
RequestHandlerInterface::handleRequestis called byForm::handleRequest -
RequestHandlerInterface::handleRequestcallsForm::submitif request has data related to the form
class: request_handler2
The Form component currently provides 2 implementations of RequestHandlerInterface:
-
NativeRequestHandlerthat retrieves request data from php superglobals ($_GET, $_POST...) -
HttpFoundationRequestHandlerthat retrieves request data from an HttpFoundation request object
.note[
Note: a pull request is opened on the psr-http-message-bridge to introduce a
Psr7RequestHandler.
]
class: submit1
-
Dispatch PreSubmitEvent with the submitted data (data provided by the request handler) and retrieve eventually modified data
-
Call
submitmethod on each form child with the submitted data for this field -
Submitted data can be modified by a form child data transformer;
DataMapperInterface::mapFormsToDatais used to merge this transformed data to submitted data
.mapper2_img[
]
??? https://carbon.now.sh/?bg=rgba%28243%2C243%2C243%2C0%29&t=a11y-dark&wt=none&l=text%2Fx-php&ds=true&dsyoff=10px&dsblur=26px&wc=false&wa=true&pv=56px&ph=56px&ln=true&fl=1&fm=Hack&fs=14px&lh=133%25&si=false&es=2x&wm=false&code=public%2520function%2520mapFormsToData%28iterable%2520%2524forms%252C%2520%2526%2524data%29%250A%257B%250A%2520%2520%2520%2520%252F%252F...%250A%2520%2520%250A%2520%2520%2520%2520foreach%2520%28%2524forms%2520as%2520%2524form%29%2520%257B%250A%2520%2520%2520%2520%2520%2520%2520%2520%2524propertyPath%2520%253D%2520%2524form-%253EgetPropertyPath%28%29%253B%250A%2520%2520%2520%2520%2520%2520%2520%2520%2524config%2520%253D%2520%2524form-%253EgetConfig%28%29%253B%250A%250A%2520%2520%2520%2520%2520%2520%2520%2520if%2520%28null%2520%21%253D%253D%2520%2524propertyPath%2520%2526%2526%2520%2524config-%253EgetMapped%28%29%2520%2526%2526%2520%2524form-%253EisSubmitted%28%29%2520%2526%2526%2520%2524form-%253EisSynchronized%28%29%2520%2526%2526%2520%21%2524form-%253EisDisabled%28%29%29%2520%257B%250A%2520%2520%2520%2520%2520%2520%2520%2520%2520%2520%2520%2520%2524propertyValue%2520%253D%2520%2524form-%253EgetData%28%29%253B%250A%2520%2520%2520%2520%2520%2520%2520%2520%2520%2520%2520%2520%2520%2520%2520%2520%250A%2520%2520%2520%2520%2520%2520%2520%2520%2520%2520%2520%2520%252F%252F...%250A%250A%2520%2520%2520%2520%2520%2520%2520%2520%2520%2520%2520%2520if%2520%28%21%255Cis_object%28%2524data%29%2520%257C%257C%2520%21%2524config-%253EgetByReference%28%29%2520%257C%257C%2520%2524propertyValue%2520%21%253D%253D%2520%2524this-%253EgetPropertyValue%28%2524data%252C%2520%2524propertyPath%29%29%2520%257B%250A%2520%2520%2520%2520%2520%2520%2520%2520%2520%2520%2520%2520%2520%2520%2520%2520%2524this-%253EpropertyAccessor-%253EsetValue%28%2524data%252C%2520%2524propertyPath%252C%2520%2524propertyValue%29%253B%250A%2520%2520%2520%2520%2520%2520%2520%2520%2520%2520%2520%2520%257D%250A%2520%2520%2520%2520%2520%2520%2520%2520%257D%250A%2520%2520%2520%2520%257D%250A%257D
class: submit2
-
Submitted data can be transformed: .submit_transformers1[
] -
Dispatch SubmitEvent with the norm data and retrieve eventually modified data
-
Data can be transformed again: .submit_transformers2[
] -
Dispatch PostSubmitEvent with the view data
class: section
.extension_img[
]
class: builtin
- CoreExtension: built-in types
- CsrfExtension: csrf protection
- ValidatorExtension: constraints integration
- DependencyInjectionExtension: A compiler pass register here:
- FormTypes services
- FormTypeExtensions services
- Guessers services
- ...
class: section
class: guessers1
Guessers allow to assume a form type based on the underlying object properties.
They are only used if no form type is provided.
In addition to the form type; they can guess:
- the html required property
- the html maxlength property
- the html pattern property
class: guessers2
Only one guesser is used for an application (ChainGuesser allows to use several guessers).
Each guesser can do assumptions on a field. Guessers tie confidences (low, medium, high, very high) to their assumptions.
ChainGuesser returns the assumption with the hightest confidence.
class: section2