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



你可能感兴趣的:(Symfony2 细节小计4)