プロジェクトを PHP 8.0+ にアップグレードしようとしています。これまで、コード コメントでは、 "option 2"のように"option 1"@paramのように タグと@returnタグを使用していました。
オプション1：
@param string[] ....@return User[] ....
オプション 2:
@param array ....@return array ....
とはいえ、最初の形式が正式に許可されているかどうかわからないので、2 番目のオプションに切り替えた方がよいのではないかと自問し始めます.利用可能なPHPコードを文書化するための公式のPHPDocリファレンスはありますか?
また、2 番目のオプションの代わりに最初のオプションを使用することをお勧めしますか? 言い換えれば、それに反対する議論はありますか - 将来も念頭に置いていますか?
お時間をいただきありがとうございます。
PS : PHPDocumentorのリファレンスを見つけましたが、これは公式の PHP ではなく、(まだ) PHP 8.0+ と互換性がないと感じています。