IDEのマジック（_callと_callStatic）メソッドを文書化するには

Question

メモ帳++でコード化して崇高なことを何年も幸せにしてから、私は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はこれらのステートメントのうちの最初のものだけを取り上げています。さらに、戻り値の型を混合型に設定できるのは、これが呼び出されたクラス（私の例ではb）として設定できることが望ましいからです。

感謝と感謝の意を表します。

Answer 1

利用クラスレベルた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約

詳細：

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

P.S. はPhpStormでうまく動作しますが（IDEにメソッドが静的であることを伝えます）、実際のphpDocumentorツールでサポートされていない可能性があります（申し訳ありませんが、しばらく使用していません）。また

---

：（PhpStormで、もちろん）Settings | Inspections | PHP | Undefined | Undefined method --> Downgrade severity if __magic methods are present in class - それはどのような方法で、このようなメソッドのコード補完を助けにはなりませんが、「未定義のメソッド」エラーなど、これらの魔法のメソッドをマークしません。（それはドキュメントとどのように少しの助けコード補完を扱うとき、それは実際のIDEにもたらすことのために役立つことができる方法）@property/@methodタグの正規表現/部分の名前を使用してに関する

---

のphpDocumentorのチケット：

元の質問に多少関連

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

Answer 2

：

phpstormメタファイルでも定義できます。あなたは魔法が発生した場合、すべての可能性をのDocblockする必要はありません

// 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(); 

この方法：ここでファクトリメソッド（v2016.3）のための例です。

詳細はdocsあります。