Как документировать магические методы для автоподстановки в phpstorm?

Question

[alestro]

Собственно сабж заключается в следующем: есть класс который принимает неопределенное количество калбеков и вызывает их через магию, в виду того, что заранее не известно какие функции будут зарегистрированны, интересует следующее: есть ли возможность документировать конкретный объект на лету для того, что бы использовать автоподстановку?

Comments

[Максим Федоров]

/**
*@method anyMethod1()
*@method anyMethod2(string $param1)
*/
class Any
{

}

[alestro]

Максим Федоров, сложность в том, что изначально неизвестно какие методы будут в классе

[green_goo]

изначально неизвестно какие методы будут в классе

По мере появления добавлять методы в phpdoc. А вообще изначально плохая идея завязываться на магию.

[Дмитрий]

alestro, все верно пишут товарищи сверху, но иногда магия необходима
https://github.com/Compolomus/Compomage/blob/maste...
Пример

[BoShurik]

Дмитрий, можете обосновать? Я бы сделал

ImageFactory::create(string $filename): AbstractImage|ImageInterface

[Дмитрий]

BoShurik, что именно? Есть магический call, есть описание дока для автокомплита

[BoShurik]

Дмитрий, по факту - класс Image - это Factory. Какой смысл пробрасывать вызовы к внутреннему $object, когда можно сразу вернуть его и работать с ним?

[Дмитрий]

BoShurik, это у вас фабрика, у меня нет фабрики, я бы назвал это свитчером наверное

[BoShurik]

Дмитрий, Собственно мой вопрос был: зачем? Какие проблемы вы этим решили? Почему не сделали Image implements ImageInterface (тогда бы не пришлось писать док. блоки)? Сейчас получается, что нельзя передать объект Image туда, где требуется ImageInterface, хотя все методы его у него есть.

[Дмитрий]

BoShurik, чтоб после создания объекта дальше стрелками пилить нужное, с фабрикой две строки получается

[BoShurik]

Дмитрий, да вроде одинаково:

$image = $imageFactory->create($filename)
$image->resize();

против

$image = new Image($filename);
$image->resize();

[Дмитрий]

BoShurik, дело вкуса как по мне, не вижу прям проблему в этом

[slartus]

Дмитрий, у вас плохой вкус

BoShurik дело говорит

[Дмитрий]

slartus, всем не угодишь, кому то не нравиться магия, кому то фабрика