php - PHPDoc 的状态如何?

标签 php documentation phpdoc

<分区>

我以前从不太关心记录我的代码,但最近我开始从事一个开源项目并且需要出现。显然,“首选武器”是 PHPDoc,但是......

我真的找不到 PHPDoc 标准的单一规范。有一个维基百科条目列出了一些属性,还有 phpDocumentor 项目,据说它有一个更广泛的字典,但令我困惑的是 PHPDoc 的权威指南在哪里?是否有一个单一的标准,或者由所有那些众多的 phpDocumentor 仿制品来扩展 PHPDoc“标准”(如果有的话)到它们看起来合适的任何东西。

如果我们假设 phpDocumentor 是创建和维护 PHPDoc 标准的地方,那么事情看起来相当严峻,因为 the project's website现在已经死了将近 4 年了。更让我困惑的是大约一个月前的一个版本 1.4.4在 phpDocumentor 的 Pear 网站上突然死而复生。

我知道这里有很多更聪明、知识渊博的人,所以我想知道。与 PHPDoc 有什么关系。是否有制定标准的单一机构?它有多可靠?有没有 future ,或者我们正在与僵尸打交道,所有的希望都破灭了......

谢谢, 伊沃

最佳答案

根据维基百科it's dead .

PhpDoc 标签的标准规范曾经列在 PhpDocumentor 的文档中。但就像我说的,它已经死了。由于 DocBlox 似乎正在填补 PhpDocumentor 留下的空白,我建议使用 DocBlox documentation作为您如何进行 PhpDoc 注释的基础。

我希望 Netbeans 7.1 将引入 DocBlox 支持,因为它要好得多。它支持 PHP 5.3,并且得到积极维护。

关于php - PHPDoc 的状态如何?,我们在Stack Overflow上找到一个类似的问题: https://stackoverflow.com/questions/8697701/

相关文章:

php - 表示在 PHP 中使用的 n/深度树的最佳方法(MySQL/XML/?)

php - 使用单个查询更改多个 MySQL 字段 - 产品代码销售

java - 从存档文件中的库继承 javadoc

php - 如何在 phpstorm 中为代码完成注释类

php - PHPDocumentor 中的类型转换

php - pdo_odbc的配置需要文件在/usr/local/但是没有文件

php - Laravel 根据用户选择返回结果

iphone - iOS私有(private)API文档

python - PyCharm:如何获取要在快速文档弹出窗口中列出的类属性?

php - PHP Documentor 中的注释关联数组