PHP中使用的文档注释是什么或如何使用

Question

我经常看到这类评论，有据可查。

/*
* @author      some name
* @category    Core
* @package     /dir/name
* @version     1.6.4
*/

function ... (){}

*** code here ***

我想知道既然有这么多人在使用这个（最开源）

它们是什么，以及我如何使用这种方法或了解有关此类内容的更多信息。

我不是在寻找快速解答，请在此处进行研究：

希望有帮助的答案，解释它是什么，花时间编写额外的代码等有什么好处。

Answer 1

它们是PHP文件注释中的文档标记。 通常与生成文档的应用程序一起使用，例如PHP Documentator

从简介：

phpDocumentor 2是一个可以从您的PHP源代码生成文档的工具。 通过此文档，您可以为消费者提供有关源中嵌入的功能的更多信息，而不仅是从用户界面中可以使用的功能。

Answer 2

它们被称为注释 ，通常（但不仅限于）用于文档目的。 尝试阅读以下内容： http : //en.wikipedia.org/wiki/PHPDoc