Как заставить intellisense работать с phpStorm при передаче объекта функции или итерации

У меня есть объект с геттерами и сеттерами, но я теряю intellisense на этом объекте, когда передаю его функции или итерации через массив этих объектов.

Например:

...
$personA = new Person(..);
$age = $personA->getAge();  // intellisense works.

$personArray = array($personA, $personB, .. );
foreach($personArray as $aPerson){
   $aPerson->getAge();   //  no intellisense here
}

doSomething($personA); 



function doSomething($person){
   $person->getAge()         //  no intellisense here
   ...
}

Что мне здесь не хватает?

Мне нужно внести изменения в код (casting и т.д.), не указав параметр phpStorm? Может быть, это невозможно?

Ответы

Ответ 1

Для первого случая foreach он пока недоступен из коробки, однако вы можете обычно намекать, что:

$personArray = array($personA, $personB, .. );
foreach ($personArray as $aPerson) {
   /* @var $aPerson Person */
   $aPerson->getAge();  // now with code-completition
}

Что делает тип-намек на переменную, которая принимает итерацию. В качестве альтернативы вы также можете ввести тип-указатель на переменную массива:

/* @var $personArray Person[] */
$personArray = array($personA, $personB, .. );
foreach ($personArray as $aPerson) {
    $aPerson->getAge();  // now with code-completition
}

Для вашего второго случая вы можете добавить подсказку типа PHP (которую я рекомендую):

function doSomething(Person $person) {
   $person->getAge() //  now with code-completition
   ...
}

Это также гарантирует, что вы можете передавать только те значения этого типа. См. Также Тип Hinting Docs и Интерфейсы Документы.

Другим решением для второго случая является также документировать параметр в док-блоке функции:

/**
 * @param Person $person
 */
function doSomething($person) {
   $person->getAge() //  now with code-completition
   ...
}

Некоторые ответы на вопросы:

Ответ 2

Пока блоки PPHDoc из @hakre работают в PHPStorm, правильная форма будет типом, за которым следует имя переменной, подобное этому 

/** @var Person $aPerson */

и что

/** @var Person[] $personArray */

Они будут работать в PHPStorm и phpDocumentor.

Источник: http://www.phpdoc.org/docs/latest/references/phpdoc/tags/var.html