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