IDEのマジック（_callおよび_callStatic）メソッドを文書化する方法

notepad ++と崇高なコーディングで何年も幸せに過ごした後、PHPIDEを試してみるようにアドバイスされました。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はこれらのステートメントの最初のものだけを取得しています。さらに、戻り値の型を混合に設定できるのは、これが呼び出されたクラス（私の例では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-method

PS ながら@method staticPhpStormでの作品の罰金（メソッドが静的であることをIDEに指示します）、それは（まだ？）実際のphpDocumentorツール（申し訳ありませんが、しばらくの間、それを使用していない）でサポートされない場合があります。

あるいは:(もちろん、PhpStormでは）Settings | Inspections | PHP | Undefined | Undefined method --> Downgrade severity if __magic methods are present in class-そのようなメソッドのコード補完にはまったく役立ちませんが、これらの魔法のメソッドを「未定義のメソッド」エラーとしてマークすることはありません。

@property/@methodタグの正規表現/部分名の使用に関するphpDocumentorのチケット（ドキュメントにどのように役立つか、コード補完を処理するときに実際の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();

このようにして、魔法が起こったときにすべての可能性をdocblockする必要はありません。

詳細については、いくつかのドキュメントがあります。