【问题标题】:Is @package required with PHP 5.3 namespaces?PHP 5.3 命名空间是否需要 @package?
【发布时间】:2011-07-24 17:23:42
【问题描述】:

我已经切换到 PHP 5.3 和命名空间。现在看来@package 标签是多余的,没用了。

phpDoc 是否仍然需要它,或者我现在可以忽略这个标签吗?

谢谢

【问题讨论】:

    标签: php namespaces php-5.3 phpdoc


    【解决方案1】:

    这不是必需的。

    最新文档现在指出,如果您使用命名空间并且不需要不同的文档结构,则应避免使用 @package

    如果总体而言,逻辑和功能细分都是 是否不建议使用 @package 标签来防止 维护开销。

    http://phpdoc.org/docs/latest/references/phpdoc/tags/package.html

    【讨论】:

      【解决方案2】:

      @package 与命名空间无关,但与组织生成的文档有关。

      包是用来帮助你的 对相关元素进行逻辑分组。 phpDoc manual

      编辑

      Is there any replacement for PHPDocumentor that supports PHP 5.3?

      【讨论】:

      • “逻辑分组相关元素”与命名空间有何不同?我的意思是,如果这取决于我,我现在希望我的文档按名称空间分组。我想知道的是:@package 标签是否添加了比命名空间更多的东西? (除了现在它是组织生成的文档的唯一方法)
      • @package 与命名空间无关。 namespace 组织代码,@package 组织文档。他们以完全独立和不同的方式做到这一点。请参阅编辑以获取链接。
      猜你喜欢
      • 1970-01-01
      • 1970-01-01
      • 2014-03-09
      • 2014-07-20
      • 2011-08-15
      • 2012-03-13
      • 2013-02-17
      • 1970-01-01
      • 2015-09-15
      相关资源
      最近更新 更多