Doctrine ORMとは？Symfonyにおける役割と基本概念を初心者向けに徹底解説
生徒
「Symfonyっていうフレームワークでデータベースとやりとりする方法がよく分からないです…」
先生
「SymfonyではDoctrine ORMという便利なツールを使って、データベースとやりとりできるようになっていますよ。」
生徒
「ドクトリン？ORM？難しそうな言葉が出てきました…」
先生
「大丈夫！一つずつわかりやすく説明していきますね。」
1. Doctrine ORMとは何か？
Doctrine ORM（ドクトリン・オーアールエム）は、PHPのフレームワークであるSymfony（シンフォニー）で使われるデータベース操作のためのツールです。「ORM」はObject Relational Mapping（オブジェクト関係マッピング）の略で、難しく聞こえますが、意味はとてもシンプルです。
例えば、「ノートに手書きで記録する代わりに、スマホのアプリで記録する」のと同じで、プログラムで直接データベースに命令を書く代わりに、Doctrineを通してやりとりするという仕組みです。
2. SymfonyとDoctrine ORMの関係
SymfonyはPHPで作られたWebアプリケーションの骨組み（フレームワーク）です。その中で、データベースとの通信を担当しているのがDoctrine ORMです。
Symfony単体ではデータベースに保存・読み込みする機能はありません。そこで、Doctrineという仕組みを使うことで、フォームから送信されたデータをデータベースに保存したり、一覧として表示したりできるようになります。
3. ORMとは？初心者向けのかんたんな説明
ORM（Object Relational Mapping）とは、プログラムの中の「オブジェクト」と、データベースの「表（テーブル）」をつなぐ橋渡しのようなものです。
たとえば、こんなイメージです。
- プログラムの中では「$user」という
ユーザーオブジェクトを使う - 実際のデータは「users」という名前の
テーブルに保存される - Doctrineが、その2つをつないでくれる
このおかげで、私たちはSQLという難しい言語をあまり使わずに、オブジェクトのような感覚でデータ操作ができるようになります。
4. Doctrineの基本用語を理解しよう
Doctrineを使うときに、よく出てくる用語を簡単に解説します。
- エンティティ（Entity）：データベースの1つのテーブルに対応するPHPのクラス。例えば「User」クラスがあれば、それは「users」テーブルに対応する。
- リポジトリ（Repository）：データの検索・取得を行う場所。
findやfindAllなどのメソッドを使う。 - マイグレーション（Migration）：テーブルの作成や変更を管理するしくみ。
5. Doctrineを使うときのイメージ
では、実際にどのようにDoctrine ORMを使うかを、初心者でも分かりやすいようにイメージで紹介します。
たとえば、以下のような「User（ユーザー）」というクラスを作ったとします。
use Doctrine\ORM\Mapping as ORM;
#[ORM\Entity]
class User
{
#[ORM\Id]
#[ORM\GeneratedValue]
#[ORM\Column]
private int $id;
#[ORM\Column(length: 100)]
private string $name;
// ... ゲッター・セッターなど
}
このようなクラスを作っておくことで、データベースと自動でつながる仕組みができます。
6. データを保存してみよう
実際に、ユーザー情報を保存する処理のイメージを見てみましょう。
$user = new User();
$user->setName('たろう');
$entityManager->persist($user);
$entityManager->flush();
$entityManager（エンティティマネージャ）というのは、データを管理する人のような存在で、persistで保存の準備をし、flushで実際にデータベースへ反映させます。
7. Doctrine ORMを使うメリット
SymfonyでDoctrine ORMを使うことで、次のようなメリットがあります。
- SQLを書かずにデータ操作できる：初心者でも使いやすい
- データの追加・更新・削除が簡単：短いコードで完結
- オブジェクト指向に沿った設計ができる：プログラムが整理されやすい
- セキュリティ上も安全にデータを扱える：入力値のエスケープなどが自動
8. よくある質問：SQLを書かなくても本当に大丈夫？
完全にSQLを書かないというわけではありませんが、基本的な操作はDoctrineが代わりにやってくれるので、初心者の方でもプログラムだけで完結することが多いです。
より細かい操作や複雑な条件を指定する場合は、Doctrine用のDQL（Doctrine Query Language）や、クエリビルダーという機能を使いますが、最初のうちは覚えなくても問題ありません。
9. Symfonyでの設定場所や使い方の流れ
DoctrineをSymfonyで使うには、以下の流れが一般的です。
- composerでDoctrineをインストール（Symfonyには最初から入っていることも多い）
.envファイルでデータベースの接続設定を書く- エンティティ（クラス）を作成する
- マイグレーションでテーブルを作成する
- エンティティマネージャを使って保存や検索を行う
これらの作業は、Symfonyのコマンドを使えば初心者でも簡単にできます。
