group_by im formbuilder: erstellen von optgroups im dropdown

Ich habe 2 Entities, „Category“ und „DetailCategory“. Jede DetailCategory hat eine Category. Um dem User das Finden der richtigen DetailCategory zu erleichtern (da sie oft auch gleich benannt sind), wollte ich nicht einfach ein Dropdown, sondern eines, wo die Categories optgroups sind. Ich fand heraus, dass das eigentlich mit group_by geht, also versuchte ich zunächst folgendes:

$form = $this->createFormBuilder()
   ->add('detailCategories', 'entity', array('label' => 'Kategorien', 'multiple' => true, 'class' => 'Package\Bundle\Entity\DetailCategory', 'group_by' => 'category', 'property' => 'name'))
   ->getForm();

Da hat Symfony aber nicht mitgemacht und eine Fehlermeldung geworfen:

Warning: Illegal offset type in isset or empty

Der Grund dafür ist wohl, dass Symfony mit „category“ so nicht klarkommt, da es kein Feld sondern eine Entity ist. Also habe ich diesen hilfreichen Beitrag auf Stackoverflow gefunden und dementsprechend in meiner DetailCategory Entity eine Funktion hinzugefügt:

public function getCategoryName(){
    if (null === $this->getCategory()) {
        return null;
    }
    if (null === $this->getCategory()->getName()) {
        return null;
    }
    return $this->getCategory()->getName();
}

Und dann habe ich im Formbuilder das group_by entsprechend geändert:

'group_by' => 'categoryName'

Und tatsächlich, damit ging’s auf einmal!