Symfony中加密字段的唯一性约束：策略与实践

<?php
// src/Entity/Foo.php
namespace App\Entity;

use Doctrine\ORM\Mapping as ORM;
use Symfony\Bridge\Doctrine\Validator\Constraints\UniqueEntity;
use App\Annotation\Encrypted; // 假设你的加密注解是这个

/**
 * @ORM\Entity(repositoryClass="App\Repository\FooRepository")
 * @UniqueEntity(
 *      fields={"emailHash"}, // 对哈希字段进行唯一性验证
 *      ignoreNull=true, // 允许null值（如果email字段可为空）
 *      message="此邮箱已被注册，请使用其他邮箱。"
 * )
 */
class Foo
{
    /**
     * @ORM\Id()
     * @ORM\GeneratedValue()
     * @ORM\Column(type="integer")
     */
    private $id;

    /**
     * @ORM\Column(type="string", length=255, nullable=true)
     * @Encrypted // 原始email字段被加密
     */
    private $email;

    /**
     * @ORM\Column(type="string", length=40, unique=true, nullable=true)
     * // emailHash 字段存储email的SHA1哈希值，并确保其在数据库层面也是唯一的
     */
    private $emailHash;

    public function getId(): ?int
    {
        return $this->id;
    }

    public function getEmail(): ?string
    {
        return $this->email;
    }

    public function setEmail(?string $email): self
    {
        $this->email = $email;
        // 在设置email时，同步更新emailHash
        // 使用类名作为盐，增加哈希的安全性，防止彩虹表攻击
        $this->emailHash = $email ? hash('sha1', $email . get_class($this)) : null;

        return $this;
    }

    public function getEmailHash(): ?string
    {
        return $this->emailHash;
    }

    // 注意：emailHash的setter不应该直接暴露，因为它应该由email的setter来控制
    // 如果需要，可以将其设为private或不提供setter
}

<?php
// src/Service/EncryptionService.php
namespace App\Service;

class EncryptionService
{
    // 这是一个简化的示例，实际的加密逻辑会更复杂
    public function encrypt(string $data): string
    {
        // 模拟加密过程，确保与@Encrypted注解使用的加密逻辑一致
        return base64_encode(strrev($data) . 'encrypted_salt');
    }

    public function decrypt(string $encryptedData): string
    {
        // 模拟解密过程
        $decoded = base64_decode($encryptedData);
        return strrev(str_replace('encrypted_salt', '', $decoded));
    }
}

<?php
// src/Repository/FooRepository.php
namespace App\Repository;

use App\Entity\Foo;
use Doctrine\Bundle\DoctrineBundle\Repository\ServiceEntityRepository;
use Doctrine\Persistence\ManagerRegistry;
use App\Service\EncryptionService; // 注入你的加密服务

class FooRepository extends ServiceEntityRepository
{
    private EncryptionService $encryptionService;

    public function __construct(ManagerRegistry $registry, EncryptionService $encryptionService)
    {
        parent::__construct($registry, Foo::class);
        $this->encryptionService = $encryptionService;
    }

    /**
     * 自定义方法，用于检查加密字段的唯一性。
     * 该方法会被UniqueEntity验证器调用。
     *
     * @param array $criteria 包含待验证字段及其值的数组 (例如 ['email' => 'test@example.com