This PR was submitted for the 2.7 branch but it was merged into the 2.8 branch instead (closes #13990).
Discussion
----------
[Form] Add flexibility for EntityType
| Q | A
| ------------- | ---
| Bug fix? | no
| New feature? | yes
| BC breaks? | no
| Deprecations? | no
| Tests pass? | yes
| Fixed tickets |
| License | MIT
| Doc PR |
Sometimes it can be usefull to return null rather than a QueryBuilder from the closure attached to the ``query_builder`` attribute of an EntityType.
For example, if I have the following method in a "DelegateRepository", which can return a QueryBuilder or null:
```php
public function getQbForOfficers()
{
$permanentMeeting = $this->getEntityManager()->getRepository('MyBundle:PermanentMeeting')->findOneBy(array());
if ($permanentMeeting === null || $permanentMeeting->getMeeting() === null) {
return null;
}
$qb = $this->getEntityManager()->createQueryBuilder();
$qb->select('p')
->from('MyBundle:Delegate', 'p')
->andWhere('p.meeting = :meetingId')
->setParameter('meetingId', $permanentMeeting->getMeeting()->getId());
return $qb;
}
```
To be able to present a list without entries when creating an entity field like this:
```php
$event->getForm()->add('officers', 'entity', array(
'class' => 'MyBundle:Delegate',
'property' => 'fullName',
'query_builder' => function(EntityRepository $er) use ($meeting, $delegationId) {
return $er->getQbForOfficers();
}
)));
```
Rather than using the "choices" attributes (more verbose and which requires the injection of the entityManager):
```php
$qb = $this->entityManager->getRepository('PTCNoventoBundle:Delegate')->getQbForOfficers();
$officers = ($qb !== null) ? $qb->getQuery()->getResult() : array();
$event->getForm()->add('officers', 'entity', array(
'class' => 'PTCNoventoBundle:Delegate',
'property' => 'fullName',
'choices' => $officers,
));
```
Commits
-------
|
||
---|---|---|
src/Symfony | ||
.editorconfig | ||
.gitignore | ||
.php_cs | ||
.travis.php | ||
.travis.yml | ||
CHANGELOG-2.2.md | ||
CHANGELOG-2.3.md | ||
CHANGELOG-2.4.md | ||
CHANGELOG-2.5.md | ||
CHANGELOG-2.6.md | ||
CHANGELOG-2.7.md | ||
composer.json | ||
CONTRIBUTING.md | ||
CONTRIBUTORS.md | ||
LICENSE | ||
phpunit.xml.dist | ||
README.md | ||
UPGRADE-2.1.md | ||
UPGRADE-2.2.md | ||
UPGRADE-2.3.md | ||
UPGRADE-2.4.md | ||
UPGRADE-2.5.md | ||
UPGRADE-2.6.md | ||
UPGRADE-2.7.md | ||
UPGRADE-2.8.md | ||
UPGRADE-3.0.md |
README
What is Symfony?
Symfony is a PHP 5.3 full-stack web framework. It is written with speed and flexibility in mind. It allows developers to build better and easy to maintain websites with PHP.
Symfony can be used to develop all kind of websites, from your personal blog to high traffic ones like Dailymotion or Yahoo! Answers.
Requirements
Symfony is only supported on PHP 5.3.9 and up.
Be warned that PHP 5.3.16 has a major bug in the Reflection subsystem and is not suitable to run Symfony (https://bugs.php.net/bug.php?id=62715)
Installation
The best way to install Symfony is to use the official Symfony Installer. It allows you to start a new project based on the version you want.
Documentation
The "Quick Tour" tutorial gives you a first feeling of the framework. If, like us, you think that Symfony can help speed up your development and take the quality of your work to the next level, read the official Symfony documentation.
Contributing
Symfony is an open source, community-driven project. If you'd like to contribute, please read the Contributing Code part of the documentation. If you're submitting a pull request, please follow the guidelines in the Submitting a Patch section and use Pull Request Template.
Running Symfony Tests
Information on how to run the Symfony test suite can be found in the Running Symfony Tests section.