对于一个Web开发者来说,处理HTML表单是一个最为普通又具挑战的任务。Symfony2集成了一个Form组件,让处理表单变的容易起来。在这一节里,我们将
从基础开始创建一个复杂的表单,学习表单类库中最重要的内容。
Symfony2 的Form组件是一个独立的类库,你可以在Symfony2项目之外使用它。
创建一个简单的表单:
假设你要创建一个应用程序的todo列表,需要显示一些任务。因为你的用户需要编辑和创建任务,所以你需要创建一个表单。在你开始之前,首先来看通用的Task类,用来表示和存储一个单一任务的数据:
// 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; } }
如果你是按照我们提供的示例编码,那么你需要先创建一个AcmeTaskBundle:
$ php app/console generate:bundle --namespace=Acme/TaskBundle
该类是一个普通的PHP对象类,因为他们没有任何Symfony或者其它类库引用。非常简单的一个PHP对象类,它直接解决的是你程序中表现task的数据。当然,在本节的最后,你将能够通过HTML表单提交一个Task实例数据,校验它的数值,并把它持久化到数据库。
创建一个Form
现在已经创建了一个Task类,下一步就是创建和渲染一个真正的HTML表单了。在symfony2中,它是通过创建一个表单对象并渲染到模板的。现在,可以从controller内部处理form。
//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(), )); }
上面的示例显示了如何直接在Controller中创建一个表单,为了可以让表单重用你完全可以在一个单独的类文件中创建表单。
因为Symfony2通过一个表单生成器“form builder"来创建表单对象,所以你可以使用很少的代码就能完成创建表单任务。表单生成器的目的是让你能编写简单的表单创建方法,让它来负责繁重的创建任务。
在这个示例中,你已经添加了两个字段到你的表单,一个是task一个是dueDate。它们关联到Task类的task和dueDate属性。你已经为它们分别指定了类型(比如,text,date等),由这些类型来决定为这些字段生成什么样的HTML表单标签。
Symfony2 拥有许多内建的类型,接下来我们将简单的介绍。
渲染一个表单
表单创建以后,下一步就是渲染它。这是通过传递一个特定的表单”view"对象(就是上例中的 $form->createView()返回的view对象)到你的模板并通过一些列的表单帮助函数来实现的。
Twig格式:
{# 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>
在这里假设你已经创建了一个名叫task_new的路由指向AcmeTaskBundle:Default:new Controller。
就是这些了,通过打印form_widget(form),表单中的每个字段都会被渲染出来。同时还有一个文本标签和错误信息。是不是很简单,不过现在它还不够灵活。通常情况下,我们渴望单独渲染表单中的每一个字段,这样我们可以更好的控制表单的样式。我们会在在模板中渲染表单一节介绍。
在继续下去之前,我们注意到,为什么我们渲染出来的task输入框中有一个来自$task对象的属性值“Write a blog post"。这是表单的第一个工作:从一个对象中获取数据并把它转换为合适的格式渲染到一个HTML表单中。