7
@param ek açıklamalarında sınıfların adlarını eklemek iyi bir uygulama mıdır? Phpdoc'un ad alanlarını desteklemediğini biliyorum, ancak phpdox veya Doxygen gibi diğer araçlar nasıl hareket edecek?@param alan adlarını kullan
Hangi yol daha iyi/daha yaygındır?
namespace foo\someNamespace;
use foo\someOtherNamespace\MyOtherClass;
--- with namespace ---
/**
* @param \foo\someOtherNamespace\MyOtherClass $otherClass
*/
class myClass(MyOtherClass $otherClass)
{
// do something
}
--- without namespace ---
/**
* @param MyOtherClass $otherClass
*/
class myClass(MyOtherClass $otherClass)
{
// do something
}
+1 Ben her şeyi değiştirirseniz kitle bulma-değiştirme işlemlerini daha kolay hale getirmek için her zaman \ Root \ MyClass tam ad alanını kullanın. Ama aynı zamanda genellikle 'use' ifadelerini ad alanımla önlerim çünkü daha fazlasını yapar Kodumda neler olduğunu anlamak zor. – rdlowrey
Benim sözleşmem ** her zaman ** Dokümanlardaki FQN'yi kullanacaktır. Önde gelen ters eğik çizgi olmadan: _foo \ someOtherNamespace \ MyOtherClass $ otherClass_ – mosch