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

生徒

「Symfonyでフォームを作ったんですが、この入力内容をデータベースに保存するにはどうしたらいいんですか？」

先生

「そのためには、フォームとエンティティを連携させる必要があります。エンティティというのは、データベースの1行1行を表す“データの型”のようなものです。」

生徒

「フォームに入力した情報が自動でエンティティに入るってことですか？」

先生

「その通り。Symfonyはフォームの値をエンティティに自動でマッピング（対応づけ）してくれる、とても便利な仕組みを持っています。」

1. フォームとエンティティの連携とは？初心者にわかりやすく解説

Symfonyのフォームは、単に入力欄を表示するだけではありません。エンティティと連携させることで、ユーザーが入力した情報をそのままデータとして保持し、データベースへ保存できるようになります。

例えば「ユーザー登録フォーム」を作るとき、フォームの入力項目とエンティティのプロパティ名が一致していれば、Symfonyが自動でデータをセットしてくれます。

初心者の方は「フォームとエンティティが紐づく」と聞くと難しく感じるかもしれませんが、イメージとしてはフォームは“入力用の紙”、エンティティは“保存用の箱”のようなものです。

2. FormTypeでエンティティを指定してフォームを作る方法

Symfonyのフォームとエンティティを連携させるポイントは、FormTypeにdata_classを指定することです。これによりフォーム入力値は自動的にエンティティへ入ります。


<?php
use Symfony\Component\Form\AbstractType;
use Symfony\Component\Form\FormBuilderInterface;
use Symfony\Component\OptionsResolver\OptionsResolver;
use Symfony\Component\Form\Extension\Core\Type\TextType;
use App\Entity\User;

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

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

data_class を設定すると、フォームの値が User エンティティの username や email プロパティに勝手にセットされるようになります。

3. コントローラでフォームとエンティティを紐づける流れ

次にコントローラでフォームを扱う部分を見てみましょう。ここでは、エンティティのインスタンスをつくり、フォームに渡します。


<?php
$user = new User();
$form = $this->createForm(UserType::class, $user);
$form->handleRequest($request);

フォームが送信されて handleRequest() が実行されると、入力されたいデータが $user に自動的に反映されます。

ここで重要なのは、フォームとエンティティをわざわざ手で対応させなくてもいいという点です。Symfonyがすべての処理をしてくれます。

4. エンティティへ保存する処理までの一連の流れ

フォーム送信後に入力データをデータベースへ保存するには、Doctrineの EntityManager を使います。


<?php
if ($form->isSubmitted() && $form->isValid()) {
    $entityManager = $this->getDoctrine()->getManager();
    $entityManager->persist($user);
    $entityManager->flush();
}

エンティティにデータが入っているので、persist() と flush() を呼ぶだけで保存が完了します。

つまり、フォーム → エンティティ → データベースという流れが自動化されているわけです。