12.6. Creando clases de formulario (Symfony 2.0, el libro oficial)

En las secciones anteriores, los formularios se creaban y utilizaban directamente desde el controlador. Sin embargo, se recomienda como una buena práctica definir los formularios en sus propias clases PHP independientes de los controladores. De esta forma puedes reutilizar el mismo formulario en diferentes partes de la aplicación. Para ello, crea en primer lugar una nueva clase con toda la lógica necesaria para crear el formulario:

// src/Acme/TaskBundle/Form/Type/TaskType.php
namespace Acme\TaskBundle\Form\Type;

use Symfony\Component\Form\AbstractType;
use Symfony\Component\Form\FormBuilder;

class TaskType extends AbstractType
{
    public function buildForm(FormBuilder $builder, array $options)
    {
        $builder->add('task');
        $builder->add('dueDate', null, array('widget' => 'single_text'));
    }

    public function getName()
    {
        return 'task';
    }
}

Esta nueva clase contiene todas las indicaciones necesarias para crear el formulario (observa que el método getName() devuelve un identificador único para este tipo de formulario). Ahora ya puedes utilizar esta clase para construir rápidamente un formulario en el controlador:

// src/Acme/TaskBundle/Controller/DefaultController.php

// añade esta nueva declaración al principio de la clase
use Acme\TaskBundle\Form\Type\TaskType;

public function newAction()
{
    $task = ...;
    $form = $this->createForm(new TaskType(), $task);

    // ...
}

Cuando la lógica del formulario reside en su propia clase, esto significa que puedes reutilizar fácilmente el formulario en cualquier parte del proyecto. Esta es la mejor manera de crear formularios, pero hacerlo así o de la otra forma depende exclusivamente de ti.

Configurando el data_class Cada formulario debe conocer el nombre de la clase asociada al objeto manejado por el formulario (por ejemplo, Acme\TaskBundle\Entity\Task). Por lo general, esta información se deduce automáticamente en función del objeto que se pasa como segundo argumento del método createForm (en el ejemplo anteiror, $task).

Más adelante, cuando comiences a incluir formularios dentro de otros formularios, esto ya no será suficiente. Así que, aunque no es obligatorio hacerlo, te recomendamos que siempre añadas la opción data_class a tus formularios utilizando el siguiente código:

public function getDefaultOptions(array $options)
{
    return array(
        'data_class' => 'Acme\TaskBundle\Entity\Task',
    );
}

Truco Cuando un formulario gestiona un objeto, se establece una relación con todas las propiedades del objeto. De esta forma, si el formulario contiene un campo que no corresponde con ninguna propiedad del objeto, se produce una excepción.

Si necesitas añadir campos adicionales en el formulario (por ejemplo para incluir la típica casilla de "Estoy de acuerdo con estos términos y condiciones") que no se van a asociar con ninguna propiedad del objeto, debes establecer la opción property_path a false:

public function buildForm(FormBuilder $builder, array $options)
{
    $builder->add('task');
    $builder->add('dueDate', null, array('property_path' => false));
}

Además, si el formulario contiene campos que no se incluyen en los datos enviados por el usuario, a esos campos se les asigna el valor null.

Los datos de cada campo se pueden acceder en un controlador con el método getData():

$form->get('dueDate')->getData();