Symfony2 细节小计4

验证约束

打开注解约束的配置：
# app/config/config.yml
framework:
validation: { enable_annotations: true }

控制器中校验实体：
$validator = $this->get('validator');
$errors = $validator->validate(实体对象); //检验失败则返回错误列表对象
---count($errors) AND ($errorsString = (string) $errors);
|
---{% for error in errors %} {{error.message}} {% endfor %}  #每个错误代表了一个 ConstraintViolation

表单验证：
$form = $this->createForm(new 表单类(), 空实体对象);
$form->handleRequest($request);
if ($form->isValid()) {
return $this->redirectToRoute(...);
}
return $this->render('author/form.html.twig', array(
'form' => $form->createView(),
));

直接调用验证函数：
$emailConstraint = new Assert\Email();
$emailConstraint->message = 'Invalid email address';
$errorList = $this->get('validator')->validate(
$email,
$emailConstraint
);

use Symfony\Component\Validator\Constraints as Assert;
可以约束的对象： 属性约束、 Getters公共方法（get,is,has开头的方法）、 类约束（可用callback等来约束整个类）

验证组，将实体的校验规则分不同组，校验时激活验证指定组的规则：default组、 类名组。
例子，registration组：
$errors = $validator->validate($author, null, array('registration')); //通过验证组来验证, 没有指定约束，则使用default组来验证

设定验证组验证顺序：
* @Assert\GroupSequence({"User", "Strict"}) //在类头部有序注解出验证组

验证组序列provider（指定那些验证组激活）
* @Assert\GroupSequenceProvider  //在类头部注解使用验证组provider
集成接口： implements GroupSequenceProviderInterface
实现方法： getGroupSequence
返回 激活的验证组名字的数组

表单

表单对象的设计意图：
映射请求数据到实体对象 或 映射实体对象到表单字段输出
更方便的对请求数据校验实体类的验证规则
实现代码复用， 将表单收编到自己的可用组件库中

## 最佳实践的建议 ##
# 推荐在模板中编写表单按钮
# 在表单类或者控制器中添加输入域
# 一般不要把表单注册为服务

创建表单类 -> 实例化表单对象 -> 表单处理提交并验证 -> 返回空表单或跳转 -> 模板绘制表单

## 创建表单 ##
//////自定义类创建表单/////////
namespace xxBundle\Form;
use Symfony\Component\Form\AbstractType;
use Symfony\Component\Form\FormBuilderInterface;
use Symfony\Component\OptionsResolver\OptionsResolver;
class MyType extends AbstractType
{
public function buildForm(FormBuilderInterface $builder, array $options)
{
$builder
->add('title')
->add('summary', 'textarea')
->add('authorEmail', 'email')
->add('publishedAt', 'datetime')
->add('save','submit',array('label'=>'yes')); #不推荐表单类中添加按钮，应在模板中
}

public function configureOptions(OptionsResolver $resolver)
{
$resolver->setDefaults(array(
'data_class' => 'xxBundle\Entity\My'，
'validation_groups' => array('registration'), # 指定表单校验时， 使用实体的哪个校验组
# 'validation_groups'=>false 关闭校验，但还会执行些基础检查
# array('AppBundle\Entity\Client','determineValidGp')通过client类的一个回调方法来决定验证组
# 回调方法接收参数 FormInterface $form
));
}

public function getName()
{
return 'My';
}
}
//////或者 控制器中创建表单//////////
use AppBundle\Entity\Post; #实体类
public function xxAction(Request $request)
{
$form = $this->createFormBuilder(new Post()【, $options】)
【->setAction($this->generateUrl('target_route'))】
【->setMethod('GET')】
->add('name')  #忽略add第二参数或为null， 则自动推断类型
->add('file')
->getForm();
}
// $options = array(
'validation_groups' => array('registration'), //指定表单校验时， 使用实体的哪个校验组
)
##################################################################

## 实例化表单 ##
use AppBundle\Entity\Post; #实体类
use xxBundle\Form\MyType; #表单类
public function xxAction(Request $request)
{
$post = new Post();
$post->setTitle('this is title');
$form = $this->createForm(new MyType(), $post【, array(
'action' => $this->generateUrl('target_route'),
'method' => 'GET',
)】);
...
}
##################################################################

## 表单提交 处理验证 ##
# isValid验证会先内部调用isSubmitted，但为了语义明显，还是推荐显示调用下isSubmitted
use AppBundle\Entity\Post; #实体类
use xxBundle\Form\MyType; #表单类
public function xxAction(Request $request) {
$post = new Post();
$form = $this->createForm(new MyType(), $post);
$form->handleRequest($request); //处理post提交请求，验证数据并写入实体对象，验证失败则将显示报错信息。
//get请求也能识别。
if ($form->isSubmitted() && $form->isValid()) { //表单验证
$em = $this->getDoctrine()->getManager();
$em->persist($post); //或者 $em->persist($form->getData());
$em->flush();

return $this->redirect($this->generateUrl(
'post_show',
array('id' => $post->getId())
));
} else { //渲染空表单
return $this->render('form.html.twig', array(
'form' => $form->createView(),
));
}
}
##################################################################

## 模板绘制表单 ##
/////////单行代码粗放绘制///////////
{{ form_start(form【, {'attr': {'class': 'blog-form'}}】) }}
{{ form_widget(form) }} <!-- 所有字段和表单报错 -->
<input type="submit" value="yes" class="btn" />
{{ form_end(form) }} <!-- CSRF Token及一些其他隐藏字段 -->
///////或者 表单控件行绘制////////
{{ form_start(form【, {'action': path('target_route'), 'method': 'GET'}】) }}
{{ form_errors(form) }} <!-- 表单的报错 -->
{{ form_row(form.title) }} <!-- title字段及其报错 -->
{{ form.vars.value.title }} <!-- 输出当前的title模板变量 -->
{{ form_end(form) }}
///////或者更细致的 表单字段绘制////////
{{ form_start(form) }}
{{ form_errors(form) }} <!-- 表单的报错 -->

<div> <!-- 这里的一个div相当于form_row -->
{{ form_label(form.dueDate【, '2015-10'】) }}  <!-- 可临时替换标签文本 -->
{{ form_errors(form.dueDate) }}
{{ form_widget(form.dueDate【,{'attr': {'class': 'dateclass'}}】) }}
{{ form.dueDate.vars.id }} <!-- 输出字段的某属性 -->
</div>
{{ form_widget(form.save) }}
{{ form_end(form) }}
##################################################################

## 控制器中读写表单字段 ##
$form->get('dueDate')->getData();
$form->get('dueDate')->setData(new \DateTime());

## 检测表单按钮点击 ##
$form->get('save')->isClicked(); //检测save按钮是否被点击

## 临时关闭客户端的required等校验功能 ##
{{ form(form, {'attr': {'novalidate': 'novalidate'}}) }}
或
submit按钮添加属性 'attr' => array('novalidate' => 'novalidate'),

## 表单字段配置 ##
$builder->add('名字', '类型', array(
'label'    =>    'yes',  #标签文字，false则不显示
'attr'     =>    array('class'=>'btn'),
'validation_groups' => false, # 适用于submit按钮
'required  =>    true, #前端html5实现字段必填
'mapped'   =>    false， #该字段不映射到实体， 比如是否同意勾选框，没有此设置，则抛异常：字段不存在于实体
))
表单字段类型:
文字类：text、textarea、email、integer、number、password、url
选择类：choice(下拉)
时间类：date、datetime、time
其他类：checkbox、radio、file
组框：collection
隐藏域：hidden
按钮类：button、reset、submit