Symfony Validator 組件深度解析：約束規則、配置方式、表單集成與分組驗證

基於 JSR-303 規範的強大驗證組件

Symfony Validator 獨立於表單，可驗證任意 PHP 對象。核心：約束 定義規則，驗證器 執行檢查。

基本用法

// 實體類
use Symfony\Component\Validator\Constraints as Assert;

class Author {
    /** @Assert\NotBlank() */
    public $name;
}

// 控制器中驗證
$author = new Author();
$validator = $this->get('validator');
$errors = $validator->validate($author);
if (count($errors) > 0) {
    // 處理錯誤
}

四種配置格式

• Annotations（推薦）：直接在屬性上標註 @Assert\NotBlank()，需在 config.yml 開啟 enable_annotations: true。
• YAML：validation.yml 映射類與約束。
• XML：validation.xml 結構化定義。
• PHP：靜態方法 loadValidatorMetadata(ClassMetadata $metadata) 程序化構建。

常用約束分類

約束目標：屬性 vs Getter

• 屬性：直接標註 private $firstName，支持 public/protected/private。
• Getter：標註 public function isPasswordLegal()，驗證動態邏輯（如密碼不等於名字）。

驗證分組

同一類不同場景用不同規則：

/** @Assert\Email(groups={"registration"}) */
private $email;
/** @Assert\NotBlank(groups={"registration"}) */
private $password;
// city 無分組，屬於 Default 組

// 驗證時指定組
$errors = $validator->validate($user, ['registration']);

單值驗證

$emailConstraint = new Email();
$emailConstraint->message = 'Invalid email';
$errors = $this->get('validator')->validateValue($email, $emailConstraint);

表單集成

表單組件內部自動調用驗證器，違規轉為 FormError 附加到字段，控制器只需判斷 $form->isValid()。

總結

Validator 組件靈活、可復用，掌握約束配置、分組、Getter 驗證、單值驗證，即可應對複雜業務校驗場景。