PHP 5.3 命名空间需要使用 @package 吗？

Question

5

我已经转换到PHP 5.3和命名空间。现在似乎@package标记是多余且无用的。

现在还需要phpDoc，还是可以忽略这个标记？

谢谢

- Matthieu Napoli

2个回答

1

@package与命名空间无关，而是用于组织生成的文档。

包用于帮助您逻辑地分组相关元素。 phpDoc手册

编辑:

- Raffael

“逻辑上将相关元素分组”与名称空间有何区别？我的意思是，如果由我来决定，我现在想按名称空间对我的文档进行分组。我的疑问是：@package标签是否比名称空间添加了更多的东西？（好吧，除了目前它是组织生成文档的唯一方法之外） - Matthieu Napoli

@package与命名空间完全无关。命名空间用于组织代码，@package用于组织文档。它们以完全独立和不同的方式进行组织。请参见编辑中的链接。 - Raffael

网页内容由stack overflow 提供, 点击上面的

可以查看英文原文，
原文链接

- PowerKiKi · Accepted Answer

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

如果在逻辑和功能上分割相等的情况下，建议不要使用@package标签，以防止维护开销。