Cómo documentar métodos mágicos (_call y _callStatic) para IDE

Después de muchos años felices codificando en notepad ++ y sublime, me recomendaron probar un IDE de PHP. Estoy probando phpStorm y parece agradable. La finalización del código y la documentación es una gran característica, pero no me funciona cuando se utilizan métodos mágicos. ¿Existe una solución alternativa para que phpStorm comprenda lo que está sucediendo con los métodos mágicos?

Nuestra situación es algo como esto:

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

El método mágico callStatic nos permite obtener una colección de objetos a través de 1 o más argumentos que componen la llamada a la función.

Veo que hay una declaración @method para usar en estos casos, pero phpStorm solo está recogiendo la primera de estas declaraciones. Además, solo puedo configurar el tipo de retorno en mixto, ya que preferiría poder configurarlo como cualquier clase a la que se haya llamado (b en mi ejemplo).

Cualquier idea o sugerencia será bien recibida, gracias.

Use el comentario PHPDoc de nivel de clase, específicamente la etiqueta @method , funciona bien en PhpStorm:

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

En lo anterior:

• @method - Etiqueta PHPDoc
• static - dice que este es un método estático
• someClasso $this- tipo de retorno
• get_by_user_id - nombre del método
• (int $id) - firma del método: ([[type] [parameter]<, ...>])
• Bla-bla - alguna descripción opcional

Más sobre @method:

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

PD Si @method staticbien funciona bien en PhpStorm (le dice al IDE que el método es estático) puede que no sea (¿todavía?) Compatible con la herramienta phpDocumentor real (lo siento, no lo he usado por un tiempo).

Alternativamente : (en PhpStorm, por supuesto) Settings | Inspections | PHP | Undefined | Undefined method --> Downgrade severity if __magic methods are present in class- no ayudará a completar el código para dichos métodos de ninguna manera, pero no marcará esos métodos mágicos como errores de "método indefinido".

Ticket de phpDocumentor con respecto al uso de RegEx / nombres parciales para @property/ @methodetiquetas (cómo puede ser útil para la documentación y qué poca ayuda puede aportar al IDE real cuando se trata de completar el código):

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

Algo relacionado con la pregunta original:

También puede definir esto en el archivo meta phpstorm. Aquí hay un ejemplo para el método de fábrica (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();

De esta manera, no tienes que bloquear todas las posibilidades cuando ocurre la magia.

Tenga algunos documentos para obtener más detalles.