Как получить автокомплит для расширенной реализации на основе интерфейса/абстрактного класса/класса?

Question

[Данила Риджи]

Есть библиотека , она работает с объектом . Зависимость внедрена через инъекцию, чтобы клиенты могли писать свои реализации . Проблема в том, что автокомплит идет для указанного типа, и даже если мы написали свою реализацию с расширенным апи то мы обламываемся на автокомплит. Как это вообще решается ?
UPD. Мы можем как угодно менять реализацию TaxiService, но когда мы выкладываем ее в opensource, то клиенты разумеется не должны менять исходники, чтобы получить свои плюшки (автокомплит для своих реализаций).

interface Machine
{
    
    public function go();
    
}

class Car implements Machine
{
    
    public function go()
    {
        // TODO: Implement go() method.
    }
    
}

class ElectroCar extends Car
{
    
    public function charge()
    {

    }
    
}

class TaxiService
{
    
    protected $machine;

    function __construct(Machine $machine)
    {
        $this->machine = $machine;
    }

    public function getMachine()
    {
        return $this->machine;
    }

}

$taxi = new TaxiService(new ElectroCar());

$taxi->getMachine()->// как получить charge ?

Answer 1

[Wol_fi]

Автокомплит идёт по phpdoc'у.
Если вам не подходит вариант с указанием phpdoc в самом коде, можно вынести отдельно классы\методы без реализации но задокументированные, например так:

class TaxiService {

/**
 * @var Machine
 */
    protected $machine;

    function __construct(Machine $machine)
    {
    }

/**
 * @return Machine
 */
    public function getMachine()
    {
    }
}

И просто указывать такие файлы в IDE как внешнюю библиотеку. Таким образом, например, решают проблему с автокомплитом в phalcon.

Comments

[Данила Риджи]

Я не догнал ваш ответ, можно поподробней с практическим примером

[Wol_fi]

Данила Риджи: вот например класс Phalcon\DI - https://github.com/phalcon/phalcon-devtools/blob/m... , как видите, тут только описание методов, реализации нет (тела методов пустые).
Так как phalcon написан на С и является нативным экстешном для php - то естественно IDE не может прочитать его файлы и построить мета-архитектуру данных (чтобы работал автокомплит и всякие проверки, например на правильность типов и т.д.). И для того, чтобы автокомплит всё-таки был, достаточно скачать папку https://github.com/phalcon/phalcon-devtools/blob/m... и указать в IDE её как внешнюю библиотеку. IDE прочтёт структуру и phpdoc из этой папки, и мы получим все плюшки, которые возможны.
Собственно предлагал вам выше такой же вариант.

[Данила Риджи]

Все понял, спасибо.

Answer 2

[Mikhail Osher]

/**
 * @var Machine|OtherInterface|OtherClass
 */
protected $machine;

Comments

[Данила Риджи]

Я получу только go()

[Mikhail Osher]

Данила Риджи: обновил ответ.

[Данила Риджи]

Обновил вопрос

Answer 3

[Sergey Petrov]

Как вариант:

$taxi = new TaxiService(new ElectroCar());

/** @var ElectroCar $taxiElectroCar */
$taxiElectroCar = $taxi->getMachine();

$taxiElectroCar->

Comments

[Данила Риджи]

Это вариант, но очень компромиссный