如何为IDE记录魔术（_call和_callStatic）方法

在用记事本++和sublime进行了许多快乐的编码之后，建议我尝试使用PHP IDE。我正在尝试phpStorm，看起来不错。代码完成和文档是一个很棒的功能，但是当使用魔术方法时，对我来说却行不通。是否有解决方法使phpStorm了解魔术方法的状况？

我们的情况是这样的：

abstract class a {
    public static function __callStatic($method,$args)
    {
        if(strpos($method,"get_by_") === 0)
        {
            //do stuff
        } elseif(strpos($method,"get_first_by_") === 0) {
            //do stuff
        } elseif($method == "get_all") {
            //do stuff
        }
    }
}

class b extends a {
    // some more stuff
}

b::get_by_user_id(27);
b::get_first_by_id(156);
b::get_all();

神奇的callStatic方法使我们能够通过1个或多个组成函数调用的参数来获取对象的集合。

我看到在这些情况下有一个@method语句可以使用，但是phpStorm仅选择了这些语句中的第一个。此外，我只能将返回类型设置为“ mixed”，因为我希望能够将其设置为被调用的任何类（在我的示例中为b）。

任何想法或建议都会非常感激，谢谢。

使用类级别的PHPDoc注释-特别是@method标记-在PhpStorm中可以正常工作：

/**
 * @method static someClass get_by_user_id(int $id) Bla-bla
 * @method static someClass get_first_by_id(int $id) 
 */
abstract class a {
...

在上面：

• @method -PHPDoc标签
• static -告诉这是静态方法
• someClass或$this-返回类型
• get_by_user_id -方法名称
• (int $id) -方法签名： ([[type] [parameter]<, ...>])
• Bla-bla -一些可选的描述

更多有关@method：

• https://docs.phpdoc.org/latest/references/phpdoc/tags/method.html
• https://github.com/phpDocumentor/phpDocumentor2/blob/develop/docs/PSR.md#711-方法

PS 虽然@method static在PhpStorm中工作正常（告诉IDE该方法是静态的），但实际的phpDocumentor工具可能尚未支持（还好吗？）（对不起，有一段时间没有使用它了）。

另外一种方法：（当然是在PhpStorm中）Settings | Inspections | PHP | Undefined | Undefined method --> Downgrade severity if __magic methods are present in class-它不会以任何方式帮助此类方法的代码完成，但是不会将那些魔术方法标记为“未定义方法”错误。

phpDocumentor有关使用正则表达式/部分名称作为@property/@method标记的票证（它如何对文档有用，以及在处理代码完成时对实际IDE的帮助很少）：

• https://github.com/phpDocumentor/phpDocumentor2/issues/689

与原始问题有关：

您也可以在phpstorm元文件中定义它。这是工厂方法（v2016.3）的示例：

// Define in .phpstorm.meta.php
namespace PHPSTORM_META {
    $STATIC_METHOD_TYPES = [
        \Factory::create('') => [],
    ];
}

// Then use in code
$factory = new \Factory();
$user = $factory->create(\User::class);
// Here you get autocomplete.
$user->subscribe();

这样，当魔术发生时，您不必对所有可能性进行文档阻止。

有一些文档以获取详细信息。