我以前从来没有关心过编写代码的问题，但是最近我开始从事一个开源项目，于是出现了这种需求。显然，"首选武器"是PHPDoc，但是…
我真的找不到一个关于PHPDoc标准的规范。有一个维基百科条目列出了一些属性，有phpDocumentor项目，据说有一个更广泛的字典，但让我困惑的是PHPDoc的最终指南在哪里?是否有一个单一的标准，或者它取决于所有那些众多的phpDocumentor仿冒品，以扩展PHPDoc"标准"(如果有的话)到他们认为合适的任何地方。
如果我们假设phpDocumentor是创建和维护PHPDoc标准的地方，事情看起来很糟糕，因为这个项目的网站已经死了将近4年了。更让我困惑的是，大约一个月前，phpDocumentor的Pear站点上突然出现了一个1.4.4版本。
我知道这里有很多更聪明、更有知识的人，所以我想知道。PHPDoc是怎么回事?是否有一个单一的权威机构来制定标准?它有多可靠?还有未来吗?或者我们正在对付一个僵尸，所有的希望都破灭了……
谢谢,Ivo
根据维基百科，它已经死了。
PhpDoc标签的标准规范过去是在PhpDocumentor的文档中列出的。但就像我说的，它死了。由于DocBlox似乎填补了PhpDocumentor留下的空白，我建议使用DocBlox文档作为如何做PhpDoc注释的基础。
我希望Netbeans 7.1会引入DocBlox支持，因为它好多了。它支持PHP 5.3，并且得到了积极的维护。
这个问题已经有点老了，但是为了信息起见，我应该补充一下，DocBlox是与PhpDocumentor合并的。
宣布phpDocumentor 2 -合并旧的(phpDocumentor)和新的(DocBlox)。
phpDocumentor的第一个alpha版本(2.0.0 . a1)，新的"响应式"默认模板显示了一个新的页面布局，以及有用的布局改进，原来的DocBlox模板在旧的phpDocumentor模板上提供(仍然可用)(它将与旧的phpDocumentor一起退役)。探索这个新模板在http://demo.phpdoc.org/Responsive/index.html .
=> http://www.docblox-project.org/2012/03/docblox-is-unmasked-it-is-really-phpdocumentor-2/
PHPDoc返回操作。div =)
截至2013年8月，PHP框架互操作性组开始为PHPDoc编写正式规范(PSR)。PHPDoc的建议标准，当前草案PSR5: https://github.com/phpDocumentor/fig-standards/blob/master/proposed/phpdoc.md
当前的草案更新了规范以解决PHP 5.3+，以及其他已经发生的变化。我相信期望php注释的这个标准将被多个文档生成器所采用。