先生と生徒の会話形式で理解しよう

生徒

「先生、Symfonyで入力チェックをしたいんですが、条件によってバリデーションの内容を変えることってできますか？」

先生

「はい、Symfonyでは groups という仕組みを使えば、特定の条件のときだけバリデーションを実行することができますよ。」

生徒

「それって難しそうですね…初心者でもわかりますか？」

先生

「大丈夫ですよ。まずは簡単な例から一緒に学んでいきましょう。」

1. バリデーションとは？

バリデーションとは、ユーザーが入力したデータが正しいかどうかを確認する仕組みです。たとえば、メールアドレスの形式が正しいか、名前が空欄でないかなどをチェックします。

Symfonyでは、アノテーション（クラスやプロパティの上に書くメモのような記述）を使って簡単にバリデーションルールを定義できます。

2. 条件付きバリデーションとは？

条件付きバリデーションとは、「ある条件のときだけこのルールをチェックする」といったように、状況によってバリデーションの内容を切り替えることができる仕組みです。

たとえば、「登録フォームでは電話番号を必須にしないけど、お問い合わせフォームでは必須にしたい」というようなケースに使います。

3. groupsの基本的な使い方

Symfonyでは、Validation groups（バリデーショングループ）という機能を使って、条件ごとにチェック内容を切り替えることができます。

以下の例では、「Default」グループと「contact」グループを使って、バリデーションルールを分けています。


use Symfony\Component\Validator\Constraints as Assert;

class User
{
    /**
     * @Assert\NotBlank(groups={"Default"})
     */
    private $name;

    /**
     * @Assert\NotBlank(groups={"contact"})
     */
    private $phone;
}

解説：

name は通常の操作（Defaultグループ）で必須
phone はお問い合わせのとき（contactグループ）だけ必須

4. 実際にバリデーションをかけてみよう

Symfonyでバリデーションを実行するときには、ValidatorInterfaceを使います。どのグループでチェックするかを指定することで、条件付きバリデーションが可能になります。


use Symfony\Component\Validator\Validator\ValidatorInterface;

$user = new User();
$user->name = '太郎';
$user->phone = '';

$errors = $validator->validate($user, null, ['contact']);

if (count($errors) > 0) {
    echo 'バリデーションエラーがあります';
}

ポイント：

第三引数に ['contact'] を渡すことで、「contact」グループのルールが適用されます。
「Default」グループを使う場合は、nullか省略でもOKです。

5. 複数のグループを組み合わせる方法

グループは複数組み合わせてバリデーションすることもできます。たとえば、「通常のチェック + 特別なチェック」を同時に実行したい場合に使います。


$errors = $validator->validate($user, null, ['Default', 'contact']);

これで、通常の入力チェックに加えて、「お問い合わせ用」のルールも一緒に確認できます。

6. フォームごとにグループを切り替える実例

バリデーションはフォームごとに違う内容にしたいことが多いです。たとえば、「会員登録フォーム」と「お問い合わせフォーム」で、バリデーションルールが違う場合は、以下のようにします。

まず、エンティティ側でグループを設定します。


/**
 * @Assert\NotBlank(groups={"register"})
 */
private $email;

/**
 * @Assert\Email(groups={"register", "contact"})
 */
private $email;

次に、フォームの処理側で、使用するグループを明示します。


$validator->validate($user, null, ['register']);

これにより、「登録時には必須」「問い合わせ時にはメール形式だけチェック」といった使い分けができます。

7. グループシーケンスで順番にチェックもできる

Symfonyでは、GroupSequenceという機能を使って、バリデーショングループの実行順序を指定できます。


use Symfony\Component\Validator\Constraints\GroupSequence;

/** @Entity
 * @Assert\GroupSequence({"Default", "contact"})
 */
class User { ... }

このように設定すると、まず「Default」グループがチェックされ、そこでエラーがなければ「contact」グループがチェックされます。

8. どんなときに使うの？

条件付きバリデーションは、以下のようなときにとても便利です。

登録・更新・削除など操作によってチェック内容を変えたいとき
管理画面と一般ユーザーで異なるチェックをしたいとき
同じエンティティを複数のフォームで使いたいとき

Symfonyのバリデーショングループを使うことで、柔軟な入力チェックが実現でき、ユーザーの入力ミスを防ぎやすくなります。

Symfonyで条件付きバリデーションを実装する方法！初心者向けにgroupsの使い方を解説