你能为一个类创建一个外部PHPdoc吗?

时间:2016-08-15 00:19:58

标签: php ide phpdoc

让我们说我有以下

class Something extends ClassWithMagicMethods{}

通常我会为我知道存在的任何属性添加一个docblock,即使通过魔术方法访问

/**
 * @property string $someVar
 * @method SomeClass getSomeClass()
 */
class Something extends ClassWithMagicMethods{}

哪个很好用,但我想知道的是,我们是否可以将该docblock与类的定义分开。两种可能的用例:

  • 第三方软件包不包含docblock,但我想从我的IDE中自动完成 - 我希望能够在某个地方添加我自己的docblock。
  • 扩展系统 - 在定义扩展名的文件中,我想记录此扩展程序添加到该类的新属性。

我知道我可以从技术上创建一个永远不会被运行的虚拟ide_helper.php文件 - 只是由IDE编制索引 - 不幸的是,这导致任何体面的IDE都抱怨重复的声明我不会这样做。我想要它也会使代码导航更慢。

那么 - 是否可以通过从类定义中外部组合多个docblock来记录PHP类?

我在SO上提取的大多数结果只是记录了使用它们的未知类型,而这并不是我需要的。即:

/** @var Something $something */
$something = FactoryMethodThing::create('Something');

1 个答案:

答案 0 :(得分:0)

看看这是否对您有帮助:

phpdoc -d path/to/my/project -f path/to/an/additional/file -t path/to/my/output/folder

来源:http://docs.phpdoc.org/guides/running-phpdocumentor.html