Как задокументировать parent в IDE на примере YII2?

Question

[Дмитрий Ким]

Есть трейт:

<?php

    namespace X\Y\Z;

    use yii\db\ActiveRecord;

    /**
     * Class SaveRelationTrait
     * @package X\Y\Z;
     */
    trait SaveRelationTrait
    {
        /**
         * @param      $data
         * @param null $formName
         * @return bool
         */
        public function load($data, $formName = null)
        {
            /* @var $this ActiveRecord|SaveRelationBehavior */
            // v==== вот в этом месте IDE не понимает, кто такой parent, хотя мы как бы указали, что $this - это актив рекорд. ЧЯДНТ?
            if (parent::load($data, $formName)) {
                $this->loadRelations($data, $this->formName());

                return true;
            }

            return false;
        }
    }

Comments

[Максим Тимофеев]

Известно:
есть трейт
речь о документировании
Не известно:
какая ide
что есть parent
чего Вы хотите добиться документированием

Складывается впечатление, что 90% вопроса, просто отсутствует

[Дмитрий Ким]

Максим Тимофеев: Не думаю, что здесь документирование кода должно отличаться для разных IDE. Но в данном случае это PHPSTORM. Трейт относится к актив рекорд модели, что я и описал в /* @var $this ActiveRecord|SaveRelationBehavior */. Документирование не есть цель всей моей жизни, просто в данном конкретном случае IDE не понимает кто такой parent, соответственно подсвечивает его и не открывает метод по клику.

Answer 1

[Илья Караваев]

Мне кажется никак.

Трейт должен реализовывать общие функции. И может быть внедрен в любой класс. С чего вы взяли, что у класса, который внедрит трейт, будет наследован от нужного Вам класса и иметь соответствующую функцию?

Единственный совет - использовать тот же $this.
Или использовать не трейт, а промежуточную модель, поскольку Вы явно подразумеваете использование данной функции только в модели и только в ActiveRecord

Comments

[Дмитрий Ким]

В том то и дело, что $this зацикливает функцию load().

[Дмитрий Ким]

И если мы в данном случае указываем, что $this это ActiveRecord, то и parent по идее должен быть как минимум ActiveRecord, а в нем функция load присутствует. Но почему-то этого не происходит.

[Илья Караваев]

Дмитрий Ким: это понятно Вам, а не анализатору. Для него parent является только непосредственно родитель. А у Вас нет родителя для трейта. У Вас примесь, которая не должна опираться на контекст. Поэтому Вы либо игнорируете данный контекст, либо реализуете иначе, через промежуточную модель, через любой хелпер, через реализацию метода только в нужной модели с опором на контекст модели.

Answer 2

[Максим Тимофеев]

Я бы сделал это через behavior а не через trait, что решит много проблем, но будет незначительнее медленнее работать.
Советую почитать вот эту статейку:
Поведение или трейт

Answer 3

[mitaichik]

Попробуйте аннотацию mixin
https://youtrack.jetbrains.com/issue/WI-1730