SymfonyでValidatorサービスを直接使ってバリデーション！初心者でも安心の使い方ガイド

1. SymfonyのValidatorサービスとは？

1. SymfonyのValidatorサービスとは？

SymfonyのValidatorサービスは、エンティティなどのクラスに依存せず、シンプルな値でも直接バリデーションできる機能です。たとえば、入力フォームを使わないAPIなどでも、このサービスを使えば入力データが正しいかどうかを簡単に確認できます。

バリデーション（検証）とは、ユーザーから送られてきたデータに誤りがないかを確認する作業のことです。名前が空欄でないか、メールアドレスの形式が正しいかなどをチェックするのがバリデーションの役割です。

2. Validatorサービスをコントローラ内で使ってみよう

2. Validatorサービスをコントローラ内で使ってみよう

Symfonyでは、コントローラの中でValidatorInterfaceを使うことで、データのバリデーションが行えます。以下は簡単な使用例です。

use Symfony\Component\Validator\Constraints as Assert;
use Symfony\Component\Validator\Validator\ValidatorInterface;
use Symfony\Component\HttpFoundation\JsonResponse;

public function checkEmail(ValidatorInterface $validator): JsonResponse
{
    $email = 'test@example'; // メールアドレスが不完全

    $violations = $validator->validate($email, [
        new Assert\NotBlank(['message' => 'メールアドレスを入力してください。']),
        new Assert\Email(['message' => '有効なメールアドレス形式で入力してください。']),
    ]);

    if (count($violations) > 0) {
        $messages = [];
        foreach ($violations as $violation) {
            $messages[] = $violation->getMessage();
        }

        return new JsonResponse([
            'status' => 'error',
            'errors' => $messages,
        ], 400);
    }

    return new JsonResponse(['status' => 'ok']);
}

validateメソッドで、チェック対象の値（この例ではメールアドレス）と、使いたいバリデーションルールを配列で渡します。すると、ルールに合わない部分があれば、それが$violationsに入ります。

3. Constraint（制約）とは？初心者でもわかる解説

3. Constraint（制約）とは？初心者でもわかる解説

上の例に出てきたNotBlankやEmailは、Symfonyのバリデーション制約（Constraint）です。これは「この条件を守ってください」というルールのようなものです。

• NotBlank：空欄であってはいけない
• Email：メールアドレス形式であるべき
• Length：文字数の長さを制限
• Regex：特定の文字の並び（正規表現）に一致している必要がある

Constraintは複数指定できるので、1つの値に対して複数のルールを適用することができます。

4. 文字数や形式をチェックする例も見てみよう

4. 文字数や形式をチェックする例も見てみよう

例えば、パスワードが8文字以上で、英数字のみという条件をバリデーションしたい場合は、次のようにします。

$password = 'abc'; // 短すぎるし英数字だけでもない

$violations = $validator->validate($password, [
    new Assert\NotBlank(['message' => 'パスワードを入力してください。']),
    new Assert\Length([
        'min' => 8,
        'minMessage' => 'パスワードは8文字以上必要です。',
    ]),
    new Assert\Regex([
        'pattern' => '/^[a-zA-Z0-9]+$/',
        'message' => 'パスワードは英数字のみで入力してください。',
    ]),
]);

これで、空欄、文字数、形式をまとめてチェックできるようになります。

5. 実際の出力例を確認してみよう

5. 実際の出力例を確認してみよう

もしパスワードが「abc」という短すぎる値だった場合、以下のようなエラーが返ってきます。

{
  "status": "error",
  "errors": [
    "パスワードは8文字以上必要です。",
    "パスワードは英数字のみで入力してください。"
  ]
}

このように、Validatorサービスを使うことで、非常に柔軟で分かりやすいバリデーションエラーが実現できます。

6. Validatorサービスはどんな場面で役立つ？

6. Validatorサービスはどんな場面で役立つ？

エンティティを使わない軽量なAPIや、ユーザー登録前の仮チェックなど、その場で手軽にデータを検証したいときに、Validatorサービスはとても便利です。

また、フォームバリデーションよりも柔軟に使えるため、細かい制御をしたいときや、非同期で検証を行うような場面でも活躍します。

7. バリデーション結果を加工して表示する方法

7. バリデーション結果を加工して表示する方法

$violationsに入っている情報は、単にメッセージだけではありません。どのルールに違反したか、何行目で違反したかなど、詳細な情報も含まれています。

たとえば、キー付きの連想配列で出力したいときは次のようにできます。

foreach ($violations as $violation) {
    $errors[$violation->getPropertyPath()] = $violation->getMessage();
}

これにより、どの項目に対するエラーかが明確になり、フロント側でのエラー表示も分かりやすくなります。