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

标签 phpdoc

什么(如果有)标签可用于指定 PHPDocumentor 的创建和/或上次修改日期?例如:

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

这主要用于文件级 DocBlocks。

最佳答案

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


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

关于PHPDoc 创建/修改日期/时间戳,我们在Stack Overflow上找到一个类似的问题: https://stackoverflow.com/questions/14220192/

相关文章:

phpunit - 排除 pdepend、phpmd、phpcpd、phpcs、phpdoc、phploc 中的某些目录和文件

php - 使用 PHPdoc 记录 PHP 扩展

php - 有没有办法表明一个类具有为另一个类上的每个方法定义的魔术方法?

php - Netbeans PHPDoc 局部变量不起作用

windows - Netbeans 和 PhpDocumentor

php - 文档错误标签

netbeans - phpdoc 建议 $this->someField 的类型

phpdoc - 使用 phpDocumentor 2 自定义模板

php - 可迭代对象的正确 phpdoc 注释?

PHPStorm 对 __construct() 的@return void 发出尖叫