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

生徒

「先生、Symfonyで『同じメールアドレスが登録されていたらエラーにしたい』ってことはできますか？」

先生

「できますよ。それはデータベースと連携した ユニークチェック を使います。」

生徒

「ユニークチェックってなんですか？」

先生

「あるデータがすでにデータベースに存在するか確認するチェックのことです。例えば同じメールアドレスがすでに登録済みなら『そのメールアドレスは使えません』とエラーを出すようにできますよ。」

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

Symfonyのバリデーションは、ユーザーが入力した値が正しいかどうかを確認する仕組みです。NotBlank（空白NG）や Email（メール形式チェック）など、基本的なルールが最初から用意されています。

さらに、SymfonyではDoctrine ORMという仕組みと連携することで、データベースと照らし合わせてチェックすることも可能です。今回はその中でもユニーク（重複禁止）バリデーションを取り上げます。

2. ユニークチェックとは？

ユニークチェックとは、「同じ値がすでにデータベースに登録されていないか」を確認するバリデーションです。

例えば、登録フォームで「すでに登録されているメールアドレス」を使おうとしたとき、「このメールアドレスはすでに使われています」と表示して、新たに登録できないようにすることができます。

3. Symfonyでユニークチェックを実装する準備

Symfonyでは、UniqueEntity というアノテーションを使って、データベースのユニークチェックが簡単に行えます。使い方はとてもシンプルです。

まず、エンティティクラス（データの設計図）にアノテーションを追加します。


use Symfony\Bridge\Doctrine\Validator\Constraints\UniqueEntity;
use Symfony\Component\Validator\Constraints as Assert;

#[UniqueEntity(fields: ['email'], message: 'このメールアドレスは既に登録されています')]
class User
{
    #[Assert\NotBlank]
    #[Assert\Email]
    private string $email;
}

ポイント解説：

UniqueEntity はクラス全体に対して使います。
fields にチェック対象のフィールド名（ここでは email）を指定します。
message はエラーメッセージです。

4. バリデーションの実行方法

フォームの送信後、Symfonyの ValidatorInterface を使ってバリデーションを実行します。ユニークチェックは、Doctrineのエンティティマネージャーと連携して、すでに保存されているデータと照らし合わせてチェックされます。


$errors = $validator->validate($user);
if (count($errors) > 0) {
    foreach ($errors as $error) {
        echo $error->getMessage();
    }
}

このようにすれば、「データベースに同じ値があるか」を自動でチェックしてくれます。

5. 他にも使える！ユニークチェックの活用例

ユニークチェックは メールアドレス 以外にも、以下のような場面で使われます。

ユーザーID（ログイン名）が重複しないように
商品のSKUコード（商品識別番号）が重複しないように
電話番号や社員番号などを一意に保つとき

複数のフィールドを組み合わせてユニークにすることも可能です。


#[UniqueEntity(fields: ['firstName', 'lastName'], message: '同じ名前の人はすでに存在します')]

これは「同じ苗字と名前の組み合わせが既に存在していたらエラーにする」という意味です。

6. データベース側でもユニーク制約を設定しよう

Symfony側のバリデーションだけでなく、データベースそのものにもユニーク制約を設けることで、より安全に重複を防げます。


#[ORM\Column(type: 'string', unique: true)]
private string $email;

ORM（オーアールエム）は、データベースとPHPのデータを自動でつなぐ仕組みのことです。unique: true を指定することで、DBレベルでも重複を禁止できます。

7. ユニークチェックの注意点

ユニークチェックは便利ですが、いくつか注意点があります。

更新時に自分自身の値とぶつかってエラーになることがあります。
その場合は、現在のIDを除外するようにロジックで工夫する必要があります。
トランザクションが重なった場合、タイミングによってはDB側の制約でエラーになることもあります。

実際のアプリケーションでは、フォームの確認画面や登録ボタンのダブルクリック防止なども合わせて対策すると安心です。

8. バリデーションエラーの表示

フォームでユニークエラーが起きた場合は、コントローラでエラーを取得して、テンプレートに渡せば表示できます。


return $this->render('user/register.html.twig', [
    'form' => $form->createView(),
    'errors' => $form->getErrors(true),
]);

テンプレート側で errors をループすれば、ユーザーにわかりやすいエラーメッセージを表示できます。

Symfonyでユニークチェックを実装する方法！データベース連携バリデーションを初心者向けに解説