Symfony 2およびDoctrine 2

Symfony 2の研究を続け、これは最もよくある質問の1つであるため、Doctrine 2とともにフレームワークの使用について説明することにしました。 そして、Doctrine 2も1.xブランチと比較して大きな変更を受けていることは注目に値します。 Doctrineプロジェクト自体は非常に大きいので、その説明はおそらく小さいながらも興味深い本になります。 したがって、Symfony 2でDoctrine 2を使用する例を非常に簡単に説明します。これにより、このバンドルの実行方法を理解でき、非常に小さくシンプルなアプリケーションの例を使用してこれを実行できます。

Doctrine 2について

始めに、Doctrine 2についての簡単な紹介を行います。プロジェクトは現在3つのパッケージに分割されています。

• 共通
• DBAL
• ORM

共通 -他のパッケージで使用される共通コンポーネントが含まれています。

DBAL-データベースアクセス抽象化レイヤー。

ORM-オブジェクトリレーショナルマッピングツール



Doctrine 2には、以前の* Tableおよび* Recordクラスになじみのあるものはありません。 また、モデルクラスがレコードクラスを継承する必要がなくなり、テーブルクラスがDoctrineパッケージからテーブルクラスを継承することも意味します。 代わりに、2つの新しい概念、EntityとEntityManagerが導入されています。 エンティティは、大まかに言って、モデルのオブジェクトであり、EntityManagerは、エンティティオブジェクトをそれぞれ管理できるクラスです。 おもしろいことは、「Entity」は任意のPHPクラスであり、Doctrineパッケージからクラスを継承しないことです。



Doctrine 1では、モデルはYamlファイルで記述されていましたが、現在はYaml、XML、またはDocblockアノテーションを使用できます。 おそらく、PHPDocumentorでメソッドを記述するために、だれでも何らかの形でDocblockアノテーションを使用する必要がありました。 そのため、永続オブジェクトのメタデータを記述することもできます。

例：

Copy Source | Copy HTML <?php /** <br/> * @Entity <br/> * @Table(name="my_model") <br/> */ class MyModel { /** <br/> * @Id @Column(name="id", type="integer") <br/> * @GeneratedValue(strategy="AUTO") <br/> */ private $id ; /** <br/> * @Column(name="title", type="string", length=255) <br/> */ private $title ; }

1. Copy Source | Copy HTML <?php /** <br/> * @Entity <br/> * @Table(name="my_model") <br/> */ class MyModel { /** <br/> * @Id @Column(name="id", type="integer") <br/> * @GeneratedValue(strategy="AUTO") <br/> */ private $id ; /** <br/> * @Column(name="title", type="string", length=255) <br/> */ private $title ; }
   
   
   
   
3. Copy Source | Copy HTML <?php /** <br/> * @Entity <br/> * @Table(name="my_model") <br/> */ class MyModel { /** <br/> * @Id @Column(name="id", type="integer") <br/> * @GeneratedValue(strategy="AUTO") <br/> */ private $id ; /** <br/> * @Column(name="title", type="string", length=255) <br/> */ private $title ; }
   
   
   
   
4. Copy Source | Copy HTML <?php /** <br/> * @Entity <br/> * @Table(name="my_model") <br/> */ class MyModel { /** <br/> * @Id @Column(name="id", type="integer") <br/> * @GeneratedValue(strategy="AUTO") <br/> */ private $id ; /** <br/> * @Column(name="title", type="string", length=255) <br/> */ private $title ; }
   
   
   
   
5. Copy Source | Copy HTML <?php /** <br/> * @Entity <br/> * @Table(name="my_model") <br/> */ class MyModel { /** <br/> * @Id @Column(name="id", type="integer") <br/> * @GeneratedValue(strategy="AUTO") <br/> */ private $id ; /** <br/> * @Column(name="title", type="string", length=255) <br/> */ private $title ; }
   
   
   
   
6. Copy Source | Copy HTML <?php /** <br/> * @Entity <br/> * @Table(name="my_model") <br/> */ class MyModel { /** <br/> * @Id @Column(name="id", type="integer") <br/> * @GeneratedValue(strategy="AUTO") <br/> */ private $id ; /** <br/> * @Column(name="title", type="string", length=255) <br/> */ private $title ; }
   
   
   
   
7. Copy Source | Copy HTML <?php /** <br/> * @Entity <br/> * @Table(name="my_model") <br/> */ class MyModel { /** <br/> * @Id @Column(name="id", type="integer") <br/> * @GeneratedValue(strategy="AUTO") <br/> */ private $id ; /** <br/> * @Column(name="title", type="string", length=255) <br/> */ private $title ; }
   
   
   
   
9. Copy Source | Copy HTML <?php /** <br/> * @Entity <br/> * @Table(name="my_model") <br/> */ class MyModel { /** <br/> * @Id @Column(name="id", type="integer") <br/> * @GeneratedValue(strategy="AUTO") <br/> */ private $id ; /** <br/> * @Column(name="title", type="string", length=255) <br/> */ private $title ; }
   
   
   
   
10. Copy Source | Copy HTML <?php /** <br/> * @Entity <br/> * @Table(name="my_model") <br/> */ class MyModel { /** <br/> * @Id @Column(name="id", type="integer") <br/> * @GeneratedValue(strategy="AUTO") <br/> */ private $id ; /** <br/> * @Column(name="title", type="string", length=255) <br/> */ private $title ; }
    
    
    
    
11. Copy Source | Copy HTML <?php /** <br/> * @Entity <br/> * @Table(name="my_model") <br/> */ class MyModel { /** <br/> * @Id @Column(name="id", type="integer") <br/> * @GeneratedValue(strategy="AUTO") <br/> */ private $id ; /** <br/> * @Column(name="title", type="string", length=255) <br/> */ private $title ; }
    
    
    
    

そしてもちろん、あなたはDoctrineのウェブサイトでこれらすべてについてもっと読むことができます

離陸

非常に小さくて非常にシンプルなアプリケーションの例として、Doctrine 2の使用を検討することにしました。 これはReadlaterサービスになり、リンクを保存して後で読むまで延期することができます。 つまり、すべての機能が3つの単純なアクションに削減されます。

• リストリンク
• リンクを追加
• リンクを削除

しかし、私はすぐに小さな問題に遭遇しました-Doctrine 2とSymfony 2の両方が現在活発に開発されており、安定性の問題はありません。 さらに、すべてが非常に頻繁に変化し、今日動作するものは明日は離陸しないかもしれません。 多くの場合、これらはコードを別のディレクトリに移動するなど、さまざまな小さなものです。 したがって、このアプリケーションでは、使用するライブラリのバージョンを凍結することにしました。 このために、私は取りました：

• symfony-sandbox ：すべてが建設中だったサンドボックス
• symfony ：Jonathan Wage開発者Doctrineによるsymfonyのフォーク
• 教義の移行 ：移行
• 教義 ：トランクの教義

これらすべてをまとめて、2010年4月18日にすべてのバージョンを元の形式に固定し、アプリケーションと一緒にgithubで共有しました。 あなたが興味を持っているのであれば、それのために行きます。

飛んだ

したがって、最初は構造について簡単に説明します。 この種類のディレクトリについて：

• readlater ：-アプリケーションディレクトリ
• src
  • アプリケーション ：-ここでは、「バンドル」ReadlaterBundleが存在し、一般的にそこにコーディングします。
  • バンドル ：-この場合は空です
  • ベンダー ：-ここにフレームワークとすべてのライブラリがあります

構成から始めましょう。 readlater / config / config.ymlに以下を追加します：

Copy Source | Copy HTML

1. カーネル。 構成 ：〜
2. ウェブ ウェブ ：〜
3. ウェブ テンプレート化 ：〜
4. 教義。 dbal ：
5. default_connection ： デフォルト
6. 接続 ：
7. デフォルト ：
8. ドライバー ：PDOMySql
9. dbname ：sfbox2
10. ユーザー ：ルート
11. パスワード ： 123
12. ホスト ：localhost
13. event_manager_class ：Doctrine \ Common \ EventManager
14. configuration_class ：Doctrine \ DBAL \設定
16. 教義。 orm ：
17. default_entity_manager ： デフォルト
18. cache_driver ：配列
19. entity_managers ：
20. デフォルト ：
21. 接続 ： デフォルト

doctrine.dbalデータベースへの接続と、Doctrine \ ORMパッケージdoctrine.ormの設定について説明しました

ここではアプリケーションコアの作成については説明しません。symfony-sandboxで行われるものと実質的に変わらないからです。

したがって、 src / Applicationに配置したReadlaterBundleに進み ます 。 バンドルの構造は次のとおりです。

• コントローラー ：-ここにコントローラーがあります
• エンティティ ：-ここにエンティティ、モデルクラスがあります
• 資源
  • config ：-ここでの設定
  • ビュー ：-ここにテンプレートがあります

エンティティディレクトリでは、これ以上必要ないため、単一のLinkクラスを作成します。 Doctrine 2はデフォルトでバンドルエンティティディレクトリにエンティティを作成することを提案します。つまり、各バンドルは独自のモデルクラスのセットを持つことができます。 設定として、DoctrineにEntities以外のディレクトリでクラスを検索するように依頼できますが、私はこれを行いません。

Linkクラスのコードは次のとおりです。

Copy Source | Copy HTML

1. <？php
3. 名前空間 Application \ ReadlaterBundle \ Entities;
4. Doctrine \ ORM \ EntityRepositoryを使用します。
6. / ** <br/> * @Entity <br/> * @Table（name = "readlater_link"） <br/> * /
7. クラスリンク
8. {
9. / ** <br/> * @Id @Column（name = "id"、type = "integer"） <br/> * @GeneratedValue（strategy = "AUTO"） <br/> * /
10. プライベート $ id ;
12. / ** <br/> * @Column（name = "url"、type = "string"、length = 255） <br/> * /
13. プライベート $ url ;
15. / ** <br/> * @Column（name = "created_at"、type = "datetime"） <br/> * /
16. private $ createdAt ;
18. / ** <br/> *コンストラクター <br/> * /
19. パブリック関数 __construct（）
20. {
21. $ this-> createdAt = new \ DateTime （）;
22. }
24. / ** <br/> *文字列 <br/>へ* /
25. パブリック関数 __toString（）
26. {
27. return $ this-> getUrl（）;
28. }
29. }

クラスで3つのフィールドを定義しました。

• $ id-識別子
• $ url-リンクのURL
• $ createdAt-追加日

また、すでに明確な2つのメソッドも追加しました。 例からわかるように、Docblockを使用してモデルを説明しました。

いくつかのコマンドを実行しました：



readlater/console doctrine:database:create

readlater/console doctrine:generate:entities

readlater/console doctrine:schema:create







最初のチームはデータベースを作成し、2番目はクラスのメソッドを生成して作業を行い、3番目はデータベースにテーブルを作成します。

次のようになります。







Linkクラスを調べると、少し変更されていることがわかりますが、次のようになります。

Copy Source | Copy HTML

1. <？php
3. 名前空間 Application \ ReadlaterBundle \ Entities;
4. Doctrine \ ORM \ EntityRepositoryを使用します。
6. / ** <br/> * @Entity <br/> * @Table（name = "readlater_link"） <br/> * /
7. クラスリンク
8. {
9. / ** <br/> * @Id @Column（name = "id"、type = "integer"） <br/> * @GeneratedValue（strategy = "AUTO"） <br/> * /
10. プライベート $ id ;
12. / ** <br/> * @Column（name = "url"、type = "string"、length = 255） <br/> * /
13. プライベート $ url ;
15. / ** <br/> * @Column（name = "created_at"、type = "datetime"） <br/> * /
16. private $ createdAt ;
18. / ** <br/> *コンストラクター <br/> * /
19. パブリック関数 __construct（）
20. {
21. $ this-> createdAt = new \ DateTime （）;
22. }
24. / ** <br/> *文字列 <br/>へ* /
25. パブリック関数 __toString（）
26. {
27. return $ this-> getUrl（）;
28. }
29. / ** <br/> * Get id <br/> * <br/> * @return integer $ id <br/> * /
30. パブリック関数 getId（）
31. {
32. $ this-> id;
33. }
35. / ** <br/> * URLを設定 <br/> * <br/> * @param string $ url <br/> * /
36. パブリック関数 setUrl（ $ url ）
37. {
38. $ this-> url = $ url ;
39. }
41. / ** <br/> * URLを取得 <br/> * <br/> * @return string $ url <br/> * /
42. パブリック関数 getUrl（）
43. {
44. return $ this-> url;
45. }
47. / ** <br/> *セットCreateAt <br/> * <br/> * @param datetime $ createdAt <br/> * /
48. パブリック関数 setCreatedAt（ $ createdAt ）
49. {
50. $ this-> createdAt = $ createdAt ;
51. }
53. / ** <br/> * Get CreateAt <br/> * <br/> * @return datetime $ createdAt <br/> * /
54. パブリック関数 getCreatedAt（）
55. {
56. return $ this-> createdAt;
57. }
59. }

クラスプロパティにアクセスするためのメソッドを導入しました。



ルーティングルールをrouting.ymlに追加します

Copy Source | Copy HTML

1. link_list ：
2. パターン ：/
3. デフォルト ： { _bundle ：ReadlaterBundle、 _controller ：Readlater、 _action ：index }
5. add_link ：
6. パターン ：/追加
7. デフォルト ： { _bundle ：ReadlaterBundle、 _controller ：Readlater、 _action ：add }
9. read_link ：
10. パターン ：/読み取り/：id
11. デフォルト ： { _bundle ：ReadlaterBundle、 _controller ：Readlater、 _action ：read }

コードから、すべてが明確であると思います。リスト、追加、削除の3つのルールがあります。



最後に、Doctrineを実行しているオブジェクトを操作する方法を確認できるコントローラーです。 コード全体をすぐに引用します。

Copy Source | Copy HTML

1. <？php
3. 名前空間 Application \ ReadlaterBundle \ Controller;
5. Symfony \ Framework \ WebBundle \ Controllerを使用し、
6. アプリケーション\ ReadlaterBundle \エンティティ\リンク、
7. Doctrine \ ORM \ QueryBuilder;
9. ReadlaterController クラス は Controllerを拡張します
10. {
11. パブリック関数 indexAction（）
12. {
13. $ em = $ this-> container-> getDoctrine_ORM_EntityManagerService（）;
15. $ links = $ em-> getRepository（ 'Application \\ ReadlaterBundle \ Entities \ Link' ）-> findAll（）;
16. return $ this- > render（ 'ReadlaterBundle：Readlater：index' 、 array （ 'links' => $ links ））;
17. }
19. パブリック関数 addAction（）
20. {
21. $ request = $ this-> getRequest（）;
23. $ url = $ request-> request-> get（ 'link' ）;
24. $ link = new Link（）;
25. $ link-> setUrl（ $ url ）;
27. $ em = $ this-> container-> getDoctrine_ORM_EntityManagerService（）;
28. $ em- > persist（ $ link ）;
29. $ em- > flush（）;
31. return $ this- > redirect（ $ this- > generateUrl（ 'link_list' ））;
32. }
34. パブリック関数 readAction（ $ id ）
35. {
36. $ em = $ this-> container-> getDoctrine_ORM_EntityManagerService（）;
38. $ link = $ em- > find（ 'Application \\ ReadlaterBundle \\ Entities \\ Link' 、 $ id ）;
39. $ em- > remove（ $ link ）;
41. $ em- > flush（）;
43. return $ this- > redirect（ $ this- > generateUrl（ 'link_list' ））;
44. }
45. }

コードに関するいくつかの言葉。

$em = $this->container->getDoctrine_ORM_EntityManagerService();



したがって、DIコンテナを使用して、 EntityManagerにアクセスします

$em->getRepository()



-これは特定のタイプのオブジェクト、つまり何らかのアナログのオブジェクトのストレージを取得する方法です* Doctrine 1.xのテーブル。

$em->persist($link);



-オブジェクトを保存します

$em->flush()



トランザクションを完了します。つまり、実際にデータベースにデータを送信します。

$em->remove($link)



- $em->remove($link)



、オブジェクトを削除してください。

ところで、 Symfony \ Framework \ DoctrineBundle \ Controller \ DoctrineControllerからコントローラーを継承した場合、メソッドは利用可能になります：

• getDatabaseConnection-データベース接続オブジェクトを返します
• getEntityManager -DI Container'aから取得する必要はありません
• createQueryBuilder
• createQuery

これがコードのすべてです。残りは明らかだと思います。



しかし、おそらくテーブルクラスがない場合、モデルオブジェクトを抽出するためのメソッドをどこで作成するかという疑問が生じました。 たとえば、この場合、 findAllメソッドが、降順で追加された日付でソートされたオブジェクトのリストを取得すると便利です。 これを行うには、特定のタイプのオブジェクト用に独自のストレージリポジトリクラスを作成します。

これを行うには、 Linkクラスを開き、ファイルの最後に追加します。

Copy Source | Copy HTML

1. / ** <br/> * LinkRepository <br/> * /
2. クラス LinkRepository は EntityRepositoryを拡張します
3. {
4. パブリック関数 findAll（）
5. {
6. return $ this- > _ em-> createQuery（ 'SELECT l FROM Application \\ ReadlaterBundle \\ Entities \\ Link l ORDER BY l.createdAt DESC' ）-> getResult（）;
7. }
8. }

これがリポジトリになります。

ここで、 Linkクラスに使用するリポジトリを考えてみましょう。このため、 LinkクラスのDocblockをわずかに変更します

Copy Source | Copy HTML

1. / ** <br/> * @Entity（repositoryClass = "Application \ ReadlaterBundle \ Entities \ LinkRepository"） <br/> * @Table（name = "readlater_link"） <br/> * /
2. クラスリンク
3. {
4. // ...
5. }

それは基本的にそれです。 これで、リンクのリストは正しい順序でソートされ、次のようになります。





テンプレートコードは引用しませんでしたが、これらはすべてgithubのソースコードで確認できます

関連リンクも：

• Doctrine 2ドキュメント
• Symfony 2ドキュメント