phpdoc için birden subpackages

3 Cevap php

Birden subpackages ait bir dosya olması mümkün mü? Örneğin:

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

Teşekkürler!

3 Cevap

Bu PHPDoc Eğer nedenleri Namespacing için bunu yapmak için izin vermez görünür. Kimden PHPDoc Docs:

NOT: @ subpackage etiketi gerçek @ paket değeri olan öğeleri kategorize yardımcı olmak için tasarlanmıştır. PHP kendisi aynı komut aynı ada sahip iki işlevleri için izin vermediğinden, phpDocumentor de benzersiz olması için bir @ paketindeki tüm isimleri gerektirir ... anlamı, @ subpackage ki içinde daha fazla "adlandırma ayrılık" izin vermez @ paketi. Ne yapar o @ paketin içindeki elemanların görsel gruplama / ayırma düzeyi sağlamasıdır.

Bu PHPDoc en @ paketi işlevleri ve sınıfları-namespace yalancı bir yoldur, ancak çünkü @ subpackage kategorizasyon için basitçe gibi görünüyor. Birden fazla subpackage ekleyerek denediniz mi? Eğer öyleyse, sonuç ne oldu?

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

Birden @ subpackage etiketleri ile oldukça iyi bir iş yapmak gibi görünüyor - hatta phpDocumentor yaptığı gibi html-belgeler üretecek - bu tarz-mümkün phpDocumentor gibi olmak görünmüyor bile.

Ayrıca, oluşturulan UML diagaram içinde göstererek ilave subpackage kullanır.

Bunu yapmak için aşağıdakileri kullanabilirsiniz:

* @package popcap\system\cache

Eğer PHPdocs derleme bu paketlerin bir hiyerarşi oluşturur.

etiketler