Symfony2でAnnotationを書くときの注意

Symfony2で、EntityなどをAnnotationで手書きする際、

/*
 * @var string $name
 *
 * @ORM¥Column(name="name", type="string", length=255)
 */
private $name;

これは反映されません。

/**
 * @var string $name
 *
 * @ORM¥Column(name="name", type="string", length=255)
 */
private $name;

これは反映されます。

違いは、コメントが「/**」で始まっているか「/*」で始まっているか、です。「/**」が正解です。

RefectionClass::getDocComment()の仕様らしいですが、手書きするときは気をつけましょう。