SymfonyのFormTypeとバリデーションの基本を徹底解説！初心者向けフォーム設計ガイド

1. FormTypeクラスとは？

1. FormTypeクラスとは？

Symfony（シンフォニー）のFormTypeクラスは、一言で言えば「フォームの構造と設定を一括管理する設計図」です。通常、Webサイトの入力フォームを作るにはHTMLで<input>タグなどを並べる必要がありますが、SymfonyではPHPコードを使ってスマートにフォームを組み立てます。

プログラミング未経験の方でもイメージしやすいように、簡単な「お問い合わせフォーム」の設計図を例に見てみましょう。

// これが「名前」と「メッセージ」を受け取るフォームの設計図です
$builder
    ->add('guest_name', TextType::class, [
        'label' => 'お名前',
        'attr' => ['placeholder' => '例：山田 太郎']
    ])
    ->add('message', TextareaType::class, [
        'label' => 'お問い合わせ内容'
    ]);

このようにFormTypeを利用すると、入力欄の種類（一行テキストなのか、長い文章なのか）や、画面に表示するラベル名を1箇所にまとめて定義できます。

最大のメリットは「再利用性」と「メンテナンス性」です。一度この設計図（FormType）を作っておけば、新規登録画面、編集画面、あるいは確認画面など、複数の場所で同じフォームを使い回すことができます。もし「電話番号の項目を追加したい」となった場合も、このFormTypeという設計図を1つ修正するだけで、全ての画面に反映されるため、ミスが少なく効率的な開発が可能になります。

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

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

バリデーションとは、フォームに入力された値が正しいかをチェックする処理です。例えば、「メールアドレスの形式が正しいか？」「必須項目が空欄になっていないか？」などの確認を行います。

Symfonyでは、このバリデーション処理をアノテーション（コメントのような命令）としてエンティティに記述することで、自動的にチェックしてくれます。

3. バリデーション対象のエンティティクラスを作る

3. バリデーション対象のエンティティクラスを作る

まず、バリデーション対象となるデータクラス（エンティティ）を作成します。以下のように、Assertというアノテーションを使って制限を追加します。

namespace App\Entity;

use Symfony\Component\Validator\Constraints as Assert;

class Contact
{
    #[Assert\NotBlank(message: "名前を入力してください。")]
    public string $name;

    #[Assert\NotBlank(message: "メールアドレスを入力してください。")]
    #[Assert\Email(message: "正しいメールアドレス形式で入力してください。")]
    public string $email;
}

NotBlankは空欄チェック、Emailはメール形式のチェックです。

4. FormTypeでフォーム構造を定義する

4. FormTypeでフォーム構造を定義する

次に、フォーム構造を定義するFormTypeクラスを作成します。ここで、先ほどのエンティティと連携させます。

namespace App\Form;

use App\Entity\Contact;
use Symfony\Component\Form\AbstractType;
use Symfony\Component\Form\FormBuilderInterface;
use Symfony\Component\OptionsResolver\OptionsResolver;
use Symfony\Component\Form\Extension\Core\Type\TextType;
use Symfony\Component\Form\Extension\Core\Type\EmailType;

class ContactType extends AbstractType
{
    public function buildForm(FormBuilderInterface $builder, array $options): void
    {
        $builder
            ->add('name', TextType::class)
            ->add('email', EmailType::class);
    }

    public function configureOptions(OptionsResolver $resolver): void
    {
        $resolver->setDefaults([
            'data_class' => Contact::class,
        ]);
    }
}

TextTypeはテキスト入力、EmailTypeはメール用の入力欄を作成します。

5. コントローラでフォームを表示して処理する

5. コントローラでフォームを表示して処理する

実際にフォームを表示し、送信されたデータをチェックする処理をコントローラに記述します。

use Symfony\Bundle\FrameworkBundle\Controller\AbstractController;
use Symfony\Component\HttpFoundation\Request;
use Symfony\Component\HttpFoundation\Response;
use App\Form\ContactType;
use App\Entity\Contact;

class ContactController extends AbstractController
{
    public function contact(Request $request): Response
    {
        $contact = new Contact();
        $form = $this->createForm(ContactType::class, $contact);
        $form->handleRequest($request);

        if ($form->isSubmitted() && $form->isValid()) {
            // 正常にバリデーションを通過したときの処理
            return $this->redirectToRoute('success_page');
        }

        return $this->render('contact/form.html.twig', [
            'form' => $form->createView(),
        ]);
    }
}

isSubmitted()で送信されたかを確認し、isValid()でバリデーションが通ったかどうかを判定します。

6. Twigテンプレートでフォームを表示する

6. Twigテンプレートでフォームを表示する

最後に、Twigテンプレートを使ってフォームを表示します。SymfonyのFormTypeと連携することで、フォームの見た目も整えられます。

{{ form_start(form) }}
    {{ form_row(form.name) }}
    {{ form_row(form.email) }}
    <button type="submit">送信</button>
{{ form_end(form) }}

バリデーションエラーがあった場合は、自動的にエラーメッセージが表示されます。

7. Symfonyのバリデーションの強みとは？

7. Symfonyのバリデーションの強みとは？

Symfonyのバリデーションは、エンティティ＋FormType＋コントローラ＋Twigが一体となって動作することで、再利用性の高い、安全なフォーム処理が実現できます。HTMLを自力で書くよりも、エラー処理やセキュリティ（CSRFトークン）も自動化されており、安全かつ便利です。

また、バリデーションルールを1か所（エンティティ）にまとめられるので、大規模なアプリケーションでも管理しやすくなります。