php - Doctrine で注釈エントリを「コメントアウト」する方法

Question

Doctrine の注釈を含む PHPDoc コメントを持つ次のプロパティがあるとします。

/**
 * @ORM\Column(name="id", type="integer")
 * @ORM\Id
 * @ORM\GeneratedValue(strategy="AUTO")
 */
private $id;

注釈行の 1 つを「コメントアウト」する最良の方法は何ですか? たとえば、次のようなものです。

/**
 * @ORM\Column(name="id", type="integer")
 * @ORM\Id
 * //Comment out please// @ORM\GeneratedValue(strategy="AUTO")
 */
private $id;

サポートされている方法、またはこれを行うための一般的な規則はありますか?

score 17 · Accepted Answer

注釈認識のために @ を削除するだけです。

/**
 * @ORM\Column(name="id", type="integer")
 * @ORM\Id
 * ORM\GeneratedValue(strategy="AUTO")
 */
private $id;

score 4 · Accepted Answer

@をに置き換えるだけです#

/**
 * @ORM\Column(name="id", type="integer")
 * @ORM\Id
 * #ORM\GeneratedValue(strategy="AUTO")
 */

score 3 · Accepted Answer

私は通常@foo、ドックブロック内でコメントアウトするために注釈を追加します (このクラスは問題を発行しません)。無視のグローバルアノテーションを登録できます。

AnnotationReader::addGlobalIgnoredName('foo');

これは次のように適用されます。

/**
 * @Column(type="string", nullable=false, name="body")
 * @foo type="string", nullable=false, name="body2" 
 */
protected $body;

@Foo アノテーション。これはドキュメントの注釈ではなく、ブラックリストにも登録されていません。Doctrine Annotations の場合、このアノテーションの処理方法は完全には明確ではありません。構成によっては、この注釈を解析するときに例外 (不明な注釈) がスローされます

@foo以下の引用によると、注釈は以前に登録されているため、この例では例外がスローされません。

4 に答える 4