phpdoc - PHPDoc 创建/修改日期/时间戳

Question

什么（如果有）标签可用于指定 PHPDocumentor 的创建和/或最后修改日期？例如：

@created 2013-01-01
@author John Doe
@updated 2013-01-06

这主要用于文件级 DocBlocks。

Answer 1

老问题，但我很好奇是否有向文档块添加日期的标准并找到了这个问题。

对于我的特定用例，我确实使用代码版本/版本控制，但我是一个项目的独立开发人员，所以我只查看我的代码，并且由于我的数据是基于日期的，我喜欢@introduced yyyy-mm-dd在我的文档块中使用标签。很好，很容易理解，当发布特定标签时，我不必追查。我的代码是版本控制的，所以我可以查看行/函数历史记录，所以我从不添加/更改日期。

/**
 * A brief description of the function
 * 
 * @introduced 2020-06-24
 * @return array
 */
 public funcition hello()
 {
   return 'world';
 }