Как объявить "магические" методы в PhpStorm?

Question

[Вадим]

Исходные данные — есть проект, основанный на стороннем движке. И в этом движке есть механизм автоподгрузки модулей при вызове их методов. Проект делается в PhpStorm. И хотелось бы, не трогая исходных файлов движка, создать файл с явным описанием вызовов всех возможных методов.

Например, есть класс Foo (в файле Foo.class.php):

class Foo {
function A() {
$this->Bar_B(); // здесь автоматически подгружается класс Bar и вызывается его метод B()
}
}

Мне хотелось бы не трогать файл Foo.class.php, но где-то описать типа:
/**
* @method int Bar_B() autoloaded method
*/

Не хочу писать это прямо в Foo.class.php, т.к. движок периодически обновляется, и трогать его «родные» файлы — это как-то не айс. Никто не знает, в PhpStorm возможны какие-то иные пути решения этой проблемы?

Answer 1

[Анатолий]

Тупой вариант конечно, но все же:

/** @var $tmp Bar; */
$tmp = $foo->A();
$tmp->//autocomplite for Bar goes here

Comments

[Вадим]

Ну, такой вариант, конечно, мне известен. Вы ж понимаете, что я не об этом

[Анатолий]

Кстати можете в проект кинуть файлик с интерфейсами классов дублирущими Ваш проект с полным описанием типа:
/**
* @method int Bar_B() autoloaded method
*/
Он должен подхватить и его тоже при выводе посказок

[Вадим]

Не катит :(
Объявить его через interface, ясень пень, не могу, т.к. есть уже класс с таким именем. Если же добавить в проект файл, скажем Foo2.class.php, где еще раз объявить класс Foo, но уже через phpdoc декларировать нужные методы, то PhpStorm, учуяв множественное объявление класса, не захочет вообще никаких подсказок по нему выдавать. Во всяком случае автодополнение точно работать не будет

[Анатолий]

Прекрасно работает, я только что проверил, работаю с CI там модели и формы загружаются через анал, и вызываются через $this->model_name и естественно нет автокомплита, только что создал файлик, создал аналогичный класс и втулил в него те свойства которые создаются динамически на данный момент — прекрасно словил, и даже учитывая что я пишу $this->form_validator он его показывает в автодополнении, хотя это свойство находится в другом классе (файл болванка) с таким же названием. Короче Вам нужно описать дубликаты классов со всеми свойствами и каментами нужными и просто кинуть в папку проекта (мой ща в корне лежит)

Answer 2

[Антон]

Вообще описание методов в отдельных файлах можно задавать — сделайте ctrl+click на какую-нибудь встроенную функцию, но как свой такой файл подключить я не в курсе.

Answer 3

[Владимир Чернышев]

Не совсем прямой ответ на вопрос, скорее обход проблемы

>Не хочу писать это прямо в Foo.class.php, т.к. движок периодически обновляется, и трогать его «родные» файлы — это как-то не айс.

Нормальные VCS вполне обычно справляются с добавлением пары строк в автоматическом режиме. Сам сейчас работаю над форком одного открытого проекта. Проект на SVN, я работаю в Mercurial(hg) — за месяц было где-то 40 обновлений оригинала — ручное вмешательство в процесс объединения правок оригинала и моих понадобился только один раз и то по какому-то пустяку типа я поменял дефолтный цвет на свой, а они потом поменяли дефолтный и hg не сообразил какой оставить.

Если же оригинальный движок вы используете как библиотеку, то есть его вообще не трогаете, а инклудите его файлы в свой, то вместо форка можно сделать субрепозиторий. А после того как добавите комменты, так ещё послать их авторам оригинального движка, может добавят и проблема исчезнет :)