phpdoc的多個子包

Question

是否有可能有一個文件屬於多個子包？例如：

/** 
* Name 
* 
* Desc 
* 
* @package Core 
* @subpackage Sub1 
* @subpackage Sub2 
*/ 

謝謝！

Answer 1

似乎PHPDoc不允許你爲了命名空間的原因做它。來自PHPDoc Docs：

注意：@subpackage標記旨在幫助對實際@package值中的元素進行分類。由於PHP本身不允許在同一個腳本中擁有兩個具有相同名稱的函數，因此PhpDocumentor還要求@package中的所有名稱都是唯一的......意思是說，@subpackage不允許在其內部有更多的「命名分離」 @包。它所做的是允許一個級別的@package中的元素的可視化分組/分離。

看來，因爲PHPDoc的的@package是一種將僞命名空間的函數和類，但@subpackage簡直就是分類。你有沒有嘗試添加多個子包？如果是這樣，結果如何？

Answer 2

http://pear.php.net/package/PHP_UML/

似乎做了很好的工作與多個@subpackage標籤 - 它甚至會產生同樣的phpDocumentor做HTML的文件 - 雖然似乎是爲風格，能夠爲它的phpDocumentor不會。

它還通過在生成的UML Diagaram中顯示它來使用額外的子包。

Answer 3

您可以使用以下方法來做到這一點：

* @package popcap\system\cache 

在編譯PHPdocs這將創建包的層次結構。