php - 在 phpdoc 中，在单独的文件中定义类属性

Question

我正在使用一个允许向框架的基类添加新组件的框架。有没有什么方法可以在不更改框架文件的情况下记录这些新方法，这样我就可以在我的 IDE 中单击该方法。

Answer 1

我强烈建议不要尝试注入(inject)子类。如果框架实例化您直接扩展的类，您将需要找到一种方法让它使用您的子类。

NetBeans 和 PhpStorm(可能还​​有很多其他的)将组合来自同一类/接口(interface)的多个定义的元素。这使您可以向任何现有类添加属性和方法，而无需修改原始源代码。

/**
 * Framework controller base class.
 * Provides helpers via __call().
 */
class Framework_Controller { ... }

现在在您的代码库中创建一个您永远不需要的文件，其中包含相同的类定义。您的 IDE 仍应解析它并将其元素与上面的类合并:

if (false) { // Safety first!
    /**
     * ACME Co. controller base class.
     *
     * @method ACME_Model_User getUser Load user via authentication helper
     */
    class Framework_Controller { /* nothing to add */ }
}

您可以尝试使用接口(interface)并正常声明方法，而不是使用 @method。这就是我们对 Zend_View 所做的，因为它已经是一个接口(interface)。我还没有尝试将类与接口(interface)混合以查看 PhpStorm 是否喜欢它。