PHP Depend和@ package-annotations

Question

與What's the point of package annotations?類似，我對源代碼的一部分運行pdepend，尋找問題。然而，吐出來的是以下幾點：

The parser doesn't detect package informations within the analyzed project, please check the documentation blocks for @package-annotations or use the --bad-documentation option.

什麼，這實際上意味着，如何解決呢，和在哪裏？

Answer 1

從PHPDocumentor for the @package annotation

包的文檔是用來幫助您在邏輯組相關的元素。你編寫類將相關的函數和數據組合在一起，phpDocumentor將文件（函數，定義和包含）的內容表示爲「程序頁面」。軟件包用於將類和程序頁面組合在一起，其方式與目錄將相關文件分組在一起的方式相同。

例如，Zend Framework中的所有驗證器都屬於Zend_Validate包，因爲從概念上講，它們就是這樣。當PHPDocumentor創建文檔時，您可以瀏覽Zend_Validate包並查看其中的所有具體驗證程序類。

PHPDepend顯然希望您使用註釋來創建適當的文檔（因此可以使用--bad-documentation）。查看我引用的頁面，瞭解如何使用註釋。