SymfonyでValidatorサービスを直接使ってバリデーション！初心者でも安心の使い方ガイド
生徒
「Symfonyでバリデーションしたいんですが、エンティティを使わずに手軽にチェックする方法はありますか？」
先生
「SymfonyにはValidatorサービスという便利な機能があり、直接使ってデータをバリデーションすることができますよ。」
生徒
「それなら簡単に試せそうですね！どうやって使うのか教えてください！」
先生
「では、Validatorサービスを使ってバリデーションを行う方法を順番に説明していきましょう。」
1. SymfonyのValidatorサービスとは？
SymfonyのValidatorサービスは、エンティティなどのクラスに依存せず、シンプルな値でも直接バリデーションできる機能です。たとえば、入力フォームを使わないAPIなどでも、このサービスを使えば入力データが正しいかどうかを簡単に確認できます。
バリデーション（検証）とは、ユーザーから送られてきたデータに誤りがないかを確認する作業のことです。名前が空欄でないか、メールアドレスの形式が正しいかなどをチェックするのがバリデーションの役割です。
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（制約）とは？初心者でもわかる解説
上の例に出てきたNotBlankやEmailは、Symfonyのバリデーション制約（Constraint）です。これは「この条件を守ってください」というルールのようなものです。
NotBlank：空欄であってはいけないEmail：メールアドレス形式であるべきLength：文字数の長さを制限Regex：特定の文字の並び（正規表現）に一致している必要がある
Constraintは複数指定できるので、1つの値に対して複数のルールを適用することができます。
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. 実際の出力例を確認してみよう
もしパスワードが「abc」という短すぎる値だった場合、以下のようなエラーが返ってきます。
{
"status": "error",
"errors": [
"パスワードは8文字以上必要です。",
"パスワードは英数字のみで入力してください。"
]
}
このように、Validatorサービスを使うことで、非常に柔軟で分かりやすいバリデーションエラーが実現できます。
6. Validatorサービスはどんな場面で役立つ？
エンティティを使わない軽量なAPIや、ユーザー登録前の仮チェックなど、その場で手軽にデータを検証したいときに、Validatorサービスはとても便利です。
また、フォームバリデーションよりも柔軟に使えるため、細かい制御をしたいときや、非同期で検証を行うような場面でも活躍します。
7. バリデーション結果を加工して表示する方法
$violationsに入っている情報は、単にメッセージだけではありません。どのルールに違反したか、何行目で違反したかなど、詳細な情報も含まれています。
たとえば、キー付きの連想配列で出力したいときは次のようにできます。
foreach ($violations as $violation) {
$errors[$violation->getPropertyPath()] = $violation->getMessage();
}
これにより、どの項目に対するエラーかが明確になり、フロント側でのエラー表示も分かりやすくなります。
