[042] Symfony4 表单入门 Part02

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

看一下验证的效果截图:

什么都不填写时提交后表单效果 输入非法信息提交后表单效果

非常的简单, 方便.