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';
 }