タグ

アノテーションに関するmimosafaのブックマーク (3)

  • 2018年のPHPDoc事情とPSR-5 - Qiita

    PHPDocとは、クラスや関数などのブロックに記述できるDocComment内に記述する書式の通称です。この書式の情報源として時折PSR-5が参照されることがあるので簡単に状況をまとめます。 TL;DR PSR-5の標準化ステータスは昨年10月にABANDONED (放棄・議論停滞)になりました 2018年9月26日にPSR-5とPSR-19が分割され、ともにDRAFT状態に入りました PHPDocを型注釈として利用する各処理系の実装にはばらつきがあり、PSR-5とは相違点があります PhpStormは現在のところ(2018.1 EAP)PSR-5と互換性がありません 特にチーム開発では、対応する型記述の書式について注意が必要です PhpStormに配慮して書く場合、phpDocumentorの仕様を参照する方が安全です PHPDoc リファレンス — phpDocumentor この記事

    2018年のPHPDoc事情とPSR-5 - Qiita
  • PhpStorm の静的解析機能をさらに活用するための3つのアノテーション | バシャログ。

    先の M-1グランプリ決勝ではスーパーマラドーナを応援していた kagata です。「人に話すとツキが落ちる」という非科学的な理由からあまり他言しないようにしていたのですが、その努力もむなしくファーストラウンド敗退に終わりました。結果は残念でしたが、関東の地上波ゴールデンタイムで「ひき肉にしてやんよ」が聴けたのでそれで満足することにします。 さて、今回は PhpStorm についての Tips です。PHP のソースコードにアノテーションを追加することで、PhpStorm の強力な静的解析機能をさらに有効活用できる例をご紹介します。これにより、バグの作りこみをへらしたり、自動補完でコーディングの効率をアップさせたりすることができます。ぜひ活用してみてください。 それにしても、「○○を◎◎する N 個の☆☆」なんてありがちな記事タイトルをたまにつけると、なんだかすごく恥ずかしいですね。 Ph

    PhpStorm の静的解析機能をさらに活用するための3つのアノテーション | バシャログ。
  • PHPUnit マニュアル – 付録B アノテーション

    アノテーションとはメタデータを表す特別な構文のことで、 プログラミング言語のソースコードに追加することができます。 PHP そのものにはソースコードにアノテーションする専用の仕組みはありませんが、 ドキュメンテーションブロックに @アノテーション名 引数 のようなタグを書くことでアノテーションを表すという記法が PHP コミュニティ内で一般に使われています。 PHP では、リフレクション API の getDocComment() メソッドを使えば関数、クラス、メソッド、属性 それぞれのドキュメンテーションブロックにアクセスすることができます。 PHPUnit などのアプリケーションでは、 この情報をもとに実行時の振る舞いを設定するのです。 注記 PHP の doc コメントは、/** で始めて */ で終わる必要があります。 その他の形式のコメントで書いたアノテーションは、無視されます。

  • 1