Zend-Form组件包含以下几个对象:
1、Elements:包含了name和attributes,
2、Fieldsets:继承自elements,但允许包含其他fieldset和elements,
3、Forms:继承自Fieldsets。提供数据和对象绑定,并组合了InputFilters。数据绑定由zend-hydrator实现。
为了更好的利用view layer,zend-form也聚合了大量与form有关的view helpers。
最低限度的每一个element和fieldset都需要一个名字。
大多数情况下,你还需要提供一些属性来指示view层如何渲染这些元素。
Zend-form里面的工厂通常用来创建elements,fieldsets,forms和相关的输入过滤(input filter)。工厂可以简化表单的创建。
与form相关的代码可能会跨越几个区域:form定义,输入过滤定义,领域模型类,一个或更多地hydrator实现。(hydrator用来数组和对象之间的转换,序列化)
Zend\Form\Annotation\AnnotationBuilder可以用来创建各种你需要的对象(上面跨越的几个区域)
Forms是元素和自定义字段(fieldsets)的聚合,最低限度的每一个元素和自定义字段都需要一个名字。更多地情况下,可以提供一些属性来告诉view层如何渲染(比如隐藏的表单)。
使用工厂直接创建InputFilter,对表单输入过滤。
执行表单验证是通过向setData()提供一个数组数据,然后调用isValid方法。如果你想更加的简化工作,可以将一个对象绑定到表单上。一旦成功验证,将从被验证的值填充?
一般性步骤(比较冗余)
/*创建元素,*/ $name = new Element('name'); /*设置标签*/ $name->setLabel('Your name'); /*设置元素的各种属性。。。*/ $name->setAttributes(['type' => 'text',]); /*创建表单,*/ $form = new Form('contact'); /*将元素添加到表单里面。*/ $form->add($name); /*创建某个元素的Input,*/ $nameInput = new Input('name'); /*创建inputfilter,*/ $inputFilter = new InputFilter(); /*添加input到inputfilter。*/ $inputFilter->add($nameinput); /*把inputfilter连接到表单。*/ $form->add($inputFilter);
通过工厂创建
你可以通过工厂一次性创建整个表单和input filter。如果你想将自己的表单保存为纯配置,这种方法very nice。将配置信息传给工厂即可。
步骤如下:
1、创建工厂对象(Zend\Form\Factory)
调用createForm方法,使用配置信息创建Form对象。 。。。
默认的Form实现时基于工厂的。这意味着你可以定义自己的表单。
验证表单:
表单验证需要三个步骤:
/*1、表单必需被一个input filter连接。*/ $yourform->setInputFilter(new yourformFilter()); /*2、你必须将需要验证的数据注入到表单中。*/ $data = $request->getPost(); $data = $request->getQuery(); $yourform->setData($data); /*3、验证表单。*/ /*4、如果数据验证无效,你将会获取到错误消息。*/ if ($form->isValid()) { $validateData = $form->getData(); }else { $messages = $form->getMessages(); }
指示给Input Filter:
有时候你想在创建元素的同时创建inputfilter。
How TO:
元素需要实现Zend\InputFilter\InputProviderInterface,这里面定义了getInputSpecification()方法。返回的数据会被input filter工厂使用来创建一个input
对于fieldset必须实现Zend\InputFilter\InputFilterProviderInterface,这里面定义了getInputFilterSpecification()方法。必须为input filter返回配置。
绑定一个对象:https://docs.zendframework.com/zend-form/quick-start/#binding-an-object
当你绑定一个对象到表单时会发生以下行为:
1、Hydrator调用extract(),返回的值构成所有元素的值属性。如果表单包含嵌套fieldset,那么表单会递归的解析出值。
2、当isValid()被调用时,如果setData()还没被调用。表单使用Hydrator从对象中解析出值来。然后使用这些值进行验证。也就是使用对象里的数据给表单赋值。
3、如果isValid()验证成功了,Hydrator将会被传入有效的值来绑定object。
4、如果对象实现了Zend\InputFilter\InputFilterAwareInterface,那对象包含的input filter会被用来替换form所包含的input filter。
对象帮定到表单的时候,使用getData默认返回的是对象。使用FormInterface::VALUES_AS_ARRAY标志可以返回关联数组。
关于视图方面:
form组件包含一系列的view helpers。这些帮助函数接受各种form对象,通过内省生成markup。一般来讲,他们会检查特性,但特殊情况下,他们也许会查找其他属性和被组合的对象。
在准备渲染之前,你一般需要调用prepare()。该方法会确保内省已经完成,并确嵌套在fieldsets和集合里的元素以数组标记的形式生成名字。如scoped[array][notation]