用phpDoc语法定义名称空间

用phpDoc语法定义名称空间,php,phpdoc,Php,Phpdoc,谁能告诉我用phpDoc语法定义php名称空间的正确方法是什么?或者,在phpDoc中@package是否已被弃用,因为名称空间或多或少定义了一个包 如果没有,是否有一种通用的方法来记录文档所在的名称空间?@package应该用于项目中每个文件的每个docblock中,也可以使用@subpackage@package不是不推荐使用的,它将是定义名称空间的正确方法。phpDoc没有名称空间的概念,但您可以(也可能应该)使用@package 您可以查看,看看它们是如何格式化名称空间的 你可以看看;这

谁能告诉我用phpDoc语法定义php名称空间的正确方法是什么?或者,在phpDoc中@package是否已被弃用,因为名称空间或多或少定义了一个包


如果没有,是否有一种通用的方法来记录文档所在的名称空间?

@package应该用于项目中每个文件的每个docblock中,也可以使用@subpackage@package不是不推荐使用的,它将是定义名称空间的正确方法。

phpDoc没有名称空间的概念,但您可以(也可能应该)使用@package

您可以查看,看看它们是如何格式化名称空间的

你可以看看;这是一个支持名称空间的API文档生成器

更清楚地回答您的问题:据我所知,由于名称空间的发明,包被认为是不推荐的。
如果您阅读PSR-0规范,您将看到它试图将包作为命名空间的第二部分提供;首先是供应商。

phpDoc文档说明:

@package标签可以用作 名称空间。名称空间提供了结构的功能细分 @package标记可以在其中提供逻辑细分的元素 可以使用不同的层次结构对元素进行分组的方式

如果在所有方面,逻辑和功能细分都是 建议不要使用@package标记,以防止 维护费用


谢谢,@子包可能有用,但这并不能解决我的问题+1感谢您在文档中引用使用命名空间格式的现有库。我找不到一个,绝对有用!也是一个很好的资源,因为这个答案让事情有了一些进展。phpDoc现在确实大量使用了名称空间的概念,但phpDoc文档没有定义它,因为它是一种PHP语言概念,在PHP5.3中变得可以控制。phpDoc文档现在建议在@package上使用名称空间,其目的是在这两个包中具有相同的层次结构,通常情况下就是这样。