Symfony2: étendre globalement les options des FormType avec l'injection de dépendance

EDIT: Article mis à jour en utilisant les FormExtension que j'ai découvert dans les commentaires.

Dans la première version de Symfony, il existait une option 'help' dans les widgets des formulaires qui permettait d'ajouter un texte sous le champs. J'ai eu besoin de retrouver cette option dans les Type de Symfony2.

On va écarter tout de suite l'option de surcharger tous les types que propose Symfony2. Il est possible d'étendre n'importe quel Type dans Symfony2 grace aux FormExtensions.

<?php
namespace Acme\demoBundle\Form\Extension;
 
use Symfony\Component\Form\AbstractTypeExtension;
use Symfony\Component\Form\FormInterface;
use Symfony\Component\Form\FormView;
use Symfony\Component\OptionsResolver\OptionsResolverInterface;
 
class HelpTypeExtension extends AbstractTypeExtension
{
    public function getExtendedType()
    {
        return 'form';
    }
 
    public function buildView(FormView $view, FormInterface $form, array $options)
    {
        $view->vars = array_merge($view->vars, array('help' => $options['help']));
    }
 
    public function setDefaultOptions(OptionsResolverInterface $resolver)
    {
        $resolver->setDefaults(array('help' => null));
    }
}

Dans la méthode getExtendedType() j'ai choisi 'form' car je veux que mon Extension soit valable pour tous les Types; setDefaultOptions() permet d'ajouter l'option que je veux et buildView() me permet de passer cette option au template.

Pour utiliser ma nouvelle extension, il faut que je la déclare dans le fichier services.yml de mon bundle:

services:
    acmedemo.form.extension.help:
        class: Acme\DemoBundle\Form\Extension\HelpTypeExtension
        tags:
            - { name: form.type, alias: form }

Il ne reste plus qu'a customiser le thème de mes formulaires dans twig. Pour plus d'info lisez cette page du cookbook de symfony2.
Une fois de plus, je ne veux pas surcharger chaque template, je préfère une modification globale, je redéfinis donc le template form_row

{% block form_row %}
{% spaceless %}
    <div>
        {{ form_label(form) }}
        {{ form_errors(form) }}
        {{ form_widget(form) }}
        {% if form.vars.help is defined and form.vars.help is not null %}
            help: {{ form.vars.help }}
        {% endif %}
    </div>
{% endspaceless %}
{% endblock form_row %}

Et voilà, je peux maintenant ajouter l'option 'help' à mes définitions de champs:

$builder->add('meta_title', 'text', array(
    'label' => 'titre de la page',
    'help'  => 'Recommandé: 68 caractères'
));