Web 应用中, 对表单的验证是与生俱来的需求. Symfony 在这方面提供了非常好的支持. 简单易用.
关于表单验证这里, 和 Zend Framework 3 比起来, Symfony4 提供了更容易的实现方式. 通常在 Zend Framework 3 中, 表单验证工作通常都放在 Form 的创建阶段, 这方面和 Symfony4 有些区别, Symfony4 把验证工作可以直接对应到实体类声明中. 这样对简单表单应用就非常的容易和直观, 当然 Symfony4 也支持在 Form 创建的时候传递一个合约声明来约束验证表单输入的内容.
还是以用注册为例, 来实际使用了一下便捷的表单验证功能. 这里顺便说到 Symfony/Validator 非常的强大. 表单验证这里只是使用了小部分基础的功能.
我们对用户注册涉及到的实体类的属性 用户名 name, 注册邮箱 email, 用户密码 passwd 分别进行约束. 修改 src/Entity/User.php 代码, 看起来像这样:
<?php
namespace App\Entity;
use Doctrine\ORM\Mapping as ORM;
use Symfony\Component\Validator\Constraints as Assert;
/**
* @ORM\Entity(repositoryClass="App\Repository\UserRepository")
*/
class User
{
/**
* @ORM\Id()
* @ORM\GeneratedValue()
* @ORM\Column(type="integer")
*/
private $id;
/**
* 用户的注册邮箱验证:
* 1. 不能为空.
* 2. 使用内置的 Email 类型验证器.
*
* @Assert\NotBlank(
* message="Emaill address cannot be empty."
* )
*
* @Assert\Email(
* message = "This email is not a valid email address."
* )
*
* @ORM\Column(type="string", length=45)
*/
private $email = '';
/**
* 用户的密码验证:
* 1. 不允设置空密码
* 2. 密码长度在 4 - 12 个字符内
*
* @Assert\NotBlank(
* message="Password cannot be empty character."
* )
* @Assert\Length(
* min = 4,
* max = 12,
* minMessage = "Your password must be at least {{ limit }} characters long",
* maxMessage = "Your password cannot be longer than {{ limit }} characters"
* )
*
* @ORM\Column(type="string", length=32)
*/
private $passwd = '';
/**
* 用户名验证:
* 1. 用户名不能为空.
* 2. 用户名长度在 2 - 12 个字符内
*
* @Assert\NotBlank(
* message="Your name cannot be empty."
* )
* @Assert\Length(
* min = 2,
* max = 12,
* minMessage = "Your name must be at least {{ limit }} characters long",
* maxMessage = "Your name cannot be longer than {{ limit }} characters"
* )
* @ORM\Column(type="string", length=45)
*/
private $name = '';
//... other code
}
再稍微修改一下表单创建部分代码:
public function signUp(Request $request)
{
$user = new User();
$formBuilder = $this->createFormBuilder($user);
$formBuilder->add('name', TextType::class, ['empty_data' => '']);
$formBuilder->add('email', EmailType::class, ['empty_data' => '']);
$formBuilder->add('passwd', PasswordType::class, ['empty_data' => '']);
$formBuilder->add('save', SubmitType::class);
$form = $formBuilder->getForm();
//... other code
}
经过简单的设置, 表单就变的非常的安全了. symfony/validator 组件提供的内置验证器非常的多. 具体可以参考文档: Symfony Validation
看一下验证的效果截图:
什么都不填写时提交后表单效果
输入非法信息提交后表单效果
非常的简单, 方便.
