W3cubDocs

/Symfony 4.1

EntityType

class EntityType extends DoctrineType

Properties

protected ManagerRegistry $registry from DoctrineType

Methods

buildForm(FormBuilderInterface $builder, array $options)

Builds the form.

from DoctrineType
buildView(FormView $view, FormInterface $form, array $options)

Builds the form view.

from AbstractType
finishView(FormView $view, FormInterface $form, array $options)

Finishes the form view.

from AbstractType
configureOptions(OptionsResolver $resolver)

Configures the options for this type.

string getBlockPrefix()

Returns the prefix of the template block name for this type.

string|null getParent()

Returns the name of the parent type.

from DoctrineType
static string createChoiceLabel(object $choice)

Creates the label for a choice.

from DoctrineType
static string createChoiceName(object $choice, int|string $key, string $value)

Creates the field name for a choice.

from DoctrineType
array|false getQueryBuilderPartsForCachingHash(object $queryBuilder)

We consider two query builders with an equal SQL string and equal parameters to be equal.

__construct(ManagerRegistry $registry) from DoctrineType
EntityLoaderInterface getLoader(ObjectManager $manager, mixed $queryBuilder, string $class)

Return the default loader object.

reset() from DoctrineType

Details

buildForm(FormBuilderInterface $builder, array $options)

Builds the form.

This method is called for each type in the hierarchy starting from the top most type. Type extensions can further modify the form.

Parameters

FormBuilderInterface $builder The form builder
array $options The options

buildView(FormView $view, FormInterface $form, array $options)

Builds the form view.

This method is called for each type in the hierarchy starting from the top most type. Type extensions can further modify the view.

A view of a form is built before the views of the child forms are built. This means that you cannot access child views in this method. If you need to do so, move your logic to {@link finishView()} instead.

Parameters

FormView $view The view
FormInterface $form The form
array $options The options

finishView(FormView $view, FormInterface $form, array $options)

Finishes the form view.

This method gets called for each type in the hierarchy starting from the top most type. Type extensions can further modify the view.

When this method is called, views of the form's children have already been built and finished and can be accessed. You should only implement such logic in this method that actually accesses child views. For everything else you are recommended to implement {@link buildView()} instead.

Parameters

FormView $view The view
FormInterface $form The form
array $options The options

configureOptions(OptionsResolver $resolver)

Configures the options for this type.

Parameters

OptionsResolver $resolver The resolver for the options

string getBlockPrefix()

Returns the prefix of the template block name for this type.

The block prefix defaults to the underscored short class name with the "Type" suffix removed (e.g. "UserProfileType" => "user_profile").

Return Value

string The prefix of the template block name

string|null getParent()

Returns the name of the parent type.

Return Value

string|null The name of the parent type if any, null otherwise

static string createChoiceLabel(object $choice)

Creates the label for a choice.

For backwards compatibility, objects are cast to strings by default.

Parameters

object $choice The object

Return Value

string The string representation of the object

static string createChoiceName(object $choice, int|string $key, string $value)

Creates the field name for a choice.

This method is used to generate field names if the underlying object has a single-column integer ID. In that case, the value of the field is the ID of the object. That ID is also used as field name.

Parameters

object $choice The object
int|string $key The choice key
string $value The choice value. Corresponds to the object's ID here.

Return Value

string The field name

array|false getQueryBuilderPartsForCachingHash(object $queryBuilder)

We consider two query builders with an equal SQL string and equal parameters to be equal.

Parameters

object $queryBuilder

Return Value

array|false Array with important QueryBuilder parts or false if they can't be determined

__construct(ManagerRegistry $registry)

Parameters

ManagerRegistry $registry

EntityLoaderInterface getLoader(ObjectManager $manager, mixed $queryBuilder, string $class)

Return the default loader object.

Parameters

ObjectManager $manager
mixed $queryBuilder
string $class

Return Value

EntityLoaderInterface

reset()

© 2004–2017 Fabien Potencier
Licensed under the MIT License.
https://api.symfony.com/4.1/Symfony/Bridge/Doctrine/Form/Type/EntityType.html