mehrere Subpackages für phpdoc

Question

Ist es möglich, mehrere Subpackages eine Datei gehört zu haben? Zum Beispiel:

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

Danke!

Answer 1

Es scheint, dass PHPDoc erlaubt Ihnen nicht, es zu tun für Namensräume Gründen. Von der PHPDoc Docs :

  

Hinweis: Der @subpackage Tag soll die Elemente helfen, zu kategorisieren, die in einem tatsächlichen @package Wert sind. Da PHP selbst nicht erlaubt, zwei Funktionen mit dem gleichen Namen im selben Skript zu haben, erfordert PhpDocumentor auch alle Namen in einem @package einzigartige ... Bedeutung zu sein, ist @subpackage nicht weiter erlauben „Trennung Benennung“ im Innern, @Paket. Was es tut, ist ein Maß an visuellen Gruppierung / Trennung der Elemente innerhalb dieser @package ermöglichen.

Es scheint, dass, weil PHPDoc der @package eine Möglichkeit, Ihre Funktionen und Klassen Pseudo-Namespace, aber @subpackage einfach für die Kategorisierung ist. Haben Sie versucht, mehr als ein subpackage hinzufügen? Wenn ja, was waren die Ergebnisse?

Answer 2

Sie können das folgende tun:

* @package popcap\system\cache

Dies wird eine Hierarchie der Pakete erstellen, wenn Sie die PHPDocs kompilieren.

Answer 3

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

Es scheint eine ziemlich gute Arbeit mit mehreren @subpackage Tags zu tun - es wird sogar html- Dokumentation erzeugen wie phpDocumentor tut -. Wenn es nicht so stil der Lage, als phpDocumentor zu sein scheint

Es macht auch die zusätzlichen subpackage durch sie in der generierten UML diagaram zeigt.