PHP教程：Symfony2框架学习笔记之表单用法详解

PHP教程
// src/Acme/TaskBundle/Entity/Task.php
namespace Acme\TaskBundle\Entity;
class Task
{
  protected $task;
  protected $dueDate;
  public function getTask()
  {
    return $this->task;
  }
  public function setTask($task)
  {
    $this->task = $task;
  }
  public function getDueDate()
  {
    return $this->dueDate;
  }
  public function setDueDate(\DateTime $dueDate = null)
  {
    $this->dueDate = $dueDate;
  }
}

PHP教程
$ php app/console generate:bundle --namespace=Acme/TaskBundle

PHP教程
//src/Acme/TaskBundle/Controller/DefaultController.php
namespace Acme\TaskBundle\Controller;
use Symfony\Bundle\FrameworkBundle\Controller\Controller;
use Symfony\Component\HttpFoundation\Request;
use Acme\TaskBundle\Entity\Task;
class DefaultController extends Controller
{
    //创建一个任务并给它一些假数据作为示例
    $task = new Task();
    $task->setTask('Write a blog post');
    $task->setDueDate(new \DateTime('tomorrow'));
    $form = $this->createFormBuilder($task)
       ->add('task','text')
       ->add('dueDate','date')
       ->getForm();
    return $this->render('AcmeTaskBundle:Default:new.html.twig',array(
        'form' =>$form->createView(),
    ));
}

PHP教程
{# src/Acme/TaskBundle/Resources/views/Default/new.html.twig #}
<form action="{{ path('task_new') }}" method ="post" {{ form_enctype(form) }}>
  {{ form_widget(form) }}
   <input type="submit" />
</form>

PHP教程
<!-- src/Acme/TaskBundle/Resources/views/Default/new.html.php -->
<form action="<?php echo $view['router']->generate('task_new') ?>" method="post" <?php echo $view['form']->enctype($form) ?> >
   <?php echo $view['form']->widget($form) ?>
   <input type="submit" />
</form>

PHP教程
//...
public function newAction(Request $request)
{
     //只是创建一个新的$task对象(不需要假数据)
    $task = new Task();
    $form= $this->createFormBuilder($task)
       ->add('task','text')
       ->add('dueDate','date')
       ->getForm();
    if($request->getMethod() == "POST"){
       $form->bindRequest($request);
       if($form->isValid()){
           //执行一些行为,比如保持task到数据库
           return $this->redirect($this->generateUrl('task_success'));
       }
    }
    //...
}

PHP教程
# Acme/TaskBundle/Resources/config/validation.yml
Acme\TaskBundle\Entity\Task:
  properties:
    task:
      - NotBlank: ~
    dueDate:
      - NotBlank: ~
      - Type: \DateTime

PHP教程
// Acme/TaskBundle/Entity/Task.php
use Symfony\Component\Validator\Constraints as Assert;
class Task
{
  /**
   * @Assert\NotBlank()
   */
  public $task;
  /**
   * @Assert\NotBlank()
   * @Assert\Type("\DateTime")
   */
  protected $dueDate;
}

PHP教程
<!-- Acme/TaskBundle/Resources/config/validation.xml -->
<class name="Acme\TaskBundle\Entity\Task">
  <property name="task">
    <constraint name="NotBlank" />
  </property>
  <property name="dueDate">
    <constraint name="NotBlank" />
    <constraint name="Type">
      <value>\DateTime</value>
    </constraint>
  </property>
</class>

PHP教程
// Acme/TaskBundle/Entity/Task.php
use Symfony\Component\Validator\Mapping\ClassMetadata;
use Symfony\Component\Validator\Constraints\NotBlank;
use Symfony\Component\Validator\Constraints\Type;
class Task
{
  // ...
  public static function loadValidatorMetadata(ClassMetadata $metadata)
  {
    $metadata->addPropertyConstraint('task', new NotBlank());
    $metadata->addPropertyConstraint('dueDate', new NotBlank());
    $metadata->addPropertyConstraint('dueDate', new Type('\DateTime'));
  }
}

PHP教程
$form = $this->createFormBuilder($users, array(
  'validation_groups' => array('registration'),
))->add(...)
;

PHP教程
public function getDefaultOptions(array $options)
{
  return array(
    'validation_groups' => array('registration')
  );
}

PHP教程
->add('dueData','data', array('widget' = 'single_text'))

PHP教程
->add('dueDate', 'date',array(
  'widget' =>'single_text',
  'label' => 'Due Date',
))

PHP教程
public function newAction()
{
  $task = new Task();
  $form = $this->createFormBuilder($task)
    ->add('task')
    ->add('dueDate', null, array('widget' => 'single_text'))
    ->getForm();
}

PHP教程
->add('task',null, array('max_length'=>4))

PHP教程
{# src/Acme/TaskBundle/Resources/views/Default/new.html.twig #}
<form action="{{ path('task_new') }}" method="post" {{ form_enctype(form) }}>
  {{ form_errors(form) }}
  {{ form_row(form.task) }}
  {{ form_row(form.dueDate) }}
  {{ form_rest(form) }}
  <input type="submit" />
</form>

PHP教程
<!-- // src/Acme/TaskBundle/Resources/views/Default/newAction.html.php -->
<form action="<?php echo $view['router']->generate('task_new') ?>" method="post" <?php echo $view['form']->enctype($form) ?>>
  <?php echo $view['form']->errors($form) ?>
  <?php echo $view['form']->row($form['task']) ?>
  <?php echo $view['form']->row($form['dueDate']) ?>
  <?php echo $view['form']->rest($form) ?>
  <input type="submit" />
</form>

PHP教程
{{ form.vars.value.task }}

PHP教程
<?php echo $view['form']->get('value')->getTask() ?>

PHP教程
{{ form_errors(form) }}
<div>
  {{ form_label(form.task) }}
  {{ form_errors(form.task) }}
  {{ form_widget(form.task) }}
</div>
<div>
  {{ form_label(form.dueDate) }}
  {{ form_errors(form.dueDate) }}
  {{ form_widget(form.dueDate) }}
</div>
{{ form_rest(form) }}

PHP教程
<?php echo $view['form']->errors($form) ?>
<div>
  <?php echo $view['form']->label($form['task']) ?>
  <?php echo $view['form']->errors($form['task']) ?>
  <?php echo $view['form']->widget($form['task']) ?>
</div>
<div>
  <?php echo $view['form']->label($form['dueDate']) ?>
  <?php echo $view['form']->errors($form['dueDate']) ?>
  <?php echo $view['form']->widget($form['dueDate']) ?>
</div>
<?php echo $view['form']->rest($form) ?>

PHP教程
{{ form_label(form.task, 'Task Description') }}

PHP教程
<?php echo $view['form']->label($form['task'], 'Task Description') ?>

PHP教程
{{ form_widget(form.task, {'attr': {'class':'task_field'} }) }}

PHP教程
<?php echo $view['form']->widget($form['task'], array(
'attr' => array('class' => 'task_field'),
)) ?>

PHP教程
{{ form.task.vars.id }}

PHP教程
<?php echo $form['task']->get('id') ?>

PHP教程
{{ form.task.vars.full_name }}

PHP教程
<?php echo $form['task']->get('full_name') ?>

PHP教程
// 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';
  }
}

PHP教程
// src/Acme/TaskBundle/Controller/DefaultController.php
// 在类上添加这个新的引用语句
use Acme\TaskBundle\Form\Type\TaskType;
public function newAction()
{
    $task = // ...
    $form = $this->createForm(new TaskType(), $task);
    // ...
}

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

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

PHP教程
$form->get('dueDate')->getData();

PHP教程
if ($form->isValid()) {
  $em = $this->getDoctrine()->getEntityManager();
  $em->persist($task);
  $em->flush();
  return $this->redirect($this->generateUrl('task_success'));
}

PHP教程
$task = $form->getData();

PHP教程
// src/Acme/TaskBundle/Entity/Category.php
namespace Acme\TaskBundle\Entity;
use Symfony\Component\Validator\Constraints as Assert;
class Category
{
  /**
   * @Assert\NotBlank()
   */
  public $name;
}

PHP教程
// ...
class Task
{
  // ...
  /**
   * @Assert\Type(type="Acme\TaskBundle\Entity\Category")
   */
  protected $category;
  // ...
  public function getCategory()
  {
    return $this->category;
  }
  public function setCategory(Category $category = null)
  {
    $this->category = $category;
  }
}

PHP教程
// src/Acme/TaskBundle/Form/Type/CategoryType.php
namespace Acme\TaskBundle\Form\Type;
use Symfony\Component\Form\AbstractType;
use Symfony\Component\Form\FormBuilder;
class CategoryType extends AbstractType
{
  public function buildForm(FormBuilder $builder, array $options)
  {
    $builder->add('name');
  }
  public function getDefaultOptions(array $options)
  {
    return array(
      'data_class' => 'Acme\TaskBundle\Entity\Category',
    );
  }
  public function getName()
  {
    return 'category';
  }
}

PHP教程
public function buildForm(FormBuilder $builder, array $options)
{
  // ...
  $builder->add('category', new CategoryType());
}

PHP教程
{# ... #}
<h3>Category</h3>
<div class="category">
  {{ form_row(form.category.name) }}
</div>
{{ form_rest(form) }}
{# ... #}

PHP教程
<!-- ... -->
<h3>Category</h3>
<div class="category">
  <?php echo $view['form']->row($form['category']['name']) ?>
</div>
<?php echo $view['form']->rest($form) ?>
<!-- ... -->

PHP教程
$task->getCategory()

PHP教程
{# src/Acme/TaskBundle/Resources/views/Form/fields.html.twig #}
{% block field_row %}
{% spaceless %}
  <div class="form_row">
    {{ form_label(form) }}
    {{ form_errors(form) }}
    {{ form_widget(form) }}
  </div>
{% endspaceless %}
{% endblock field_row %}

PHP教程
<!-- src/Acme/TaskBundle/Resources/views/Form/field_row.html.php -->
<div class="form_row">
  <?php echo $view['form']->label($form, $label) ?>
  <?php echo $view['form']->errors($form) ?>
  <?php echo $view['form']->widget($form, $parameters) ?>
</div>

PHP教程
{# src/Acme/TaskBundle/Resources/views/Default/new.html.twig #}
{% form_theme form 'AcmeTaskBundle:Form:fields.html.twig' %}
{% form_theme form 'AcmeTaskBundle:Form:fields.html.twig' 'AcmeTaskBundle:Form:fields2.html.twig' %}
<form ...>

PHP教程
<!-- src/Acme/TaskBundle/Resources/views/Default/new.html.php -->
<?php $view['form']->setTheme($form, array('AcmeTaskBundle:Form')) ?>
<?php $view['form']->setTheme($form, array('AcmeTaskBundle:Form', 'AcmeTaskBundle:Form')) ?>
<form ...>

PHP教程
# app/config/config.yml
twig:
  form:
    resources:
      - 'AcmeTaskBundle:Form:fields.html.twig'
  # ...

PHP教程
<!-- app/config/config.xml -->
<twig:config ...>
    <twig:form>
      <resource>AcmeTaskBundle:Form:fields.html.twig</resource>
    </twig:form>
    <!-- ... -->
</twig:config>

PHP教程
// app/config/config.php
$container->loadFromExtension('twig', array(
  'form' => array('resources' => array(
    'AcmeTaskBundle:Form:fields.html.twig',
   ))
  // ...
));

PHP教程
{% extends '::base.html.twig'%}
{# 导入"_self" 作为一个表单主题 #}
{% form_theme form _self %}
{# 个性化表单片段 #}
{% block field_row %}
    {# 自定义字段行输出 #}
{% endblock field_row %}
{% block content %}
    {# ... #}
    {{ form_row(form.task) }}
{% endblock %}

PHP教程
# app/config/config.yml
framework:
  templating:
    form:
      resources:
        - 'AcmeTaskBundle:Form'
# ...

PHP教程
<!-- app/config/config.xml -->
<framework:config ...>
  <framework:templating>
    <framework:form>
      <resource>AcmeTaskBundle:Form</resource>
    </framework:form>
  </framework:templating>
  <!-- ... -->
</framework:config>

PHP教程
// app/config/config.php
$container->loadFromExtension('framework', array(
  'templating' => array('form' =>
    array('resources' => array(
      'AcmeTaskBundle:Form',
   )))
  // ...
));

PHP教程
class TaskType extends AbstractType
{
   // ...
   public function getDefaultOptions(array $options)
   {
      return array(
          'data_class' => 'Acme\TaskBundle\Entity\Task',
          'csrf_protection' => true,
          'csrf_field_name' => '_token',
          // 一个唯一的键值来保证生成令牌
          'intention' => 'task_item',
      );
   }
   // ...
}

PHP教程
// 确认你在类上方导入了Request对象
use Symfony\Component\HttpFoundation\Request
// ...
public function contactAction(Request $request)
{
    $defaultData = array('message' => 'Type your message here');
    $form = $this->createFormBuilder($defaultData)
       ->add('name', 'text')
       ->add('email', 'email')
       ->add('message', 'textarea')
       ->getForm();
     if ($request->getMethod() == 'POST') {
        $form->bindRequest($request);
        // 数据是一个数组并包含 "name", "email", 和"message" 键
        $data = $form->getData();
     }
    // ... 渲染表单
}

PHP教程
$this->get('request')->request->get('name');

PHP教程
// 在controller类前导入命名空间
use Symfony\Component\Validator\Constraints\Email;
use Symfony\Component\Validator\Constraints\MinLength;
use Symfony\Component\Validator\Constraints\Collection;
$collectionConstraint = new Collection(array(
      'name' => new MinLength(5),
      'email' => new Email(array('message' => 'Invalid email address')),
));
// 创建一个表单没有默认值,传入约束选项.
$form = $this->createFormBuilder(null, array(
           'validation_constraint' => $collectionConstraint,
    ))->add('email', 'email')
// ...
;

PHP教程
namespace Acme\TaskBundle\Form\Type;
use Symfony\Component\Form\AbstractType;
use Symfony\Component\Form\FormBuilder;
use Symfony\Component\Validator\Constraints\Email;
use Symfony\Component\Validator\Constraints\MinLength;
use Symfony\Component\Validator\Constraints\Collection;
class ContactType extends AbstractType
{
  // ...
  public function getDefaultOptions(array $options)
  {
    $collectionConstraint = new Collection(array(
      'name' => new MinLength(5),
      'email' => new Email(array('message' => 'Invalid email address')),
    ));
    return array('validation_constraint' => $collectionConstraint);
  }
}