验证约束
打开注解约束的配置:
# 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