2012-09-09 3 views
5

は、私は、静的メソッドに@static注釈になってしまった。彼らは、コードから推測できる場合@staticのような冗長なphp docblockタグのポイントは何ですか? PhpStorm自動のPHPのDocblock世代を使用している場合

/** 
* Reset the singleton instance, for the tests only 
* @static 
*/ 
public static function reset() { 
    self::$singletonInstance = null; 
} 

は、これらのタグのための任意の使用はありますか?私はそれを残すべきか、それを取り除かなければならないのかを決定しようとしています。

答えて

6

これらのタグは、コードでこのようなキーワードの使用を許可していなかった従来のPHP 4コード用に導入されました。 PHP 5では、コードが効果的に自己文書化しているので、これらのタグは実際には冗長です。私はそれらを守る理由は何も見ません。

実際、PHP 5ソースファイルのドキュメントを生成する場合、phpDocumentorはこれらが静的メソッドであることを引き続き判断できるはずです。これはphpDocumentor docsに記載されている:

ちょうどあなたのコード内で静的キーワードを使用すると、静的変数やメソッドを認識し、そしてphpDocumentorのは、静的としてそれらをマークしますPHP5にphpDocumentorのために十分です。

+1

ああ私はPHP4を考えていませんでしたが、今は意味があります;) –

関連する問題